Gérer les pools d'identités de charge de travail et les fournisseurs

La fédération d'identité de charge de travail vous permet d'accorder aux charges de travail externes l'accès aux ressourcesGoogle Cloud via des pools d'identités de charge de travail et des fournisseurs d'identité connectés. Si vos besoins évoluent, vous pouvez créer, afficher, mettre à jour, supprimer ou annuler la suppression de pools et de fournisseurs à l'aide de la consoleGoogle Cloud , de la Google Cloud CLI ou de l'API REST.

Avant de commencer

Créez un pool d'identités de charge de travail. Pour obtenir des instructions, consultez les guides de configuration de la fédération d'identité de charge de travail.

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer les pools et fournisseurs d'identités de charge de travail, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ces rôles prédéfinis contiennent les autorisations requises pour gérer les pools et fournisseurs d'identités de charge de travail. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour gérer les pools et les fournisseurs d'identités de charge de travail :

  • Pour afficher les pools et fournisseurs d'identités de charge de travail :
    • iam.googleapis.com/workloadIdentityPoolProviders.get
    • iam.googleapis.com/workloadIdentityPoolProviders.list
    • iam.googleapis.com/workloadIdentityPools.get
    • iam.googleapis.com/workloadIdentityPools.list
  • Pour créer, mettre à jour et supprimer des pools et des fournisseurs :
    • iam.googleapis.com/workloadIdentityPoolProviders.create
    • iam.googleapis.com/workloadIdentityPoolProviders.delete
    • iam.googleapis.com/workloadIdentityPoolProviders.undelete
    • iam.googleapis.com/workloadIdentityPoolProviders.update
    • iam.googleapis.com/workloadIdentityPools.create
    • iam.googleapis.com/workloadIdentityPools.delete
    • iam.googleapis.com/workloadIdentityPools.undelete
    • iam.googleapis.com/workloadIdentityPools.update

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Gérer les pools d'identités de charge de travail

Cette section explique comment gérer les pools d'identités de charge de travail.

Créer des pools

Pour créer des pools d'identités de charge de travail dans un projet, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Nouveau fournisseur et pool de charges de travail.

    Accéder au nouveau fournisseur de charges de travail et au pool

  2. Dans la section Créer un pool d'identités, saisissez un nom pour le pool.

    La console Google Cloud utilise ce nom pour créer l'ID du pool. Pour modifier l'ID du pool, cliquez sur Modifier. Vous ne pourrez pas modifier l'ID du pool par la suite.

  3. Facultatif : Dans le champ Description, saisissez une description du pool.
  4. Facultatif : Pour créer le pool à l'état "Désactivé", cliquez sur le bouton Pool activé.
  5. Cliquez sur Continuer.
  6. Dans les sections Ajouter un fournisseur au pool et Configurer les attributs du fournisseur, configurez un fournisseur d'identité pour le pool. Pour obtenir des instructions, consultez Créer un fournisseur.
  7. Cliquez sur Enregistrer.

gcloud

La commande gcloud iam workload-identity-pools create crée un pool d'identités de charge de travail dans un projet.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • POOL_ID : Identifiant unique du pool d'identités de charge de travail (par exemple, my-pool). Doit comporter entre 4 et 32 caractères alphanumériques minuscules ou traits d'union, et ne peut pas commencer par gcp-.
  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • DISPLAY_NAME : facultatif. Nom à afficher pour le pool d'identités de charge de travail, d'une longueur maximale de 32 caractères (par exemple, My workload pool).
  • DESCRIPTION : facultatif. Description du pool d'identités de charge de travail, jusqu'à 256 caractères.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud iam workload-identity-pools create POOL_ID \
    --project=PROJECT_ID \
    --location="global" \
    --display-name="DISPLAY_NAME" \
    --description="DESCRIPTION"

Windows (PowerShell)

gcloud iam workload-identity-pools create POOL_ID `
    --project=PROJECT_ID `
    --location="global" `
    --display-name="DISPLAY_NAME" `
    --description="DESCRIPTION"

Windows (cmd.exe)

gcloud iam workload-identity-pools create POOL_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --display-name="DISPLAY_NAME" ^
    --description="DESCRIPTION"

Vous devriez obtenir un résultat semblable à celui-ci :

Create request issued for: [my-pool]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef] to complete...done.
Created workloadIdentityPool [my-pool].

REST

La méthode projects.locations.workloadIdentityPools.create crée un pool d'identités de charge de travail dans un projet.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • POOL_ID : Identifiant unique du pool d'identités de charge de travail (par exemple, my-pool). Doit comporter entre 4 et 32 caractères alphanumériques minuscules ou traits d'union, et ne peut pas commencer par gcp-.
  • DISPLAY_NAME : facultatif. Nom à afficher pour le pool d'identités de charge de travail, d'une longueur maximale de 32 caractères (par exemple, My workload pool).
  • DESCRIPTION : facultatif. Description du pool d'identités de charge de travail, jusqu'à 256 caractères.

Méthode HTTP et URL :

POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools?workloadIdentityPoolId=POOL_ID

Corps JSON de la requête :

{
  "displayName": "DISPLAY_NAME",
  "description": "DESCRIPTION"
}

Pour envoyer votre requête, développez l'une des options suivantes :

La réponse contient une opération de longue durée qui représente votre requête. Pour vérifier si la création du pool est terminée, consultez la section Vérifier l'état d'une opération de longue durée sur cette page.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": false
}

Répertorier les pools

Pour répertorier tous les pools d'identités de charge de travail d'un projet, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Pools d'identités de charge de travail.

    Accéder aux pools d'identité de charge de travail

  2. Dans le tableau, affichez la liste des pools d'identités de charge de travail.
  3. Facultatif : Pour inclure les pools et les fournisseurs supprimés dans la liste, cliquez sur le bouton Afficher les pools et fournisseurs supprimés.

gcloud

La commande gcloud iam workload-identity-pools list liste les pools d'identités de charge de travail d'un projet.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project. Pour inclure les pools supprimés de façon réversible dans le résultat, ajoutez l'option --show-deleted.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud iam workload-identity-pools list \
    --project=PROJECT_ID \
    --location="global" \
    --format="json"

Windows (PowerShell)

