Join our Newsletter — 33% off our NHI Course
Home› Guides› Power BI Security Guide: SCuBA Settings, Service Principals…
Guide SaaS & OAuth Integrations

Power BI Security Guide: SCuBA Settings, Service Principals and Sharing

PDF for newsletter subscribers · free to read online

← All guides
By NHI Mgmt Group, edited by Lalit Choda Updated 8 November 2026 14 min read
On this page

Power BI concentrates an organisation's most sensitive numbers in a service where a single tenant setting can publish a report to the open internet and a single service principal can read every workspace it has been added to. Most Power BI exposure comes from tenant settings left at defaults, guests and sharing links nobody reviews, and applications that embed or automate reports with long-lived secrets. This guide covers the CISA SCuBA Power BI baseline policy by policy, then the identity layer underneath it: admin roles, workspace roles, service principals, embedding, gateway credentials and the audit operations that show abuse. It is for Microsoft 365 and Fabric administrators, data platform owners and security engineers. For data protection in general see the Data Security Guide.

This is an independent guide from NHI Mgmt Group, based on Microsoft's public documentation as of November 2026. It is not sponsored or reviewed by Microsoft. Product features change, so confirm settings against Microsoft's current documentation.

Key takeaways

  • Tenant settings are the control plane. The SCuBA baseline sets seven policies, all in the Power BI admin portal: publish to web, guest access, guest invitations, two service principal settings, resource keys, R and Python visuals, and sensitivity labels.
  • Publish to web means anonymous. It creates a public URL that needs no authentication; disable it, or limit it to a named security group and audit every PublishToWebReport event.
  • Service principals need two grants, so control both. A tenant setting scoped to a security group, and workspace membership as Member or Admin; Microsoft says such apps need no Entra API permissions at all.
  • Workspace roles are broader than they look. Members can add people and reshare, Contributors can read data through OneLake and Spark, and nested groups inherit roles.
  • Audit lives in Microsoft Purview. Operations such as ShareReport, ExportReport, GenerateEmbedToken and TakeOverDataset are the ones to alert on.

The SCuBA Power BI baseline at a glance

CISA's Power BI secure configuration baseline, in the cisagov/ScubaGear repository, uses SHOULD for every policy, leaving room for mission-justified exceptions. Each one maps to a named tenant setting. Policy IDs and setting names below were checked in the repository on 27 October 2026; Microsoft renames settings as Fabric evolves, so confirm the label in your admin portal.

Policy IDRequirementTenant setting (section)Risk addressed
MS.POWERBI.1.1v1Publish to web SHOULD be disabled unless the mission requires itPublish to web (Export and sharing settings)Anonymous public access to report data
MS.POWERBI.2.1v1Guest user access SHOULD be disabled unless required, or limited to security groupsGuest users can access Microsoft Fabric (Export and sharing settings); in GCC, GCC High and DoD: Allow Azure Active Directory guest users to access Power BIExternal users reaching data and APIs
MS.POWERBI.3.1v1Inviting external users SHOULD be disabled unless requiredUsers can invite guest users to collaborate through item sharing and permissionsGuest sprawl created through sharing dialogs
MS.POWERBI.4.1v1Service principals with API access SHOULD be restricted to specific security groupsService principals can call Fabric public APIs (Developer settings)Unrestricted application access to APIs
MS.POWERBI.4.2v1Service principals' ability to create and use profiles SHOULD be restricted to security groupsAllow service principals to create and use profiles (Developer settings)Profiles used with more permission than intended
MS.POWERBI.5.1v1ResourceKey-based authentication SHOULD be blocked unless streaming or push datasets need itBlock ResourceKey authentication set to Enabled (Developer settings)Data pushed with a secret key in a URL, without an Entra token
MS.POWERBI.6.1v1Python and R interactions SHOULD be disabledInteract with and share R and Python visualsUntrusted script code in reports
MS.POWERBI.7.1v1Sensitivity labels SHOULD be enabled and used for sensitive dataAllow users to apply sensitivity labels for content (Information protection)Unclassified data shared or exported without protection

Two baseline notes matter in practice. Disabling external invitations does not remove existing guests, who keep the access they already had. And sensitivity labels need Microsoft Purview Information Protection Premium P1 or P2 licensing, with a Power BI Pro or Premium Per User licence for people applying labels. See the CISA SCuBA Baselines Guide for the other Microsoft 365 baselines and the Microsoft Purview Information Protection Guide for labelling.

