Déléguer des autorisations d'agent de service à un compte de service géré par l'utilisateur

La délégation des autorisations de l'agent de service à un compte de service géré par l'utilisateur est une configuration facultative pour les organisations qui nécessitent un contrôle des accès aux buckets par utilisateur.

Pour les transferts sans agent, le service de transfert de stockage utilise par défaut un agent de service pour transférer vos données entre la source et la destination. Vous accordez à l'agent de service les autorisations nécessaires pour accéder à vos buckets Cloud Storage.

Étant donné que le même agent de service du service de transfert de stockage est utilisé par tous les transferts d'un projet, il dispose nécessairement d'autorisations sur tous les buckets impliqués dans chaque transfert de ce projet.

Vous pouvez également attribuer des autorisations de bucket à plusieurs comptes de service gérés par l'utilisateur. Ces comptes de service gérés par l'utilisateur disposent d'autorisations sur des buckets sources et de destination spécifiques, et sont également limités à des comptes utilisateur spécifiques (les comptes qui créent ou déclenchent le job de transfert).

Exemples de cas de figure

Les scénarios suivants illustrent différentes options d'autorisation à l'aide de l'agent de service et des comptes de service gérés par l'utilisateur.

Développez chaque section pour en afficher le détail.

Scénario 1 : Agent de service uniquement

Dans ce scénario, toutes les autorisations sont accordées à l'agent de service.

  • L'agent de service dispose d'autorisations d'écriture sur les buckets A, B, C et D.

Tout utilisateur disposant des autorisations appropriées pour créer un job de transfert peut transférer des données vers ou depuis les buckets A, B, C et D.

Cette approche fonctionne bien lorsque l'utilisateur du service de transfert de stockage est un utilisateur de confiance pour les données de tous les buckets et qu'il peut configurer correctement les jobs de transfert pour éviter de déplacer des données vers ou depuis un bucket incorrect.

Scénario 2 : Comptes de service gérés par l'utilisateur uniquement

Dans ce scénario, toutes les autorisations sont accordées aux comptes de service gérés par l'utilisateur.

  • Le compte de service géré par l'utilisateur n° 1 dispose d'autorisations sur les buckets A et B.
  • Le compte de service géré par l'utilisateur 2 dispose d'autorisations sur les buckets C et D.

En outre :

  • L'utilisateur Alpha est autorisé à accéder au compte de service 1.
  • L'utilisateur Bravo se voit accorder l'accès au compte de service 2.
  • L'utilisateur Charlie est autorisé à accéder aux comptes de service 1 et 2.

Dans ce cas :

  • Alpha ne peut effectuer de transferts qu'entre les buckets A et B.
  • Bravo ne peut effectuer de transferts qu'entre les buckets C et D.
  • Charlie ne peut effectuer de transferts qu'entre les buckets A et B, et entre les buckets C et D.
  • Charlie ne peut pas effectuer de transfert entre A et C, A et D, B et C, ou B et D.

Scénario 3 : Autorisations mixtes

Dans ce scénario, votre projet contient un mélange d'autorisations d'agent de service et d'autorisations de compte de service géré par l'utilisateur.

  • L'agent de service se voit accorder des autorisations d'écriture sur les buckets A et B.
  • Le compte de service géré par l'utilisateur 1 dispose d'autorisations de lecture seule sur le bucket C et d'autorisations d'écriture sur le bucket D.
  • L'utilisateur Alpha est autorisé à accéder au compte de service géré par l'utilisateur 1.

Dans ce cas :

  • Tout utilisateur disposant des autorisations appropriées pour créer une tâche de transfert peut effectuer un transfert vers ou depuis les buckets A et B. Ils ne peuvent pas être transférés vers ou depuis les buckets C ou D.
  • L'utilisateur Alpha peut transférer des données vers ou depuis les buckets A et B.
  • Alpha peut transférer des données depuis le bucket C vers le bucket D.
  • Alpha ne peut pas transférer de données du bucket C vers le bucket A ou B.

Présentation de l'implémentation

