Conexão com Microsoft Azure

Veja nesta página como:

Credenciais de Acesso

Para acessar as APIs do Azure usando os SDKs, você precisará das seguintes credenciais:

  • Client ID

  • Tenant ID

  • Client Secret

  • Subscription ID

Veja a documentação do Azure para mais detalhes.

Client Id, Tenant Id e Client Secret

Para obter o Client ID e Tenant ID, é necessário criar um App Registration (Service Principal) no Azure. Após criar o aplicativo, adicione um segredo (Client Secret) e as permissões necessárias.

Passos para criar o App Registration (Service Principal) no Azure e obter o Client ID e o Tenant ID:

  1. Logue no portal da Microsoft Azure.

  2. Acesse Microsoft Entra ID.

  3. Clique em App Registrations e então em + New registration.

    tela do Azure para criação de app

  4. Na tela Register an application:

    • Informe um nome para a aplicação.

    • Em Who can use this application or access this API (Quem pode usar a aplicação ou acessar a API), selecione a opção Accounts in this organizational directory only (Apenas as contas daquele diretório).

    • Clique no botão Register.
      tela do Azure para criação de app registration

  5. Anote os IDs:

    • Application (client) ID.

    • Directory (tenant) ID.

      tela do Azure para criação de app


Passos para adicionar um segredo (secret) ao App Registration:

  1. Acesse Certifications & secrets.

  2. Selecione a aba Client secrets.

  3. Clique no botão New client secret.

  4. Informe uma descrição e quando deve expirar.

  5. Clique no botão Add.

    tela do Azure

  6. Anote o Client Secret.
    Ele é exibido no campo Value

    tela do Azure

    O Client Secret só é informado no momento da criação.


Subscription ID

Passos para obter o Subscription ID:

  1. Clique em Home.

  2. Em Navigate, clique em Subscriptions.
    tela do Azure para criação de app registration

  3. Anote o valor do Subscription ID.
    tela do Azure para criação de app registration


Adicionando permissão ao Service Principal

Para poder ler as informações do Azure API Management, é necessário atribuir o papel (role) de API Management Service Reader ao Service Principal.

Consulte a documentação da Azure para mais informações.

Passos para editar o papel (role):

  1. Clique em Home.
    Em Navigate, clique em Subscriptions.

  2. Selecione Access Control (IAM).

  3. Clique em + Add e depois em Add role assignment.

    tela do Azure

  4. Na aba Members, em Assign access to, selecione User, group, or service principal.

  5. Clique em + Select members e faça uma busca pelo nome do seu App.
    Selecione o App e clique em Select.
    tela do Azure

  6. Clique em Review + assign.

Criando uma nova conexão

  1. Entre na tela Connections, clicando no menu lateral esquerdo ou no card na tela inicial.

  2. Clique no botão + CREATE CONNECTION, localizado na parte superior direita da tela.
    screenshot da tela connetions com destaque para o botão create connection

  3. Na etapa 1 - PROVIDER, digite ou selecione o provedor da conexão.
    detalhe da tela de criação de conexão com a etapa 1

  4. Clique em NEXT.

  5. Na etapa 2 - CONNECTION, forneça as seguintes informações:

    • Connection mode: Selecione o modo de conexão: se é nativa (dados atualizados diretamente com o provedor) ou não (upload manual).

      A sincronização em conexões nativas depende das credenciais estarem cadastradas no provedor.

    • Connection name: Defina um nome para a conexão.

  6. Na última etapa, revise as informações. Se estiverem corretas, clique em SAVE.

Importando APIs

Para importar APIs, siga os passos abaixo:

  1. Entre na tela Connections, clicando no menu lateral esquerdo ou no card na tela inicial.

  2. Encontre a conexão que deseja editar e clique no ícone icon view 2.
    Se precisar, utilize a barra de busca para localizar a conexão desejada.

  3. Na tela API Imports, clique no botão + IMPORT API, localizado logo abaixo de General Info e acima de API Imports.
    screenshot da tela de importação de APIs

  4. Selecione as APIs que deseja importar e clique em SAVE.

Sempre que uma API for atualizada, clique em icone de recarregar.
detalhe com o botão de recarregar APIs importadas
Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]