Contrôle des accès avec IAM

Ce document explique comment utiliser les rôles et autorisations Identity and Access Management (IAM) pour contrôler l'accès aux données des journaux dans l'API Logging, l'explorateur de journaux et la Google Cloud CLI.

Présentation

Les autorisations et les rôles IAM déterminent votre capacité à accéder aux données des journaux dans l'API Logging, l'explorateur de journaux et la Google Cloud CLI.

Un rôle est un ensemble d'autorisations. Vous ne pouvez pas accorder directement une autorisation principale. À la place, vous lui accordez un rôle. Lorsque vous accordez un rôle à un compte principal, vous lui accordez toutes les autorisations associées à ce rôle. Vous pouvez attribuer plusieurs rôles au même compte principal.

Pour utiliser Logging dans une ressource Google Cloud, telle qu'un projet, un dossier, un bucket ou une organisation Google Cloud, un compte principal doit disposer d'un rôle IAM contenant les autorisations appropriées.

Rôles prédéfinis

IAM fournit des rôles prédéfinis permettant d'accorder un accès précis à des ressources Google Cloud spécifiques et d'empêcher tout accès indésirable à d'autres ressources. Google Cloud crée et gère ces rôles, et met automatiquement à jour leurs autorisations si nécessaire, par exemple lorsque Logging ajoute de nouvelles fonctionnalités.

Le tableau suivant répertorie les rôles prédéfinis pour Logging. Pour chaque rôle, le tableau affiche son titre, sa description, les autorisations qu'il contient et le type de ressource de niveau le plus bas auquel il peut être attribué. Vous pouvez attribuer les rôles prédéfinis au niveau du projet Google Cloud ou, dans la plupart des cas, de tout type de niveau supérieur dans la hiérarchie Google Cloud. Pour définir de façon plus précise le rôle d'accesseur de vues de journaux au niveau du bucket, utilisez les attributs de ressources pour les conditions IAM.

Pour obtenir la liste de toutes les autorisations individuelles contenues dans un rôle, consultez la section Obtenir les métadonnées du rôle.

Role Permissions

(roles/logging.admin)

Provides all permissions necessary to use all features of Cloud Logging.

Lowest-level resources where you can grant this role:

  • Project

logging.buckets.copyLogEntries

logging.buckets.create

logging.buckets.delete

logging.buckets.get

logging.buckets.list

logging.buckets.undelete

logging.buckets.update

logging.exclusions.*

  • logging.exclusions.create
  • logging.exclusions.delete
  • logging.exclusions.get
  • logging.exclusions.list
  • logging.exclusions.update

logging.fields.access

logging.links.*

  • logging.links.create
  • logging.links.delete
  • logging.links.get
  • logging.links.list

logging.locations.*

  • logging.locations.get
  • logging.locations.list

logging.logEntries.*

  • logging.logEntries.create
  • logging.logEntries.download
  • logging.logEntries.list
  • logging.logEntries.route

logging.logMetrics.*

  • logging.logMetrics.create
  • logging.logMetrics.delete
  • logging.logMetrics.get
  • logging.logMetrics.list
  • logging.logMetrics.update

logging.logServiceIndexes.list

logging.logServices.list

logging.logs.*

  • logging.logs.delete
  • logging.logs.list

logging.notificationRules.*

  • logging.notificationRules.create
  • logging.notificationRules.delete
  • logging.notificationRules.get
  • logging.notificationRules.list
  • logging.notificationRules.update

logging.operations.*

  • logging.operations.cancel
  • logging.operations.get
  • logging.operations.list

logging.privateLogEntries.list

logging.queries.*

  • logging.queries.create
  • logging.queries.delete
  • logging.queries.deleteShared
  • logging.queries.get
  • logging.queries.getShared
  • logging.queries.list
  • logging.queries.listShared
  • logging.queries.share
  • logging.queries.update
  • logging.queries.updateShared
  • logging.queries.usePrivate

logging.settings.*

  • logging.settings.get
  • logging.settings.update

logging.sinks.*

  • logging.sinks.create
  • logging.sinks.delete
  • logging.sinks.get
  • logging.sinks.list
  • logging.sinks.update

logging.usage.get

logging.views.*

  • logging.views.access
  • logging.views.create
  • logging.views.delete
  • logging.views.get
  • logging.views.getIamPolicy
  • logging.views.list
  • logging.views.listLogs
  • logging.views.listResourceKeys
  • logging.views.listResourceValues
  • logging.views.setIamPolicy
  • logging.views.update

