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. A Power BI Desktop és az Excel OData-adatcsatorna-összekötője például a következő hitelesítési módszer párbeszédpanelt jeleníti meg.

A Power Query Desktop OData-hírcsatorna hitelesítési párbeszédpaneljének képernyőképe.

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

Az OData-összekötő adatforrásablakainak képernyőképe az Power Query Online.

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. Az Power Query Online-ban történő hitelesítésről további információt a Kapcsolódások és hitelesítés az Power Query Online webhelyen 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 a webes összekötőt https://contoso.com/2020data/List_of_countries_and_capitalsURL-címmel választja ki, 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 a https://contoso.com/ címet választja ki szintnek, amelyre alkalmazni szeretné a webes összekötő URL-beállításait. Ha webes ö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 Power Query felismeri a kapcsolati beállítások egy készletét, megpróbál megkeresni a megfelelő hitelesítőadat-tárban, hogy 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 Power BI Desktopban vagy Excel:

  1. Tegye az alábbiak egyikét:

    • Az Power BI Desktopban a File lapon válassza a Options and settings>Data forrásbeállítások lehetőséget.

      A Power BI Desktop Fájl lapjának képernyőképe, amelyen a Beállítások és az Adatforrás beállításai ki vannak emelve.

    • A Excel Data lapon válassza a Get data>Adatforrás beállításai lehetőséget.

      Az Excel-munkafüzet képernyőképe a Data Source Settings lehetőséggel kiemelve.

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

  3. Az Engedélyek szerkesztése párbeszédpanelen, a Hitelesítő adatokalatt válassza a Szerkesztéslehetőséget.

    Az Engedélyek szerkesztése párbeszédpanel képernyőképe, 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éslehetőséget, majd válassza OKlehetőséget.

Egy adott adatforrás hitelesítő adatait a 3. lépésben is törölheti, ha kiválasztja Kijelölt adatforrás engedélyeinek törlése, vagy a Az összes engedély törlése az összes felsorolt adatforráshoz lehetőséget választja.

Csatlakozás a Microsoft Entra ID-hez a Web és OData összekötők használatával

Ha OAuth- vagy Microsoft Entra ID-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, használhatja a beépített Web vagy OData-csatornát összekötőket az adatok hitelesítéséhez és az adatokhoz való csatlakozáshoz anélkül, hogy szolgáltatásspecifikus vagy egyéni összekötőre lenne szükség.

Ez a szakasz a kapcsolati tüneteket ismerteti, ha a szolgáltatás nincs megfelelően konfigurálva. Arról is tájékoztatást nyújt, hogy 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 OK lehetőséget 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 Organizational account, majd a Sign in 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 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 a CRM, például https://contoso.crm.dynamics.com/api/data/v8.2.

  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írcsatorna adatlekérési élményéről a CRM címének az URL-ben való megadásával.

  2. Válassza szervezeti fiók, majd válassza bejelentkezési 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.

Ha a fenti 2. lépésben a Sign-in lehetőséget választja, 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: contoso.crm.dynamics.com
Connection: Keep-Alive

A szolgáltatásnak ezután egy 401 választ kell adnia egy WWW-Authenticate fejléctel, amely a használni kívánt Microsoft Entra ID 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/aaaabbbb-0000-cccc-1111-dddd2222eeee/oauth2/authorize
Date: Wed, 15 Aug 2018 15:02:04 GMT
Content-Length: 49

A Power Query ezután kezdeményezheti az OAuth-folyamatot a authorization_uri ellen. Power Query egy Microsoft Entra ID erőforrás- vagy célközönségértéket kér, amely megegyezik a kért URL-cím tartományával. Ez az érték az api-/szolgáltatásregisztrációban használt Azure-alkalmazás AZONOSÍTÓ URL-címének értéke. Például, ha a https://api.myservice.com/path/to/data/api érhető el, a Power Query elvárja, hogy az alkalmazásazonosító URL-címének értéke https://api.myservice.com legyen.

Ha több vezérlésre van szüksége az OAuth-folyamat felett (például ha a szolgáltatásnak 302 kell válaszolnia 401 helyett), vagy ha az alkalmazás alkalmazásazonosítójának URL-címe vagy Microsoft Entra ID Erőforrás értéke nem egyezik meg 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és 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 az általános Microsoft Entra ID beállításoktól függően. További részletekért lépjen a Hatókör hozzáadása 6. lépéséhez.

Ügyfélazonosító Cím Leírás
a672d62c-fc7b-4e81-a576-e60dc46e951d Power Query az Excelhez Az 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, a Power BI szolgáltatásban használva.
7ab7862c-4c57-491e-8a45-d52a7e023983 Power Apps és Power Automate "Bizalmas ügyfél, használják a Power Apps és a Power Automate alkalmazásokban."