Hitelesítés asztali alkalmazásokban

Amikor először próbál meg új összekötővel csatlakozni egy adatforráshoz, előfordulhat, hogy az adatok elérésekor ki kell választania a használni kívánt hitelesítési módszert. A hitelesítési módszer kiválasztása után a rendszer nem fogja kérni, hogy a megadott kapcsolati paraméterekkel válasszon hitelesítési módszert az összekötőhöz. Ha azonban később módosítania kell a hitelesítési módszert, megteheti.

Hitelesítési módszer kiválasztása

A különböző összekötők különböző hitelesítési módszereket mutatnak. Például a Power BI Desktopban és az Excelben az OData-hírcsatorna-összekötő a következő hitelesítési módszer párbeszédpanelt jeleníti meg.

Képernyőkép egy OData-hírcsatorna hitelesítési párbeszédpaneléről a Power Query Desktopban.

Ha online alkalmazásból( például a Power BI szolgáltatás vagy a Power Appsből) származó összekötőt használ, a Power Query megjeleníti az OData-hírcsatorna-összekötő hitelesítési módszerének párbeszédpanelét, amely az alábbi képhez hasonlóan néz ki.

Képernyőkép a Power Query Online OData-összekötőjének adatforrásablakainak Csatlakozás.

Mint látható, a hitelesítési módszerek különböző választéka jelenik meg egy online alkalmazásból. Az online alkalmazásban is előfordulhat, hogy egyes összekötők arra kérik, hogy adja meg a helyszíni adatátjáró nevét, hogy csatlakozni tudjon az adataihoz. A Power Query Online-ban történő hitelesítésről további információt a Power Query Online Csatlakozás ions és hitelesítés című témakörben talál.

A hitelesítési módszer szintjének beállítása

Az url-cím megadását igénylő összekötőkben a rendszer arra kéri, hogy válassza ki azt a szintet, amelyre a hitelesítési módszert alkalmazza. Ha például az URL-címmel https://contoso.com/2020data/List_of_countries_and_capitalsrendelkező webes összekötőt választja, a hitelesítési módszer alapértelmezett szintbeállítása.https://contoso.com

Képernyőkép a hitelesítési párbeszédpanelről, amelyen megjelenik a szintkijelölés és az alapértelmezett beállításra beállított szint.

Az összekötőhöz választott hitelesítési módszerhez választott szint határozza meg, hogy az URL-cím mely része alkalmazza a hitelesítési módszert. Ha a legfelső szintű webcímet választja, az összekötőhöz választott hitelesítési módszert használja a rendszer az adott URL-címhez vagy a cím bármely alcíméhez.

Előfordulhat azonban, hogy nem szeretné a legfelső szintű címet egy adott hitelesítési módszerre beállítani, mert a különböző alcímek eltérő hitelesítési módszereket igényelhetnek. Ilyen lehet például, ha egyetlen SharePoint-webhely két különálló mappáját szeretné elérni, és különböző Microsoft-fiókokat szeretne használni az egyes webhelyek eléréséhez.

Miután beállította az összekötő adott címéhez tartozó hitelesítési módszert, nem kell ismét az adott URL-címmel vagy alcímmel kiválasztania az összekötő hitelesítési módszerét. Tegyük fel például, hogy azt a https://contoso.com/ címet választja ki, amelyre a webes összekötő URL-beállításait alkalmazni szeretné. Ha webösszekötőt használ az ezzel a címmel kezdődő weblapok eléréséhez, nem kell újra kiválasztania a hitelesítési módszert.

A hitelesítési módszer módosítása

Általában amikor a Power Query felismeri a kapcsolati beállítások egy készletét, megpróbál megkeresni a megfelelő hitelesítőadat-tárolóban, hogy lássa, van-e olyan kapcsolat, amely megfelel ezeknek a beállításoknak, és ha igen, automatikusan kiválasztja ezt a kapcsolatot. Bizonyos esetekben azonban előfordulhat, hogy módosítania kell az összekötőben használt hitelesítési módszert egy adott adatforrás eléréséhez.

