Verificatie in bureaublad-apps

Wanneer u voor het eerst verbinding probeert te maken met een gegevensbron met behulp van een nieuwe connector, wordt u mogelijk gevraagd om de verificatiemethode te selecteren die moet worden gebruikt bij het openen van de gegevens. Nadat u de verificatiemethode hebt geselecteerd, wordt u niet gevraagd om een verificatiemethode voor de connector te selecteren met behulp van de opgegeven verbindingsparameters. Als u de verificatiemethode later echter moet wijzigen, kunt u dit doen.

Een verificatiemethode selecteren

Diverse connectors tonen verschillende verificatiemethoden. De OData-feedconnector in Power BI Desktop en Excel geeft bijvoorbeeld het volgende dialoogvenster voor de verificatiemethode weer.

Schermopname van het verificatiedialoogvenster voor een OData-feed in Power Query Desktop.

Als u een connector gebruikt vanuit een online-app, zoals de Power BI-service of Power Apps, geeft Power Query een dialoogvenster verificatiemethode weer voor de OData-feedconnector die er ongeveer als volgt uitziet.

Schermopname van het venster Verbinding maken met gegevensbron voor de OData-connector in Power Query Online.

Zoals u kunt zien, wordt een andere selectie van verificatiemethoden weergegeven vanuit een online-app. In de online app kan het voorkomen dat sommige connectors u vragen om de naam van een lokale gegevensgateway in te voeren om verbinding te maken met uw gegevens. Ga voor meer informatie over verificatie in Power Query Online naar Connections en verificatie in Power Query Online.

Het niveau van de verificatiemethode instellen

In connectors waarvoor u een URL moet invoeren, wordt u gevraagd het niveau te selecteren waarop de verificatiemethode wordt toegepast. Als u bijvoorbeeld de webconnector selecteert met een URL van https://contoso.com/2020data/List_of_countries_and_capitals, wordt de standaardinstelling voor uw verificatiemethode https://contoso.com.

Schermopname van het verificatiedialoogvenster waarin de niveauselectie wordt weergegeven en het niveau dat is ingesteld op de standaardinstelling.

Het niveau dat u selecteert voor de verificatiemethode die u voor deze connector hebt gekozen, bepaalt welk deel van een URL de verificatiemethode heeft toegepast. Als u het webadres op het hoogste niveau selecteert, wordt de verificatiemethode die u voor deze connector selecteert, gebruikt voor dat URL-adres of een subadres binnen dat adres.

Het is echter mogelijk dat u het adres op het hoogste niveau niet wilt instellen op een specifieke verificatiemethode, omdat verschillende subadressen verschillende verificatiemethoden kunnen vereisen. Een voorbeeld hiervan kan zijn als u twee afzonderlijke mappen van één SharePoint site opent en verschillende Microsoft-accounts wilt gebruiken voor toegang tot elke site.

Nadat u de verificatiemethode voor het specifieke adres van een connector hebt ingesteld, hoeft u de verificatiemethode voor die connector niet opnieuw te selecteren met dat URL-adres of een subadres. Stel dat u het https://contoso.com/ adres selecteert als het niveau waarop u de URL-instellingen van de webconnector wilt toepassen. Wanneer u een -webconnector gebruikt om toegang te krijgen tot een webpagina die begint met dit adres, hoeft u de verificatiemethode niet opnieuw te selecteren.

De verificatiemethode wijzigen

Normaal gesproken, wanneer Power Query een set verbindingsinstellingen herkent, kijkt het in de bijbehorende referentieopslag om te zien of er een verbinding is die overeenkomt met die instellingen en selecteert, als dat het geval is, automatisch die verbinding. In sommige gevallen moet u echter mogelijk de verificatiemethode wijzigen die u in een connector gebruikt om toegang te krijgen tot een specifieke gegevensbron.

De verificatiemethode bewerken in Power BI Desktop of Excel:

  1. Ga op een van de volgende manieren te werk:

    • Selecteer in Power BI Bureaublad op het tabblad FileOptions and settings>Data source settings.

      Schermopname van het tabblad Power BI Bureaubladbestand, met opties en instellingen en gegevensbroninstellingen benadrukt.

    • Ga in Excel naar het tabblad Gegevens en selecteer Gegevens ophalen>Gegevensbroninstellingen.

      Schermopname van de Excel werkmap met de optie Instellingen voor gegevensbron benadrukt.

  2. Selecteer in het dialoogvenster Gegevensbroninstellingenalgemene machtigingen, kies de gegevensbron waar u de machtigingsinstelling wilt wijzigen en selecteer vervolgens Machtigingen bewerken.

  3. Selecteer in het dialoogvenster Machtigingen bewerken onder referentiesde optie Bewerken.

    Schermopname van het dialoogvenster Machtigingen bewerken, met locaties om de referenties en het privacyniveau te wijzigen.

  4. Wijzig de referenties in het type dat is vereist voor de gegevensbron, selecteer Opslaanen selecteer vervolgens OK.

U kunt de referenties voor een bepaalde gegevensbron in stap 3 ook verwijderen door Machtigingen wissen te selecteren voor een geselecteerde gegevensbron of door Alle machtigingen wissen te selecteren voor alle vermelde gegevensbronnen.

Verbinding maken met Microsoft Entra ID met behulp van de web- en OData-connectors

