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.

Utilisation des certificats de serveur IAM

Cet exemple Node.js de code montre :

Scénario

Pour activer les connexions HTTPS à votre site Web ou à votre application AWS, vous avez besoin d'un certificat de SSL/TLS serveur. Pour utiliser un certificat obtenu auprès d'un fournisseur externe avec votre site Web ou votre application AWS, vous devez télécharger le certificat dans IAM ou l'importer dans AWS Certificate Manager.

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

Pour plus d'informations sur les certificats de serveur, consultez la section Utilisation des certificats de serveur dans le guide de l'utilisateur IAM.

Tâches prérequises

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

Liste des certificats de serveur

Créez un Node.js module avec le nom de fichieriam_listservercerts.js. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à IAM, créez un objet AWS.IAM de service. Appelez la méthode listServerCertificates 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.listServerCertificates({}, 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_listservercerts.js

Cet exemple de code se trouve ici sur GitHub.

Obtention d'un certificat de serveur

Créez un Node.js module avec le nom de fichieriam_getservercert.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 obtenir un certificat, ce qui inclut le nom du certificat de serveur que vous recherchez. Appelez la méthode getServerCertificates 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.getServerCertificate(
  { ServerCertificateName: "CERTIFICATE_NAME" },
  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_getservercert.js

Cet exemple de code se trouve ici sur GitHub.

Mise à jour d'un certificat de serveur

Créez un Node.js module avec le nom de fichieriam_updateservercert.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 un certificat, ce qui comprend le nom du certificat de serveur existant, ainsi que le nom du nouveau certificat. Appelez la méthode updateServerCertificate 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 = {
  ServerCertificateName: "CERTIFICATE_NAME",
  NewServerCertificateName: "NEW_CERTIFICATE_NAME",
};

iam.updateServerCertificate(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_updateservercert.js

Cet exemple de code se trouve ici sur GitHub.

Suppression d'un certificat de serveur

Créez un Node.js module avec le nom de fichieriam_deleteservercert.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 supprimer un certificat de serveur, ce qui inclut le nom du certificat à supprimer. Appelez la méthode deleteServerCertificates 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.deleteServerCertificate(
  { ServerCertificateName: "CERTIFICATE_NAME" },
  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_deleteservercert.js

Cet exemple de code se trouve ici sur GitHub.