A hitelesítési módszer szerkesztése a Power BI Desktopban vagy az Excelben:

  1. Hajtsa végre a megfelelő műveletet:

    • A Power BI Desktop Fájl lapján válassza a Beállítások és beállítások>Adatforrás beállításai lehetőséget.

      Képernyőkép a Power BI Desktop Fájl lapjának paneljéről, amelyen a Beállítások és beállítások, valamint az Adatforrás beállításai vannak kiemelve.

    • Az Excel Adat lapján válassza az Adatforrás>lekérése Gépház lehetőséget.

      Képernyőkép az Excel-munkafüzetről az Adatforrás Gépház lehetőség kiemelésével.

  2. Az Adatforrás beállításai párbeszédpanelen válassza a Globális engedélyek lehetőséget, válassza ki azt az adatforrást, ahol módosítani szeretné az engedélybeállítást, majd válassza az Engedélyek szerkesztése lehetőséget.

  3. Az Engedélyek szerkesztése párbeszédpanel Hitelesítő adatok csoportjában válassza a Szerkesztés lehetőséget.

    Képernyőkép az Engedélyek szerkesztése párbeszédpanelről, amelyen a hitelesítő adatok és az adatvédelmi szint módosítható.

  4. Módosítsa a hitelesítő adatokat az adatforrás által megkövetelt típusra, válassza a Mentés, majd az OK gombot.

A 3. lépésben egy adott adatforrás hitelesítő adatait is törölheti a kijelölt adatforrás engedélyeinek törlése vagy az összes felsorolt adatforrás összes engedélyének törlése lehetőséget választva.

Csatlakozás a Microsoft Entra-azonosítóval a webes és OData-összekötők használatával

Amikor OAuth- vagy Microsoft Entra-alapú hitelesítést igénylő adatforrásokhoz és szolgáltatásokhoz csatlakozik, bizonyos esetekben, amikor a szolgáltatás megfelelően van konfigurálva, a beépített webes vagy OData-összekötőkkel hitelesítheti és csatlakozhat az adatokhoz szolgáltatásspecifikus vagy egyéni összekötő nélkül.

Ez a szakasz a kapcsolati tüneteket ismerteti, ha a szolgáltatás nincs megfelelően konfigurálva. Emellett arról is információt nyújt, hogy a Power Query hogyan kommunikál a szolgáltatással, ha megfelelően van konfigurálva.

A szolgáltatás nem megfelelően konfigurált állapotának tünetei

Előfordulhat, hogy olyan hibába ütközik, amely miatt nem sikerült csatlakozni, mert az erőforrás nem támogatja ezt a hitelesítőadat-típust. Válasszon másik hitelesítőadat-típust. Ez a hiba azt jelenti, hogy a szolgáltatás nem támogatja a hitelesítési típust.

Ilyen hiba például a Northwind OData szolgáltatásban fordulhat elő.

  1. Adja meg a Northwind-végpontot az "Adatok lekérése" felületen az OData-összekötő használatával.

    Képernyőkép az OData-hírcsatorna adatlekérési párbeszédpaneljéről, amelyen a Northwind-webhely szerepel URL-címként.

  2. Válassza az OK gombot a hitelesítési felület megadásához. Általában, mivel a Northwind nem hitelesített szolgáltatás, csak az Anonymoust használná. A Microsoft Entra ID támogatásának hiányának bemutatásához válassza a Szervezeti fiók lehetőséget, majd válassza a Bejelentkezés lehetőséget.

    Képernyőkép a hitelesítési párbeszédpanelről, amelyen a szervezeti fiók lap van kiválasztva.

  3. Hibaüzenet jelenik meg, amely azt jelzi, hogy az OAuth vagy a Microsoft Entra ID hitelesítés nem támogatott a szolgáltatásban.

    Képernyőkép a hitelesítési párbeszédpanelről, amelyen a nem lehet csatlakozni hibaüzenet jelenik meg.

Támogatott munkafolyamat

