Compartilhar via


Registrar um aplicativo cliente (API REST do Azure Catálogo de Dados)


Este artigo mostra como registrar um aplicativo cliente Catálogo de Dados no Azure Active Directory (Azure AD). Para permitir que seu aplicativo acesse a API REST Catálogo de Dados, você precisa registrar seu aplicativo no Azure Active Directory. Essa ação permite que você estabeleça uma identidade para seu aplicativo e especifique permissões para Catálogo de Dados recursos REST.

Importante Antes de registrar um aplicativo Catálogo de Dados, você precisa de um locatário do Azure Active Directory e de um usuário organizacional.

Registrar um aplicativo cliente

Registre seu aplicativo cliente no Azure Active Directory para estabelecer uma identidade para seu aplicativo e especificar permissões para Catálogo de Dados recursos REST. Ao registrar um aplicativo cliente, como um aplicativo de console, você recebe uma ID do aplicativo (cliente). A ID é usada pelo aplicativo para se identificar.

  1. Siga este artigo para Registrar um novo aplicativo cliente em sua empresa Azure Active Directory: Início Rápido: Registrar um aplicativo com o plataforma de identidade da Microsoft

    1. Abra o Portal do Azure.

    2. Selecione Azure Active Directory no menu do lado esquerdo.

    3. Na seção Gerenciar, escolha Registros de aplicativo.

    4. Selecione + Novo Registro.

    5. Insira um nome para o aplicativo (o nome da entidade de serviço), como a conta de Catálogo de Dados do Azure.

    6. Selecione Contas neste diretório organizacional apenas como o tipo de conta.

    7. Para o campo URI de redirecionamento , insira qualquer URL desejada. O site não precisa existir.

    8. Em seguida, selecione Registrar.

  2. Em seu novo registro de aplicativo, selecione Permissões de API. Selecione Adicionar uma permissão.

    No portal do Azure, selecione Solicitar permissões

  3. Na lista de Permissões, selecione Azure Catálogo de Dados

  4. Para a escolha em Que tipo de permissões seu aplicativo requer, selecione a opção Permissões delegadas.

    No portal do Azure, selecione Permissões delegadas

  5. Marque a caixa de seleção para conceder permissão user_impersonation. Em seguida, selecione Adicionar permissão.

Obter a ID do aplicativo (cliente)

Você precisa copiar a ID do aplicativo (cliente) e os valores de ID do diretório (locatário ).

Se você acabou de criar o registro do aplicativo, selecione a página Visão geral do registro do aplicativo para obter informações de ID.

Se você já fechou o registro do aplicativo, veja como encontrá-lo:

  1. Abra o Portal do Azure.

  2. Selecione Azure Active Directory na lista de recursos.

  3. No título Gerenciar , selecione a página Registros de Aplicativo . Uma lista de Todos os aplicativos. Selecione a guia Aplicativos de propriedade para ver apenas os aplicativos que você criou.

  4. Selecione a linha para o registro de aplicativo que você deseja usar.

  5. Selecione a ID do aplicativo (cliente). Use o botão copiar para copiar o valor e colar no bloco de notas ou em outro local temporário.

  6. Selecione a ID do Diretório (locatário). Use o botão copiar para copiar o valor e colar no bloco de notas ou em outro local temporário.

    Copiar a ID do aplicativo e do locatário

Configurar a entidade de serviço do Azure Catálogo de Dados

  1. Navegue para http://www.azuredatacatalog.com

  2. Selecione Configurações. Em seguida, adicione a entidade de serviço ao Usuário de Catálogo apropriado.

    Com base na necessidade de negócios, você pode adicioná-lo ao administrador do glossário ou ao administrador do catálogo.

    Observação

    O formato da entidade de serviço é <clientid>@<tenantid>. Para localizar os valores a serem inseridos para os <espaços reservados>, use o portal do Azure e abra o Azure Active Directory.

    • O valor Clientid está listado na página Registros de aplicativo do Azure Active Directory (Herdado) na coluna ID do Aplicativo.
    • O valor TenantID está listado na página Propriedades do Azure Active Directory como a propriedade ID do Diretório .
  3. Siga o código da API REST de exemplo de Autenticação da Entidade de Serviço para criar sua solução.