L'implémentation est la suivante :

  • Vous créez un compte de service géré par l'utilisateur ou vous en utilisez un existant.
  • Vous accordez des autorisations :
    • Pour qu'un utilisateur puisse accéder au compte de service géré par l'utilisateur.
    • Pour que l'agent de service génère un jeton d'accès à partir du compte de service géré par l'utilisateur.
    • Pour que le compte de service géré par l'utilisateur puisse accéder à vos buckets.
  • L'utilisateur crée un job de transfert qui spécifie le compte de service géré par l'utilisateur.
  • Le service de transfert de stockage vérifie que l'utilisateur dispose des autorisations appropriées sur le compte de service. Si les autorisations appropriées n'ont pas été accordées, la création du job de transfert échoue.
  • L'agent de service génère un jeton OAuth au nom du compte de service géré par l'utilisateur. Le jeton OAuth permet au service de transfert de stockage d'accéder aux buckets impliqués dans le transfert.
  • Le job de transfert s'exécute.
  • Le jeton OAuth est de courte durée et expire. Si le job de transfert est en cours d'exécution lorsque le jeton expire, le service de transfert de stockage en génère un nouveau et poursuit le transfert.

Configurer la délégation d'autorisations

Suivez les instructions pour déléguer l'accès de l'agent de service à un compte de service géré par l'utilisateur.

Conditions requises

  • Pour créer ou gérer des jobs de transfert, votre compte utilisateur doit disposer des autorisations de projet du service de transfert de stockage. Consultez Autorisations utilisateur requises.
  • Pour créer un compte de service géré par l'utilisateur, vous devez disposer du rôle Créer des comptes de service (roles/iam.serviceAccountCreator) sur le projet.
  • Pour accorder l'accès au compte de service géré par l'utilisateur à l'utilisateur et à l'agent de service, vous devez disposer du rôle Administrateur de compte de service (roles/iam.serviceAccountAdmin) sur le compte de service géré par l'utilisateur ou sur le projet.

Créer ou identifier un compte de service géré par l'utilisateur

Vous pouvez créer un compte de service géré par l'utilisateur ou en utiliser un existant.

  • Pour créer un compte de service géré par l'utilisateur, suivez les instructions de la section Créer des comptes de service.

  • Pour utiliser un compte de service géré par l'utilisateur existant, vous avez besoin de son adresse e-mail, qui utilise le format suivant :

    SERVICE_ACCOUNT_NAME@PROJECT_ID.

  • Si vous avez besoin de l'identifiant unique du compte de service (uniqueId), exécutez gcloud iam service-accounts describe SERVICE_ACCOUNT_EMAIL --format="value(uniqueId)" ou consultez la colonne Identifiant unique sur la page Comptes de service de la consoleGoogle Cloud .

Si le compte de service se trouve dans un projet différent de celui du job de transfert, consultez Activer l'association des comptes de service à plusieurs projets.

Accorder l'accès à l'utilisateur

Accordez au compte utilisateur l'accès au nouveau compte de service géré par l'utilisateur et attribuez-lui le rôle Utilisateur du compte de service (roles/iam.serviceAccountUser). Le compte utilisateur est celui utilisé pour créer ou mettre à jour le job de transfert.

Console Google Cloud

  1. Dans la console Google Cloud , accédez à la page Comptes de service.

    Accéder à la page "Comptes de service"

  2. Sélectionnez un projet.

  3. Cliquez sur l'adresse e-mail du compte de service géré par l'utilisateur.

  4. Sélectionnez l'onglet Comptes principaux avec accès.

  5. Cliquez sur  Accorder l'accès.

  6. Saisissez l'identifiant principal de l'utilisateur. Pour un compte Google, il s'agit de l'adresse e-mail, par exemple user1@example.com.

  7. Dans la liste déroulante Rôle, sélectionnez Utilisateur du compte de service.

  8. Cliquez sur Enregistrer. Le rôle est attribué au compte principal sur le compte de service.

gcloud

Pour attribuer un rôle à un compte principal, exécutez la commande add-iam-policy-binding :

gcloud iam service-accounts add-iam-policy-binding USER_MANAGED_SERVICE_ACCOUNT_EMAIL \
  --member=PRINCIPAL --role=roles/iam.serviceAccountUser

Remplacez les variables suivantes :

  • USER_MANAGED_SERVICE_ACCOUNT_EMAIL : adresse e-mail du compte de service géré par l'utilisateur, au format SA_NAME@PROJECT_ID..
  • PRINCIPAL : identifiant principal de l'utilisateur qui exécute le job de transfert, tel que user:name@example.com pour un compte Google ou un identifiant principal:// pour un utilisateur fédéré. Consultez la section Identifiants de comptes principaux.

Accorder l'accès à l'agent de service

Pour permettre à l'agent de service de générer un jeton d'accès à partir du compte de service géré par l'utilisateur, accordez à l'agent de service l'accès au compte de service géré par l'utilisateur, puis attribuez-lui le rôle Créateur de jetons du compte de service (roles/iam.serviceAccountTokenCreator).

