Fournisseur d’API : partage de votre nom de domaine personnalisé privé à l’aide d’AWS RAM
Vous pouvez autoriser les utilisateurs d’API d’autres Comptes AWS à accéder à votre nom de domaine personnalisé privé. Dans cette section, vous allez apprendre à partager votre nom de domaine personnalisé privé à l’aide d’AWS RAM et à contrôler l’accès à votre nom de domaine personnalisé privé.
Considérations relatives au partage de votre nom de domaine personnalisé privé
Les considérations suivantes peuvent impacter la façon dont vous autorisez l’accès à votre nom de domaine personnalisé privé à l’aide d’AWS RAM. Pour apprendre à partager votre nom de domaine personnalisé privé sans utiliser AWS RAM, consultez Fournisseur d’API : partage de votre nom de domaine personnalisé privé à l’aide de l’API Gateway AWS CLI.
-
Les noms de domaine personnalisés privés sont partagés au niveau de la Région AWS. Le nom de domaine personnalisé privé et le point de terminaison de VPC doivent se trouver dans la même Région AWS.
-
Vous pouvez utiliser un partage de ressources avec plusieurs principaux, et après avoir créé le partage de ressources, vous pouvez y ajouter d’autres principaux. Nous vous recommandons, dans la mesure du possible, de réutiliser votre partage de ressources.
-
Vous devez toujours autoriser le point de terminaison de VPC de l’utilisateur d’API à invoquer votre nom de domaine personnalisé privé et toutes les API privées qui y sont mappées.
-
Si l’utilisateur d’API et le fournisseur d’API font partie d’une même organisation utilisant AWS Organizations, le partage des ressources est automatiquement accepté. Vous devez tout de même créer le partage de ressources à l’aide d’AWS RAM.
-
Si l’utilisateur d’API et le fournisseur d’API font partie d’une même organisation utilisant AWS Organizations et que le partage des ressources au sein de votre organisation est activé, les ressources sont automatiquement partagées avec les principaux de l’organisation. Aucune invitation n’est nécessaire et vous pouvez ignorer le partage des ressources.
-
Si l’utilisateur d’API n’accepte pas le partage de ressources dans les 12 heures, le fournisseur d’API doit à nouveau partager la ressource.
-
Après avoir créé le partage de ressources, AWS RAM met à jour la politique
managementPolicypour le service Amazon API Gateway Management pour votre nom de domaine personnalisé privé afin d’empêcher l’accès aux principaux qui ne disposent pas d’un accèsallowexplicite. Pour plus d’informations, consultez Determining whether a request is allowed or denied within an account dans le Guide de l’utilisateur IAM.La politique
managementPolicymise à jour ressemble à ce qui suit :AWS RAM a empêché les principaux sans accès
allowexplicite de créer des associations d’accès avec votre nom de domaine personnalisé privé, en ajoutant ce qui suit :"StringNotEquals": { "aws:PrincipalAccount": "111122223333" }Vous pouvez tout de même utiliser le principal du Compte AWS ayant créé le nom de domaine personnalisé privé pour créer des associations d’accès au nom de domaine.
Autorisation d’autres comptes à créer des associations d’accès au nom de domaine avec votre nom de domaine personnalisé privé
Tout d’abord, vous devez autoriser un autre Compte AWS à créer des associations d’accès au nom de domaine avec votre nom de domaine personnalisé privé.
Une fois que vous avez fourni l’accès à un autre Compte AWS, les utilisateurs d’API de ce compte doivent créer une association d’accès au nom de domaine entre le point de terminaison de leur VPC et votre nom de domaine personnalisé privé. Vous ne pouvez pas la créer pour eux. Pour plus d’informations, consultez Association de votre point de terminaison de VPC à un nom de domaine personnalisé privé partagé.
Autorisation d’autres comptes à invoquer votre nom de domaine personnalisé privé
Ensuite, vous allez autoriser le point de terminaison de VPC de l’utilisateur d’API à invoquer votre nom de domaine personnalisé privé et toutes les API privées qui y sont mappées.