Présentation des recommandations de rôle

Les recommandations de rôle vous aident à identifier et supprimer les autorisations en excès de vos comptes principaux, améliorant ainsi les configurations de sécurité de vos ressources.

Présentation des recommandations de rôle

Les recommandations de rôle sont générées par l'outil de recommandation IAM. L'outil de recommandation IAM est l'un des outils de recommandation proposés par Recommender.

Chaque recommandation de rôle vous suggère de supprimer ou de remplacer un rôle accordant des autorisations en excès à vos comptes principaux. À grande échelle, ces recommandations vous aident à appliquer le principe du moindre privilège en vous assurant que les comptes principaux disposent uniquement des autorisations dont ils ont réellement besoin.

L'outil de recommandation IAM identifie les autorisations en excès à l'aide d'insights sur les stratégies. Les insights sur les stratégies sont des informations exploitables, basées sur le ML, qui concernent l'utilisation des autorisations d'un compte principal.

Certaines recommandations sont également associées à des insights sur les mouvements latéraux. Ces insights identifient les rôles permettant aux comptes de service d'un projet d'emprunter l'identité des comptes de service d'un autre projet. Pour en savoir plus, consultez la section Comment les insights sur les mouvements latéraux sont-ils générés ?.

Comment les insights sur les stratégies sont-ils générés ?

Les insights sur les stratégies mettent en évidence les autorisations des rôles d'un compte principal qu'il n'utilise pas.

L'outil de recommandation IAM génère des insights sur les stratégies en comparant le nombre total d'autorisations d'un compte principal avec les autorisations qu'il a utilisées au cours des 90 derniers jours. Si le rôle a été attribué il y a moins de 90 jours, l'outil de recommandation IAM examine l'utilisation des autorisations par le principal depuis qu'il a reçu le rôle.

Un compte principal peut utiliser une autorisation de différentes manières:

• Directement, en appelant une API nécessitant l'autorisation

  Par exemple, la méthode roles.list de l'API REST IAM nécessite l'autorisation iam.roles.list. Lorsque vous appelez la méthode roles.list, vous utilisez l'autorisation iam.roles.list.

  De même, lorsque vous appelez la méthode testIamPermissions pour une ressource, vous utilisez effectivement toutes les autorisations que vous testez.

• Indirectement, en utilisant Google Cloud Console pour travailler avec les ressources Google Cloud

  Par exemple, dans la console Google Cloud, vous pouvez modifier une instance de machine virtuelle (VM) Compute Engine, qui nécessite des autorisations différentes selon les paramètres que vous modifiez. Toutefois, la console Google Cloud affiche également les paramètres existants, ce qui nécessite l'autorisation compute.instances.get.

  Par conséquent, lorsque vous modifiez une instance de VM dans la console Google Cloud, vous utilisez l'autorisation compute.instances.get.

Pour déterminer les autorisations utilisées par le principal, l'outil de recommandation IAM utilise des données d'accès IAM agrégées. Pour savoir comment exporter les données utilisées par l'outil de recommandation IAM pour ces insights, consultez Exporter des données pour les recommandations de rôle.

L'outil de recommandation IAM utilise également le machine learning pour identifier les autorisations du rôle actuel d'un compte principal dont ce compte principal est susceptible d'avoir besoin à l'avenir, même s'il n'a pas utilisé ces autorisations récemment. Pour en savoir plus, consultez la section Machine learning pour les insights sur les stratégies sur cette page.

Les insights sur les stratégies ne sont pas générés pour tous les rôles IAM accordés aux membres. Pour en savoir plus sur la raison pour laquelle un rôle peut ne pas avoir d'insight sur les stratégies, consultez la section Disponibilité sur cette page.

Pour savoir comment gérer les insights sur les stratégies, consultez Gérer les insights sur les stratégies pour les projets, les dossiers et les organisations ou Gérer les insights sur les stratégies pour les buckets Cloud Storage.

Machine learning pour les insights sur les stratégies

Dans certains cas, un compte principal aura probablement besoin de certaines autorisations incluses dans ses rôles actuels mais qui n'ont pas été utilisées récemment. Pour identifier ces autorisations, l'outil de recommandation IAM utilise un modèle de machine learning (ML) lors de la génération des insights sur les stratégies.

Ce modèle de machine learning est entraîné à l'aide de plusieurs ensembles de signaux :

• Schémas de co-occurrence courants dans l'historique en cours d'observation : le fait qu'un utilisateur ait utilisé les autorisations A, B et C par le passé suggère que celles-ci sont liées d'une manière ou d'une autre et qu'elles sont toutes nécessaires pour mener à bien une tâche sur Google Cloud. Si le modèle de ML constate ce schéma suffisamment fréquemment, la prochaine fois qu'un autre utilisateur utilisera les autorisations A et B, le modèle suggérera qu'il pourrait également avoir besoin de l'autorisation C.

• Connaissance du domaine, telle qu'elle est encodée dans les définitions de rôle : Cloud IAM fournit des centaines de rôles prédéfinis différents, spécifiques à un service. Si un rôle prédéfini contient un ensemble d'autorisations, cela signifie très probablement que ces autorisations doivent être accordées ensemble.

En plus de ces signaux, le modèle utilise également l'embedding lexical pour calculer dans quelle mesure les autorisations sont sémantiquement similaires. Les autorisations sémantiquement similaires se "rapprochent" après le plongement et sont plus susceptibles d'être accordées ensemble. Par exemple, bigquery.datasets.get et bigquery.tables.list seront très proches l'une de l'autre après le plongement.

