Ενσωμάτωση αναφοράς με ταυτότητα βάσει διακριτικού (SSO)

Ισχύει για:✅ Power BI ενσωματωμένη ανάλυση για τους πελάτες σας (τα δεδομένα ανήκουν στην εφαρμογή)

Η ταυτότητα που βασίζεται σε διακριτικό επιτρέπει σε έναν ISV να χρησιμοποιήσει ένα διακριτικό πρόσβασης Microsoft Entra για να μεταβιβάσει την ταυτότητα ενός πελάτη σε μια βάση δεδομένων SQL Azure που διαχειρίζεται ο μισθωτής του πελάτη.

Οι πελάτες ISV που διατηρούν και διαχειρίζονται τα δεδομένα τους στη βάση δεδομένων SQL Azure μπορούν να διατηρήσουν τα δεδομένα τους ασφαλή στον μισθωτή τους κατά την ενοποίηση με το Power BI Embedded στην εφαρμογή ISV.

Κατά τη δημιουργία του διακριτικού ενσωμάτωσης, καθορίστε την ταυτότητα του χρήστη στο Azure SQL διαβιβάζοντας το διακριτικό πρόσβασης Microsoft Entra αυτού του χρήστη για τον διακομιστή Azure SQL. Στη συνέχεια, το διακριτικό πρόσβασης χρησιμοποιείται για την άντληση μόνο των σχετικών δεδομένων για αυτόν τον χρήστη από το Azure SQL, για τη συγκεκριμένη περίοδο λειτουργίας.

Σημαντικό

Περιορισμοί SSO που ανήκουν σε δεδομένα εφαρμογής:

• Σε σενάρια ιδιοκτησίας δεδομένων εφαρμογής (έλεγχος ταυτότητας κύριας υπηρεσίας ή κύριου χρήστη), το SSO για προελεύσεις δεδομένων DirectQuery υποστηρίζεται μόνο με Azure SQL Database.
• Κατά τη δημιουργία ενός διακριτικού ενσωμάτωσης με SSO, πρέπει να παρέχετε ένα IdentityBlob για κάθε προέλευση δεδομένων που έχει ενεργοποιημένο το SSO. Η παράλειψη του IdentityBlob προκαλεί την αποτυχία της δημιουργίας διακριτικού ή της εκτέλεσης ερωτήματος.

Ρύθμιση ταυτότητας βάσει διακριτικού

Η ταυτότητα βάσει διακριτικού λειτουργεί μόνο για μοντέλα DirectQuery σε εκχωρημένους πόρους που είναι συνδεδεμένοι σε μια βάση δεδομένων SQL Azure που έχει ρυθμιστεί ώστε να επιτρέπει τον έλεγχο ταυτότητας της Microsoft Entra. Η προέλευση δεδομένων του μοντέλου σημασιολογίας πρέπει να ρυθμιστεί ώστε να χρησιμοποιεί διαπιστευτήρια τελικού χρήστη OAuth2, προκειμένου να χρησιμοποιηθεί μια ταυτότητα βάσει διακριτικού. Μάθετε περισσότερα σχετικά με τον έλεγχο ταυτότητας Microsoft Entra για τη βάση δεδομένων SQL Azure.

Πριν ρυθμίσετε τις παραμέτρους της ταυτότητας που βασίζεται σε διακριτικά, επαληθεύστε:

• Η προέλευση δεδομένων DirectQuery είναι Azure SQL Database (η μόνη υποστηριζόμενη προέλευση δεδομένων SSO για σενάρια ιδιοκτησίας της εφαρμογής).
• Το Azure SQL Database έχει διαμορφωθεί για έλεγχο ταυτότητας Microsoft Entra.
• Έχετε το διακριτικό πρόσβασης Microsoft Entra του χρήστη για να το μεταβιβάσει ο διακομιστής Azure SQL ως IdentityBlob.

Ρύθμιση στην πύλη

1. Από την πύλη Power BI, επιλέξτε >.>

   

2. Επιλέξτε το πλαίσιο επιλογής OAuth2 .

   

Ρύθμιση με API

Αποστολή μιας κλήσης Gateways - Update Datasource API με "useEndUserOAuth2Credentials" = True και "credentialType": "OAuth2" για το επιθυμητό σημασιολογικό μοντέλο. Το σώμα αίτησης θα πρέπει να μοιάζει κάπως έτσι:

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

Δημιουργία διακριτικού ταυτότητας

Για να δημιουργήσετε ένα διακριτικό πρόσβασης για το Azure SQL, η εφαρμογή πρέπει να έχει δικαίωμα ανάθεσης της Βάσης δεδομένων SQL Azure και της Αποθήκης δεδομένων στο API βάσης δεδομένων SQL Azure στη ρύθμιση παραμέτρων καταχώρησης εφαρμογής Microsoft Entra στην πύλη Azure.

Πραγματοποιήστε έλεγχο ταυτότητας και αποκτήστε ένα διακριτικό για τον χρήστη από το τελικό σημείο Azure AD v2 για την ακόλουθη εμβέλεια: https://database.windows.net/.default

Ανατρέξτε στα παρακάτω δείγματα κώδικα MSAL για βοήθεια:

• Δείγματα κώδικα για τον έλεγχο ταυτότητας και την εξουσιοδότηση της πλατφόρμας ταυτότητας της Microsoft - Microsoft Entra | Microsoft Learn
• Πλατφόρμα ταυτότητας της Microsoft και ροή κωδικού εξουσιοδότησης OAuth 2.0

Δημιουργία διακριτικού ενσωμάτωσης

Για να ενσωματώσετε μια αναφορά με ταυτότητα βάσει διακριτικού, δημιουργήστε ένα διακριτικό ενσωμάτωσης που περιέχει την ταυτότητα βάσης διακριτικού του επιθυμητού χρήστη ISV. Δείτε τα παρακάτω παραδείγματα για τη δημιουργία διακριτικών ενσωμάτωσης για διαφορετικά σενάρια.

Σημείωμα

Μπορείτε πρέπει συμπεριλάβετε μια καταχώρηση datasourceIdentities με έγκυρη προέλευση δεδομένων identityBlob για each Azure SQL προέλευση δεδομένων που έχει ενεργοποιημένη την SSO. Εάν λείπει κάποια προέλευση δεδομένων με δυνατότητα SSO , identityBlobη κλήση δημιουργίας διακριτικού ενσωμάτωσης θα αποτύχει ή η εκτέλεση ερωτήματος θα επιστρέψει ένα σφάλμα.

Αναφορά Power BI με καθολική σύνδεση (SSO)

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

Σελιδοποιημένη αναφορά με 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 με SSO και RLS στο μοντέλο σημασιολογίας

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

Σελιδοποιημένη αναφορά που συνδέεται στο σημασιολογικό μοντέλο Power BI με RLS και προέλευση δεδομένων SSO που συνδέεται με το DirectQuery σε ένα άλλο σύνολο δεδομένων Power BI

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

Το παρακάτω παράδειγμα εμφανίζει μια ενσωματωμένη αναφορά Power BI με SSO και RLS εφαρμοσμένα στο σύνολο δεδομένων: