La AWS SDK pour JavaScript v2 a atteint la fin du support. Nous vous recommandons de migrer vers la AWS SDK pour JavaScript version 3. Pour plus de détails et d'informations sur la manière de migrer, veuillez consulter cette annonce.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Gestion des clés d’accès IAM

Cet exemple Node.js de code montre :

Scénario

Les utilisateurs ont besoin de leurs propres clés d'accès pour effectuer des appels programmatiques AWS depuis le SDK pour. JavaScript Pour ce faire, vous pouvez créer, modifier, afficher ou faire tourner les clés d'accès (ID de clé d'accès et clés d'accès secrètes) pour les utilisateurs IAM. Par défaut, lorsque vous créez une clé d'accès, son statut est Active, ce qui signifie que l'utilisateur peut l'utiliser pour les appels d'API.

Dans cet exemple, une série de Node.js modules sont utilisés pour gérer les clés d'accès dans IAM. Les Node.js modules utilisent le SDK pour gérer les clés JavaScript d'accès IAM à l'aide des méthodes suivantes de la classe AWS.IAM client :

Pour plus d'informations sur les clés d'accès IAM, consultez la section Clés d'accès dans le guide de l'utilisateur IAM.

Tâches prérequises

Pour configurer et exécuter cet exemple, vous devez d'abord :

Création de clés d'accès pour un utilisateur

Créez un Node.js module avec le nom de fichieriam_createaccesskeys.js. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à IAM, créez un objet AWS.IAM de service. Créez un objet JSON contenant les paramètres nécessaires à la création de nouvelles clés d'accès, y compris le nom d'utilisateur IAM. Appelez la méthode createAccessKey de l'objet de service AWS.IAM.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create the IAM service object
var iam = new AWS.IAM({ apiVersion: "2010-05-08" });

iam.createAccessKey({ UserName: "IAM_USER_NAME" }, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data.AccessKey);
  }
});

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Veillez à diriger les données renvoyées vers un fichier texte afin de ne pas perdre la clé secrète, qui peut être fournie une seule fois.

node iam_createaccesskeys.js > newuserkeys.txt

Cet exemple de code se trouve ici sur GitHub.

Liste des clés d'accès d'un utilisateur

Créez un Node.js module avec le nom de fichieriam_listaccesskeys.js. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à IAM, créez un objet AWS.IAM de service. Créez un objet JSON contenant les paramètres nécessaires pour récupérer les clés d'accès de l'utilisateur, y compris le nom de l'utilisateur IAM et éventuellement le nombre maximum de paires de clés d'accès que vous souhaitez répertorier. Appelez la méthode listAccessKeys de l'objet de service AWS.IAM.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create the IAM service object
var iam = new AWS.IAM({ apiVersion: "2010-05-08" });

var params = {
  MaxItems: 5,
  UserName: "IAM_USER_NAME",
};

iam.listAccessKeys(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data);
  }
});

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande.

node iam_listaccesskeys.js

Cet exemple de code se trouve ici sur GitHub.

Obtention de la date à laquelle une clé d'accès a été utilisée pour la dernière fois

Créez un Node.js module avec le nom de fichieriam_accesskeylastused.js. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à IAM, créez un objet AWS.IAM de service. Créez un objet JSON contenant les paramètres requis pour créer des clés d'accès, qui est l'ID de clé d'accès pour lequel vous souhaitez récupérer les informations sur la dernière utilisation. Appelez la méthode getAccessKeyLastUsed de l'objet de service AWS.IAM.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create the IAM service object
var iam = new AWS.IAM({ apiVersion: "2010-05-08" });

iam.getAccessKeyLastUsed(
  { AccessKeyId: "ACCESS_KEY_ID" },
  function (err, data) {
    if (err) {
      console.log("Error", err);
    } else {
      console.log("Success", data.AccessKeyLastUsed);
    }
  }
);

            

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande.

node iam_accesskeylastused.js

Cet exemple de code se trouve ici sur GitHub.

Mise à jour du statut des clés d'accès

Créez un Node.js module avec le nom de fichieriam_updateaccesskey.js. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à IAM, créez un objet AWS.IAM de service. Créez un objet JSON contenant les paramètres requis pour mettre à jour le statut des clés d'accès, ce qui inclut l'ID de clé d'accès et le statut mis à jour. Le statut peut être Active ou Inactive. Appelez la méthode updateAccessKey de l'objet de service AWS.IAM.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create the IAM service object
var iam = new AWS.IAM({ apiVersion: "2010-05-08" });

var params = {
  AccessKeyId: "ACCESS_KEY_ID",
  Status: "Active",
  UserName: "USER_NAME",
};

iam.updateAccessKey(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data);
  }
});

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande.

node iam_updateaccesskey.js

Cet exemple de code se trouve ici sur GitHub.

Suppression des clés d'accès

Créez un Node.js module avec le nom de fichieriam_deleteaccesskey.js. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à IAM, créez un objet AWS.IAM de service. Créez un objet JSON contenant les paramètres requis pour supprimer des clés d'accès, ce qui inclut l'ID des clés d'accès et le nom de l'utilisateur. Appelez la méthode deleteAccessKey de l'objet de service AWS.IAM.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create the IAM service object
var iam = new AWS.IAM({ apiVersion: "2010-05-08" });

var params = {
  AccessKeyId: "ACCESS_KEY_ID",
  UserName: "USER_NAME",
};

iam.deleteAccessKey(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data);
  }
});

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande.

node iam_deleteaccesskey.js

Cet exemple de code se trouve ici sur GitHub.