Toutes les données utilisées dans le pipeline de machine learning de l'outil de recommandation IAM disposent du k-anonymat, ce qui signifie que l'identité des personnes de l'ensemble de données anonymisé ne peut pas être restaurée. Pour atteindre ce niveau d'anonymat, nous supprimons toutes les informations personnelles, telles que l'ID utilisateur associé à chaque modèle d'utilisation des autorisations. Nous supprimons ensuite tous les modèles d'utilisation qui ne s'affichent pas assez souvent dans Google Cloud. Le modèle global est entraîné à l'aide de ces données anonymisées.

Le modèle global peut être personnalisé davantage pour chaque organisation à l'aide de l'apprentissage fédéré, un processus de machine learning qui entraîne des modèles de machine learning sans exporter de données.

Comment les recommandations de rôle sont-elles générées ?

Si un insight sur une stratégie indique qu'un compte principal n'a pas besoin de toutes les autorisations de son rôle, l'outil de recommandation IAM évalue le rôle pour déterminer s'il peut être révoqué ou s'il existe un autre rôle plus adapté. Si le rôle peut être révoqué, l'outil de recommandation IAM génère une recommandation de rôle pour révoquer le rôle. Si un autre rôle est plus adapté, l'outil de recommandation IAM génère une recommandation de rôle pour remplacer le rôle par un rôle suggéré. Ce rôle suggéré peut être un nouveau rôle personnalisé, un rôle personnalisé existant, ou un ou plusieurs rôles prédéfinis. Sauf dans le cas des recommandations pour les agents de service, une recommandation de rôle ne suggère jamais de modification qui augmente le niveau d'accès d'un compte principal.

Les recommandations de rôle sont générées uniquement sur la base des contrôles d'accès IAM. Elles ne tiennent pas compte d'autres types de contrôles d'accès, tels que les listes de contrôle d'accès (LCA) et le contrôle des accès basé sur les rôles (RBAC) Kubernetes. Si vous utilisez d'autres types de contrôles d'accès, soyez particulièrement vigilant lorsque vous examinez les recommandations et prenez en compte le rapport entre ces contrôles d'accès et vos stratégies d'autorisation.

De plus, les recommandations de rôle ne sont pas générées pour tous les rôles IAM attribués aux principaux. Pour en savoir plus sur la raison pour laquelle un rôle peut ne pas avoir de recommandation de rôle, consultez la section Disponibilité sur cette page.

Période d'observation

La période d'observation d'une recommandation de rôle correspond au nombre de jours de données d'utilisation des autorisations sur lesquelles la recommandation est basée.

La période d'observation maximale pour les recommandations de rôle est de 90 jours. Cela signifie que l'outil de recommandation IAM utilise au maximum les données d'utilisation des autorisations des 90 derniers jours pour générer des recommandations de rôles.

L'outil de recommandation IAM ne commence également à générer des recommandations de rôle qu'après avoir collecté un certain nombre de jours de données d'utilisation des autorisations. Cette durée est appelée période d'observation minimale. Par défaut, la période d'observation minimale est de 90 jours, mais pour les recommandations de rôles au niveau du projet, vous pouvez la définir manuellement sur 30 jours ou 60 jours. Pour en savoir plus, consultez la section Configurer la génération de recommandations de rôles. Si vous définissez la période d'observation minimale sur moins de 90 jours, vous recevrez des recommandations plus rapidement, mais leur exactitude peut être affectée.

Si cela fait plus de 90 jours que le rôle a été attribué, mais moins de 90 jours que la période d'observation minimale est terminée, la période d'observation correspond à la durée écoulée depuis l'attribution du rôle.

Nouveaux rôles personnalisés dans les recommandations de rôle

Lorsque l'outil de recommandation IAM suggère des remplacements pour un rôle, il suggère toujours un rôle personnalisé existant, ou un ou plusieurs rôles prédéfinis, qui semblent mieux correspondre aux besoins du compte principal.

Si l'outil de recommandation IAM identifie un modèle d'utilisation d'autorisation commun dans votre organisation qui ne correspond pas à un rôle prédéfini ou personnalisé existant, il peut également être recommandé de créer un rôle personnalisé rôle. Ce rôle personnalisé n'inclut que les autorisations recommandées. Vous pouvez modifier la recommandation de rôle personnalisé en ajoutant ou en supprimant des autorisations.

Si vous souhaitez appliquer le principe du moindre privilège aussi strictement que possible, choisissez le nouveau rôle personnalisé. L'outil de recommandation IAM crée le rôle personnalisé au niveau du projet. Vous êtes responsable de la gestion et de la mise à jour des rôles personnalisés pour vos projets.

Si vous préférez utiliser un rôle géré pour vous, choisissez le rôle prédéfini. Google Cloud met régulièrement à jour ces rôles en ajoutant ou en supprimant des autorisations. Pour être informé de ces mises à jour, abonnez-vous au flux d'actualités du journal des modifications des autorisations. Lorsque vous choisissez le rôle prédéfini, le compte principal conserve au moins quelques autorisations qu'il n'a pas utilisées, et potentiellement un grand nombre de celles-ci.

L'outil de recommandation IAM ne recommande de nouveaux rôles personnalisés que pour les rôles accordés à un projet. Il ne recommande pas de nouveaux rôles personnalisés pour les rôles accordés à d'autres ressources, comme des dossiers ou des organisations.

En outre, l'outil de recommandation IAM ne recommande pas de nouveaux rôles personnalisés dans les cas suivants:

