Partilhar via

Biblioteca de cliente Azure AuthorizationManagement para JavaScript - versão 2.1.0

  • Artigo

Este pacote contém um SDK isomórfico (executado tanto em Node.js como em browsers) para o cliente Azure AuthorizationManagement.

O controlo de acesso baseado em funções fornece-lhe uma forma de aplicar a administração de políticas de nível granular a recursos individuais ou grupos de recursos. Estas operações permitem-lhe gerir definições de funções e atribuições de funções. Uma definição de função descreve o conjunto de ações que podem ser executadas nos recursos. Uma atribuição de função concede acesso aos utilizadores do Azure Active Directory.

Código fonte | Pacote (NPM) | Documentação | de referência da APIExemplos

Introdução

Ambientes atualmente suportados

Veja a nossa política de suporte para obter mais detalhes.

Pré-requisitos

Instalar o pacote @azure/arm-authorization-profile-2020-09-01-hybrid

Instale a biblioteca de cliente Azure AuthorizationManagement para JavaScript com npm:

npm install @azure/arm-authorization-profile-2020-09-01-hybrid

Criar e autenticar um AuthorizationManagementClient

Para criar um objeto de cliente para aceder à API Azure AuthorizationManagement, precisará do endpoint recurso Azure AuthorizationManagement e de um credential. O cliente Azure AuthorizationManagement pode utilizar as credenciais do Azure Active Directory para autenticar. Pode encontrar o ponto final do recurso Azure AuthorizationManagement no Portal do Azure.

Pode autenticar com o Azure Active Directory com uma credencial da biblioteca de identidades/@azure ou de um Token do AAD existente.

Para utilizar o fornecedor DefaultAzureCredential apresentado abaixo ou outros fornecedores de credenciais fornecidos com o SDK do Azure, instale o @azure/identity pacote:

npm install @azure/identity

Também terá de registar uma nova aplicação do AAD e conceder acesso ao Azure AuthorizationManagement ao atribuir a função adequada ao seu principal de serviço (nota: funções como "Owner" não concederão as permissões necessárias). Defina os valores do ID do cliente, do ID do inquilino e do segredo do cliente da aplicação do AAD como variáveis de ambiente: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.

Para obter mais informações sobre como criar uma Aplicação Azure AD, consulte este guia.

const { AuthorizationManagementClient } = require("@azure/arm-authorization-profile-2020-09-01-hybrid");
const { DefaultAzureCredential } = require("@azure/identity");
// For client-side applications running in the browser, use InteractiveBrowserCredential instead of DefaultAzureCredential. See https://aka.ms/azsdk/js/identity/examples for more details.

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new AuthorizationManagementClient(new DefaultAzureCredential(), subscriptionId);

// For client-side applications running in the browser, use this code instead:
// const credential = new InteractiveBrowserCredential({
//   tenantId: "<YOUR_TENANT_ID>",
//   clientId: "<YOUR_CLIENT_ID>"
// });
// const client = new AuthorizationManagementClient(credential, subscriptionId);

Pacote JavaScript

Para utilizar esta biblioteca de cliente no browser, primeiro tem de utilizar um bundler. Para obter detalhes sobre como fazê-lo, consulte a nossa documentação de agrupamento.

Conceitos-chave

AuthorizationManagementClient

AuthorizationManagementClient é a interface principal para programadores que utilizam a biblioteca de cliente Azure AuthorizationManagement. Explore os métodos neste objeto de cliente para compreender as diferentes funcionalidades do serviço Azure AuthorizationManagement a que pode aceder.

Resolução de problemas

Registo

Ativar o registo pode ajudar a descobrir informações úteis sobre falhas. Para ver um registo de pedidos HTTP e respostas, defina a variável de AZURE_LOG_LEVEL ambiente como info. Em alternativa, o registo pode ser ativado no runtime ao chamar setLogLevel no @azure/logger:

const { setLogLevel } = require("@azure/logger");
setLogLevel("info");

Para obter instruções mais detalhadas sobre como ativar registos, pode ver os documentos do pacote de @azure/logger.

Passos seguintes

Veja o diretório de exemplos para obter exemplos detalhados sobre como utilizar esta biblioteca.

Contribuir

Se quiser contribuir para esta biblioteca, leia o guia de contribuição para saber mais sobre como criar e testar o código.

Impressões