Az OAuth-tal megfelelően működő támogatott szolgáltatások egyik példája például https://contoso.crm.dynamics.com/api/data/v8.2a CRM.

  1. Adja meg az URL-címet az "Adatok lekérése" felületen az OData-összekötő használatával.

    Képernyőkép az OData-hírcsatornáról az URL-címben megadott CRM-címmel.

  2. Válassza a Szervezeti fiók lehetőséget, majd válassza a Bejelentkezés lehetőséget az OAuth használatával való csatlakozáshoz.

    Képernyőkép a hitelesítési párbeszédpanelről, amelyen a szervezeti fiók ki van jelölve, és készen áll a bejelentkezésre.

  3. A kérés sikeres, és az OAuth-folyamat továbbra is lehetővé teszi a sikeres hitelesítést.

    Képernyőkép a hitelesítési párbeszédpanelről, amelyen a szervezeti fiók van kiválasztva, és a felhasználó sikeresen bejelentkezett.

Amikor a fenti 2. lépésben a bejelentkezést választja, a Power Query egy kérést küld a megadott URL-végpontnak egy üres tulajdonosi jogkivonattal rendelkező engedélyezési fejléccel.

GET https://contoso.crm.dynamics.com/api/data/v8.2 HTTP/1.1
Authorization: Bearer
User-Agent: Microsoft.Data.Mashup (https://go.microsoft.com/fwlink/?LinkID=304225)
Host: pbi.crm.dynamics.com
Connection: Keep-Alive

A szolgáltatásnak ezután egy 401-ben megadott válaszsal kell válaszolnia egy WWW-Authenticate fejléccel, amely a Használni kívánt Microsoft Entra-azonosító engedélyezési URI-t jelzi. Ennek a válasznak tartalmaznia kell a bejelentkezni kívánt bérlőt, vagy /common/ , ha az erőforrás nincs hozzárendelve egy adott bérlőhöz.

HTTP/1.1 401 Unauthorized
Cache-Control: private
Content-Type: text/html
Server: 
WWW-Authenticate: Bearer authorization_uri=https://login.microsoftonline.com/3df2eaf6-33d0-4a10-8ce8-7e596000ebe7/oauth2/authorize 
Date: Wed, 15 Aug 2018 15:02:04 GMT
Content-Length: 49

A Power Query ezután elindíthatja az OAuth-folyamatot a authorization_uri. A Power Query a Kért URL-cím tartományával megegyező Microsoft Entra-azonosító erőforrást vagy célközönségértéket kér. Ez az érték a Azure-alkalmazás AZONOSÍTÓ URL-címének az API-/szolgáltatásregisztrációban használt értéke. Ha például hozzáfér https://api.myservice.com/path/to/data/api, a Power Query elvárja, hogy az alkalmazásazonosító URL-címe egyenlő legyen https://api.myservice.com.

Ha több vezérlésre van szüksége az OAuth-folyamat felett (például ha a szolgáltatásnak nem a 401megfelelővel 302 kell válaszolnia), vagy ha az alkalmazás alkalmazásazonosítójának URL-címe vagy a Microsoft Entra-azonosító erőforrás értéke nem egyezik a szolgáltatás URL-címével, akkor egyéni összekötőt kell használnia. A beépített Microsoft Entra ID-folyamat használatáról további információt a Microsoft Entra ID-hitelesítéssel kapcsolatban talál.

Microsoft Entra ID-ügyfélazonosítók

A Power Query az alábbi Microsoft Entra ID-ügyfélazonosítókat használja. Előfordulhat, hogy explicit módon engedélyeznie kell ezeknek az ügyfélazonosítóknak, hogy hozzáférjenek a szolgáltatáshoz és az API-hoz a Microsoft Entra-azonosító általános beállításaitól függően. További részletekért tekintse meg a Hatókör hozzáadása 8. lépését.

Ügyfél azonosítója Cím Leírás
a672d62c-fc7b-4e81-a576-e60dc46e951d Power Query az Excelhez A Power BI Desktopban és az átjáróban használt nyilvános ügyfél.
b52893c8-bc2e-47fc-918b-77022b299bbc Power BI-adatfrissítés Bizalmas ügyfél, Power BI szolgáltatás.
7ab7862c-4c57-491e-8a45-d52a7e023983 Power Apps és Power Automate A Power Appsben és a Power Automate-ben használt bizalmas ügyfél.