Partilhar via

Biblioteca de cliente do Azure HardwareSecurityModules para JavaScript - versão 2.0.0

Este pacote contém um SDK isomórfico (executado em Node.js e em navegadores) para o cliente Azure HardwareSecurityModules.

A API de gerenciamento do Azure fornece um conjunto RESTful de serviços Web que interagem com os Módulos de Segurança de Hardware.

Key links:

Getting started

Ambientes atualmente suportados

See our support policy for more details.

Prerequisites

Instalar o pacote @azure/arm-hardwaresecuritymodules

Instale a biblioteca de cliente do Azure HardwareSecurityModules para JavaScript com npm:

npm install @azure/arm-hardwaresecuritymodules

Criar e autenticar um AzureDedicatedHSMResourceProvider

Para criar um objeto cliente para acessar a API HardwareSecurityModules do Azure, você precisará endpoint do recurso HardwareSecurityModules do Azure e de um credentialarquivo . O cliente Azure HardwareSecurityModules pode usar credenciais do Azure Ative Directory para autenticar. You can find the endpoint for your Azure HardwareSecurityModules resource in the Azure Portal.

You can authenticate with Azure Active Directory using a credential from the @azure/identity library or an existing AAD Token.

To use the DefaultAzureCredential provider shown below, or other credential providers provided with the Azure SDK, please install the @azure/identity package:

npm install @azure/identity

Você também precisará registrar um novo aplicativo AAD e conceder acesso ao Azure HardwareSecurityModules atribuindo a função adequada à sua entidade de serviço (observação: funções como "Owner" não concederão as permissões necessárias).

For more information about how to create an Azure AD Application check out this guide.

Usando ambientes Node.js e Node-like, você pode usar a classe DefaultAzureCredential para autenticar o cliente.

import { AzureHSMResourceProvider } from "@azure/arm-hardwaresecuritymodules";
import { DefaultAzureCredential } from "@azure/identity";

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

Para ambientes de navegador, use o InteractiveBrowserCredential do pacote @azure/identity para autenticar.

import { InteractiveBrowserCredential } from "@azure/identity";
import { AzureHSMResourceProvider } from "@azure/arm-hardwaresecuritymodules";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new AzureHSMResourceProvider(credential, subscriptionId);

JavaScript Bundle

Para usar essa biblioteca de cliente no navegador, primeiro você precisa usar um bundler. For details on how to do this, please refer to our bundling documentation.

Key concepts

AzureDedicatedHSMResourceProvider

AzureDedicatedHSMResourceProvider é a interface principal para desenvolvedores que usam a biblioteca de cliente Azure HardwareSecurityModules. Explore os métodos neste objeto de cliente para entender os diferentes recursos do serviço Azure HardwareSecurityModules que você pode acessar.

Troubleshooting

Logging

Habilitar o registro em log pode ajudar a descobrir informações úteis sobre falhas. Para ver um log de solicitações e respostas HTTP, defina a AZURE_LOG_LEVEL variável de ambiente como info. Como alternativa, o registro em log pode ser habilitado em tempo de execução chamando setLogLevel o @azure/logger:

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Para obter instruções mais detalhadas sobre como habilitar logs, você pode consultar os documentos do pacote @azure/logger.

Next steps

Please take a look at the samples directory for detailed examples on how to use this library.

Contributing

If you'd like to contribute to this library, please read the contributing guide to learn more about how to build and test the code.

  • Last updated on