Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 18 additions & 2 deletions Workload-Identity-Federation-for-SCIM-Provisioning.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Workload Identity Federation: A New Authentication Method for SCIM Provisioning

**Date:** 9th June 2026
**Date:** 25th June 2026

---

Expand Down Expand Up @@ -62,6 +62,8 @@ This is a fundamental shift from the traditional model where admins had to:

The administrator must perform **3 steps** to set up the integration for their app. The administrator must have at least the **Application Administrator** role on the customer's tenant.

![Workload Identity Federation configuration flow](media/workload-identity-federation/wif-configuration-flow.png)

### Step 1: Configure ISV App and Workload Identity in Entra Portal

In the Entra App Gallery, the administrator:
Expand All @@ -70,6 +72,16 @@ In the Entra App Gallery, the administrator:
2. On the Connectivity Page, picks **"Workload Identity Federation"** as the auth method
3. Clicks **"Select Workload Identity"** — customers can register a new Workload Identity App or reuse an existing one they have already used to set up with the ISV

The Connectivity page exposes **Workload Identity Federation** as an authentication method alongside the existing authentication options.

![Select Workload Identity Federation as the provisioning authentication method](media/workload-identity-federation/select-workload-identity-federation-auth-method.jpg)

After selecting **Workload Identity Federation**, the administrator chooses **Select Workload Identity**. From there, they can either register a new workload identity app or select an existing workload identity that has already been configured with the ISV.

| Register a new workload identity | Select an existing workload identity |
|---|---|
| ![Register a new workload identity in Entra](media/workload-identity-federation/register-new-workload-identity.jpg) | ![Select an existing workload identity in Entra](media/workload-identity-federation/select-existing-workload-identity.jpg) |

After the access app is configured, the UX displays the following values to be **copied to the ISV Portal**:

| Value | Format |
Expand All @@ -79,6 +91,8 @@ After the access app is configured, the UX displays the following values to be *
| **Subject (sub)** | `<Sync Fabric Workload Identity 1P app object ID>` |
| **Audience (aud)** | `api://{WorkloadIdentity_appid}/.default` |

![Copy WIF claims and JWKS URL from Entra to the ISV portal](media/workload-identity-federation/copy-wif-claims-to-isv.png)

### Step 2: Set up SCIM Client with JWKS in ISV Portal

In the ISV portal, the administrator sets up a client for the ISV's SCIM endpoint. As part of setting up the auth integration, the administrator copies the values from Step 1 (issuer, JWKS URL, subject, audience) into the ISV portal.
Expand All @@ -99,6 +113,8 @@ Back in the Entra App Gallery:
2. Click **"Test Connection"** — this invokes the backend to perform all the token exchange steps and validate the integration
3. **Save** the configuration — the app is now ready to configure provisioning

![Complete Workload Identity Federation connectivity settings in Entra](media/workload-identity-federation/complete-entra-connectivity-settings.png)

---

## How the JWT Bearer Assertion Flow Works
Expand Down Expand Up @@ -402,4 +418,4 @@ If the JWKS endpoint is temporarily unavailable:
| Microsoft Identity Platform OIDC Metadata | `https://login.microsoftonline.com/{tenantId}/v2.0/.well-known/openid-configuration`|
---

*Last updated: June 9, 2026*
*Last updated: June 25, 2026*
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.