Vous avez besoin de l'adresse e-mail de l'agent de service pour lui accorder l'accès. Appelez googleServiceAccounts.get pour l'ID de projet que vous utilisez pour gérer le service de transfert de stockage :

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storagetransfer./v1/googleServiceAccounts/PROJECT_ID"

Vous pouvez également accéder à la page de référence googleServiceAccounts.get, saisir votre ID de projet sous Paramètres de requête dans le panneau Essayer cette méthode, puis cliquer sur Exécuter.

L'adresse e-mail de votre agent de service est renvoyée en tant que valeur de accountEmail. Il utilise le format project-PROJECT_NUMBER@storage-transfer-service..

Ensuite, pour accorder à l'agent de service l'accès au compte de service géré par l'utilisateur :

Console Google Cloud

  1. Dans la console Google Cloud , accédez à la page Comptes de service.

    Accéder à la page "Comptes de service"

  2. Sélectionnez un projet.

  3. Cliquez sur l'adresse e-mail du compte de service géré par l'utilisateur.

  4. Sélectionnez l'onglet Comptes principaux avec accès.

  5. Cliquez sur  Accorder l'accès.

  6. Saisissez l'adresse e-mail de l'agent de service.

  7. Dans la liste déroulante Rôle, sélectionnez Créateur de jetons du compte de service.

  8. Cliquez sur Enregistrer. Le rôle est attribué au compte principal sur le compte de service.

gcloud

Pour attribuer un rôle à un compte principal, exécutez la commande add-iam-policy-binding :

gcloud iam service-accounts add-iam-policy-binding USER_MANAGED_SERVICE_ACCOUNT_EMAIL \
  --member=serviceAccount:SERVICE_AGENT_EMAIL --role=roles/iam.serviceAccountTokenCreator

Remplacez les variables suivantes :

  • USER_MANAGED_SERVICE_ACCOUNT_EMAIL : adresse e-mail du compte de service géré par l'utilisateur, au format SA_NAME@PROJECT_ID..
  • SERVICE_AGENT_EMAIL : adresse e-mail de l'agent de service.

Accorder des autorisations de bucket au compte de service géré par l'utilisateur

Accordez les autorisations listées dans Configurer l'accès à une source : Cloud Storage et Configurer l'accès à un récepteur : Cloud Storage au compte de service géré par l'utilisateur, plutôt qu'à l'agent de service.

Créer un job de transfert à l'aide d'un compte de service géré par l'utilisateur

Une fois que vous avez accordé les autorisations appropriées, vous pouvez spécifier le compte de service géré par l'utilisateur lors de la création d'un job de transfert.

Console Google Cloud

Suivez les instructions pour créer un transfert. Avant de finaliser le job de transfert :

  1. Sur la page Choisir les paramètres, recherchez la section Type de compte de service.
  2. Sélectionnez Compte de service géré par l'utilisateur.
  3. Saisissez l'adresse e-mail du compte de service géré par l'utilisateur au format SERVICE_ACCOUNT_NAME@PROJECT_ID..
  4. Cliquez sur Créer pour créer la tâche de transfert.

API REST

Spécifiez le compte de service géré par l'utilisateur comme valeur du champ serviceAccount dans la requête transferJobs.create.

L'adresse e-mail du compte de service (SERVICE_ACCOUNT_NAME@PROJECT_ID.) ou l'identifiant unique (123456789012345678901) sont acceptés.

Exemple :

POST https://storagetransfer./v1/transferJobs
{
"description": "A transfer using a user-managed service account for bucket permissions",
"status": "ENABLED",
"projectId": "PROJECT_ID",
"serviceAccount": "SERVICE_ACCOUNT_NAME@PROJECT_ID.",
"transferSpec": {
  // ...
}
}

Récupérer l'identifiant unique d'un compte de service

Lorsque vous configurez l'accès fédéré à AWS S3 ou au stockage Microsoft Azure, ou que vous spécifiez un compte de service dans les requêtes API REST, vous pouvez avoir besoin de l'ID unique de votre compte de service géré par l'utilisateur.

Pour récupérer l'uniqueId :

Console Google Cloud

  1. Accédez à la page Comptes de service dans la console Google Cloud .

    Accéder à la page "Comptes de service"

  2. Cliquez sur l'adresse e-mail du compte de service.

  3. Dans l'onglet Détails, recherchez l'identifiant unique.

gcloud CLI

Utilisez la commande Google Cloud CLI suivante :

gcloud iam service-accounts describe USER_MANAGED_SERVICE_ACCOUNT_EMAIL \
  --format='value(uniqueId)'