resourcemanager.projects.get

resourcemanager.projects.list

(roles/logging.bucketWriter)

Ability to write logs to a log bucket.

Lowest-level resources where you can grant this role:

  • Project

logging.buckets.write

(roles/logging.configWriter)

Provides permissions to read and write the configurations of logs-based metrics and sinks for exporting logs.

Lowest-level resources where you can grant this role:

  • Project

logging.buckets.create

logging.buckets.delete

logging.buckets.get

logging.buckets.list

logging.buckets.undelete

logging.buckets.update

logging.exclusions.*

  • logging.exclusions.create
  • logging.exclusions.delete
  • logging.exclusions.get
  • logging.exclusions.list
  • logging.exclusions.update

logging.links.*

  • logging.links.create
  • logging.links.delete
  • logging.links.get
  • logging.links.list

logging.locations.*

  • logging.locations.get
  • logging.locations.list

logging.logMetrics.*

  • logging.logMetrics.create
  • logging.logMetrics.delete
  • logging.logMetrics.get
  • logging.logMetrics.list
  • logging.logMetrics.update

logging.logServiceIndexes.list

logging.logServices.list

logging.logs.list

logging.notificationRules.*

  • logging.notificationRules.create
  • logging.notificationRules.delete
  • logging.notificationRules.get
  • logging.notificationRules.list
  • logging.notificationRules.update

logging.operations.*

  • logging.operations.cancel
  • logging.operations.get
  • logging.operations.list

logging.settings.*

  • logging.settings.get
  • logging.settings.update

logging.sinks.*

  • logging.sinks.create
  • logging.sinks.delete
  • logging.sinks.get
  • logging.sinks.list
  • logging.sinks.update

logging.views.create

logging.views.delete

logging.views.get

logging.views.getIamPolicy

logging.views.list

logging.views.update

resourcemanager.projects.get

resourcemanager.projects.list

(roles/logging.fieldAccessor)

Ability to read restricted fields in a log bucket.

Lowest-level resources where you can grant this role:

  • Project

logging.fields.access

(roles/logging.linkViewer)

Ability to see links for a bucket.

logging.links.get

logging.links.list

(roles/logging.logWriter)

Provides the permissions to write log entries.

Lowest-level resources where you can grant this role:

  • Project

logging.logEntries.create

logging.logEntries.route

(roles/logging.privateLogViewer)

Provides permissions of the Logs Viewer role and in addition, provides read-only access to log entries in private logs.

Lowest-level resources where you can grant this role:

  • Project

logging.buckets.get

logging.buckets.list

logging.exclusions.get

logging.exclusions.list

logging.links.get

logging.links.list

logging.locations.*

  • logging.locations.get
  • logging.locations.list

logging.logEntries.list

logging.logMetrics.get

logging.logMetrics.list

logging.logServiceIndexes.list

logging.logServices.list

logging.logs.list

logging.privateLogEntries.list

logging.queries.create

logging.queries.delete

logging.queries.get

logging.queries.getShared

logging.queries.list

logging.queries.listShared

logging.queries.update

logging.queries.usePrivate

logging.sinks.get

logging.sinks.list

logging.usage.get

logging.views.access

logging.views.get

logging.views.list

resourcemanager.projects.get

(roles/logging.viewAccessor)

Ability to read logs in a view.

Lowest-level resources where you can grant this role:

  • Project

logging.logEntries.download

logging.views.access

logging.views.listLogs

logging.views.listResourceKeys

logging.views.listResourceValues

(roles/logging.viewer)

Provides access to view logs.

Lowest-level resources where you can grant this role:

  • Project

logging.buckets.get

logging.buckets.list

logging.exclusions.get

logging.exclusions.list

logging.links.get

logging.links.list

logging.locations.*

  • logging.locations.get
  • logging.locations.list

logging.logEntries.list

logging.logMetrics.get

logging.logMetrics.list

logging.logServiceIndexes.list

logging.logServices.list

logging.logs.list

logging.operations.get

logging.operations.list

logging.queries.create

logging.queries.delete

logging.queries.get

logging.queries.getShared

logging.queries.list

logging.queries.listShared

logging.queries.update

logging.queries.usePrivate

logging.sinks.get

logging.sinks.list

logging.usage.get

logging.views.get

logging.views.list

resourcemanager.projects.get

Les sections suivantes fournissent des informations supplémentaires pour vous aider à choisir les rôles qui s'appliquent aux cas d'utilisation de vos comptes principaux.

