Microsoft Setup¶
What to configure in Microsoft Entra ID and the Fabric admin portal so that MetaMiner can read your tenant. MetaMiner signs in as a service principal you own; tenant settings scoped to a security group unlock the Power BI and Fabric admin APIs, and Graph permissions unlock the Entra directory.
Order of tasks¶
flowchart LR
A[Register the application] --> B[Client secret]
B --> C[Graph API permissions + admin consent]
C --> D[Security group with the app]
D --> E[Fabric tenant settings for the group]
E --> F[MetaMiner Administrator: add environment, Test Connection]
E -.optional.-> G[Capacity Metrics app + workspace role]
E -.optional.-> H[Delegated sign-in consent]
Microsoft Entra ID¶
-
Create the single-tenant app registration and record its tenant and client IDs.
-
The Microsoft Graph application permissions MetaMiner checks, and why it needs no Power BI permissions.
-
Create the secret, store it safely, and rotate it before it expires.
-
A group containing only MetaMiner's service principal, used to scope the tenant settings.
Fabric admin portal¶
-
The admin API, Fabric API and scan detail settings, and the Test Connection step that proves each one.
-
When the service principal needs a workspace role, and which features run as the signed-in user.
-
Install the Capacity Metrics app and point MetaMiner at its semantic model.
Optional¶
-
Let client users sign in as themselves for Manage Access, restore and lakehouse export.
-
Endpoint sets for US Government, High and Military tenants.
-
What MetaMiner reads about gateways and connections, with no agent to install.
-
Every task on one page, by role.
Chapter status¶
- Register the Application - Entra admin center navigation path not re-checked against current Microsoft Learn.
- API Permissions - product decision needed on a Graph-free configuration; Microsoft guidance on Power BI permissions for admin-API service principals to re-check.
- Client Secret - portal labels to re-check.
- Security Group for the App - portal path to re-check.
- Tenant Settings - every setting name and admin portal section to re-check; whether the Power BI APIs and Fabric APIs settings are one or two.
- Workspace Access - minimum role for dataflow definitions and .pbix export unconfirmed.
- Capacity Metrics App - Microsoft install steps and where the semantic model ID is shown to re-check.
- Delegated User Sign-In - Entra roles that can grant the consent unconfirmed.
- Sovereign Clouds - tested feature matrix per US Government cloud missing.
- Gateways and Connections - minimum gateway/connection role for a complete inventory unconfirmed.