• Votre organisation dispose déjà d'au moins 100 rôles personnalisés.
• Votre projet dispose déjà d'au moins 25 rôles personnalisés.

L'outil de recommandation IAM ne recommande pas plus de cinq nouveaux rôles personnalisés par jour dans chaque projet et pas plus de 15 nouveaux rôles personnalisés dans toute l'organisation.

Comment les insights sur les mouvements latéraux sont-ils générés ?

Le mouvement latéral se produit lorsqu'un compte de service d'un projet est autorisé à usurper l'identité d'un compte de service d'un autre projet. Par exemple, un compte de service peut avoir été créé dans le projet A, mais dispose des autorisations nécessaires pour emprunter l'identité d'un compte de service dans le projet B.

Ces autorisations peuvent entraîner une chaîne d'usurpations d'identités sur plusieurs projets, ce qui permet aux comptes principaux d'accéder de manière inattendue aux ressources. Par exemple, si un compte principal usurpe l'identité du compte de service du projet A, il peut s'en servir pour usurper l'identité du compte de service du projet B. Si le compte de service du projet B est autorisé à usurper l'identité d'autres comptes de service d'autres projets de votre organisation, le compte principal peut continuer à usurper l'identité du compte de service pour passer d'un projet à l'autre, et ainsi obtenir au fur et à mesure les autorisations nécessaires.

L'outil de recommandation IAM génère des insights sur les mouvements latéraux en identifiant les rôles qui répondent aux critères suivants:

• Le principal auquel le rôle a été attribué est un compte de service qui n'a pas été créé dans le projet.

• Le rôle inclut l'une des autorisations suivantes, qui permettent à un compte principal d'emprunter l'identité d'un compte de service :

  • iam.serviceAccounts.actAs
  • iam.serviceAccounts.getAccessToken
  • iam.serviceAccounts.getOpenIdToken
  • iam.serviceAccounts.implicitDelegation
  • iam.serviceAccounts.signBlob
  • iam.serviceAccounts.signJwt

Si un rôle répond à ces critères, l'outil de recommandation IAM génère un insight de mouvement ultérieur pour le rôle. Cet insight contient des informations sur les capacités d'emprunt d'identité du compte de service, y compris sur les comptes de service qu'il peut emprunter et si des autorisations d'emprunt d'identité ont été utilisées au cours des 90 derniers jours.

L'outil de recommandation IAM n'utilise pas lui-même les insights sur les mouvements latéraux pour générer de nouvelles recommandations de rôle. En effet, si un compte de service utilise ses autorisations d'emprunt d'identité, l'outil de recommandation IAM ne peut pas suggérer de les supprimer en toute sécurité. Toutefois, si une recommandation de rôle suggère de supprimer ces autorisations parce qu'elles ne sont pas utilisées, l'outil de recommandation IAM associera l'insight de déplacement latéral à cette recommandation. Cette association vous permet de hiérarchiser les recommandations de rôles pour les comptes de service disposant d'autorisations d'emprunt d'identité puissantes et inutilisées pour l'ensemble des projets.

Pour savoir comment gérer les insights sur les mouvements latéraux, consultez la page Gérer les insights sur les mouvements latéraux.

Disponibilité

Les insights sur les stratégies, les insights sur les mouvements latéraux et les recommandations de rôles ne sont pas générés pour tous les rôles accordés aux comptes principaux. Lisez les sections suivantes pour comprendre les rôles pour lesquels des insights, des recommandations et des insights sur les mouvements latéraux sont générés.

Disponibilité des insights sur les stratégies

Pour que l'outil de recommandation IAM génère un insight sur une stratégie pour un rôle, les conditions suivantes doivent être remplies:

• La stratégie d'autorisation IAM qui accorde le rôle doit être associée à l'une des ressources suivantes:

  • Bucket Cloud Storage
  • Ensemble de données BigQuery
  • Projet
  • Dossier
  • Organisation

  L'outil de recommandation IAM ne génère des insights sur les stratégies que pour les rôles accordés sur ces ressources.

• La liaison de rôle qui accorde le rôle ne doit pas avoir de condition. L'outil de recommandation IAM ne génère pas d'insights sur les stratégies pour les liaisons de rôle conditionnelles.

• Le compte principal auquel le rôle est attribué doit être l'un des types suivants:

  • Utilisateur
  • Compte de service
  • Groupe
  • allUsers
  • allAuthenticatedUsers
  • Valeurs pratiques de Cloud Storage
  • Membre d'un groupe spécial BigQuery

  • L'un des types d'identités fédérées suivants:

    • Toutes les identités d'un pool d'identités de charge de travail
    • Identité unique d'un pool d'identités de charge de travail
    • Toutes les identités d'un pool d'identités de personnel
    • Identité unique d'un pool d'identités de personnel

    • Tous les pods Google Kubernetes Engine qui utilisent un compte de service Kubernetes spécifique

  Pour en savoir plus sur le format de l'identifiant pour chaque type de compte principal, consultez la section Identifiants principaux.

La génération des insights sur les stratégies pour un rôle nouvellement accordé peut prendre jusqu'à 10 jours.

Les insights sur les règles existants sont actualisés quotidiennement en fonction de votre utilisation récente des autorisations. Toutefois, les données sur lesquelles s'appuient les insights sur les règles sont généralement retardées de deux jours par rapport à votre utilisation réelle.

Disponibilité des informations sur les mouvements latéraux

Les insights sur les mouvements latéraux sont générés pour les rôles attribués sur les ressources suivantes:

• Organisations
• Dossiers
• Projets
• Comptes de service