Rôles Logging

  • Pour autoriser un utilisateur à effectuer toutes les actions dans Logging, attribuez-lui le rôle Administrateur Logging (roles/logging.admin).

  • Pour permettre à un utilisateur de créer et de modifier des configurations de journalisation, telles que des récepteurs, des buckets, des vues, des liens, des métriques basées sur les journaux ou des exclusions, accordez le rôle "Rédacteur de configuration des journaux" (roles/logging.configWriter).

  • Pour permettre à un utilisateur de lire des journaux dans les buckets _Required et _Default, utilisez l'explorateur de journaux et la page "Analyse de journaux", attribuez l'un des rôles suivants:

    • Pour accéder à tous les journaux du bucket _Required et à la vue _Default sur le bucket _Default, accordez le rôle Lecteur de journaux (roles/logging.viewer).
    • Pour accéder à tous les journaux des buckets _Required et _Default, y compris les journaux d'accès aux données, attribuez le rôle Lecteur de journaux privés (roles/logging.privateLogViewer).
  • Pour permettre à un utilisateur de lire des journaux à l'aide d'une vue de journaux sur un bucket de journaux, accordez le rôle "Accesseur de vues de journaux" (roles/logging.viewAccessor). Vous pouvez limiter l'autorisation à une vue de journaux spécifique sur un bucket de journaux spécifique. Pour en savoir plus sur la création de vues de journaux et l'attribution d'accès, consultez la page Configurer des vues de journaux sur un bucket de journaux.

  • Pour permettre à un utilisateur d'accéder à des champs LogEntry restreints, le cas échéant, dans un bucket donné, accordez le rôle "Accesseur de champs de journaux" (roles/logging.fieldAccessor). Pour en savoir plus, consultez Configurer l'accès au niveau du champ.

  • Pour permettre à un utilisateur d'écrire des journaux à l'aide de l'API Logging, accordez le rôle "Rédacteur de journaux" (roles/logging.logWriter). Ce rôle n'accorde pas de droits de lecture.

  • Pour autoriser le compte de service d'un récepteur à acheminer les journaux vers un bucket situé dans un autre projet Google Cloud, attribuez-lui le rôle Rédacteur de bucket de journaux (roles/logging.bucketWriter). Pour savoir comment accorder des autorisations à un compte de service, consultez la section Définir des autorisations de destination.

Rôles au niveau du projet

  • Pour accorder un accès en lecture à la plupart des services Google Cloud, accordez le rôle Lecteur (roles/viewer).

    Ce rôle inclut toutes les autorisations accordées par le rôle Lecteur de journaux (roles/logging.viewer).

  • Pour accorder un accès éditeur à la plupart des services Google Cloud, accordez le rôle Éditeur (roles/editor).

    Ce rôle inclut toutes les autorisations accordées par le rôle Lecteur de journaux (roles/logging.viewer), ainsi que les autorisations permettant d'écrire des entrées de journal, de supprimer des journaux et de créer des métriques basées sur les journaux. Toutefois, ce rôle ne permet pas aux utilisateurs de créer des récepteurs, de lire les journaux d'audit pour l'accès aux données qui se trouvent dans le bucket _Default, ni de lire les journaux qui se trouvent dans des buckets de journaux définis par l'utilisateur.

  • Pour accorder un accès complet à la plupart des services Google Cloud, accordez le rôle Propriétaire (roles/owner).

Attribution des rôles…

Pour savoir comment attribuer un rôle à un compte principal, consultez la page Accorder, modifier et révoquer les accès.

Vous pouvez attribuer plusieurs rôles au même utilisateur. Pour obtenir la liste des autorisations contenues dans un rôle, consultez la section Obtenir les métadonnées du rôle.

Si vous essayez d'accéder à une ressource Google Cloud et que vous ne disposez pas des autorisations nécessaires, contactez le compte principal répertorié comme propriétaire de la ressource.

Rôles personnalisés

Pour créer un rôle personnalisé avec des autorisations Logging, procédez comme suit :

Pour plus d'informations sur les rôles personnalisés, voir Comprendre les rôles personnalisés IAM.

Autorisations pour la console Google Cloud

Le tableau suivant répertorie les autorisations nécessaires pour utiliser l'explorateur de journaux.

Dans le tableau, a.b.{x,y} signifie a.b.x et a.b.y.

