Een rapport insluiten met op tokens gebaseerde identiteit (SSO)

Van toepassing op:✅ Power BI ingesloten analyses voor uw klanten (App-owns-data)

Met de identiteit op basis van tokens kan een ISV een Microsoft Entra-toegangstoken gebruiken om de identiteit van een klant door te geven aan een Azure SQL-database die wordt beheerd in de tenant van de klant.

ISV-klanten die hun gegevens in Azure SQL Database bewaren en beheren, kunnen hun gegevens veilig houden in hun tenant bij de integratie met Power BI Embedded in de ISV-app.

Bij het genereren van het insluittoken geeft u de identiteit van de gebruiker in Azure SQL op door het Microsoft Entra-toegangstoken van die gebruiker door te geven voor de Azure SQL-server. Het toegangstoken wordt vervolgens gebruikt om alleen de relevante gegevens voor die gebruiker op te halen uit Azure SQL voor die specifieke sessie.

Schematische tekening waarin ISV de effectieve identiteit doorgeeft aan de SQL-tenant en de klant die een insluittoken teruggeeft.

Important

Beperkingen voor eenmalige aanmelding van App-owns-data:

In app-eigen-gegevensscenario's (service-principal of hoofdgebruikersverificatie) wordt eenmalige aanmelding voor DirectQuery-gegevensbronnen alleen ondersteund met Azure SQL Database.
Bij het genereren van een insluittoken met eenmalige aanmelding moet u een IdentityBlob voor elke gegevensbron opgeven waarvoor eenmalige aanmelding is ingeschakeld. Als u de IdentityBlob weglaat, mislukt het genereren van tokens of het uitvoeren van query's.

Identiteit op basis van tokens instellen

De identiteit op basis van tokens werkt alleen voor DirectQuery-modellen op een capaciteit die is verbonden met een Azure SQL Database die is geconfigureerd om Microsoft Entra-verificatie toe te staan. De gegevensbron van het semantische model moet zijn geconfigureerd voor het gebruik van OAuth2-referenties van eindgebruikers om een identiteit op basis van tokens te kunnen gebruiken. Meer informatie over Microsoft Entra-verificatie voor Azure SQL Database.

Voordat u een identiteit op basis van tokens configureert, moet u het volgende controleren:

Uw DirectQuery-gegevensbron is Azure SQL Database (de enige ondersteunde SSO-gegevensbron voor app-eigen gegevensscenario's).
De Azure SQL Database is geconfigureerd voor Microsoft Entra verificatie.
U hebt het Microsoft Entra toegangstoken van de gebruiker voor de Azure SQL Server om door te geven als IdentityBlob.

Instellen in portal
Instellen met API

Selecteer in de Power BI-portal Semantisch model > Meer opties (drie puntjes) > Instellingen > gegevensbronreferenties >Referenties bewerken.
Vink het OAuth2-vakje aan.

Stuur een Gateways - Datasource-API-aanroep bijwerken met "useEndUserOAuth2Credentials" = True en "credentialType": "OAuth2" voor het gewenste semantische model. De aanvraagbody moet er ongeveer als volgt uitzien:

{
  "credentialDetails": {
    "credentials": "{\"credentialData\":[{\"name\":\"accessToken\",\"value\":\"eyJ…\"}]}",
    "credentialType": "OAuth2",
    "encryptedConnection": "Encrypted",
    "encryptionAlgorithm": "None",
    "privacyLevel": "Organizational",
    "useEndUserOAuth2Credentials": true
  }
}

Een identiteitstoken genereren

Als u een toegangstoken voor Azure SQL wilt maken, moet de app beschikken over gedelegeerde machtigingen voor Azure SQL DB en Data Warehouse voor Azure SQL Database-API in de configuratie voor app-registratie van Microsoft Entra in Azure Portal.

Schermopname van de configuratie-instellingen voor de registratie van Microsoft Entra-apps in Azure Portal. Verifieer en verwerf een token voor de gebruiker van het Azure AD v2-eindpunt voor het volgende bereik: https://database.windows.net/.default

Zie de volgende MSAL-codevoorbeelden voor hulp:

Codevoorbeelden voor verificatie en autorisatie van Het Microsoft Identity Platform - Microsoft Entra | Microsoft Learn
Microsoft identity platform en OAuth 2.0-autorisatiecodestroom

Insluittoken genereren

Als u een rapport wilt insluiten met een identiteit op basis van tokens, genereert u een insluittoken dat de basisidentiteit van het token van de gewenste ISV-gebruiker bevat. Zie de volgende voorbeelden voor het genereren van insluittokens voor verschillende scenario's.

Note

U moet een vermelding met een geldige datasourceIdentities voor identityBlob Azure SQL-gegevensbron met SSO inschakelen. Als een gegevensbron met eenmalige aanmelding zijn identityBlob mist, zal de aanroep voor het genereren van het insluittoken mislukken of zal de uitvoering van de query een fout retourneren.

{
  "datasets": [
    {
      "id": "66ba5010-xxxx-xxxx-xxxx-f2bf0125abeb",
    }
  ],
  "reports": [
    {
      "allowEdit": false,
      "id": "9e6da541-xxxx-xxxx-xxxx-7d9442827cce"
    }
  ],
  "datasourceIdentities": [
    {
      "identityBlob": "eyJ…",
      "datasources": [
        {
          "datasourceType": "Sql",
          "connectionDetails": {
            "server": "YourServerName.database.windows.net",
            "database": "YourDataBaseName"
          }
        }
      ]
    }
  ]
}

{
  "reports": [
    {
      "allowEdit": false,
      "id": "2b0a27c7-xxxx-xxxx-xxxx-4d2036b42f90"
    }
  ],
  "datasourceIdentities": [
    {
      "identityBlob": "eyJ…",
      "datasources": [
        {
          "datasourceType": "Sql",
          "connectionDetails": {
            "server": "YourServerName.database.windows.net",
            "database": "YourDataBaseName"
          }
        }
      ]
    }
  ]
}

{
  "datasets": [
    {
      "id": "fff1a505-xxxx-xxxx-xxxx-e69f81e5b974",
    }
  ],
  "reports": [
    {
      "allowEdit": false,
      "id": "10ce71df-xxxx-xxxx-xxxx-814a916b700d"
    }
  ],
  "identities": [
    {
      "username": "YourUsername",
      "datasets": [
        "fff1a505-xxxx-xxxx-xxxx-e69f81e5b974"
      ],
      "roles": [
        "YourRole"
      ]
    }
  ],
  "datasourceIdentities": [
    {
      "identityBlob": "eyJ…",
      "datasources": [
        {
          "datasourceType": "Sql",
          "connectionDetails": {
            "server": "YourServerName.database.windows.net",
            "database": "YourDataBaseName"
          }
        }
      ]
    }
  ]
}

{
  "datasets": [
    {
      "id": "35a4a948-xxxx-xxxx-xxxx-2e6ad7a02dc7",
      "xmlaPermissions": "ReadOnly"
    },
    {
      "id": "064ef46d-xxxx-xxxx-xxxx-fd6dda7a467b",
      "xmlaPermissions": "ReadOnly"
    }
  ],
  "reports": [
    {
      "allowEdit": false,
      "id": "9e81ebf7-xxxx-xxxx-xxxx-5a6294b43d55"
    }
  ],
  "identities": [
    {
      "username": "YourUsename",
      "datasets": [
        "35a4a948-xxxx-xxxx-xxxx-2e6ad7a02dc7"
      ],
      "roles": [
        "YourRole"
      ]
    }
  ],
  "datasourceIdentities": [
    {
      "identityBlob": "eyJ…",
      "datasources": [
        {
          "datasourceType": "Sql",
          "connectionDetails": {
            "server": " YourServerName.database.windows.net",
            "database": " YourDatabaseName "
          }
        }
      ]
    }
  ]
}

In het volgende voorbeeld ziet u een ingesloten Power BI-rapport met Single Sign-On en RLS die zijn toegepast op de gegevensset.

Schermopname van een ingesloten Power BI-rapport met Single Sign-On en RLS die zijn toegepast op de dataset.

Feedback

Is deze pagina nuttig?

Last updated on 2026-05-11