gcloud iam workload-identity-pools list `
    --project=PROJECT_ID `
    --location="global" `
    --format="json"

Windows (cmd.exe)

gcloud iam workload-identity-pools list ^
    --project=PROJECT_ID ^
    --location="global" ^
    --format="json"

Vous devriez obtenir un résultat semblable à celui-ci :

[
  {
    "description": "Workload identity pool for external workloads.",
    "displayName": "My workload pool",
    "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
    "state": "ACTIVE"
  }
]

REST

La méthode projects.locations.workloadIdentityPools.list répertorie les pools d'identités de charge de travail d'un projet.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project. Pour inclure les pools supprimés de façon réversible dans la réponse, ajoutez ?showDeleted=true à l'URL de la requête.

Méthode HTTP et URL :

GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "workloadIdentityPools": [
    {
      "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
      "displayName": "My workload pool",
      "description": "Workload identity pool for external workloads.",
      "state": "ACTIVE"
    }
  ]
}

Obtenir un pool

Pour obtenir des détails sur un pool d'identités de charge de travail spécifique, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Pools d'identités de charge de travail.

    Accéder aux pools d'identité de charge de travail

  2. Recherchez le pool d'identités de charge de travail que vous souhaitez afficher, puis cliquez sur son nom à afficher. La console Google Cloud affiche les détails du pool d'identités de charge de travail.

gcloud

La commande gcloud iam workload-identity-pools describe permet d'obtenir des détails sur un pool d'identités de charge de travail.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • POOL_ID : ID du pool d'identités de charge de travail (par exemple, my-pool).
  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud iam workload-identity-pools describe POOL_ID \
    --project=PROJECT_ID \
    --location="global" \
    --format="json"

Windows (PowerShell)

gcloud iam workload-identity-pools describe POOL_ID `
    --project=PROJECT_ID `
    --location="global" `
    --format="json"

Windows (cmd.exe)

gcloud iam workload-identity-pools describe POOL_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --format="json"

Vous devriez obtenir un résultat semblable à celui-ci :

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
  "displayName": "My workload pool",
  "description": "Workload identity pool for external workloads.",
  "state": "ACTIVE"
}

REST

La méthode projects.locations.workloadIdentityPools.get permet d'obtenir des informations sur un pool d'identités de charge de travail.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • POOL_ID : ID du pool d'identités de charge de travail (par exemple, my-pool).

Méthode HTTP et URL :

GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
  "displayName": "My workload pool",
  "description": "Workload identity pool for external workloads.",
  "state": "ACTIVE"
}

Mettre à jour un pool

Vous pouvez activer ou désactiver un pool d'identités de charge de travail. Vous pouvez également modifier son nom à afficher ou sa description.

Pour mettre à jour un pool d'identités de charge de travail existant, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Pools d'identités de charge de travail.

    Accéder aux pools d'identité de charge de travail

  2. Recherchez le pool d'identités de charge de travail que vous souhaitez modifier.
  3. Cliquez sur le nom à afficher du pool d'identités de charge de travail.
  4. Pour modifier le nom à afficher du pool d'identités de charge de travail, procédez comme suit :

    1. Sur la page Détails du pool, à côté du nom à afficher, cliquez sur l'icône Modifier.
    2. Dans la boîte de dialogue Modifier le nom à afficher du pool qui s'affiche, modifiez le nom à afficher.
    3. Cliquez sur Enregistrer.
  5. Pour désactiver ou activer le pool d'identités de charge de travail, cliquez sur le bouton État, puis sur Désactiver ou Activer.
  6. Pour modifier la description, procédez comme suit :

    1. Dans Description, à côté du texte de votre description, cliquez sur  Modifier.
    2. Mettez à jour la description.
    3. Cliquez sur Enregistrer.

gcloud

La commande gcloud iam workload-identity-pools update met à jour un pool d'identités de charge de travail existant.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • POOL_ID : ID du pool d'identités de charge de travail (par exemple, my-pool).
  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • DISPLAY_NAME : nom à afficher pour le pool d'identités de charge de travail, d'une longueur maximale de 32 caractères (par exemple, My updated pool).
  • DESCRIPTION : description du pool d'identités de charge de travail, d'une longueur maximale de 256 caractères. Pour désactiver ou activer le pool, transmettez également l'option --disabled ou --no-disabled.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud iam workload-identity-pools update POOL_ID \
    --project=PROJECT_ID \
    --location="global" \
    --display-name="DISPLAY_NAME" \
    --description="DESCRIPTION"

Windows (PowerShell)

gcloud iam workload-identity-pools update POOL_ID `
    --project=PROJECT_ID `
    --location="global" `
    --display-name="DISPLAY_NAME" `
    --description="DESCRIPTION"

Windows (cmd.exe)

gcloud iam workload-identity-pools update POOL_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --display-name="DISPLAY_NAME" ^
    --description="DESCRIPTION"

Vous devriez obtenir un résultat semblable à celui-ci :

Update request issued for: [my-pool]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000001-0123456789abcdef] to complete...done.
Updated workloadIdentityPool [my-pool].

REST

La méthode projects.locations.workloadIdentityPools.patch met à jour un pool d'identités de charge de travail existant.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • POOL_ID : ID du pool d'identités de charge de travail (par exemple, my-pool).
  • UPDATE_MASK : liste de champs à mettre à jour, séparés par une virgule (par exemple, displayName,description,disabled).
  • DISPLAY_NAME : nom à afficher pour le pool d'identités de charge de travail, d'une longueur maximale de 32 caractères (par exemple, My updated pool).
  • DESCRIPTION : description du pool d'identités de charge de travail, d'une longueur maximale de 256 caractères.
  • DISABLED : indique si le pool est désactivé. Définissez cette option sur true pour désactiver le pool ou sur false pour l'activer.

Méthode HTTP et URL :

PATCH https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID?updateMask=UPDATE_MASK

Corps JSON de la requête :

{
  "displayName": "DISPLAY_NAME",
  "description": "DESCRIPTION",
  "disabled": DISABLED
}

Pour envoyer votre requête, développez l'une des options suivantes :

La réponse contient une opération de longue durée qui représente votre requête. Pour vérifier si la mise à jour du pool est terminée, consultez la section Vérifier l'état d'une opération de longue durée sur cette page.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000001-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": false
}