How identity and access work in Power BI

Power BI is part of Microsoft Fabric and authenticates every user and application through Microsoft Entra ID, so Conditional Access, MFA and guest policies in Entra apply first. Inside the service, access is layered:

  • Tenant settings: switch features on or off for the organisation or for named security groups. They decide whether a capability exists at all, such as publish to web, export, guest access or service principal API use.
  • Workspace roles: Admin, Member, Contributor and Viewer, assignable to users, security groups, Microsoft 365 groups, distribution lists and service principals.
  • Item permissions and sharing: direct sharing of reports, dashboards and semantic models, including Reshare and Build permissions, and published apps for wider audiences.
  • Data-level controls: row-level security in semantic models, sensitivity labels, and the credentials stored for data sources and gateways.
Capability (from Microsoft's workspace roles table)AdminMemberContributorViewer
Update and delete the workspace; add or remove adminsYesNoNoNo
Add members or others with lower permissionsYesYesNoNo
Share items and allow others to reshareYesYesOnly with ReshareOnly with Reshare
Create, write and delete itemsYesYesYesNo
Read data through OneLake APIs and SparkYesYesYesNo
View items and read through the SQL endpointYesYesYesYes

Microsoft notes that group members inherit the role, nested group members do too, and a user with several roles gets the highest. Workspace roles also do not govern everything underneath: OneLake shortcut destinations and on-premises gateways need their own permissions. Review group nesting before assuming a workspace is private.

Admin roles and privileged access

Administration happens in the Power BI (Fabric) admin portal, held by the Entra Fabric Administrator role (formerly Power BI Administrator) and by Global Administrator. Either can change every tenant setting in the table above, so a single compromised admin session can re-enable publish to web or open service principal API access to everyone.

  • Put the Fabric Administrator role behind PIM, with approval and short activation, and keep Global Administrator for emergencies. See the Privileged Identity Management (PIM) Guide.
  • Scope delegated settings: Fabric lets some tenant settings be delegated to capacity, domain or workspace admins, and the audit log records changes such as UpdateWorkspaceTenantSettingDelegation. Decide which settings may be delegated and alert on delegation changes.
  • Limit workspace Admins: two named owners per production workspace is a practical target; use Member for people who manage content and Viewer, or an app audience, for consumers.
  • Watch take-overs: taking over a semantic model or data source (TakeOverDataset, TakeOverDatasource) moves its stored credentials and refresh to a new owner. It is a legitimate fix when an owner leaves and a quiet way to gain control of a data connection.

Integrations, API tokens and service principals

Service principals are how applications embed reports, automate deployment, refresh semantic models and call admin APIs. Microsoft's embedding documentation describes two layers of access, and both should be narrow.

  1. Tenant settings: a Power BI admin enables Embed content in apps and the setting that lets service principals call the APIs, for the whole organisation or for a security group. SCuBA MS.POWERBI.4.1v1 says to use a security group. Microsoft adds that service principals get every tenant setting they are enabled for, so use a dedicated group and exclude it from sensitive settings.
  2. Workspace membership: the service principal, or its group, is added to each workspace it needs as Member or Admin. Prefer Member; Admin can add and remove other admins.
Integration patternIdentity usedMain riskControl
Embed for customers (app owns data)Service principal, or a master user accountEmbed tokens generated for any report the identity can reachDedicated workspace per app; Member role; alert on unusual GenerateEmbedToken volume
Deployment and automation pipelinesService principalSecret in CI with Admin on many workspacesCertificate or federated credential; one principal per pipeline; Member on target workspaces only
Admin and governance tools (scanner, inventory)Service principal with read-only admin API accessTenant-wide metadata readSeparate admin API setting scoped to one group; read-only only
Streaming and push datasetsResource key in a URLAnyone with the URL can push dataBlock ResourceKey authentication (MS.POWERBI.5.1v1); use Entra tokens
Data source and gateway connectionsStored database or cloud credentialsCredentials reused by anyone who can refresh or take overDedicated read-only accounts; limit gateway data source users
  • Do not add Entra API permissions: Microsoft states that an app used as a Power BI service principal does not need delegated or application permissions in the Azure portal and recommends not adding them, because they are never used. Remove any that were added "to make it work".
  • Certificates over secrets: Microsoft recommends certificates for back-end services. A client secret is shown once and tends to be copied into configuration files. See the Azure Entra Client Secrets Security Guide.
  • Know the limits: service principals cannot use My workspace, cannot sign in to the portal, and cannot be used for "embed for your organisation" apps.
  • Replace master user accounts: embedding with a real user account means a password, often exempted from MFA. Replace it with a service principal.
  • Gateway credentials: on-premises data gateways store data source credentials encrypted (the audit log records EncryptCredentials and ChangeGatewayDatasourceUsers). Limit who can use each gateway data source and give the stored account read-only rights.

See the Service Account Security Guide and the Entra ID Applications and Consent Guide for lifecycle and ownership practice.

Sharing, guests and data exfiltration paths

Power BI offers several ways for data to leave its intended audience, and the controls differ for each.

  • Publish to web: anonymous, viewable by anyone with the link. The baseline's fallback, if it must stay on, is to restrict it to specific security groups. Embed codes can be reviewed and deleted by admins; the audit log records PublishToWebReport and DeleteEmbedCode.
  • Guests: B2B guests appear in user pickers once invited. Limit guest access to a security group, and review guests with access to sensitive workspaces. See the Entra ID Cross-Tenant Access and B2B Guest Governance Guide.
  • Export and download: exports to files, report downloads and Analyze in Excel move data outside the service (ExportReport, ExportArtifactDownload, DownloadReport, AnalyzeInExcel). Restrict export tenant settings to groups that need them and rely on sensitivity labels to carry protection into exported files.
  • Resharing: anyone with Reshare can extend access. Grant Reshare sparingly and prefer apps with defined audiences.

These map to ATT&CK collection and exfiltration techniques such as Data from Information Repositories (T1213) and Exfiltration Over Web Service (T1567). See the Data Loss Prevention (DLP) Guide.

Logging and detection

Fabric and Power BI activities are recorded in the Microsoft Purview audit log. Searching it needs the Audit Logs role in Exchange Online, which the Compliance Management and Organization Management role groups hold by default, and retention is governed by Purview audit retention policies. Forward the events to your SIEM; see the Microsoft 365 Unified Audit Log Guide for Detection.

Operation (Microsoft operation list)What it meansAlert or review
PublishToWebReportA report was published to the webAlert on every occurrence; confirm approval
ShareReport, ShareDashboard, ShareArtifactDirect sharingReview shares to guests or external domains
ExportReport, ExportArtifactDownload, DownloadReport, AnalyzeInExcelData leaving the serviceAlert on volume spikes per user or principal
GenerateEmbedToken, GenerateMultiResourceEmbedTokenEmbed tokens issuedBaseline per application; alert on new reports or volume
AddGroupMembers, DeleteGroupMembers, UpdateFolderAccessWorkspace membership and access changesAlert on Admin grants in production workspaces
TakeOverDataset, TakeOverDatasourceOwnership and credentials movedConfirm it matches a leaver or change record
CreateServicePrincipalProfileNew service principal profileCheck against the approved group (MS.POWERBI.4.2v1)
AddDatasourceToGateway, ChangeGatewayDatasourceUsers, EncryptCredentialsGateway data sources and stored credentials changedReview who gained use of a data source

Pair Power BI audit data with Entra sign-in logs for service principals: a principal signing in from a new location or outside its pipeline schedule is the earliest sign of a stolen secret (ATT&CK T1528, T1078.004). See the Entra ID Sign-In and Audit Log Detection Guide.

Metrics:

  • ScubaGear results for the Power BI baseline, per run.
  • Number of active publish-to-web embed codes (target zero, or only approved ones).
  • Guests with access to workspaces holding labelled confidential data.
  • Service principals in the API security group, and those with Admin rather than Member on workspaces.
  • Share of production semantic models with a sensitivity label.
  • Exports per week from labelled content, against a baseline.

Hardening baseline

  1. Assess: run ScubaGear against the Power BI baseline and export tenant settings, workspace role assignments, guests, service principals and active embed codes.
  2. Close anonymous paths first: disable publish to web after reviewing existing embed codes with owners; block ResourceKey authentication after checking streaming and push datasets. Roll back by re-enabling for a named security group, never the whole organisation.
  3. Constrain external access: limit guest access and invitations to security groups (or disable them) and review existing guests, who are not removed by the setting.
  4. Restructure service principals: create a dedicated security group for API access, a separate one for profiles and one for read-only admin APIs; move each principal to Member on only its workspaces; switch to certificates; remove unused Entra API permissions.
  5. Disable R and Python visuals unless a reviewed use exists.
  6. Turn on sensitivity labels, apply them to production semantic models and reports, and restrict export settings to groups that need them.
  7. Reduce admins: move Fabric Administrator to PIM, cut workspace Admins to named owners, and decide which tenant settings can be delegated.
  8. Monitor: forward audit operations to the SIEM with the alerts above, and schedule ScubaGear runs to catch drift.

Small versus large organisations: a small tenant can usually disable publish to web, guest invitations, resource keys and R and Python visuals outright, and needs only one or two service principals. Large organisations typically need exceptions, so the security-group form of each setting matters more than the on or off choice, together with workspace ownership reviews and labelling at scale.

Common misconfigurations

  • Publish to web enabled for the entire organisation: any report author can create an anonymous public link to production data.
  • Service principal API access for everyone: the API setting enabled tenant-wide, so any app registration added to a workspace can call the APIs, against MS.POWERBI.4.1v1.
  • One service principal as Admin on every workspace: a deployment secret in CI that can read, change and reshare everything.
  • Master user embedding: a licensed user account with a password stored in an application, excluded from MFA.
  • Guests never reviewed: external invitations disabled after the fact, but existing guests keep their access.
  • Nested groups granting workspace roles: a broad group nested inside a workspace Member group, giving hundreds of people the ability to add others and reshare.

Framework mapping

AreaNIST SP 800-53 Rev. 5 (SCuBA mapping where given)NIST CSF 2.0
Publish to web, guests, invitationsCM-7, SC-7, AC-6PR.AA-05
Service principals and profilesAC-4, AC-6PR.AA-01, PR.AA-05
Resource keysCM-7, IA-5PR.AA-01
R and Python visualsCM-7, SI-3PR.PS-01
Sensitivity labelsAC-21, SC-7PR.DS-01
Audit and monitoringAU-12PR.PS-04, DE.CM-09

Practitioner checklist

  • Run ScubaGear for Power BI and document a pass or exception for each MS.POWERBI policy.
  • Disable publish to web, or limit it to one security group, and review every existing embed code.
  • Limit guest access and guest invitations to security groups and review existing guests on sensitive workspaces.
  • Restrict service principal API access and profile creation to dedicated security groups.
  • Give each service principal Member, not Admin, on only the workspaces it needs, with a certificate credential and no Entra API permissions.
  • Block ResourceKey authentication and disable R and Python visuals unless a reviewed exception exists.
  • Enable sensitivity labels and restrict export settings to the groups that need them.
  • Move the Fabric Administrator role to PIM and keep workspace Admins to named owners.
  • Alert on PublishToWebReport, external shares, export spikes, embed token anomalies, take-overs and workspace Admin grants.

Standards and references

Related NHI Mgmt Group resources: Data Security Guide · Microsoft 365 Security Guide · Exchange Online Security Guide · Service Account Security Guide

PDF for subscribers

Take this guide with you

Every section, table and checklist in one PDF, with links to the sources and related guides. Subscribe to our weekly NHI & AI Identity Journal and we’ll email you a download link.

Free weekly newsletter

Subscribe to the NHI & AI Identity Journal

The latest on NHI and Agentic AI security – articles, research, breaches, news and events every week.

Bonus 33% off our NHI Course when you subscribe.

NHIMG Editorial Note
Researched and written by the NHI Mgmt Group editorial team using AI tools, under the editorial direction of Lalit Choda. Facts are drawn from the sources listed on this page and checked by our automated quality process. Last updated 8 November 2026. Spotted an error? Use our contact page.
NHI Mgmt Group, the independent authority on Non-Human Identity, IAM and Agentic AI security. nhimg.org

PDF Downloads for Newsletter Subscribers

Get the guide

Enter your details and we’ll email you a download link.

The full guide is free to read online. The PDF is a thank you for subscribing.

Fill in all fields marked * and tick the PDF box to continue.