Een client-app registreren (Azure Data Catalog REST API)

  • Artikel
  • 2 minuten om te lezen

In dit artikel wordt beschreven hoe u een client-app Data Catalog registreren in Azure Active Directory (Azure AD). Als u uw toepassing toegang wilt geven tot de Data Catalog REST API, moet u uw toepassing registreren bij Azure Active Directory. Met deze actie kunt u een identiteit instellen voor uw toepassing en machtigingen opgeven voor het Data Catalog REST-resources.

Belangrijk Voordat u een app Data Catalog, hebt u een Azure Active Directory-tenant en een organisatiegebruiker nodig.

Een client-app registreren

Registreer uw client-app in Azure Active Directory om een identiteit voor uw toepassing te maken en geef machtigingen op voor het Data Catalog REST-resources. Wanneer u een client-app registreert, zoals een console-app, ontvangt u de toepassings-id (client). De id wordt door de toepassing gebruikt om zichzelf te identificeren.

  1. Volg dit artikel om een nieuwe clienttoepassing te registreren in uw Azure Active Directory: Quickstart: Een toepassing registreren bij de Microsoft identity platform

    1. Open de Azure Portal.

    2. Selecteer Azure Active Directory in het menu aan de linkerkant.

    3. Selecteer in de sectie Beheren de optie App-registraties.

    4. Selecteer + Nieuwe registratie.

    5. Voer een naam in voor de toepassing (de service-principal-naam), zoals Azure Data Catalog account.

    6. Selecteer Accounts in deze organisatiemap alleen als het accounttype.

    7. Voer voor het veld Omleidings-URI elke want-URL in. De website hoeft niet te bestaan.

    8. Selecteer vervolgens Registreren.

  2. Selecteer API-machtigingen in uw nieuwe app-registratie. Selecteer + Een machtiging toevoegen.

    Selecteer in Azure Portal de optie Machtigingen aanvragen

  3. Selecteer Azure Data Catalog in de lijst Azure Data Catalog

  4. Voor de keuze onder Welk type machtigingen heeft uw toepassing nodig, selecteert u de optie Gedelegeerde machtigingen.

    Selecteer in Azure Portal de optie Gedelegeerde machtigingen

  5. Schakel het selectievakje in om machtigingen te user_impersonation. Selecteer vervolgens Machtiging toevoegen.

De toepassings-id (client)-id op halen

U moet de waarden voor Toepassings-id (client)-id en Map-id (tenant) kopiëren.

Als u zojuist de app-registratie hebt gemaakt, selecteert u de pagina Overzicht van de App-registratie om id-gegevens op te halen.

Als u de app-registratie al hebt gesloten, kunt u deze als volgende vinden:

  1. Open de Azure Portal.

  2. Selecteer Azure Active Directory in de lijst met resources.

  3. Selecteer app-registraties onder de kop Beheren. Een lijst met Alle toepassingen. Selecteer het tabblad Toepassingen in eigendom om alleen de toepassingen te zien die u hebt gemaakt.

  4. Selecteer de rij voor de app-registratie die u wilt gebruiken.

  5. Selecteer de toepassings-id (client-id). Gebruik de kopieerknop om de waarde te kopiëren en plak deze in Kladblok of een andere tijdelijke plaats.

  6. Selecteer de Map-id (tenant). Gebruik de kopieerknop om de waarde te kopiëren en plak deze in Kladblok of een andere tijdelijke plaats.

    De toepassing en tenant-id kopiëren

De service-principal Azure Data Catalog configureren

  1. Blader naar http://www.azuredatacatalog.com

  2. Selecteer Instellingen. Voeg vervolgens de service-principal toe aan de juiste catalogusgebruiker.

    Op basis van de zakelijke behoefte kunt u deze toevoegen aan de woordenlijstbeheerder of catalogusbeheerder.

    Notitie

    De indeling van de service-principal is <clientid>@<tenantid> . Als u de waarden wilt zoeken die u wilt invoegen voor de , gebruikt u de Azure Portal en opent u de Azure Active Directory.

    • De waarde Clientid wordt weergegeven op de pagina Azure Active Directory App-registraties (verouderd) in de kolom Toepassings-id.
    • De waarde TenantID wordt op de pagina Eigenschappen Azure Active Directory weergegeven als de eigenschap Directory-id.

  3. Volg het voorbeeld van service-principal-REST API code om uw oplossing te bouwen.