Configuration des clés d'API à l'aide de la console API Gateway - Amazon API Gateway

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.

Configuration des clés d'API à l'aide de la console API Gateway

Pour configurer les clés API, procédez comme suit :

  • Configurez des méthodes API pour exiger une clé API.

  • Créez ou importez une clé API pour l'API dans une région.

Avant de configurer des clés API, vous devez avoir créé une API et l'avoir déployée jusqu'à une étape. Une fois que vous avez créé une valeur de clé d'API, elle ne peut pas être modifiée.

Pour obtenir les instructions de création et de déploiement d'une API à l'aide de la console API Gateway, veuillez consulter Création d'une API REST dans Amazon API Gateway et Déploiement d'une API REST dans Amazon API Gateway, respectivement.

Après avoir créé une clé d'API, vous devez l'associer à un plan d'utilisation. Pour de plus amples informations, veuillez consulter Création, configuration et test des plans d'utilisation avec la console API Gateway.

Note

Pour connaître les bonnes pratiques à prendre en compte, consultez Bonnes pratiques concernant les clés d'API et les plans d'utilisation.

Exigence d'une clé API sur une méthode

La procédure suivante explique comment configurer une méthode d'API pour exiger une clé API.

Pour configurer une méthode d'API pour exiger une clé API
  1. Connectez-vous à la console API Gateway à l'adresse https://console.aws.amazon.com/apigateway.

  2. Choisissez une API REST.

  3. Dans le panneau de navigation principal d'API Gateway, choisissez Resources (Ressources).

  4. Sous Resources, créez une méthode ou choisissez une méthode existante.

  5. Dans l'onglet Demande de méthode, sous Paramètres de demande de méthode, choisissez Modifier.

    
                        Ajouter une clé d'API à une méthode
  6. Sélectionnez Clé API obligatoire.

  7. Choisissez Enregistrer.

  8. Déployez ou redéployez l'API pour que l'exigence prenne effet.

Si l'option Clé API obligatoire est définie sur false et que vous n'exécutez pas les étapes précédentes, aucune clé d'API associée à une étape d'API n'est utilisée pour la méthode.

Créez une clé API :

Si vous avez déjà créé ou importé des clés API à utiliser avec les plans d'utilisation, vous pouvez ignorer cette procédure et la suivante.

Pour créer une clé API
  1. Connectez-vous à la console API Gateway à l'adresse https://console.aws.amazon.com/apigateway.

  2. Choisissez une API REST.

  3. Dans le panneau de navigation principal d'API Gateway, choisissez Clés d'API.

  4. Choisissez Créer une clé d'API.

    
                      Création de clés API pour les plans d'utilisation
  5. Pour Nom, entrez un nom.

  6. (Facultatif) Sous Description, entrez une description.

  7. Pour Clé d'API, choisissez Autogénérer pour qu'API Gateway génère la valeur de la clé, ou choisissez Personnalisé pour créer votre propre valeur de clé.

  8. Choisissez Enregistrer.

Importation de clés API

La procédure suivante explique comment importer des clés API à utiliser avec les plans d'utilisation.

Pour importer des clés API
  1. Connectez-vous à la console API Gateway à l'adresse https://console.aws.amazon.com/apigateway.

  2. Choisissez une API REST.

  3. Dans le panneau de navigation principal, choisissez Clés d'API.

  4. Choisissez le menu déroulant Actions, puis choisissez Importer des clés API.

  5. Pour charger un fichier de clés séparées par des virgules, choisissez Choisissez un fichier. Vous pouvez également entrer les clés dans l'éditeur de texte. Pour plus d'informations sur le format de fichier, consultez Format de fichier de clé d'API API Gateway.

  6. Choisissez Échouer avec les avertissements pour arrêter l'importation en cas d'erreur, ou Ignorer les avertissements pour continuer à importer les entrées de clé valides en cas d'avertissement.

  7. Choisissez Importer pour importer vos clés d'API.