Partager via

Bibliothèque cliente Azure ManagedServiceIdentity pour JavaScript - version 2.2.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 ManagedServiceIdentity.

Le client d’identité de service géré.

Source code | Package (NPM) | API reference documentation | Samples

Getting started

Environnements actuellement pris en charge

See our support policy for more details.

Prerequisites

Installer le package @azure/arm-msi

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

npm install @azure/arm-msi

Créer et authentifier un ManagedServiceIdentityClient

Pour créer un objet client afin d’accéder à l’API Azure ManagedServiceIdentity, vous aurez besoin de la endpoint de votre ressource Azure ManagedServiceIdentity et d’un credential. Le client Azure ManagedServiceIdentity peut utiliser les informations d’identification Azure Active Directory pour s’authentifier. You can find the endpoint for your Azure ManagedServiceIdentity 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 ManagedServiceIdentity 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 { ManagedServiceIdentityClient } from "@azure/arm-msi";
import { DefaultAzureCredential } from "@azure/identity";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new ManagedServiceIdentityClient(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 { ManagedServiceIdentityClient } from "@azure/arm-msi";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new ManagedServiceIdentityClient(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

ManagedServiceIdentityClient

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

Troubleshooting

Logging

L’activation de la journalisation peut vous aider à mieux comprendre les échecs. Pour avoir 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 @azure/logger :

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

setLogLevel("info");

Pour obtenir des instructions plus détaillées sur l’activation des journaux, consultez les documents relatifs au package @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