Gérer les fournisseurs de pools d'identités de personnel

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Ce guide explique comment effectuer des opérations courantes avec la fédération d'identité de personnel.

Gérer les pools et les fournisseurs de personnel

Vous pouvez définir le projet autorisé en tant que projet de facturation/quota pour accéder aux API de pool de personnel.

Avant de commencer

  1. Identifiez un projet de facturation/quota.

    Pour définir le projet Google Cloud de facturation/quotas dans gcloud CLI, exécutez la commande suivante :

    gcloud config set billing/quota_project PROJECT_ID
    

    Remplacez PROJECT_ID par l'ID du projet.

  2. Pour savoir comment configurer la fédération d'identité de personnel, consultez la page Configurer la fédération d'identité de personnel. Pour obtenir des instructions spécifiques à un fournisseur d'identité, consultez les articles suivants :

  3. Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante :

    gcloud init

Gérer les pools

Cette section explique comment gérer les pools de fédération d'identité de personnel.

Créer un pool

Pour créer un pool de personnel, exécutez la commande suivante :

gcloud iam workforce-pools create WORKFORCE_POOL_ID \
    --organization=ORGANIZATION_ID \
    --description=DESCRIPTION \
    --location=global

Remplacez les éléments suivants :

  • WORKFORCE_POOL_ID : ID de pool de personnel que vous choisissez
  • ORGANIZATION_ID : ID de votre organisation.
  • DESCRIPTION : description de ce pool

Décrire un pool

Pour décrire un pool de personnel spécifique, exécutez la commande suivante :

gcloud iam workforce-pools describe WORKFORCE_POOL_ID \
    --location=global

Remplacez WORKFORCE_POOL_ID par l'ID de pool de personnel que vous avez choisi lors de la création du pool.

Répertorier les pools

Pour répertorier les pools de personnel de l'organisation, exécutez la commande suivante :

gcloud iam workforce-pools list \
    --organization=ORGANIZATION_ID \
    --location=global

Remplacez ORGANIZATION_ID par votre ID d'organisation.

Mettre à jour un pool

Pour mettre à jour un pool de personnel spécifique, exécutez la commande suivante :

gcloud iam workforce-pools update WORKFORCE_POOL_ID \
    --description=DESCRIPTION \
    --location=global

Remplacez les éléments suivants :

  • WORKFORCE_POOL_ID : ID du pool de personnel
  • DESCRIPTION : description du pool

Supprimer un pool

Pour supprimer un pool d'identités de personnel, exécutez la commande suivante :

gcloud iam workforce-pools delete WORKFORCE_POOL_ID \
    --location=global

Remplacez WORKFORCE_POOL_ID par l'ID du pool de personnel.

Annuler la suppression d'un pool

Vous pouvez annuler la suppression d'un pool d'identités de personnel supprimé au cours des 30 derniers jours.

Pour annuler la suppression d'un pool, exécutez la commande suivante :

gcloud iam workforce-pools undelete WORKFORCE_POOL_ID \
    --location=global

Remplacez WORKFORCE_POOL_ID par l'ID du pool de personnel.

Configurer un fournisseur dans le pool de personnel

Cette section explique comment utiliser les commandes gcloud pour configurer les fournisseurs de pools de personnel :

Créer un fournisseur

Pour créer un fournisseur, exécutez la commande suivante :

gcloud iam workforce-pools providers create-oidc PROVIDER_ID \
    --workforce-pool=WORKFORCE_POOL_ID \
    --display-name=DISPLAY_NAME \
    --description=DESCRIPTION \
    --issuer-uri="OIDC_ISSUER_URL" \
    --client-id="OIDC_CLIENT_ID" \
    --attribute-mapping="ATTRIBUTE_MAPPING" \
    --attribute-condition="ATTRIBUTE_CONDITION"
    --location=global

Remplacez les éléments suivants :

  • PROVIDER_ID : ID du fournisseur
  • WORKFORCE_POOL_ID : ID du pool de personnel
  • DISPLAY_NAME : nom à afficher
  • DESCRIPTION : description
  • OIDC_ISSUER_URL : URL d'émetteur OIDC
  • OIDC_CLIENT_ID : ID client OIDC
  • ATTRIBUTE_MAPPING : mappage d'attributs. Par exemple : google.subject=assertion.sub, google.groups=assertion.groupList, google.display_name=assertion.displayName,google.profile_photo=assertion.profilePhoto, attribute.costcenter=assertion.costcenter.
  • ATTRIBUTE_CONDITION : condition d'attribut. Par exemple : assertion.group1=='gcp-users'.

Dans la réponse de la commande, POOL_RESOURCE_NAME correspond au nom du pool, par exemple locations/global/workforcePools/enterprise-example-organization-employees.

Décrire un fournisseur

Pour décrire un fournisseur, exécutez la commande suivante :

  gcloud iam workforce-pools providers describe PROVIDER_ID \
      --workforce-pool=WORKFORCE_POOL_ID \
      --location=global

Remplacez les éléments suivants :

  • PROVIDER_ID : ID du fournisseur
  • WORKFORCE_POOL_ID : ID du pool de personnel

Répertorier les fournisseurs

Pour répertorier les fournisseurs, exécutez la commande suivante :

gcloud iam workforce-pools providers list \
    --workforce-pool=WORKFORCE_POOL_ID \
    --location=global

Remplacez WORKFORCE_POOL_ID par l'ID du pool de personnel.

Mettre à jour un fournisseur

Pour mettre à jour un fournisseur OIDC après sa création, exécutez la commande suivante :

gcloud iam workforce-pools providers update-oidc PROVIDER_ID \
    --workforce-pool= WORKFORCE_POOL_ID \
    --description="DESCRIPTION" \
    --location=global

Remplacez les éléments suivants :

  • PROVIDER_ID : ID du fournisseur
  • WORKFORCE_POOL_ID : ID du pool de personnel
  • DESCRIPTION : description

Supprimer un fournisseur

Pour supprimer un fournisseur, exécutez la commande suivante :

gcloud iam workforce-pools providers delete PROVIDER_ID \
    --workforce-pool=WORKFORCE_POOL_ID \
    --location=global

Remplacez les éléments suivants :

  • PROVIDER_ID : ID du fournisseur
  • WORKFORCE_POOL_ID : ID du pool de personnel

Annuler la suppression d'un fournisseur

Pour annuler la suppression d'un fournisseur au cours des 30 derniers jours, exécutez la commande suivante :

gcloud iam workforce-pools providers undelete PROVIDER_ID \
    --workforce-pool=WORKFORCE_POOL_ID \
    --location=global

Remplacez les éléments suivants :

  • PROVIDER_ID : ID du fournisseur
  • WORKFORCE_POOL_ID : ID du pool de personnel

Étape suivante