Supprimer un pool

Lorsque vous supprimez un pool d'identités de charge de travail, vous supprimez également ses fournisseurs de pools d'identités de charge de travail. Par conséquent, les identités du pool perdent l'accès aux ressourcesGoogle Cloud .

Vous pouvez annuler la suppression d'un pool pendant un maximum de 30 jours. Passé ce délai, la suppression est définitive. Tant qu'un pool n'est pas définitivement supprimé, vous ne pouvez pas réutiliser son nom lors de la création d'un pool d'identités de charge de travail.

Pour supprimer un pool d'identités de charge de travail et ses IdP, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Pools d'identités de charge de travail.

    Accéder aux pools d'identité de charge de travail

  2. Recherchez le pool d'identités de charge de travail que vous souhaitez supprimer, puis cliquez sur son nom à afficher.
  3. Cliquez sur Supprimer le pool, puis sur Supprimer. Le pool d'identités de charge de travail et ses IdP sont supprimés.

gcloud

La commande gcloud iam workload-identity-pools delete supprime un pool d'identités de charge de travail.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • POOL_ID : ID du pool d'identités de charge de travail à supprimer (par exemple, my-pool).
  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud iam workload-identity-pools delete POOL_ID \
    --project=PROJECT_ID \
    --location="global"

Windows (PowerShell)

gcloud iam workload-identity-pools delete POOL_ID `
    --project=PROJECT_ID `
    --location="global"

Windows (cmd.exe)

gcloud iam workload-identity-pools delete POOL_ID ^
    --project=PROJECT_ID ^
    --location="global"

Vous devriez obtenir un résultat semblable à celui-ci :

Delete request issued for: [my-pool]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000002-0123456789abcdef] to complete...done.
Deleted workloadIdentityPool [my-pool].

REST

La méthode projects.locations.workloadIdentityPools.delete supprime un pool d'identités de charge de travail.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • POOL_ID : ID du pool d'identités de charge de travail à supprimer (par exemple, my-pool).

Méthode HTTP et URL :

DELETE https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID

Pour envoyer votre requête, développez l'une des options suivantes :

La réponse contient une opération de longue durée qui représente votre requête. Pour vérifier si la suppression du pool est terminée, consultez la section Vérifier l'état d'une opération de longue durée sur cette page.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000002-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": false
}

Annuler la suppression d'un pool

Vous pouvez récupérer un pool d'identité de charge de travail supprimé pendant un maximum de 30 jours.

Pour annuler la suppression d'un pool, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Pools d'identités de charge de travail.

    Accéder aux pools d'identité de charge de travail

  2. Cliquez sur le bouton Afficher les pools et les fournisseurs supprimés.
  3. Recherchez le pool d'identités de charge de travail dont vous souhaitez annuler la suppression, puis cliquez sur l'icône Restaurer.
  4. Cliquez sur Restaurer. Le pool et ses fournisseurs sont restaurés.

gcloud

La commande gcloud iam workload-identity-pools undelete restaure un pool d'identités de charge de travail supprimé de façon réversible.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • POOL_ID : ID du pool d'identités de charge de travail supprimé à restaurer (par exemple, my-pool).
  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud iam workload-identity-pools undelete POOL_ID \
    --project=PROJECT_ID \
    --location="global"

Windows (PowerShell)

gcloud iam workload-identity-pools undelete POOL_ID `
    --project=PROJECT_ID `
    --location="global"

Windows (cmd.exe)

gcloud iam workload-identity-pools undelete POOL_ID ^
    --project=PROJECT_ID ^
    --location="global"

Vous devriez obtenir un résultat semblable à celui-ci :

Undelete request issued for: [my-pool]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000003-0123456789abcdef] to complete...done.
Undeleted workloadIdentityPool [my-pool].

REST

La méthode projects.locations.workloadIdentityPools.undelete restaure un pool d'identités de charge de travail supprimé de façon réversible.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • POOL_ID : ID du pool d'identités de charge de travail supprimé à restaurer (par exemple, my-pool).

Méthode HTTP et URL :

POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID:undelete

Corps JSON de la requête :

{}

Pour envoyer votre requête, développez l'une des options suivantes :

La réponse contient une opération de longue durée qui représente votre requête. Pour vérifier si la restauration du pool est terminée, consultez la section Vérifier l'état d'une opération de longue durée sur cette page.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000003-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": false
}

Gérer les fournisseurs de pools d'identités de charge de travail

Cette section explique comment gérer les fournisseurs de pools d'identités de charge de travail.

Créer un fournisseur

Pour créer un fournisseur de pool d'identité de charge de travail dans un pool d'identités de charge de travail existant, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Pools d'identités de charge de travail.

    Accéder aux pools d'identité de charge de travail

  2. Recherchez le pool d'identités de charge de travail auquel vous souhaitez ajouter un fournisseur, puis cliquez sur son nom à afficher.
  3. Cliquez sur Ajouter un fournisseur.
  4. Sélectionnez le type de fournisseur à créer :

    • AWS : un IdP Amazon Web Services (AWS).
    • OpenID Connect (OIDC) : fournisseur d'identité compatible avec OIDC. y compris un fournisseur Microsoft Azure.
  5. Attribuez un nom au fournisseur.

    La console Google Cloud utilise ce nom pour créer l'ID du fournisseur. Pour modifier l'ID du fournisseur, cliquez sur Modifier. Vous ne pourrez pas modifier l'ID du fournisseur par la suite.

  6. Renseignez les autres champs de votre fournisseur :

    • AWS : saisissez l'identifiant de votre compte AWS.
    • OIDC : saisissez l'URL de l'émetteur. Pour Azure, l'URL de l'émetteur utilise le format https://sts.windows.net/AZURE_TENANT_ID. Pour les autres fournisseurs, consultez la documentation du fournisseur.

    Lorsque vous avez terminé, cliquez sur Continuer.

  7. Pour configurer le mappage d'attributs, cliquez sur Modifier le mappage. Le mappage d'attributs vous permet d'utiliser des informations sur les identités externes pour accorder l'accès à un sous-ensemble de ces identités.

  8. Facultatif : pour fournir une condition d'attribut, qui spécifie les identités pouvant s'authentifier, cliquez sur Ajouter une condition et saisissez une expression CEL (Common Expression Language) valide. Pour en savoir plus, consultez Conditions d'attribut.
  9. Cliquez sur Enregistrer. Le fournisseur du pool d'identités de charge de travail est créé.