Disponibilité des recommandations de rôle

Pour que l'outil de recommandation IAM génère une recommandation de rôle pour un rôle, les conditions suivantes doivent être remplies:

• Le rôle doit être associé à un insight sur une stratégie. Cet insight sur une stratégie sert de base pour la recommandation.
• Il doit s'écouler plus de la période d'observation minimale depuis l'attribution du rôle. Cela garantit que l'outil de recommandation IAM dispose de suffisamment de données d'utilisation pour émettre une recommandation. Par défaut, la période d'observation minimale est de 90 jours, mais vous pouvez la définir manuellement sur 30 ou 60 jours. Pour en savoir plus, consultez Configurer la génération de recommandations de rôles.
• Si le principal auquel le rôle est attribué est un agent de service, le rôle doit être "Propriétaire", "Éditeur" ou "Lecteur". L'outil de recommandation IAM ne génère pas de recommandations de rôle pour les agents de service associés à d'autres rôles. Pour en savoir plus, consultez la section Recommandations de rôles pour les agents de service.

Si un rôle a été attribué trop récemment ou n'a aucun insight, la colonne Autorisations analysées dans la console Google Cloud affiche une icône help.

Dans certains cas, l'outil de recommandation IAM ne génère pas de recommandations de rôle pour un rôle, même si suffisamment de temps s'est écoulé et que le rôle est associé à un insight. Cela peut se produire pour les raisons suivantes:

• Aucun rôle IAM prédéfini n'est plus approprié que le rôle actuel : Si un compte principal dispose déjà d'un rôle prédéfini qui minimise ses autorisations ou inclut moins d'autorisations que les autres rôles prédéfinis, l'outil de recommandation IAM ne peut pas recommander un rôle prédéfini différent.

  Vous pouvez peut-être réduire le nombre d'autorisations du compte principal en lui créant un rôle personnalisé.

• Le compte principal est un agent de service et le rôle n'est pas un rôle de base. L'outil de recommandation IAM ne génère des recommandations de rôle que pour les agents de service disposant d'un rôle de base (propriétaire, éditeur ou lecteur). Pour en savoir plus, consultez la section Recommandations de rôles pour les agents de service.

• Aucun autre compte principal ne dispose du rôle de base "Propriétaire" pour le projet : au moins un compte principal doit disposer du rôle "Propriétaire" (roles/owner) pour chaque projet. Si un seul compte principal dispose de ce rôle, l'outil de recommandation IAM ne vous recommandera pas de révoquer ou de remplacer le rôle.

Dans ces cas, la colonne Autorisations analysées dans la console Google Cloud indique l'utilisation des autorisations du compte principal, mais ne comporte pas l'icône Recommandation disponible .

Les recommandations de rôles existantes sont actualisées quotidiennement en fonction de votre utilisation récente des autorisations. Toutefois, les données sur lesquelles les recommandations de rôle sont basées sont généralement retardées de deux jours par rapport à votre utilisation réelle.

Priorité et gravité

La priorité des recommandations et le niveau de gravité des insights vous aident à comprendre l'urgence d'une recommandation ou d'un insight, et à hiérarchiser les insights en conséquence.

Priorité des recommandations de rôle

Les recommandations se voient attribuer des niveaux de priorité en fonction de leur degré d'urgence perçue. Les niveaux de priorité vont de P1 (priorité la plus élevée) à P4 (priorité la plus basse).

La priorité d'une recommandation de rôle dépend du rôle pour lequel elle est destinée:

Niveau de gravité des insights

Les insights se voient attribuer des niveaux de gravité en fonction de leur degré d'urgence perçue. Les niveaux de gravité peuvent être LOW, MEDIUM, HIGH ou CRITICAL.

Le niveau de gravité d'un insight sur les stratégies dépend du rôle auquel il est destiné:

Tous les insights sur les mouvements latéraux ont une gravité de LOW.

Comment les recommandations de rôle sont-elles appliquées ?

L'outil de recommandation IAM n'applique pas automatiquement les recommandations. Au lieu de cela, vous devez examiner vos recommandations et décider de les appliquer ou de les ignorer. Pour savoir comment examiner, appliquer et ignorer des recommandations de rôle, consultez l'un des guides suivants:

• Examiner et appliquer les recommandations de rôle pour les projets, les dossiers et les organisations
• Examiner et appliquer les recommandations de rôle pour les buckets Cloud Storage
• Examiner et appliquer les recommandations de rôles pour les ensembles de données BigQuery

Journaux d'audit

Lorsque vous appliquez ou ignorez une recommandation, l'outil de recommandation IAM crée une entrée de journal. Vous pouvez afficher ces entrées dans l'historique des recommandations ou les consulter dans vos journaux d'audit Google Cloud.

Sous-types de recommandations de rôle

Les recommandations de rôle sont divisées en plusieurs sous-types différents en fonction de l'action qu'elles recommandent. Si vous utilisez la CLI gcloud ou l'API REST, vous pouvez utiliser ces sous-types pour filtrer vos recommandations.

Recommandations de rôle pour les agents de service

Pour les agents de service, l'outil de recommandation IAM ne fournit que des recommandations pour les rôles de base (propriétaire, éditeur ou lecteur).

Les recommandations pour les agents de service sont divisées en deux sous-types.

SERVICE_AGENT_WITH_DEFAULT_ROLE

