API d'authentification

Les API suivantes vous permettent de gérer les clés d'API pour Amazon Location Service. Utilisez ces opérations pour créer des clés, configurer des restrictions, faire pivoter les clés et surveiller votre inventaire de clés.

• CreateKey: crée une nouvelle clé d'API avec des restrictions spécifiées et une expiration facultative. Renvoie la valeur clé utilisée pour authentifier les demandes d'API suivantes. Pour plus d'informations, consultez CreateKeyle manuel Amazon Location Service API Reference.

• DescribeKey: récupère les détails d'une clé d'API existante, y compris ses restrictions, son expiration et la valeur de la clé. Pour plus d'informations, consultez DescribeKeyle manuel Amazon Location Service API Reference.

• UpdateKey: modifie les restrictions, l'expiration ou la description d'une clé d'API existante. Utilisez cette opération pour renforcer les autorisations, prolonger ou définir l'expiration, ou désactiver une clé. Pour plus d'informations, consultez UpdateKeyle manuel Amazon Location Service API Reference.

• DeleteKey: Supprime définitivement une clé d'API. Vous ne pouvez supprimer que les clés inactives depuis au moins 90 jours. Pour plus d'informations, consultez DeleteKeyle manuel Amazon Location Service API Reference.

• ListKeys: renvoie une liste des clés d'API de votre compte et de votre région, y compris les métadonnées telles que le nom de la clé, son statut et son expiration. Pour plus d'informations, consultez ListKeysle manuel Amazon Location Service API Reference.

Cas d’utilisation courants

Voici des cas d'utilisation courants pour les opérations de gestion des clés d'API.

• Création d'une clé pour une application cartographique : créez une clé limitée aux geo-maps:* actions sur la ressource du fournisseur de cartes par défaut, adaptée à une page Web qui affiche uniquement des cartes.

• Création d'une clé pour les cartes et les lieux : créez une clé qui permet à la fois le rendu des cartes et le géocodage en spécifiant plusieurs actions et ressources autorisées dans une seule clé.

• Faites pivoter une clé d'API : créez une nouvelle clé, mettez à jour votre application pour l'utiliser, puis désactivez l'ancienne clé en réglant son expiration à une date antérieure en utilisantUpdateKey.

• Ajouter des restrictions de domaine : mettez à jour une clé existante pour restreindre l'utilisation à des domaines Web spécifiques à l'aide de restrictions client basées sur le référent.

• Audit de l'inventaire des clés : Répertoriez toutes les clés du compte afin ListKeys d'identifier les clés non utilisées ou expirant à des fins de nettoyage.

• Révoquer une clé compromise : désactivez immédiatement une clé en mettant à jour son statut avecUpdateKey, puis supprimez-la après 90 jours d'utilisation. DeleteKey