gcloud

Créer un fournisseur AWS

La commande gcloud iam workload-identity-pools providers create-aws crée un fournisseur de pool d'identités de charge de travail AWS.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • PROVIDER_ID : Identifiant unique pour le fournisseur, par exemple my-aws-provider. Doit comporter entre 4 et 32 caractères alphanumériques minuscules ou traits d'union, et ne peut pas commencer par gcp-.
  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • POOL_ID : ID du pool d'identités de charge de travail auquel ajouter le fournisseur, par exemple my-pool.
  • DISPLAY_NAME : facultatif. Nom à afficher pour le fournisseur, d'une longueur maximale de 32 caractères (par exemple, My AWS provider).
  • AWS_ACCOUNT_ID : votre ID de compte AWS à 12 chiffres, par exemple 123456789012.
  • ATTRIBUTE_CONDITION : facultatif. Expression CEL (Common Expression Language) qui limite les identités pouvant s'authentifier (par exemple, attribute.aws_role == 'arn:aws:sts::123456789012:assumed-role/my-role').

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud iam workload-identity-pools providers create-aws PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --display-name="DISPLAY_NAME" \
    --account-id="AWS_ACCOUNT_ID" \
    --attribute-condition="ATTRIBUTE_CONDITION"

Windows (PowerShell)

gcloud iam workload-identity-pools providers create-aws PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --display-name="DISPLAY_NAME" `
    --account-id="AWS_ACCOUNT_ID" `
    --attribute-condition="ATTRIBUTE_CONDITION"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers create-aws PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --display-name="DISPLAY_NAME" ^
    --account-id="AWS_ACCOUNT_ID" ^
    --attribute-condition="ATTRIBUTE_CONDITION"

Vous devriez obtenir un résultat semblable à celui-ci :

Create request issued for: [my-aws-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000010-0123456789abcdef] to complete...done.
Created workloadIdentityPoolProvider [my-aws-provider].

Créer un fournisseur OIDC

La commande gcloud iam workload-identity-pools providers create-oidc crée un fournisseur de pools d'identités de charge de travail OIDC.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • PROVIDER_ID : Identifiant unique pour le fournisseur, par exemple my-oidc-provider. Doit comporter entre 4 et 32 caractères alphanumériques minuscules ou traits d'union, et ne peut pas commencer par gcp-.
  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • POOL_ID : ID du pool d'identités de charge de travail auquel ajouter le fournisseur, par exemple my-pool.
  • DISPLAY_NAME : facultatif. Nom à afficher pour le fournisseur, d'une longueur maximale de 32 caractères (par exemple, My OIDC provider).
  • ISSUER_URI : URL HTTPS de l'émetteur OIDC, par exemple https://idp.example.com ou https://sts.windows.net/AZURE_TENANT_ID.
  • DISCOVERY_URI : Facultatif. URL à partir de laquelle récupérer le document de découverte OIDC, en remplaçant l'URL ISSUER_URI/.well-known/openid-configuration par défaut (par exemple, https://idp.example.com/.well-known/custom-openid-configuration). Le schéma, l'hôte et le port doivent correspondre à ISSUER_URI, et le chemin d'accès doit contenir un segment /.well-known/ suivi d'un suffixe non vide.
  • ATTRIBUTE_CONDITION : facultatif. Expression CEL (Common Expression Language) qui limite les identités pouvant s'authentifier (par exemple, assertion.sub.startsWith('repo:my-org/')).
  • ACTOR_PROVIDERS : Facultatif. Noms complets des ressources de trois fournisseurs de pools d'identités de charge de travail maximum dans le même pool, autorisés à émettre des jetons d'acteur pour ce fournisseur (par exemple, projects/my-project/locations/global/workloadIdentityPools/my-pool/providers/my-actor-provider). L'identifiant de projet dans chaque nom de ressource doit correspondre au format d'ID du projet ou de numéro de projet que vous utilisez pour ce fournisseur. Pour en savoir plus, consultez Configurer la délégation d'identité et les jetons d'acteur.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --display-name="DISPLAY_NAME" \
    --issuer-uri="ISSUER_URI" \
    --discovery-uri="DISCOVERY_URI" \
    --attribute-mapping="google.subject=assertion.sub" \
    --attribute-condition="ATTRIBUTE_CONDITION" \
    --actor-providers="ACTOR_PROVIDERS"

Windows (PowerShell)

gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --display-name="DISPLAY_NAME" `
    --issuer-uri="ISSUER_URI" `
    --discovery-uri="DISCOVERY_URI" `
    --attribute-mapping="google.subject=assertion.sub" `
    --attribute-condition="ATTRIBUTE_CONDITION" `
    --actor-providers="ACTOR_PROVIDERS"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --display-name="DISPLAY_NAME" ^
    --issuer-uri="ISSUER_URI" ^
    --discovery-uri="DISCOVERY_URI" ^
    --attribute-mapping="google.subject=assertion.sub" ^
    --attribute-condition="ATTRIBUTE_CONDITION" ^
    --actor-providers="ACTOR_PROVIDERS"

Vous devriez obtenir un résultat semblable à celui-ci :

Create request issued for: [my-oidc-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000011-0123456789abcdef] to complete...done.
Created workloadIdentityPoolProvider [my-oidc-provider].

REST

Créer un fournisseur AWS

La méthode projects.locations.workloadIdentityPools.providers.create crée un fournisseur de pool d'identités de charge de travail AWS.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • POOL_ID : ID du pool d'identités de charge de travail auquel ajouter le fournisseur, par exemple my-pool.
  • PROVIDER_ID : Identifiant unique pour le fournisseur, par exemple my-aws-provider. Doit comporter entre 4 et 32 caractères alphanumériques minuscules ou traits d'union, et ne peut pas commencer par gcp-.
  • DISPLAY_NAME : facultatif. Nom à afficher pour le fournisseur, d'une longueur maximale de 32 caractères (par exemple, My AWS provider).
  • AWS_ACCOUNT_ID : votre ID de compte AWS à 12 chiffres, par exemple 123456789012.
  • ATTRIBUTE_CONDITION : facultatif. Expression CEL (Common Expression Language) qui limite les identités pouvant s'authentifier (par exemple, attribute.aws_role == 'arn:aws:sts::123456789012:assumed-role/my-role').

Méthode HTTP et URL :

POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers?workloadIdentityPoolProviderId=PROVIDER_ID

Corps JSON de la requête :

{
  "displayName": "DISPLAY_NAME",
  "aws": {
    "accountId": "AWS_ACCOUNT_ID"
  },
  "attributeCondition": "ATTRIBUTE_CONDITION"
}

Pour envoyer votre requête, développez l'une des options suivantes :

La réponse contient une opération de longue durée qui représente votre requête. Pour vérifier si la création du fournisseur est terminée, consultez la section Vérifier l'état d'une opération de longue durée sur cette page.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000010-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
  },
  "done": false
}

Créer un fournisseur OIDC

La méthode projects.locations.workloadIdentityPools.providers.create crée un fournisseur de pools d'identités de charge de travail OIDC.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • POOL_ID : ID du pool d'identités de charge de travail auquel ajouter le fournisseur, par exemple my-pool.
  • PROVIDER_ID : Identifiant unique pour le fournisseur, par exemple my-oidc-provider. Doit comporter entre 4 et 32 caractères alphanumériques minuscules ou traits d'union, et ne peut pas commencer par gcp-.
  • DISPLAY_NAME : facultatif. Nom à afficher pour le fournisseur, d'une longueur maximale de 32 caractères (par exemple, My OIDC provider).
  • ISSUER_URI : URL HTTPS de l'émetteur OIDC, par exemple https://idp.example.com ou https://sts.windows.net/AZURE_TENANT_ID.
  • DISCOVERY_URI : Facultatif. URL à partir de laquelle récupérer le document de découverte OIDC, en remplaçant l'URL ISSUER_URI/.well-known/openid-configuration par défaut (par exemple, https://idp.example.com/.well-known/custom-openid-configuration). Le schéma, l'hôte et le port doivent correspondre à ISSUER_URI, et le chemin d'accès doit contenir un segment /.well-known/ suivi d'un suffixe non vide.
  • ATTRIBUTE_CONDITION : facultatif. Expression CEL (Common Expression Language) qui limite les identités pouvant s'authentifier (par exemple, assertion.sub.startsWith('repo:my-org/')).
  • ACTOR_PROVIDERS : Facultatif. Noms complets des ressources de trois fournisseurs de pools d'identités de charge de travail maximum dans le même pool, autorisés à émettre des jetons d'acteur pour ce fournisseur (par exemple, projects/my-project/locations/global/workloadIdentityPools/my-pool/providers/my-actor-provider). L'identifiant de projet dans chaque nom de ressource doit correspondre au format d'ID du projet ou de numéro de projet que vous utilisez pour ce fournisseur. Pour en savoir plus, consultez Configurer la délégation d'identité et les jetons d'acteur.

Méthode HTTP et URL :

POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers?workloadIdentityPoolProviderId=PROVIDER_ID

Corps JSON de la requête :

{
  "displayName": "DISPLAY_NAME",
  "oidc": {
    "issuerUri": "ISSUER_URI",
    "discoveryUri": "DISCOVERY_URI"
  },
  "attributeMapping": {
    "google.subject": "assertion.sub"
  },
  "attributeCondition": "ATTRIBUTE_CONDITION",
  "actorProviders": [
    "ACTOR_PROVIDERS"
  ]
}

Pour envoyer votre requête, développez l'une des options suivantes :

La réponse contient une opération de longue durée qui représente votre requête. Pour vérifier si la création du fournisseur est terminée, consultez la section Vérifier l'état d'une opération de longue durée sur cette page.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000011-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
  },
  "done": false
}

Répertorier les fournisseurs

Pour répertorier les fournisseurs de pools d'identités de charge de travail d'un projet, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Pools d'identités de charge de travail.

    Accéder aux pools d'identité de charge de travail

  2. Pour afficher les fournisseurs d'un pool d'identités de charge de travail, cliquez sur l'icône Développer le nœud du pool.

gcloud

La commande gcloud iam workload-identity-pools providers list liste les fournisseurs d'un pool d'identités de charge de travail.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • POOL_ID : ID du pool d'identités de charge de travail dont vous souhaitez lister les fournisseurs (par exemple, my-pool). Pour inclure les fournisseurs supprimés de façon réversible dans la sortie, ajoutez l'option --show-deleted.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud iam workload-identity-pools providers list \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --format="json"

Windows (PowerShell)

gcloud iam workload-identity-pools providers list `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --format="json"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers list ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --format="json"

Vous devriez obtenir un résultat semblable à celui-ci :

[
  {
    "attributeMapping": {
      "google.subject": "assertion.sub"
    },
    "displayName": "My OIDC provider",
    "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
    "oidc": {
      "issuerUri": "https://idp.example.com"
    },
    "state": "ACTIVE"
  }
]

REST

La méthode projects.locations.workloadIdentityPools.providers.list liste les fournisseurs d'un pool d'identités de charge de travail.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • POOL_ID : ID du pool d'identités de charge de travail dont vous souhaitez lister les fournisseurs (par exemple, my-pool). Pour inclure les fournisseurs supprimés de façon réversible dans la réponse, ajoutez ?showDeleted=true à l'URL de la requête.

Méthode HTTP et URL :

GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "workloadIdentityPoolProviders": [
    {
      "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
      "displayName": "My OIDC provider",
      "state": "ACTIVE",
      "attributeMapping": {
        "google.subject": "assertion.sub"
      },
      "oidc": {
        "issuerUri": "https://idp.example.com"
      }
    }
  ]
}

Obtenir un fournisseur

Pour obtenir des détails sur un fournisseur de pool d'identité de charge de travail spécifique, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Pools d'identités de charge de travail.

    Accéder aux pools d'identité de charge de travail

  2. Recherchez le pool d'identités de charge de travail qui contient le fournisseur, puis cliquez sur l'icône Développer le nœud pour le pool.
  3. Recherchez le fournisseur du pool d'identités de charge de travail que vous souhaitez afficher, puis cliquez sur l'icône Modifier. La console Google Cloud affiche des informations détaillées sur le fournisseur.

gcloud

La commande gcloud iam workload-identity-pools providers describe permet d'obtenir des informations sur un fournisseur de pool d'identités de charge de travail.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • PROVIDER_ID : ID du fournisseur du pool d'identités de charge de travail, par exemple my-oidc-provider.
  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • POOL_ID : ID du pool d'identités de charge de travail contenant le fournisseur, par exemple my-pool.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud iam workload-identity-pools providers describe PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --format="json"

Windows (PowerShell)

gcloud iam workload-identity-pools providers describe PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --format="json"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers describe PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --format="json"

Vous devriez obtenir un résultat semblable à celui-ci :

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
  "displayName": "My OIDC provider",
  "state": "ACTIVE",
  "attributeMapping": {
    "google.subject": "assertion.sub"
  },
  "oidc": {
    "issuerUri": "https://idp.example.com"
  }
}

REST

La méthode projects.locations.workloadIdentityPools.providers.get permet d'obtenir des informations sur un fournisseur de pool d'identités de charge de travail.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • POOL_ID : ID du pool d'identités de charge de travail contenant le fournisseur, par exemple my-pool.
  • PROVIDER_ID : ID du fournisseur du pool d'identités de charge de travail, par exemple my-oidc-provider.

Méthode HTTP et URL :

GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
  "displayName": "My OIDC provider",
  "state": "ACTIVE",
  "attributeMapping": {
    "google.subject": "assertion.sub"
  },
  "oidc": {
    "issuerUri": "https://idp.example.com"
  }
}

Mettre à jour un fournisseur

Vous pouvez activer ou désactiver un fournisseur de pools d'identités de charge de travail. Vous pouvez également mettre à jour les informations de son compte et son mappage d'attributs, ainsi que son nom à afficher et sa description.

Pour mettre à jour un fournisseur de pool d'identité de charge de travail existant, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Pools d'identités de charge de travail.

    Accéder aux pools d'identité de charge de travail

  2. Recherchez le pool d'identités de charge de travail qui contient le fournisseur, puis cliquez sur l'icône Développer le nœud pour le pool.

  3. Recherchez le fournisseur du pool d'identités de charge de travail que vous souhaitez modifier, puis cliquez sur l'icône Modifier.

  4. Modifiez les informations relatives au fournisseur, puis cliquez sur Enregistrer.

gcloud

Mettre à jour un fournisseur AWS

La commande gcloud iam workload-identity-pools providers update-aws met à jour un fournisseur de pool d'identités de charge de travail AWS existant.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • PROVIDER_ID : ID du fournisseur à mettre à jour (par exemple, my-aws-provider).
  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • POOL_ID : ID du pool d'identités de charge de travail contenant le fournisseur, par exemple my-pool.
  • DISPLAY_NAME : nom à afficher pour le fournisseur, d'une longueur maximale de 32 caractères (par exemple, Updated AWS provider).
  • DESCRIPTION : description du fournisseur, jusqu'à 256 caractères. Pour désactiver ou activer le fournisseur, transmettez également l'option --disabled ou --no-disabled.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud iam workload-identity-pools providers update-aws PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --display-name="DISPLAY_NAME" \
    --description="DESCRIPTION"

Windows (PowerShell)