Lors de leur création, certains agents de service se voient automatiquement attribuer un rôle d'agent de service afin de garantir le bon fonctionnement de vos services Google Cloud. Si vous remplacez ce rôle par un rôle de base (propriétaire, éditeur ou lecteur), l'outil de recommandation peut vous suggérer de restaurer le rôle d'agent de service d'origine pour supprimer les autorisations en excès, même si l'agent de service dispose d'autorisations qui ne sont pas incluses dans le rôle de base. Ces recommandations sont associées au sous-type SERVICE_AGENT_WITH_DEFAULT_ROLE. Elles vous aident à supprimer les autorisations en excès en toute sécurité, tout en vous assurant que l'ensemble des services Google Cloud fonctionnent correctement.

Les recommandations SERVICE_AGENT_WITH_DEFAULT_ROLE sont les seules à pouvoir suggérer des rôles dont les autorisations ne figurent pas dans le rôle actuel.

SERVICE_AGENT_WITHOUT_DEFAULT_ROLE

Si un agent de service ne se voit pas automatiquement attribuer un rôle lors de sa création, les recommandations pour ce compte sont basées exclusivement sur les autorisations utilisées par l'agent de service. Ces recommandations sont associées au sous-type SERVICE_AGENT_WITHOUT_DEFAULT_ROLE.

Recommandations de rôles dans Security Command Center

Si vous disposez du niveau Premium de Security Command Center, vous pouvez afficher certains sous-types de recommandations de rôles en tant que résultats dans Security Command Center. Chaque sous-type est associé à un détecteur:

Pour en savoir plus sur l'affichage des recommandations de rôles dans Security Command Center, consultez la section Outil de recommandation IAM dans la documentation de Security Command Center.

Tarifs

Les recommandations de rôles au niveau du projet, du dossier et de l'organisation pour les rôles de base sont disponibles sans frais.

Les fonctionnalités avancées de l'outil de recommandation IAM suivantes nécessitent une activation du niveau Premium de Security Command Center au niveau de l'organisation:

• Recommandations pour les rôles non de base
• Recommandations pour les rôles attribués à des ressources autres que des organisations, des dossiers et des projets (par exemple, recommandations pour les rôles attribués à des buckets Cloud Storage)
• Recommandations suggérant des rôles personnalisés
• Insights sur les stratégies
• Insights sur les mouvements latéraux

Pour en savoir plus, consultez Questions sur la facturation.

Exemples de recommandations de rôles

Les exemples suivants illustrent les types de recommandations que vous pouvez recevoir.

Révoquer un rôle existant

Le rôle Navigateur a été attribué à l'utilisateur my-user@example.com sur un projet. Le rôle Navigateur inclut six autorisations permettant à l'utilisateur d'afficher les ressources du projet. Cependant, au cours des 90 derniers jours, my-user@example.com n'a vu aucune ressource.

Par conséquent, l'outil de recommandation IAM génère une recommandation de rôle qui suggère de révoquer le rôle Navigateur de my-user@example.com:

{
  "associatedInsights": [
    {
      "insight": "projects/123456789012/locations/global/insightTypes/google.iam.policy.Insight/insights/86c14538-dcfd-4326-afe5-ee8ac921e06a"
    }
  ],
  "content": {
    "operationGroups": [
      {
        "operations": [
          {
            "action": "remove",
            "path": "/iamPolicy/bindings/*/members/*",
            "pathFilters": {
              "/iamPolicy/bindings/*/condition/expression": "",
              "/iamPolicy/bindings/*/members/*": "user:my-user@example.com",
              "/iamPolicy/bindings/*/role": "roles/browser"
            },
            "resource": "//cloudresourcemanager.googleapis.com/projects/123456789012",
            "resourceType": "cloudresourcemanager.googleapis.com/Project"
          }
        ]
      }
    ],
    "overview": {
      "member": "user:my-user@example.com",
      "removedRole": "roles/browser",
      "resource": "//cloudresourcemanager.googleapis.com/projects/123456789012"
    }
  },
  "description": "This role has not been used during the observation window.",
  "etag": "\"9fc3241da8bfab51\"",
  "lastRefreshTime": "2022-05-20T07:00:00Z",
  "name": "projects/123456789012/locations/global/recommenders/google.iam.policy.Recommender/recommendations/fe512038-5455-49g1-8f9c-752e31c8c154",
  "primaryImpact": {
    "category": "SECURITY",
    "securityProjection": {
      "details": {
        "revokedIamPermissionsCount": 6
      }
    }
  },
  "priority": "P4",
  "recommenderSubtype": "REMOVE_ROLE",
  "stateInfo": {
    "state": "ACTIVE"
  }
}

{
  "name": "projects/123456789012/locations/global/recommenders/google.iam.policy.Recommender/recommendations/fe512038-5455-49g1-8f9c-752e31c8c154",
  "description": "This role has not been used during the observation window.",
  "lastRefreshTime": "2022-05-20T07:00:00Z",
  "primaryImpact": {
    "category": "SECURITY",
    "securityProjection": {
      "details": {
        "revokedIamPermissionsCount": 6
      }
    }
  },
  "content": {
    "operationGroups": [
      {
        "operations": [
          {
            "action": "remove",
            "resourceType": "cloudresourcemanager.googleapis.com/Project",
            "resource": "//cloudresourcemanager.googleapis.com/projects/123456789012",
            "path": "/iamPolicy/bindings/*/members/*",
            "pathFilters": {
              "/iamPolicy/bindings/*/condition/expression": "",
              "/iamPolicy/bindings/*/members/*": "user:my-user@example.com",
              "/iamPolicy/bindings/*/role": "roles/browser"
            }
          }
        ]
      }
    ],
    "overview": {
      "resource": "//cloudresourcemanager.googleapis.com/projects/123456789012",
      "member": "user:my-user@example.com",
      "removedRole": "roles/browser"
    }
  },
  "stateInfo": {
    "state": "ACTIVE"
  },
  "etag": "\"9fc3241da8bfab51\"",
  "recommenderSubtype": "REMOVE_ROLE",
  "associatedInsights": [
    {
      "insight": "projects/123456789012/locations/global/insightTypes/google.iam.policy.Insight/insights/86c14538-dcfd-4326-afe5-ee8ac921e06a"
    }
  ],
  "priority": "P4"
}

Remplacer un rôle existant

Le rôle Éditeur (roles/editor) a été attribué à un compte de service sur un projet. Ce rôle de base comprend plus de 3 000 autorisations et accorde un accès étendu au projet. Toutefois, au cours des 90 derniers jours, le compte de service n'a utilisé que certaines de ces autorisations.

Par conséquent, l'outil de recommandation IAM génère une recommandation de rôle qui vous suggère de révoquer le rôle Éditeur et de le remplacer par une combinaison de deux autres rôles, ce qui supprime des milliers d'autorisations en excès:

{
  "associatedInsights": [
    {
      "insight": "projects/123456789012/locations/global/insightTypes/google.iam.policy.Insight/insights/3d4ef3d6-bdf0-4330-975d-c65cb929c44d"
    }
  ],
  "content": {
    "operationGroups": [
      {
        "operations": [
          {
            "action": "add",
            "path": "/iamPolicy/bindings/*/members/-",
            "pathFilters": {
              "/iamPolicy/bindings/*/condition/expression": "",
              "/iamPolicy/bindings/*/role": "roles/iam.serviceAccountUser"
            },
            "resource": "//cloudresourcemanager.googleapis.com/projects/123456789012",
            "resourceType": "cloudresourcemanager.googleapis.com/Project",
            "value": "user:my-user@example.com"
          },
          {
            "action": "add",
            "path": "/iamPolicy/bindings/*/members/-",
            "pathFilters": {
              "/iamPolicy/bindings/*/condition/expression": "",
              "/iamPolicy/bindings/*/role": "roles/storage.objectAdmin"
            },
            "resource": "//cloudresourcemanager.googleapis.com/projects/123456789012",
            "resourceType": "cloudresourcemanager.googleapis.com/Project",
            "value": "user:my-user@example.com"
          },
          {
            "action": "remove",
            "path": "/iamPolicy/bindings/*/members/*",
            "pathFilters": {
              "/iamPolicy/bindings/*/condition/expression": "",
              "/iamPolicy/bindings/*/members/*": "user:my-user@example.com",
              "/iamPolicy/bindings/*/role": "roles/editor"
            },
            "resource": "//cloudresourcemanager.googleapis.com/projects/123456789012",
            "resourceType": "cloudresourcemanager.googleapis.com/Project"
          }
        ]
      }
    ],
    "overview": {
      "addedRoles": [
        "roles/iam.serviceAccountUser",
        "roles/storage.objectAdmin"
      ],
      "member": "user:my-user@example.com",
      "minimumObservationPeriodInDays": "0",
      "removedRole": "roles/editor",
      "resource": "//cloudresourcemanager.googleapis.com/projects/123456789012"
    }
  },
  "description": "Replace the current role with smaller predefined roles to cover the permissions needed.",
  "etag": "\"0da9a354c2a83d96\"",
  "lastRefreshTime": "2022-06-22T07:00:00Z",
  "name": "projects/123456789012/locations/global/recommenders/google.iam.policy.Recommender/recommendations/4637db3d-dba5-45eb-95ac-b4ee4b4cd14e",
  "primaryImpact": {
    "category": "SECURITY",
    "securityProjection": {
      "details": {
        "revokedIamPermissionsCount": 2998
      }
    }
  },
  "priority": "P2",
  "recommenderSubtype": "REPLACE_ROLE",
  "stateInfo": {
    "state": "ACTIVE"
  }
}

{
  "name": "projects/123456789012/locations/global/recommenders/google.iam.policy.Recommender/recommendations/4637db3d-dba5-45eb-95ac-b4ee4b4cd14e",
  "description": "Replace the current role with smaller predefined roles to cover the permissions needed.",
  "lastRefreshTime": "2022-06-22T07:00:00Z",
  "primaryImpact": {
    "category": "SECURITY",
    "securityProjection": {
      "details": {
        "revokedIamPermissionsCount": 2998
      }
    }
  },
  "content": {
    "operationGroups": [
      {
        "operations": [
          {
            "action": "add",
            "resourceType": "cloudresourcemanager.googleapis.com/Project",
            "resource": "//cloudresourcemanager.googleapis.com/projects/123456789012",
            "path": "/iamPolicy/bindings/*/members/-",
            "value": "user:my-user@example.com",
            "pathFilters": {
              "/iamPolicy/bindings/*/condition/expression": "",
              "/iamPolicy/bindings/*/role": "roles/iam.serviceAccountOwner"
            }
          },
          {
            "action": "add",
            "resourceType": "cloudresourcemanager.googleapis.com/Project",
            "resource": "//cloudresourcemanager.googleapis.com/projects/123456789012",
            "path": "/iamPolicy/bindings/*/members/-",
            "value": "user:my-user@example.com",
            "pathFilters": {
              "/iamPolicy/bindings/*/condition/expression": "",
              "/iamPolicy/bindings/*/role": "roles/storage.objectAdmin"
            }
          },
          {
            "action": "remove",
            "resourceType": "cloudresourcemanager.googleapis.com/Project",
            "resource": "//cloudresourcemanager.googleapis.com/projects/123456789012",
            "path": "/iamPolicy/bindings/*/members/*",
            "pathFilters": {
              "/iamPolicy/bindings/*/condition/expression": "",
              "/iamPolicy/bindings/*/members/*": "user:my-user@example.com",
              "/iamPolicy/bindings/*/role": "roles/editor"
            }
          }
        ]
      }
    ],
    "overview": {
      "resource": "//cloudresourcemanager.googleapis.com/projects/123456789012",
      "member": "user:my-user@example.com",
      "removedRole": "roles/editor",
      "addedRoles": [
        "roles/iam.serviceAccountUser",
        "roles/storage.objectAdmin"
      ],
      "minimumObservationPeriodInDays": "0"
    }
  },
  "stateInfo": {
    "state": "ACTIVE"
  },
  "etag": "\"0da9a354c2a83d96\"",
  "recommenderSubtype": "REPLACE_ROLE",
  "associatedInsights": [
    {
      "insight": "projects/123456789012/locations/global/insightTypes/google.iam.policy.Insight/insights/3d4ef3d6-bdf0-4330-975d-c65cb929c44d"
    }
  ],
  "priority": "P2"
}