Activité de la console Autorisations requises
Accès minimal en lecture seule logging.logEntries.list
logging.logs.list
logging.logServiceIndexes.list
logging.logServices.list
resourcemanager.projects.get
Possibilité d'afficher les journaux d'audit concernant l'accès aux données Ajouter logging.privateLogEntries.list
Possibilité d'afficher des métriques basées sur les journaux Ajouter logging.logMetrics.{list, get}
Possibilité d'afficher des récepteurs Ajouter logging.sinks.{list, get}
Possibilité d'afficher l'utilisation des journaux Ajouter logging.usage.get
Possibilité d'exclure les journaux Ajouter logging.exclusions.{list, create, get, update, delete}
Possibilité d'utiliser des récepteurs Ajouter logging.sinks.{list, create, get, update, delete}
Possibilité de créer des métriques basées sur les journaux Ajouter logging.logMetrics.{list, create, get, update, delete}
Possibilité d'utiliser des requêtes enregistrées privées Ajouter logging.queries.{list, create, get, update, delete}
Possibilité d'utiliser des requêtes enregistrées partagées Ajouter logging.queries.{share, getShared, updateShared, deleteShared, listShared}
Possibilité d'utiliser des requêtes récentes Ajouter logging.queries.{create, list}

Autorisations pour la ligne de commande

Les commandes gcloud logging sont contrôlées par les autorisations IAM.

Pour utiliser l'une des commandes gcloud logging, les comptes principaux doivent disposer de l'autorisation serviceusage.services.use.

Un compte principal doit également disposer du rôle IAM correspondant à la ressource du journal et au cas d'utilisation. Pour en savoir plus, consultez la section Autorisations de l'interface de ligne de commande.

La liste suivante décrit les rôles prédéfinis et les autorisations correspondantes pour gérer vos ensembles de données BigQuery associés:

Les rôles et autorisations précédemment répertoriés ne s'appliquent qu'aux pages d'observabilité de Google Cloud, telles que la page Analyse de journaux. Si vous utilisez l'interface BigQuery pour gérer vos ensembles de données, vous aurez peut-être besoin de rôles et d'autorisations BigQuery distincts. Pour en savoir plus, consultez la page Contrôle des accès avec IAM pour BigQuery.

Autorisations pour enregistrer des requêtes

Cette section décrit les rôles prédéfinis et les autorisations pour enregistrer, partager et utiliser des requêtes dans les pages Explorateur de journaux et Analyse de journaux. L'utilisation de requêtes enregistrées privées qui ne sont visibles que par vous et l'utilisation de requêtes enregistrées partagées avec d'autres membres du projet Google Cloud nécessitent des autorisations différentes:

  • Pour obtenir les autorisations dont vous avez besoin pour utiliser des requêtes enregistrées privées, demandez à votre administrateur de vous attribuer le rôle IAM Lecteur de journaux (roles/logging.viewer) sur votre projet.

    Ce rôle prédéfini contient les autorisations requises pour utiliser des requêtes enregistrées privées. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

    Autorisations requises

    Les autorisations suivantes sont requises pour utiliser des requêtes enregistrées privées:

    • logging.queries.list
    • logging.queries.create
    • logging.queries.get
    • logging.queries.update
    • logging.queries.delete
  • Pour obtenir les autorisations nécessaires pour créer, mettre à jour et supprimer des requêtes partagées, demandez à votre administrateur de vous attribuer le rôle IAM Administrateur Logging (roles/logging.admin) sur votre projet.

    Ce rôle prédéfini contient les autorisations requises pour créer, mettre à jour et supprimer des requêtes partagées. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

    Autorisations requises

    Les autorisations suivantes sont requises pour créer, mettre à jour et supprimer des requêtes partagées:

    • logging.queries.share
    • logging.queries.updateShared
    • logging.queries.deleteShared
  • Pour obtenir les autorisations nécessaires pour répertorier et obtenir des requêtes partagées, demandez à votre administrateur de vous attribuer le rôle IAM Lecteur de journaux (roles/logging.viewer) sur votre projet.

    Ce rôle prédéfini contient les autorisations requises pour répertorier et obtenir des requêtes partagées. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

    Autorisations requises

    Les autorisations suivantes sont requises pour répertorier et obtenir des requêtes partagées:

    • logging.queries.listShared
    • logging.queries.getShared

Autorisations de routage des journaux

Pour en savoir plus sur la définition des contrôles d'accès lors de la création et de la gestion des récepteurs pour acheminer les journaux, consultez la section Définir les autorisations de destination.

