Azure-hitelesítés a Data API Builderben

A Data API Builder lehetővé teszi a fejlesztők számára, hogy meghatározzák azt a hitelesítési mechanizmust (identitásszolgáltatót), amelyet a Data API Builder használni szeretne a kérések hitelesítéséhez.

A hitelesítés egy támogatott identitásszolgáltatóhoz van delegálva, ahol a hozzáférési jogkivonat kibocsátható. A Data API Builder felé irányuló bejövő kérésekhez egy beszerzett hozzáférési jogkivonatot kell tartalmaznia. A Data API Builder ezután ellenőrzi a bemutatott hozzáférési jogkivonatokat, biztosítva, hogy a Data API Builder legyen a jogkivonat célközönsége.

A támogatott identitásszolgáltató konfigurációs beállításai a következők:

• StaticWebApps
• JSON Webes Jogkivonatok (JWT)

Fejlesztés alatt (AZ Login)

Az Authentication='Active Directory Default' használata az Azure SQL Database kapcsolati láncokban azt jelenti, hogy az ügyfél a Microsoft Entra hitelesítő adataival fog hitelesíteni. A pontos hitelesítési módszert a környezet határozza meg. Amikor egy fejlesztő az loginfuttat, az Azure CLI megnyitja a böngészőablakot, amely arra kéri a felhasználót, hogy jelentkezzen be Microsoft-fiókkal vagy vállalati hitelesítő adatokkal. Hitelesítés után az Azure CLI előhívja és gyorsítótárazza a Microsoft Entra identitáshoz kapcsolódó tokent. Ez a jogkivonat ezután az Azure-szolgáltatásokhoz érkező kérések hitelesítésére szolgál anélkül, hogy hitelesítő adatokat kellene megadnia a kapcsolati sztringben.

"data-source": {
    "connection-string": "...;Authentication='Active Directory Default';"
}

A helyi hitelesítő adatok beállításához egyszerűen használja a az login-at, miután telepítette az Azure CLI-t.

az login

Azure Static Web Apps-hitelesítés (EasyAuth)

A Data API builder elvárja, hogy az Azure Static Web Apps hitelesítés (EasyAuth) hitelesítse a kérést, és az azonosított felhasználóra vonatkozó metaadatokat az X-MS-CLIENT-PRINCIPAL HTTP-fejlécben szolgáltassa az StaticWebApps opció használata esetén. A Static Web Apps által biztosított hitelesített felhasználói metaadatokra a következő dokumentáció hivatkozhat: Felhasználói adatok elérése.

A StaticWebApps szolgáltató használatához meg kell adnia a következő konfigurációt a konfigurációs fájl runtime.host szakaszában:

"authentication": {
    "provider": "StaticWebApps"
}

A StaticWebApps-szolgáltató használata akkor hasznos, ha a Data API Buildert az Azure-ban tervezi futtatni, az App Service-ben üzemelteti és egy tárolóban futtatja: Egyéni tároló futtatása az Azure App Service-.

JWT

A JWT-szolgáltató használatához konfigurálnia kell a runtime.host.authentication szakaszt a kapott JWT-jogkivonat ellenőrzéséhez szükséges információk megadásával:

"authentication": {
    "provider": "AzureAD",
    "jwt": {
        "audience": "<APP_ID>",
        "issuer": "https://login.microsoftonline.com/<AZURE_AD_TENANT_ID>/v2.0"
    }
}

Szerepkörök kiválasztása

Amint egy kérést bármelyik elérhető lehetőségen keresztül hitelesítenek, a tokenben meghatározott szerepeket használják annak meghatározására, hogyan értékelik az engedélyezési szabályokat a kérelem engedélyezéséhez. A hitelesített kérések automatikusan hozzá lesznek rendelve a authenticated rendszerszerepkörhöz, kivéve, ha felhasználói szerepkört kérnek használathoz. További információért lásd a engedélyezést.

Névtelen kérések

A kérések hitelesítés nélkül is megadhatók. Ilyen esetekben a rendszer automatikusan hozzárendeli a kérést a anonymous rendszerszerepkörhöz, hogy megfelelően jóváhagyják.

X-MS-API-ROLE kérelem fejléce

A Data API Builder megköveteli, hogy a fejléc X-MS-API-ROLE egyéni szerepkörökkel engedélyezze a kéréseket. A X-MS-API-ROLE értékének meg kell egyeznie a tokenben megadott szerepkörrel. Ha például a jogkivonat a Sample.Roleszerepkört tartalmazza, akkor az X-MS-API-ROLE is a Sample.Roleszerepkör kell, hogy legyen. További információ: engedélyezési felhasználói szerepkörök.

Kapcsolódó tartalom

• helyi hitelesítés
• Engedélyezés