Présentation de l'accès aux API API Gateway

Cette page décrit les options de contrôle des accès aux API disponibles dans API Gateway.

Présentation

API Gateway utilise Identity and Access Management (IAM) pour contrôler l'accès à votre API. Vous pouvez accorder l'accès à votre API au niveau du projet et au niveau du client du service. Par exemple, vous pouvez :

• accorder l'accès aux utilisateurs de votre API afin qu'ils puissent l'activer dans leur propre projet Google Cloud.
• Autorisez les comptes principaux à afficher toutes les ressources API Gateway.
• Autoriser les entités principales à créer, mettre à jour ou supprimer des ressources API Gateway.

Rôles qui contrôlent l'accès aux services et aux ressources

Vous pouvez afficher et attribuer des rôles à l'aide du panneau des autorisations sur les pages d'informations API Gateway > API ou Passerelles de la console Google Cloud. Les rôles peuvent également être attribués à l'aide de l'API ou de la Google Cloud CLI.

Nom de rôle IAM	Titre du rôle	Description
roles/servicemanagement.serviceConsumer	Client du service	Ce rôle permet à un compte Google, à un groupe Google ou à un compte de service d'afficher et d'activer l'API dans son propre projet. Pour en savoir plus sur ce rôle, consultez la rubrique Contrôle des accès à l'API Service Management.
roles/apigateway.viewer	Lecteur API Gateway	Accès en lecture seule à une passerelle API et à ses ressources associées. Ce rôle inclut des autorisations permettant d'obtenir et de répertorier les API, les configurations d'API, les passerelles et les emplacements.
roles/apigateway.admin	Administrateur API Gateway	Accès complet à une passerelle API et à ses ressources associées. Ce rôle inclut des autorisations permettant d'obtenir, de créer, de mettre à jour et de supprimer des API, des configurations d'API, des passerelles et des emplacements.

Remarque :Bien que vous puissiez attribuer d'autres rôles au niveau du service, nous vous recommandons de gérer votre API à l'aide des rôles répertoriés dans le tableau précédent.

Autorisations et rôles API Gateway

Le tableau suivant répertorie les rôles au niveau du projet qui accordent l'accès aux ressources API Gateway et les autorisations associées :

Rôle	Autorisations
Lecteur API Gateway	apigateway.apiconfigs.get apigateway.apiconfigs.getIamPolicy apigateway.apiconfigs.list apigateway.apis.get apigateway.apis.getIamPolicy apigateway.apis.list apigateway.gateways.get apigateway.gateways.getIamPolicy apigateway.gateways.list apigateway.locations.get apigateway.locations.list apigateway.operations.get apigateway.operations.list resourcemanager.projects.get resourcemanager.projects.list
Administrateur API Gateway	Toutes les autorisations incluses dans le rôle Lecteur API Gateway, plus : apigateway.apiconfigs.create apigateway.apiconfigs.delete apigateway.apiconfigs.setIamPolicy apigateway.apiconfigs.update apigateway.apis.create apigateway.apis.delete apigateway.apis.setIamPolicy apigateway.apis.update apigateway.gateways.create apigateway.gateways.delete apigateway.gateways.setIamPolicy apigateway.gateways.update apigateway.operations.cancel apigateway.operations.delete

Remarque :Pour afficher les pages dans la console Google Cloud, vous devez attribuer aux utilisateurs le rôle Lecteur de passerelle API ou un rôle supérieur au niveau du projet.

Rôles personnalisés

Si les rôles de base ou prédéfinis ne répondent pas à vos besoins spécifiques, API Gateway est compatible avec les rôles personnalisés. Vous pouvez utiliser IAM afin de créer des rôles personnalisés pour API Gateway.