Upota raportti, jossa on tunnuspohjaiset käyttäjätiedot (SSO)

Koskee seuraavia:✅ Power BI asiakkaille upotettu analytiikka (sovellus omistaa tiedot)

Token-pohjainen identiteetti mahdollistaa ISV:n käyttää Microsoft Entra access tokenia asiakkaan identiteetin siirtämiseen Azure SQL -tietokantaan, jota hallinnoidaan asiakkaan vuokralainen.

ISV-asiakkaat, jotka säilyttävät ja hallitsevat tietojaan Azure SQL -tietokannassa, voivat pitää tietonsa suojattuina vuokraajassaan, kun he integroivat Power BI Embeddedin ISV-sovellukseen.

Kun muodostat upotustunnuksen, määritä käyttäjän käyttäjätiedot Azure SQL:ssä välittämällä käyttäjän Microsoft Entra -käyttöoikeustietue Azure SQL -palvelimelle. Käyttöoikeustietuetta käytetään sitten vain tätä käyttäjää koskevien olennaisten tietojen noutamiseen Azure SQL:stä tätä tiettyä istuntoa varten.

Important

App-owns-data SSO-rajoitukset:

• App-owns-data -tilanteissa (palveluperiaate tai pääkäyttäjän tunnistautuminen) DirectQuery-tietolähteiden SSO on tuettu vain Azure SQL Database kanssa.
• Kun luot embed-tokenia SSO:lla, sinun täytyy antaa IdentityBlobjokaiselle tietolähteelle, jolla SSO on käytössä. IdentityBlobin poisjättäminen aiheuttaa tokenin generoinnin tai kyselyn suorituksen epäonnistumisen.

Tunnuspohjaisten käyttäjätietojen määrittäminen

Tunnuspohjaiset käyttäjätiedot toimivat vain DirectQuery-malleissa kapasiteetissa, joka on yhdistetty Azure SQL -tietokantaan, joka on määritetty sallimaan Microsoft Entra -todennus. Semanttisen mallin tietolähde on määritettävä käyttämään loppukäyttäjän OAuth2-tunnistetietoja tunnuspohjaisten käyttäjätietojen käyttämiseksi. Lue lisää Microsoft Entra -todennuksesta Azure SQL -tietokantaa varten.

Ennen token-pohjaisen identiteetin määrittämistä varmista:

• DirectQuery-tietolähteesi on Azure SQL Database (ainoa tuettu SSO-tietolähde App-owns-data -tilanteissa).
• Azure SQL Database on konfiguroitu Microsoft Entra autentikointiin.
• Sinulla on käyttäjän Microsoft Entra access token, jonka Azure SQL palvelin voi välittää IdentityBlob.

Portaalissa määrittäminen

1. Valitse Power BI -portaalissa Semanttinen malli > Lisää asetuksia (kolme pistettä) > Asetukset > Tietolähteen tunnistetiedot > Muokkaa tunnistetietoja.

   

2. Valitse OAuth2-vaihtoehto .

   

Ohjelmointirajapinnan määrittäminen

Lähetä yhdyskäytävät – Päivitä tietolähteen ohjelmointirajapinnan kutsu haluamasi semanttisen mallin kanssa "useEndUserOAuth2Credentials" = True ja "credentialType": "OAuth2" sitä varten. Pyynnön rungon pitäisi näyttää suunnilleen tältä:

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

Luo käyttäjätietotunnus

Jotta voit luoda käyttöoikeustietueen Azure SQL:lle, sovelluksella on oltava delegoitu Azure SQL -tietokannan ja tietovaraston käyttöoikeus Azure SQL -tietokannan ohjelmointirajapintaan Microsoft Entra -sovelluksen rekisteröintimäärityksessä Azure-portaali.

Todenna ja hanki käyttäjälle tunnus Azure AD v2 -päätepisteestä seuraavaan laajuuteen:https://database.windows.net/.default

Lisätietoja on seuraavissa MSAL-koodiesimertteissä:

• Koodiesimerkit Microsoftin käyttäjätietojen käyttöympäristön todentamiseen ja valtuutukseen – Microsoft Entra | Microsoft Learn
• Microsoftin käyttäjätietoympäristö ja OAuth 2.0 -valtuutuskoodin työnkulku

Muodosta upotustunnus

Jos haluat upottaa raportin, jossa on tunnuspohjaisia käyttäjätietoja, luo upotustunnus, joka sisältää halutun ISV-käyttäjän tunnuksen perustiedot. Seuraavissa esimerkeissä voit luoda upotustunnuksia eri skenaarioissa.

Huomautus

Sinun täytyy lisätä datasourceIdentities-merkintä, jossa on voimassa oleva identityBlobeach Azure SQL tietolähteelle, jossa SSO on käytössä. Jos jokin SSO-yhteensopiva tietolähde puuttuu identityBlob, upotustokenin generointikutsu epäonnistuu tai kyselyn suoritus palauttaa virheen.

Power BI -raportti, jossa on kertakirjautuminen

{
  "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"
          }
        }
      ]
    }
  ]
}

Sivutettu raportti, jossa on SSO

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

Power BI -raportti, jossa on SSO ja RLS semanttisessa mallissa

{
  "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"
          }
        }
      ]
    }
  ]
}

Sivutettu raportti, joka on yhdistetty Power BI:n semanttiseen malliin rivitason suojauksen avulla, ja SSO-tietolähde, joka on yhdistetty DirectQueryyn toiseen Power BI -tietojoukkoon

{
  "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 "
          }
        }
      ]
    }
  ]
}

Seuraavassa esimerkissä on upotettu Power BI -raportti, jossa on käytössä kertakirjautuminen ja rivitason suojaus tietojoukossa: