Cette page vous explique comment contrôler les autorisations et l'accès à l'API Discovery Engine pour les ressources Agent Search à l'aide d'Identity and Access Management (IAM).
Présentation
Google Cloud propose IAM, qui vous permet d'attribuer un accès précis à des ressources Google Cloud spécifiques et empêche tout accès non souhaité à d'autres ressources. Cette page décrit les autorisations et les rôles IAM associés à la recherche par agent. Pour obtenir une description détaillée d' Google Cloud IAM, consultez la documentation IAM.
Agent Search fournit un ensemble de rôles prédéfinis conçus pour vous aider à contrôler l'accès à vos ressources Agent Search. Si ces rôles ne vous attribuent pas les autorisations dont vous avez besoin, vous pouvez également créer des rôles personnalisés. En outre, les anciens rôles de base (éditeur, lecteur et propriétaire) restent disponibles, même s'ils ne permettent pas un contrôle aussi précis que les rôles Agent Search. Vous pouvez les utiliser spécifiquement pour accéder à l'ensemble des ressources Google Cloud , et pas uniquement à Agent Search. Pour en savoir plus, consultez la documentation sur les rôles de base.
Rôles prédéfinis
Agent Search fournit des rôles prédéfinis que vous pouvez utiliser pour attribuer des autorisations plus précises aux comptes principaux. Le rôle que vous attribuez à une entité principale définit les actions qu'elle peut entreprendre. Les entités principales peuvent être des individus, des groupes ou des comptes de service.
Vous pouvez attribuer plusieurs rôles à une même entité principale et les modifier à tout moment (à condition de disposer des autorisations nécessaires).
Les rôles généraux incluent les rôles plus précis. Par exemple, le rôle d'éditeur Discovery Engine inclut toutes les autorisations du rôle de lecteur Discovery Engine, ainsi que ses propres autorisations supplémentaires. De même, le rôle d'administrateur Discovery Engine inclut toutes les autorisations du rôle d'éditeur Discovery Engine, ainsi que ses propres autorisations supplémentaires.
Les rôles de base (propriétaire, éditeur, lecteur) fournissent des autorisations pour l'ensemble des services Google Cloud. Les rôles propres à Agent Search n'incluent que les autorisations Agent Search, à l'exception des autorisations Google Cloud suivantes, nécessaires pour l'utilisation générale Google Cloud :
resourcemanager.projects.getresourcemanager.projects.listserviceusage.services.listserviceusage.services.get
Le tableau suivant répertorie les rôles IAM pour la recherche par agent, ainsi que la liste de toutes les autorisations incluses dans chaque rôle.
| Rôle | Autorisations |
|---|---|
Administrateur Discovery Engine( Accorde un accès complet à toutes les ressources Discovery Engine. |
|
Éditeur Discovery Engine( Accorde un accès en lecture et en écriture à toutes les ressources Discovery Engine. |
|
Utilisateur Discovery Engine( Accorde un accès utilisateur aux ressources Discovery Engine. |
|
Lecteur Discovery Engine( Accorde un accès en lecture à toutes les ressources Discovery Engine. |
|
Gérer l'IAM de la recherche d'agent
Vous pouvez obtenir et définir des stratégies d'autorisation et des rôles IAM à l'aide de la console Google Cloud. Pour en savoir plus, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.
Étapes suivantes
- Découvrez comment gérer l'accès aux projets, aux dossiers et aux organisations.
- Apprenez-en plus sur IAM.
- Apprenez-en plus sur les rôles de base.
- Découvrez les rôles personnalisés.