Créer un rôle personnalisé

L'utilisateurmy-user@example.com s'est vu attribuer le rôle Administrateur Cloud Trace (roles/cloudtrace.admin) sur un projet. Ce rôle inclut plus de 10 autorisations, mais un insight sur une stratégie indique qu'au cours des 90 derniers jours, my-user@example.com n'a utilisé que quatre de ces autorisations.

Par conséquent, l'outil de recommandation IAM génère une recommandation de rôle suggérant de créer un rôle personnalisé qui n'inclut que les autorisations réellement utilisées par my-user@example.com:

{
  "associatedInsights": [
    {
      "insight": "projects/123456789012/locations/global/insightTypes/google.iam.policy.Insight/insights/2799dc04-b12e-4cf6-86aa-d81907d31f58"
    }
  ],
  "associatedResourceNames": [
    "//cloudresourcemanager.googleapis.com/projects/123456789012"
  ],
  "content": {
    "operationGroups": [
      {
        "operations": [
          {
            "action": "add",
            "path": "/iamPolicy/bindings/*/members/-",
            "pathFilters": {
              "/iamPolicy/bindings/*/condition/expression": "",
              "/iamPolicy/bindings/*/role": "roles/cloudtrace.user"
            },
            "resource": "//cloudresourcemanager.googleapis.com/projects/123456789012",
            "resourceType": "cloudresourcemanager.googleapis.com/Project",
            "value": "user:my-user@example.com"
          },
          {
            "action": "remove",
            "path": "/iamPolicy/bindings/*/members/*",
            "pathFilters": {
              "/iamPolicy/bindings/*/condition/expression": "",
              "/iamPolicy/bindings/*/members/*": "user:my-user@example.com",
              "/iamPolicy/bindings/*/role": "roles/cloudtrace.admin"
            },
            "resource": "//cloudresourcemanager.googleapis.com/projects/123456789012",
            "resourceType": "cloudresourcemanager.googleapis.com/Project"
          }
        ]
      }
    ],
    "overview": {
      "minimumObservationPeriodInDays": "0"
    }
  },
  "description": "Replace the current role with a smaller role to cover the permissions needed.",
  "etag": "\"c7f57a4725d32d66\"",
  "lastRefreshTime": "2022-06-22T07:00:00Z",
  "name": "projects/123456789012/locations/global/recommenders/google.iam.policy.Recommender/recommendations/ba1fc977-fddd-3856-a829-f69649ae8075",
  "originalContent": {},
  "primaryImpact": {
    "category": "SECURITY",
    "securityProjection": {
      "details": {},
      "revokedIamPermissionsCount": 1
    }
  },
  "priority": "P4",
  "recommenderSubtype": "REPLACE_ROLE_CUSTOMIZABLE",
  "stateInfo": {
    "state": "ACTIVE"
  },
  "targetResources": [
    "//cloudresourcemanager.googleapis.com/projects/123456789012"
  ]
}

{
  "name": "projects/123456789012/locations/global/recommenders/google.iam.policy.Recommender/recommendations/ba1fc977-fddd-3856-a829-f69649ae8075",
  "description": "Replace the current role with a smaller role to cover the permissions needed.",
  "lastRefreshTime": "2022-06-22T07:00:00Z",
  "primaryImpact": {
    "category": "SECURITY",
    "securityProjection": {
      "details": {
        "revokedIamPermissionsCount": 1
      }
    }
  },
  "content": {
    "operationGroups": [
      {
        "operations": [
          {
            "action": "add",
            "resourceType": "cloudresourcemanager.googleapis.com/Project",
            "resource": "//cloudresourcemanager.googleapis.com/projects/123456789012",
            "path": "/iamPolicy/bindings/*/members/-",
            "value": "user:my-user@example.com",
            "pathFilters": {
              "/iamPolicy/bindings/*/condition/expression": "",
              "/iamPolicy/bindings/*/role": "roles/cloudtrace.user"
            }
          },
          {
            "action": "remove",
            "resourceType": "cloudresourcemanager.googleapis.com/Project",
            "resource": "//cloudresourcemanager.googleapis.com/projects/123456789012",
            "path": "/iamPolicy/bindings/*/members/*",
            "pathFilters": {
              "/iamPolicy/bindings/*/condition/expression": "",
              "/iamPolicy/bindings/*/members/*": "user:my-user@example.com",
              "/iamPolicy/bindings/*/role": "roles/cloudtrace.admin"
            }
          }
        ]
      }
    ],
    "overview": {
      "minimumObservationPeriodInDays": "0"
    }
  },
  "stateInfo": {
    "state": "ACTIVE"
  },
  "etag": "\"c7f57a4725d32d66\"",
  "recommenderSubtype": "REPLACE_ROLE_CUSTOMIZABLE",
  "associatedInsights": [
    {
      "insight": "projects/123456789012/locations/global/insightTypes/google.iam.policy.Insight/insights/2799dc04-b12e-4cf6-86aa-d81907d31f58"
    }
  ],
  "priority": "P4"
}