gcloud iam workload-identity-pools providers update-aws PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --display-name="DISPLAY_NAME" `
    --description="DESCRIPTION"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers update-aws PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --display-name="DISPLAY_NAME" ^
    --description="DESCRIPTION"

Vous devriez obtenir un résultat semblable à celui-ci :

Update request issued for: [my-aws-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000012-0123456789abcdef] to complete...done.
Updated workloadIdentityPoolProvider [my-aws-provider].

Mettre à jour un fournisseur OIDC

La commande gcloud iam workload-identity-pools providers update-oidc met à jour un fournisseur de pool d'identités de charge de travail AWS existant.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • PROVIDER_ID : ID du fournisseur OIDC à mettre à jour (par exemple, my-oidc-provider).
  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • POOL_ID : ID du pool d'identités de charge de travail contenant le fournisseur, par exemple my-pool.
  • DISPLAY_NAME : nom à afficher pour le fournisseur, d'une longueur maximale de 32 caractères (par exemple, Updated OIDC provider).
  • DESCRIPTION : description du fournisseur, jusqu'à 256 caractères.
  • ISSUER_URI : URL HTTPS de l'émetteur OIDC, par exemple https://idp.example.com. Pour désactiver ou activer le fournisseur, transmettez également l'option --disabled ou --no-disabled.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud iam workload-identity-pools providers update-oidc PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --display-name="DISPLAY_NAME" \
    --description="DESCRIPTION" \
    --issuer-uri="ISSUER_URI"

Windows (PowerShell)

gcloud iam workload-identity-pools providers update-oidc PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --display-name="DISPLAY_NAME" `
    --description="DESCRIPTION" `
    --issuer-uri="ISSUER_URI"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers update-oidc PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --display-name="DISPLAY_NAME" ^
    --description="DESCRIPTION" ^
    --issuer-uri="ISSUER_URI"

Vous devriez obtenir un résultat semblable à celui-ci :

Update request issued for: [my-oidc-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000013-0123456789abcdef] to complete...done.
Updated workloadIdentityPoolProvider [my-oidc-provider].

REST

La méthode projects.locations.workloadIdentityPools.providers.patch met à jour un fournisseur de pool d'identités de charge de travail existant.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • POOL_ID : ID du pool d'identités de charge de travail contenant le fournisseur, par exemple my-pool.
  • PROVIDER_ID : ID du fournisseur à mettre à jour (par exemple, my-aws-provider).
  • UPDATE_MASK : liste de champs à mettre à jour, séparés par une virgule (par exemple, displayName,description,disabled).
  • DISPLAY_NAME : nom à afficher pour le fournisseur, d'une longueur maximale de 32 caractères (par exemple, Updated AWS provider).
  • DESCRIPTION : description du fournisseur, jusqu'à 256 caractères.
  • DISABLED : indique si le fournisseur est désactivé. Définissez cette option sur true pour désactiver le fournisseur ou sur false pour l'activer.

Méthode HTTP et URL :

PATCH https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID?updateMask=UPDATE_MASK

Corps JSON de la requête :

{
  "displayName": "DISPLAY_NAME",
  "description": "DESCRIPTION",
  "disabled": DISABLED
}

Pour envoyer votre requête, développez l'une des options suivantes :

La réponse contient une opération de longue durée qui représente votre requête. Pour vérifier si la mise à jour du fournisseur est terminée, consultez la section Vérifier l'état d'une opération de longue durée sur cette page.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000012-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
  },
  "done": false
}

Supprimer un fournisseur

Lorsque vous supprimez un fournisseur de pool d'identités de charge de travail, les identités du fournisseur perdent l'accès aux ressources Google Cloud .

Vous pouvez annuler la suppression d'un fournisseur pendant un maximum de 30 jours. Passé ce délai, la suppression est définitive. Tant qu'un fournisseur n'est pas définitivement supprimé, vous ne pouvez pas réutiliser son nom lors de la création d'un autre fournisseur.

Pour supprimer un fournisseur de pools d'identités de charge de travail, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Pools d'identités de charge de travail.

    Accéder aux pools d'identité de charge de travail

  2. Recherchez le pool d'identités de charge de travail qui contient le fournisseur, puis cliquez sur son nom à afficher.

  3. Dans le volet Fournisseurs, recherchez le fournisseur que vous souhaitez supprimer, puis cliquez sur son icône Supprimer.

  4. Cliquez sur Supprimer pour supprimer le fournisseur.

gcloud

La commande gcloud iam workload-identity-pools providers delete supprime un fournisseur de pools d'identités de charge de travail.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • PROVIDER_ID : ID du fournisseur de pool d'identités de charge de travail à supprimer, par exemple my-oidc-provider.
  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • POOL_ID : ID du pool d'identités de charge de travail contenant le fournisseur, par exemple my-pool.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud iam workload-identity-pools providers delete PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID"

Windows (PowerShell)

gcloud iam workload-identity-pools providers delete PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers delete PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID"

Vous devriez obtenir un résultat semblable à celui-ci :

Delete request issued for: [my-oidc-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000014-0123456789abcdef] to complete...done.
Deleted workloadIdentityPoolProvider [my-oidc-provider].

REST

La méthode projects.locations.workloadIdentityPools.providers.delete supprime un fournisseur de pool d'identités de charge de travail.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • POOL_ID : ID du pool d'identités de charge de travail contenant le fournisseur, par exemple my-pool.
  • PROVIDER_ID : ID du fournisseur de pool d'identités de charge de travail à supprimer, par exemple my-oidc-provider.

Méthode HTTP et URL :

DELETE https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID

Pour envoyer votre requête, développez l'une des options suivantes :

La réponse contient une opération de longue durée qui représente votre requête. Pour vérifier si la suppression du fournisseur est terminée, consultez la section Vérifier l'état d'une opération de longue durée sur cette page.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000014-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
  },
  "done": false
}

Annuler la suppression d'un fournisseur

Vous pouvez récupérer un fournisseur de pool d'identités de charge de travail supprimé pendant un maximum de 30 jours. Pour annuler la suppression d'un fournisseur, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Pools d'identités de charge de travail.

    Accéder aux pools d'identité de charge de travail

  2. Cliquez sur le bouton Afficher les pools et les fournisseurs supprimés.

  3. Recherchez le pool d'identités de charge de travail qui contient le fournisseur, puis cliquez sur l'icône Développer le nœud pour le pool.

  4. Recherchez le fournisseur dont vous souhaitez annuler la suppression, puis cliquez sur l'icône Restaurer.

  5. Cliquez sur Restaurer. Le fournisseur est restauré.

gcloud

La commande gcloud iam workload-identity-pools providers undelete restaure un fournisseur de pool d'identités de charge de travail supprimé de façon réversible.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • PROVIDER_ID : ID du fournisseur de pool d'identités de charge de travail supprimé à restaurer (par exemple, my-oidc-provider).
  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • POOL_ID : ID du pool d'identités de charge de travail contenant le fournisseur, par exemple my-pool.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud iam workload-identity-pools providers undelete PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID"

Windows (PowerShell)

gcloud iam workload-identity-pools providers undelete PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers undelete PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID"

Vous devriez obtenir un résultat semblable à celui-ci :

Undelete request issued for: [my-oidc-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000015-0123456789abcdef] to complete...done.
Undeleted workloadIdentityPoolProvider [my-oidc-provider].

REST

La méthode projects.locations.workloadIdentityPools.providers.undelete restaure un fournisseur de pool d'identités de charge de travail supprimé de façon réversible.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID de votre projet Google Cloud . Les ID de projet sont des chaînes alphanumériques, telles que my-project.
  • POOL_ID : ID du pool d'identités de charge de travail contenant le fournisseur, par exemple my-pool.
  • PROVIDER_ID : ID du fournisseur de pool d'identités de charge de travail supprimé à restaurer (par exemple, my-oidc-provider).

Méthode HTTP et URL :

POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID:undelete

Corps JSON de la requête :

{}

Pour envoyer votre requête, développez l'une des options suivantes :

La réponse contient une opération de longue durée qui représente votre requête. Pour vérifier si la restauration du fournisseur est terminée, consultez la section Vérifier l'état d'une opération de longue durée sur cette page.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000015-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
  },
  "done": false
}

Vérifier l'état d'une opération de longue durée

Lorsque vous utilisez l'API REST, toute méthode qui crée, met à jour, supprime ou restaure un pool ou un fournisseur d'identités de charge de travail renvoie une opération de longue durée (LRO). L'opération de longue durée suit l'état de la requête et indique si la modification est terminée.

gcloud

La commande gcloud iam workload-identity-pools operations describe renvoie l'état d'une opération de longue durée.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • OPERATION_NAME : nom complet de la ressource de l'opération à partir du champ name de la réponse d'origine :

    • Opérations de pool : projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/operations/OPERATION_ID
    • Opérations du fournisseur : projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID/operations/OPERATION_ID

    Pour les opérations de fournisseur, exécutez plutôt la commande gcloud iam workload-identity-pools providers operations describe.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud iam workload-identity-pools operations describe OPERATION_NAME

Windows (PowerShell)

gcloud iam workload-identity-pools operations describe OPERATION_NAME

Windows (cmd.exe)

gcloud iam workload-identity-pools operations describe OPERATION_NAME

Vous devriez obtenir un résultat semblable à celui-ci :

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPool",
    "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
    "displayName": "My workload pool",
    "description": "Workload identity pool for external workloads.",
    "state": "ACTIVE"
  }
}

REST

La méthode projects.locations.workloadIdentityPools.operations.get renvoie l'état d'une opération de longue durée.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • OPERATION_NAME : nom complet de la ressource de l'opération à partir du champ name de la réponse d'origine :

    • Opérations de pool : projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/operations/OPERATION_ID
    • Opérations du fournisseur : projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID/operations/OPERATION_ID

Méthode HTTP et URL :

GET https://iam.googleapis.com/v1/OPERATION_NAME

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPool",
    "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
    "displayName": "My workload pool",
    "description": "Workload identity pool for external workloads.",
    "state": "ACTIVE"
  }
}

Si le champ done de l'opération est défini sur false ou s'il est omis, continuez à surveiller son état en récupérant l'opération de manière répétée. Utilisez une temporisation de retransmission exponentielle tronquée pour introduire un délai entre les requêtes. Lorsque le champ done est défini sur true, l'opération est terminée.

Gérer les contraintes pour la fédération d'identité de charge de travail

Vous pouvez utiliser des contraintes relatives aux règles d'administration pour limiter l'utilisation des ressources de votre organisation Google Cloud .

Cette section décrit les contraintes recommandées lors de l'utilisation de la fédération d'identité de charge de travail.

Gérer les IdP autorisés

En tant qu'administrateur de l'organisation, vous pouvez décider avec quels IdP votre organisation est autorisée à se fédérer.

Pour gérer les IdP autorisés, activez la contrainte de liste constraints/iam.workloadIdentityPoolProviders dans la règle d'administration de votre organisation. Cette contrainte spécifie les URI de l'émetteur des fournisseurs autorisés. Vous pouvez utiliser la consoleGoogle Cloud ou Google Cloud CLI pour activer cette contrainte.

Pour n'autoriser que la fédération depuis AWS, créez une seule contrainte avec l'URI https://sts.amazonaws.com. L'exemple suivant montre comment créer cette contrainte à l'aide de gcloud CLI :

gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolProviders \
     https://sts.amazonaws.com --organization=ORGANIZATION_NUMBER

Vous pouvez également spécifier les ID des compte AWS ayant accès à vos ressourcesGoogle Cloud . Pour spécifier les ID de compte, utilisez la contrainte de liste constraints/iam.workloadIdentityPoolAwsAccounts :

gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolAwsAccounts \
    ACCOUNT_ID --organization=ORGANIZATION_NUMBER

Pour autoriser la fédération depuis un seul fournisseur OIDC, créez une seule contrainte avec l'URI du fournisseur (issuer_uri) autorisé. Par exemple, le code suivant n'autorise la fédération qu'à partir d'un locataire Azure spécifique :

gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolProviders \
     https://sts.windows.net/AZURE_TENANT_ID --organization=ORGANIZATION_NUMBER

La fédération à partir d'un IdP SAML est particulière, car les clés publiques utilisées pour valider l'assertion sont fournies lors de la configuration de l'IdP SAML. Par conséquent, il est possible qu'un utilisateur malveillant tente d'importer un document de métadonnées SAML avec l'ID d'entité de l'IdP de votre organisation à l'aide d'une clé publique. Dans ce scénario, la restriction de la fédération à l'aide d'un ID d'entité ne représente qu'une illusion de sécurité.

Pour atténuer ce risque, nous vous conseillons vivement de n'autoriser la création d'un pool d'identités de charge de travail avec la fédération SAML que dans un projet Google Cloud géré de manière centralisée par votre organisation. Ensuite, si nécessaire, accordez aux identités externes de ce pool d'identités de charge de travail l'accès aux ressources de votre organisation.

Pour autoriser la fédération depuis des IdP SAML, créez une contrainte autorisant le mot clé spécial KEY_UPLOAD.

gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolProviders \
     KEY_UPLOAD --organization=ORGANIZATION_NUMBER

Vous pouvez répéter ces commandes pour autoriser la fédération depuis d'autres fournisseurs.

Pour bloquer la fédération depuis tous les fournisseurs, procédez comme suit :

  1. Créez un fichier YAML contenant les éléments suivants :

    constraint: constraints/iam.workloadIdentityPoolProviders
    listPolicy:
      allValues: DENY
  2. Transmettez le fichier à la commande gcloud resource-manager org-policies set-policy :

    gcloud resource-manager org-policies set-policy FILE_NAME.yaml \
        --organization=ORGANIZATION_NUMBER

Restreindre la création de clés de compte de service

La fédération d'identité de charge de travail vous permet d'accéder aux ressources Google Cloud en dehors de Google Cloud sans utiliser de clé de compte de service. Si vous n'utilisez jamais les clés de compte de service pour vous authentifier, vous pouvez réduire les risques en désactivant la création de clés.

Pour désactiver la création de clés de compte de service, appliquez la contrainte booléenne iam.disableServiceAccountKeyCreation dans la règle d'administration de votre organisation. Vous pouvez également appliquer la contrainte booléenne iam.disableServiceAccountKeyUpload, qui désactive l'importation de clés publiques pour des comptes de service.

Vous pouvez utiliser la consoleGoogle Cloud ou gcloud CLI pour activer ces contraintes. Par exemple, les commandes de gcloud CLI suivantes activent les deux contraintes :

gcloud resource-manager org-policies enable-enforce \
    constraints/iam.disableServiceAccountKeyCreation \
    --organization=ORGANIZATION_NUMBER
gcloud resource-manager org-policies enable-enforce \
    constraints/iam.disableServiceAccountKeyUpload \
    --organization=ORGANIZATION_NUMBER

Surveiller la fédération d'identité de charge de travail

Vous pouvez utiliser les métriques Cloud Monitoring pour surveiller les événements d'authentification pour vos pools et fournisseurs d'identités de charge de travail. Pour obtenir la liste des métriques disponibles, consultez Métriques IAM.

Étape suivante

En savoir plus sur la fédération d'identité de charge de travail.