Partager via

Bibliothèque cliente Azure HardwareSecurityModules pour JavaScript - version 2.0.0

Ce package contient un Kit de développement logiciel (SDK) isomorphe (qui s’exécute à la fois dans Node.js et dans les navigateurs) pour le client Azure HardwareSecurityModules.

L’API de gestion Azure fournit un ensemble RESTful de services web qui interagissent avec les modules de sécurité matérielle.

Key links:

Getting started

Environnements actuellement pris en charge

See our support policy for more details.

Prerequisites

Installer le package @azure/arm-hardwaresecuritymodules

Installez la bibliothèque cliente Azure HardwareSecurityModules pour JavaScript avec npm:

npm install @azure/arm-hardwaresecuritymodules

Créer et authentifier un AzureDedicatedHSMResourceProvider

Pour créer un objet client permettant d’accéder à l’API Azure HardwareSecurityModules, vous aurez besoin de la endpoint de votre ressource Azure HardwareSecurityModules et d’un credential. Le client Azure HardwareSecurityModules peut utiliser les informations d’identification Azure Active Directory pour s’authentifier. 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

Vous devrez également inscrire une nouvelle application AAD et accorder l’accès à Azure HardwareSecurityModules en attribuant le rôle approprié à votre principal de service (remarque : les rôles tels que n’accorderont "Owner" pas les autorisations nécessaires).

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

À l’aide de Node.js et d’environnements de type Nœud, vous pouvez utiliser la classe DefaultAzureCredential pour authentifier le 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);

Pour les environnements de navigateur, utilisez le InteractiveBrowserCredential à partir du package @azure/identity pour l’authentification.

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

Pour utiliser cette bibliothèque cliente dans le navigateur, vous devez d’abord utiliser un bundler. For details on how to do this, please refer to our bundling documentation.

Key concepts

AzureDedicatedHSMResourceProvider

AzureDedicatedHSMResourceProvider est l’interface principale pour les développeurs qui utilisent la bibliothèque cliente Azure HardwareSecurityModules. Explorez les méthodes de cet objet client pour comprendre les différentes fonctionnalités du service Azure HardwareSecurityModules auxquelles vous pouvez accéder.

Troubleshooting

Logging

L’activation de la journalisation peut vous aider à découvrir des informations utiles sur les échecs. Pour afficher un journal des requêtes et réponses HTTP, définissez la variable d’environnement AZURE_LOG_LEVEL sur info. Vous pouvez également activer la journalisation au moment de l’exécution en appelant setLogLevel dans la @azure/logger:

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

setLogLevel("info");

Pour obtenir des instructions plus détaillées sur l’activation des journaux, vous pouvez consulter la documentationdu package @azure/enregistreur d’événements.

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