L'outil de recommandation propose également une autre option, qui consiste à remplacer le rôle existant par le rôle Utilisateur Cloud Trace (roles/cloudtrace.user). Ce rôle prédéfini inclut un nombre d'autorisations légèrement inférieur à celui du rôle Administrateur Cloud Trace.

Remplacer des rôles avec des autorisations suggérées par le machine learning

Le rôle Éditeur (roles/editor) a été attribué à un compte de service sur un projet. Ce rôle de base comprend plus de 3 000 autorisations et accorde un accès étendu à un projet. Toutefois, un insight sur une stratégie indique que le compte de service a utilisé moins de 10 autorisations au cours des 90 derniers jours.

L'insight sur les stratégies met également en évidence plusieurs autorisations dont le compte de service est susceptible d'avoir besoin à l'avenir. L'outil de recommandation IAM a identifié ces autorisations à l'aide du machine learning.

L'outil de recommandation IAM génère une recommandation de rôle qui suggère de révoquer le rôle Éditeur et de le remplacer par le rôle Administrateur des objets de l'espace de stockage (roles/storage.objectAdmin), qui accorde un contrôle total sur les objets d'un bucket Cloud Storage. Cette modification supprime des milliers d'autorisations en excès, tout en incluant toujours les autorisations utilisées par le compte de service et celles dont le compte de service est susceptible d'avoir besoin à l'avenir:

associatedRecommendations:
- recommendation: projects/123456789012/locations/global/recommenders/google.iam.policy.Recommender/recommendations/0573b702-96a5-4622-a916-c762e7b0731f
category: SECURITY
content:
  condition:
    description: ''
    expression: ''
    location: ''
    title: ''
  currentTotalPermissionsCount: '5069'
  exercisedPermissions:
  - permission: storage.objects.create
  - permission: storage.objects.delete
  - permission: storage.objects.get
  - permission: storage.objects.list
  inferredPermissions:
  - permission: resourcemanager.projects.get
  member: serviceAccount:my-service-account@my-project.iam.gserviceaccount.com
  role: roles/editor
description: 4 of the permissions in this role binding were used in the past 90 days.
etag: '"d3cdec23cc712bd0"'
insightSubtype: PERMISSIONS_USAGE
lastRefreshTime: '2020-07-11T07:00:00Z'
name: projects/123456789012/locations/global/insightTypes/google.iam.policy.Insight/insights/0d3ce433-f067-4e78-b6ae-03d7d1f6f040
observationPeriod: 7776000s
stateInfo:
  state: ACTIVE
targetResources:
- //cloudresourcemanager.googleapis.com/projects/123456789012
severity: HIGH

{
  "name": "projects/123456789012/locations/global/insightTypes/google.iam.policy.Insight/insights/07841f74-02ce-4de8-bbe6-fc4eabb68568",
  "description": "4 of the permissions in this role binding were used in the past 90 days.",
  "content": {
    "role": "roles/editor",
    "member": "serviceAccount:my-service-account@my-project.iam.gserviceaccount.com",
    "condition": {
      "expression": "",
      "title": "",
      "description": "",
      "location": ""
    },
    "exercisedPermissions": [
      {
        "permission": "storage.objects.create"
      },
      {
        "permission": "storage.objects.delete"
      },
      {
        "permission": "storage.objects.get"
      },
      {
        "permission": "storage.objects.list"
      }
    ],
    "inferredPermissions": [
      {
        "permission": "resourcemanager.projects.get"
      }
    ],
    "currentTotalPermissionsCount": "5069"
  },
  "lastRefreshTime": "2020-07-12T07:00:00Z",
  "observationPeriod": "7776000s",
  "stateInfo": {
    "state": "ACTIVE"
  },
  "category": "SECURITY",
  "associatedRecommendations": [
    {
      "recommendation": "projects/123456789012/locations/global/recommenders/google.iam.policy.Recommender/recommendations/b1932220-867d-43d1-bd74-fb95876ab656"
    }
  ],
  "targetResources": [
    "//cloudresourcemanager.googleapis.com/projects/123456789012"
  ],
  "insightSubtype": "PERMISSIONS_USAGE",
  "etag": "\"d3cdec23cc712bd0\"",
  "severity": "HIGH"
}

Étape suivante

• Découvrez les bonnes pratiques d'utilisation des recommandations de rôle.
• Examiner et appliquer les recommandations de rôle pour les projets, les dossiers et les organisations
• Examiner et appliquer les recommandations de rôle pour les buckets Cloud Storage
• Examiner et appliquer vos recommandations de rôles pour les ensembles de données BigQuery
• Apprenez-en plus sur l'outil de recommandation.
• Découvrez les rôles prédéfinis et les rôles personnalisés dans IAM.