Wanneer u verbinding maakt met gegevensbronnen en services waarvoor verificatie is vereist via OAuth of Microsoft Entra ID-gebaseerde verificatie, kunt u in bepaalde gevallen waarin de service correct is geconfigureerd, de ingebouwde Web of OData-feed gebruiken om gegevens te verifiëren en er verbinding mee te maken zonder dat hiervoor een servicespecifieke of aangepaste connector is vereist.

In deze sectie worden de verbindingssymptomen beschreven wanneer de service niet juist is geconfigureerd. Het biedt ook informatie over hoe Power Query communiceert met de service wanneer deze correct is geconfigureerd.

Symptomen wanneer de service niet goed is geconfigureerd

Mogelijk treedt de fout op dat er geen verbinding kan worden gemaakt omdat dit referentietype niet wordt ondersteund voor deze resource. Kies een ander referentietype. Deze fout betekent dat uw service geen ondersteuning biedt voor het verificatietype.

Een voorbeeld waarin deze fout kan optreden, is in de OData-service Northwind.

  1. Voer het Northwind-eindpunt in de ervaring 'Gegevens ophalen' in met behulp van de OData-connector.

    Schermopname van het OData-feed dialoogvenster om gegevens op te halen met de Northwind-site als URL.

  2. Selecteer OK- om de verificatie-ervaring in te voeren. Normaal gesproken, omdat Northwind geen geverifieerde service is, zou u gewoon Anoniem gebruiken. Als u wilt aantonen dat er geen ondersteuning voor Microsoft Entra ID is, kiest u Organizational-account en selecteert u vervolgens Aantekenen.

    Schermopname van het dialoogvenster Verificatie met het tabblad Organisatieaccount geselecteerd.

  3. Er treedt een fout op, waarmee wordt aangegeven dat OAuth of Microsoft Entra ID-verificatie niet wordt ondersteund in de service.

    Schermopname van het verificatiedialoogvenster met het foutbericht dat niet kan worden verbonden.

Ondersteunde werkstroom

Een voorbeeld van een ondersteunde service die goed werkt met OAuth, is CRM, bijvoorbeeld https://contoso.crm.dynamics.com/api/data/v8.2.

  1. Voer de URL in de ervaring Gegevens ophalen in met behulp van de OData-connector.

    Schermopname van de OData-feed voor het ophalen van gegevens met het CRM-adres dat is ingevoerd in de URL.

  2. Selecteer organisatieaccounten selecteer aanmeldings- om verbinding te maken met behulp van OAuth.

    Schermopname van het verificatiedialoogvenster met het organisatieaccount geselecteerd en gereed om u aan te melden.

  3. Het verzoek slaagt en de OAuth-werkstroom blijft u in staat stellen om uzelf succesvol te authentiseren.

    Schermopname van het verificatiedialoogvenster met het organisatieaccount geselecteerd en de gebruiker is aangemeld.

Wanneer u Aantekening selecteert in stap 2 hierboven, stuurt Power Query een aanvraag naar het opgegeven URL-eindpunt met een autorisatieheader met een leeg bearer-token.

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

Vervolgens wordt verwacht dat de service reageert met een 401-antwoord met een WW-Authentication header die de Microsoft Entra ID autorisatie-URI aangeeft die moet worden gebruikt. Dit antwoord moet de tenant om mee aan te melden bevatten, of /common/ als de bron niet is gekoppeld aan een specifieke tenant.

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

Power Query kan vervolgens de OAuth-stroom met de authorization_uri initiëren. Power Query vraagt een Microsoft Entra ID resource- of doelgroepwaarde aan die gelijk is aan het domein van de URL die wordt aangevraagd. Deze waarde is de waarde die u gebruikt voor uw Azure-toepassing-ID-URL-waarde in uw API/serviceregistratie. Als u bijvoorbeeld https://api.myservice.com/path/to/data/api opent, verwacht Power Query dat de URL-waarde van de toepassings-id gelijk is aan https://api.myservice.com.

Als u meer controle nodig hebt over de OAuth-stroom (bijvoorbeeld als uw service moet reageren met een 302 in plaats van een 401), of als de URL van de toepassings-id of Microsoft Entra ID resourcewaarde niet overeenkomt met de URL van uw service, moet u een aangepaste connector gebruiken. Ga voor meer informatie over het gebruik van onze ingebouwde Microsoft Entra ID-stroom naar Microsoft Entra ID verificatie.

Microsoft Entra ID client-ID's

De volgende Microsoft Entra ID client-id's worden gebruikt door Power Query. Mogelijk moet u deze client-id's expliciet toegang geven tot uw service en API, afhankelijk van uw algemene Microsoft Entra ID-instellingen. Ga naar stap 6 van Een bereik toevoegen voor meer informatie.

Klant-ID Titel Beschrijving
a672d62c-fc7b-4e81-a576-e60dc46e951d Power Query voor Excel Openbare client, gebruikt in Power BI Desktop en de gateway.
b52893c8-bc2e-47fc-918b-77022b299bbc Power BI-gegevens vernieuwen Vertrouwelijke client, gebruikt in Power BI-service.
7ab7862c-4c57-491e-8a45-d52a7e023983 Power Apps en Power Automate Vertrouwelijke client, gebruikt in Power Apps en Power Automate.