Notez que la gestion des filtres d'exclusion est intégrée à la configuration des récepteurs. Toutes les autorisations liées à la gestion des récepteurs, y compris la définition de filtres d'exclusion, sont incluses dans les autorisations logging.sinks.*. Lors de la création d'un rôle personnalisé qui inclut des autorisations permettant de gérer les filtres d'exclusion, ajoutez les autorisations logging.sinks.* au rôle plutôt que d'ajouter les autorisations logging.exclusions.*.

Une fois que vos entrées de journal ont été acheminées vers une destination compatible, l'accès aux copies de journaux est contrôlé entièrement par les autorisations et les rôles IAM sur les destinations : Cloud Storage, BigQuery ou Pub/Sub.

Autorisations pour les métriques basées sur les journaux

Voici un récapitulatif des rôles et autorisations dont un compte principal a besoin pour accéder aux métriques basées sur les journaux :

  • Le rôle Rédacteur de configuration des journaux (roles/logging.configWriter) permet aux comptes principaux de répertorier, créer, obtenir, mettre à jour et supprimer des métriques basées sur les journaux.

  • Le rôle Lecteur de journaux (roles/logging.viewer) contient les autorisations nécessaires pour afficher les métriques existantes. Plus précisément, un compte principal a besoin des autorisations logging.logMetrics.get et logging.logMetrics.list pour afficher les métriques existantes.

  • Le rôle Lecteur Monitoring (roles/monitoring.viewer) dispose des autorisations nécessaires pour lire les données TimeSeries. Plus précisément, un compte principal a besoin de l'autorisation monitoring.timeSeries.list pour lire les données de séries temporelles.

  • Les rôles Administrateur Logging (roles/logging.admin), Éditeur de projet (roles/editor) et Propriétaire de projet (roles/owner) disposent des autorisations nécessaires pour créer des métriques basées sur les journaux. Plus précisément, un compte principal a besoin de l'autorisation logging.logMetrics.create pour créer des métriques basées sur les journaux.

Autorisations pour les règles d'alerte basées sur les journaux

Pour créer et gérer des règles d'alerte basées sur les journaux, un compte principal doit disposer des rôles et autorisations Logging et Monitoring suivants:

  • Pour obtenir les autorisations nécessaires pour lire les journaux et gérer les règles de notification Logging, demandez à votre administrateur de vous attribuer le rôle IAM Administrateur Logging (roles/logging.admin) pour votre projet.

    Ce rôle prédéfini contient les autorisations requises pour lire les journaux et gérer les règles de notification de Logging. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

    Autorisations requises

    Les autorisations suivantes sont requises pour lire les journaux et gérer les règles de notification de Logging:

    • logging.queries.listShared
    • logging.queries.getShared
  • Pour obtenir les autorisations nécessaires pour gérer les règles d'alerte basées sur les journaux et leurs canaux de notification, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet:

    Ces rôles prédéfinis contiennent les autorisations requises pour gérer les règles d'alerte basées sur les journaux et leurs canaux de notification. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

    Autorisations requises

    Les autorisations suivantes sont requises pour gérer les règles d'alerte basées sur les journaux et leurs canaux de notification:

    • logging.queries.listShared
    • logging.queries.getShared
  • Pour obtenir les autorisations dont vous avez besoin pour créer une règle d'alerte dans la Google Cloud CLI, demandez à votre administrateur de vous attribuer le rôle IAM Consommateur d'utilisation du service (roles/serviceusage.serviceUsageConsumer) sur votre projet.

    Ce rôle prédéfini contient les autorisations requises pour créer une règle d'alerte dans la Google Cloud CLI. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

    Autorisations requises

    Les autorisations suivantes sont requises pour créer une règle d'alerte dans la Google Cloud CLI:

    • logging.queries.listShared
    • logging.queries.getShared

Champs d'application de l'accès à Logging

Les niveaux d'accès représentent l'ancienne méthode de spécification des autorisations associées aux comptes de service sur vos instances de VM Compute Engine.

Les champs d'application d'accès suivants s'appliquent à l'API Logging :

Champ d'application d'accès Autorisations accordées
http://www.googleapis.com/auth/logging.read roles/logging.viewer
http://www.googleapis.com/auth/logging.write roles/logging.logWriter
http://www.googleapis.com/auth/logging.admin Accès complet à l'API Logging.
http://www.googleapis.com/auth/cloud-platform Accès complet à l'API Logging et à toutes les autres API Google Cloud activées

Pour en savoir plus sur l'utilisation de cette ancienne méthode pour définir les niveaux d'accès de vos comptes de service, consultez la page Autorisations de compte de service.