Registrare un'app client (API REST di Azure Data Catalog)


Questo articolo illustra come registrare un'app client Data Catalog in Azure Active Directory (Azure AD). Per consentire all'applicazione di accedere all'API REST Data Catalog, è necessario registrare l'applicazione con Azure Active Directory. Questa azione consente di stabilire un'identità per l'applicazione e di specificare le autorizzazioni per Data Catalog risorse REST.

Importante Prima di registrare un'app Data Catalog è necessario un tenant di Azure Active Directory e un utente dell'organizzazione.

Registrare un'app client

Registrare l'app client in Azure Active Directory per stabilire un'identità per l'applicazione e specificare le autorizzazioni per Data Catalog risorse REST. Quando si registra un'app client, ad esempio un'app console, si riceve un ID applicazione (client). L'ID viene usato dall'applicazione per identificarsi.

  1. Seguire questo articolo per registrare una nuova applicazione client nell'azienda Azure Active Directory: Guida introduttiva: Registrare un'applicazione con il Microsoft Identity Platform

    1. Aprire il portale di Azure.

    2. Selezionare Azure Active Directory nel menu a sinistra.

    3. Nella sezione Gestisci selezionare Registrazioni app.

    4. Selezionare + Nuova registrazione.

    5. Immettere un nome per l'applicazione (nome dell'entità servizio), ad esempio l'account azure Data Catalog.

    6. Selezionare Account in questa directory organizzativa solo come tipo di account.

    7. Per il campo URI di reindirizzamento immettere qualsiasi URL desiderato. Il sito Web non deve esistere.

    8. Selezionare Registra.

  2. Nella registrazione della nuova app selezionare Autorizzazioni API. Selezionare + Aggiungi un'autorizzazione.

    Nel portale di Azure selezionare Richiedi autorizzazioni

  3. Nell'elenco Autorizzazioni selezionare Azure Data Catalog

  4. Per la scelta in Tipo di autorizzazioni richieste dall'applicazione, selezionare l'opzione Autorizzazioni delegate.

    Nella portale di Azure selezionare Autorizzazioni delegate

  5. Selezionare la casella di controllo per concedere l'autorizzazione user_impersonation. Selezionare quindi Aggiungi autorizzazione.

Ottenere l'ID applicazione (client)

È necessario copiare i valori ID applicazione (client) e ID directory (tenant).

Se è stata appena creata la registrazione dell'app, selezionare la pagina Panoramica della registrazione dell'app per ottenere informazioni sull'ID.

Se hai già chiuso la registrazione dell'app, ecco come trovarlo:

  1. Aprire il portale di Azure.

  2. Selezionare Azure Active Directory nell'elenco delle risorse.

  3. Sotto l'intestazione Gestisci selezionare La pagina Registrazioni app . Elenco di Tutte le applicazioni. Selezionare la scheda Applicazioni di proprietà per visualizzare solo le applicazioni create.

  4. Selezionare la riga relativa alla registrazione dell'app che si vuole usare.

  5. Selezionare l'ID applicazione (client). Usare il pulsante copia per copiare il valore e incollarlo nel Blocco note o in un'altra posizione temporanea.

  6. Selezionare l'ID directory (tenant). Usare il pulsante copia per copiare il valore e incollarlo nel Blocco note o in un'altra posizione temporanea.

    Copiare l'applicazione e l'ID tenant

Configurare l'entità servizio di Azure Data Catalog

  1. Passare a http://www.azuredatacatalog.com.

  2. Selezionare Impostazioni. Aggiungere quindi l'entità servizio all'utente del catalogo appropriato.

    In base alle esigenze aziendali, è possibile aggiungerlo all'amministratore del glossario o all'amministratore del catalogo.

    Nota

    Il formato dell'entità servizio è <clientid>@<tenantid>. Per individuare i valori da inserire per i <segnaposto>, usare il portale di Azure e aprire Azure Active Directory.

    • Il valore Clientid è elencato nella pagina Azure Active Directory Registrazioni app (legacy) nella colonna ID applicazione.
    • Il valore TenantID è elencato nella pagina Proprietà di Azure Active Directory come proprietà ID directory .
  3. Seguire il codice DELL'API REST di esempio di autenticazione dell'entità servizio per compilare la soluzione.