Sign up & instance setup · BYOF: identity, access and monitoring
Assign the service principal to a Fabric workspace
Grant the application direct workspace access, choose Member or Admin, and verify the same workspace is available in Emplyr.
BYOF setup checklist · Task 3 of 5
On this page
Before you start
- Have the app’s name and application/client ID, plus the correct Fabric workspace name. Use a workspace administrator for this procedure, especially when granting the application Admin.
- Complete the scoped tenant settings and capacity permissions first. Decide whether Emplyr only needs content/report access or must also manage workspace users/groups.
Which role should I choose?
On smaller screens, scroll the table sideways to see all columns.
| Use case | App’s workspace role |
|---|---|
| Emplyr lists/embeds/exports existing reports | Member, or Admin where the agreed operations need it. |
| Emplyr adds/removes workspace admins or groups | Admin. |
| Someone edits the Eventstream manually in Fabric | That human needs Contributor or higher in the Eventstream workspace, plus capacity-admin authority for the capacity sources. |
| Optional Metrics app history | Grant the app access to the installed Metrics workspace and model separately; the content workspace grant does not cover it. |
Follow these steps
- Sign in to Microsoft Fabric in the same tenant as the service principal. Open Workspaces and the exact workspace to bind to the Emplyr profile.
- At the workspace’s top bar choose Manage access → Add people or groups. In older Power BI navigation use the workspace More menu → Workspace access.
- Search for the registered application by its name or application/client ID and select the service-principal entry. Check its identity against your recorded app; similarly named user accounts are different identities.
- Choose Member for Emplyr report/content access when workspace-user management is unnecessary. Choose Admin if Emplyr must manage workspace role assignments. Select Add and confirm the application is listed with that role.
- Check Workspace settings → License info (or the capacity setting shown in that workspace) and confirm the intended capacity. Reassigning a workspace requires workspace Admin and capacity contributor/Admin and may affect existing content; use the approved placement.
- If you are still signing up, record the workspace ID from its Fabric URL and continue with Connect Fabric / Connect live usage; Emplyr administration opens after readiness. For an existing ready instance, refresh Admin / Global → Fabric → Workspaces now and match both workspace ID and name.
- Once the instance is Ready, create/edit the intended profile and bind that workspace. Enable the required modules and profile roles. If commercially enrolled, ensure the workspace is on a capacity activated for this instance.
- After readiness, test report listing/embedding or the intended workspace action with the app, then test as an ordinary member with the correct profile/report permissions. Repeat the Microsoft workspace grant on other intended profile workspaces; a group used for tenant scoping alone does not add workspace access.
Worked example
For the fictional NovaNest Operations workspace, add emplyr-novanest-production as Member if the team only reads existing reports. Use Admin instead when the agreed Emplyr flow must assign workspace access. Confirm the workspace ID before binding the Operations profile.
Provider references
What you should see
The application appears on the correct workspace’s access list with the agreed role. After live setup makes the instance Ready, refresh Emplyr inventory and confirm the matching workspace/profile can use its authorised content.
If something goes wrong
The application cannot be selected
Confirm tenant, app name/client ID and its Enterprise applications entry. Ask the workspace administrator to check the identity rather than adding another user with a similar name.
Reports work but Assign access fails
The app may have Member rather than Admin. Workspace role-assignment management needs the corresponding Admin permission; directory lookup may also need approved Graph access.
The workspace is visible but profile access is paused
Check Emplyr’s commercial activation and actual workspace capacity/placement. Provider permissions and subscription eligibility are separate.
I added a user in Emplyr but the service principal still lacks access
The app’s Fabric workspace role is separate from Emplyr membership and from a person’s Fabric access. Grant the application itself as described above.