Condividi tramite

Libreria client Azure HardwareSecurityModules per JavaScript - versione 2.0.0

Questo pacchetto contiene un SDK isomorfico (viene eseguito sia in Node.js che nei browser) per il client Azure HardwareSecurityModules.

L'API di gestione di Azure fornisce un set RESTful di servizi Web che interagiscono con i moduli di sicurezza hardware.

Key links:

Getting started

Ambienti attualmente supportati

See our support policy for more details.

Prerequisites

Installare il pacchetto @azure/arm-hardwaresecuritymodules

Installare la libreria client Azure HardwareSecurityModules per JavaScript con npm:

npm install @azure/arm-hardwaresecuritymodules

Creare ed autenticare un AzureDedicatedHSMResourceProvider

Per creare un oggetto client per accedere all'API HardwareSecurityModules di Azure, è necessario endpoint disporre della risorsa Azure HardwareSecurityModules e di un credentialfile . Il client Azure HardwareSecurityModules può usare le credenziali di Azure Active Directory per l'autenticazione. 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

Sarà anche necessario registrare una nuova applicazione AAD e concedere l'accesso ad Azure HardwareSecurityModules assegnando il ruolo appropriato all'entità servizio (nota: ruoli come quelli che "Owner" non concederanno le autorizzazioni necessarie).

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

Usando Node.js e ambienti simili a Node, è possibile usare la classe DefaultAzureCredential per autenticare il client.

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);

Per gli ambienti del browser, usare il InteractiveBrowserCredential dal pacchetto di @azure/identity per l'autenticazione.

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

Per usare questa libreria client nel browser, è prima necessario usare un bundler. For details on how to do this, please refer to our bundling documentation.

Key concepts

AzureDedicatedHSMResourceProvider

AzureDedicatedHSMResourceProvider è l'interfaccia principale per gli sviluppatori che usano la libreria client Azure HardwareSecurityModules. Esplorare i metodi in questo oggetto client per comprendere le diverse funzionalità del servizio Azure HardwareSecurityModules a cui è possibile accedere.

Troubleshooting

Logging

L'abilitazione della registrazione può aiutare a individuare informazioni utili sugli errori. Per visualizzare un log di richieste e risposte HTTP, impostare la variabile di ambiente AZURE_LOG_LEVEL su info. In alternativa, la registrazione può essere abilitata in fase di esecuzione chiamando setLogLevel nel @azure/logger:

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

setLogLevel("info");

Per istruzioni più dettagliate su come abilitare i log, è possibile esaminare la documentazione del pacchetto @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