Résoudre les problèmes liés à la fédération des identités des employés

Pour diagnostiquer et résoudre les erreurs d'authentification et de provisionnement dans la fédération des identités des employés, inspectez les réponses de votre fournisseur d'identité (IdP) et Cloud Audit Logs. Ces vérifications vous aident à identifier les incohérences de configuration et à restaurer l'accès des utilisateurs.

Inspecter la réponse du fournisseur d'identité

Cette section explique comment inspecter la réponse de votre fournisseur d'identité (IdP) pour résoudre les problèmes mentionnés dans ce document.

Connexion basée sur un navigateur

Pour inspecter la réponse renvoyée par votre IdP, générez un fichier HAR à l'aide de l'outil de votre choix. Par exemple, vous pouvez utiliser l'outil d'analyse HAR de Google Admin Toolbox, qui fournit des instructions pour générer un fichier HAR ainsi que les outils pour l'importer et l'analyser.

SAML

Pour inspecter la réponse du fournisseur d'identité SAML, procédez comme suit :

  1. Recherchez la valeur du paramètre de requête SAMLResponse dans le fichier HAR enregistré au niveau de l'URL avec le chemin /signin-callback.
  2. Décodez-la à l'aide d'un outil de votre choix, comme par exemple l'outil Encode/Decode de Google Admin Toolbox.

OIDC

Pour inspecter la réponse du fournisseur d'identité OIDC, procédez comme suit : Cette approche ne fonctionne pas avec le flux de code.

  1. Recherchez la valeur du paramètre de requête id_token dans le fichier HAR enregistré au niveau de l'URL avec le chemin /signin-callback.
  2. Décodez-le à l'aide de l'outil de débogage JWT de votre choix.

gcloud CLI

Pour inspecter la réponse de votre IdP lorsque vous utilisez la gcloud CLI, copiez le contenu du fichier que vous avez transmis dans l'option --credential-source-file lors de l'exécution de la commande gcloud iam workforce-pools create-cred-config, puis procédez comme suit :

SAML

Décodez la réponse du fournisseur d'identité SAML à l'aide d'un outil de votre choix, comme par exemple l'outil Encode/Decode de Google Admin Toolbox.

OIDC

Décodez la réponse du fournisseur d'identité OIDC à l'aide d'un outil de débogage JWT de votre choix.

Consulter les journaux

Pour déterminer si Google Cloud communique avec votre IdP, et vérifier les informations sur les transactions, vous pouvez consulter les journaux Cloud Audit Logs.

Pour afficher des exemples de journaux, consultez la page Exemples de journaux d'audit.

Erreurs de gestion de pools d'employés et de fournisseurs

Cette section fournit des suggestions permettant de résoudre les erreurs courantes que vous pourriez rencontrer lors de la gestion de pools et de fournisseurs.

Erreurs générales de mappage d'attributs

Pour résoudre les problèmes de mappage d'attributs du fournisseur de pool d'identités de personnel, procédez comme suit :

  • Inspectez les attributs, également appelés revendications, dans la configuration de votre IdP. Vérifiez comment vos mappages d'attributs convertissent les attributs IdP en attributs Google Cloudet comment vos conditions évaluent ces attributs pour autoriser ou refuser l'accès dans la console Google Cloud .

    1. Assurez-vous de disposer du rôle Éditeur IAM de pool d'employés (roles/iam.workforcePoolEditor).
    2. Pour activer le flux de connexion basé sur un navigateur pour la fédération des identités des employés, ajoutez https://auth.cloud.google/signin-callback/locations/global/workforcePools/POOL_ID/providers/PROVIDER_ID à la liste des URI de redirection autorisés de votre IdP.
    3. Dans la console Google Cloud , accédez à Pools d'identités de personnel.

      Accéder aux pools d'identités de personnel
    4. Dans la liste des pools, cliquez sur le nom du pool que vous souhaitez vérifier.
    5. Sur la page Détails du pool d'employés, cliquez sur le nom de l'IdP que vous souhaitez vérifier.
    6. Sur la page Détails du fournisseur, cliquez sur Déboguer le jeton IdP.
    7. Dans la boîte de dialogue Connexion, connectez-vous à votre IdP en tant qu'utilisateur test.

    La page Valider les attributs de votre fournisseur affiche les attributs mappés et le résultat de votre condition d'attribut.

    La section Attributs mappés à partir de votre jeton IdP indique comment les attributs Google, tels que google.subject, sont renseignés à partir du jeton de votre IdP en fonction de votre configuration de mappage. Une icône d'erreur s'affiche si un mappage est incorrect.

    La section Condition d'attribut affiche le résultat booléen de votre condition. Si la condition renvoie false, la connexion est bloquée.

    Pour afficher le jeton d'assertion complet, cliquez sur Afficher le jeton complet. L'objet JSON brut de votre IdP s'affiche. Référencez une propriété de premier niveau dans vos mappages au format assertion.PROPERTY_NAME.

    Pour corriger les erreurs, vous pouvez modifier la configuration :

    1. Sur la page Valider les attributs de votre fournisseur, cliquez sur Modifier.
    2. Apportez les modifications nécessaires.
    3. Pour lancer un nouveau test et voir les résultats mis à jour, cliquez sur Enregistrer et récupérer le jeton.

  • Inspectez les jetons générés par votre IdP. Pour savoir comment générer un jeton à partir de votre IdP, consultez la documentation de votre IdP.

  • Consultez la journalisation d'audit détaillée de la fédération d'identité de personnel dans Cloud Audit Logs.

La journalisation d'audit détaillée consigne les erreurs d'authentification et d'autorisation, ainsi que les revendications reçues par la fédération des identités des employés.

Vous pouvez activer la journalisation d'audit détaillée lorsque vous créez votre fournisseur de pool d'identités de personnel. Pour activer la journalisation d'audit détaillée, ajoutez l'option --detailed-audit-logging lorsque vous créez votre fournisseur de pool d'identités de personnel.

Autorisation refusée

Cette erreur se produit lorsque l'utilisateur qui tente de configurer la fédération des identités des employés ne dispose pas du rôle IAM d'administrateur de pools d'employés (roles/iam.workforcePoolAdmin).

INVALID_ARGUMENT : configuration de l'authentification unique Web OIDC manquante

L'erreur suivante se produit lorsque les champs web-sso-response-type et web-sso-assertion-claims-behavior ne sont pas définis lors de la création d'un fournisseur de pools d'identités des employés OIDC :

ERROR: (gcloud.iam.workforce-pools.providers.create-oidc) INVALID_ARGUMENT: Missing OIDC web single sign-on config.

Pour résoudre cette erreur, suivez les étapes décrites dans la section Créer un fournisseur pour définir les champs de manière appropriée lorsque vous créez le fournisseur de pools d'identités des employés OIDC.

Limitation du débit dépassée (HTTP 429)

Cette erreur se produit lorsque votre organisation a épuisé son quota d'échange de jetons de pool d'employés (sts.googleapis.com/workforce_requests).

Ce quota est appliqué à chaque organisation et est défini par défaut sur 1 000 requêtes par minute. Étant donné que ce quota est partagé entre tous les pools d'employés, fournisseurs, utilisateurs et charges de travail automatisées de votre organisation, un seul client à haute fréquence peut provoquer des erreurs HTTP 429 dans l'ensemble de l'organisation, y compris pour les administrateurs. Pour en savoir plus, consultez Quotas et limites.

Avant de commencer

Si vous êtes connecté via la fédération d'identité de personnel, les commandes de la Google Cloud CLI et les nouvelles sessions de connexion à la console Google Cloud peuvent être limitées. Pour effectuer ces étapes lorsque votre quota est dépassé, utilisez un compte administrateur qui ne s'authentifie pas via la fédération des identités des employés, par exemple un compte de super-administrateur Cloud Identity d'accès d'urgence.

Étape 1 : Vérifiez que le quota est épuisé

Dans la console Google Cloud , accédez à IAM et administration > Quotas, définissez le sélecteur de ressources sur votre organisation (et non sur un projet), puis sélectionnez Requêtes d'échange de jetons de pool d'employés.

Accéder à la page "IAM et administration" > "Quotas"

Étape 2 : Identifiez la source du trafic

Les échanges de jetons limités sont rejetés avant la validation des identifiants. Ils n'apparaissent donc pas dans Cloud Audit Logs. Pour identifier la source du trafic, utilisez l'une des méthodes suivantes :

  • Examinez les journaux de connexion de votre IdP : dans votre fournisseur d'identité, comme le journal système Okta ou les journaux de connexion Microsoft Entra ID, recherchez une application, un compte principal de service ou un compte utilisateur spécifique qui émet des jetons à un rythme anormalement élevé.
  • Examinez les configurations des charges de travail : vérifiez vos jobs automatisés, vos pipelines de CI/CD, vos agents de daemon et vos charges de travail GKE configurés avec un fichier de configuration des identifiants de personnel.

Étape 3 : Contenir le trafic

Choisissez l'option qui résout le problème de trafic avec le moins de perturbations pour votre personnel :

ActionEffet sur les utilisateurs de votre domaine
Arrêtez la charge de travail (réduisez le déploiement à zéro, supprimez le job ou révoquez le client dans votre IdP). Aucune. Recommandé lorsque vous pouvez identifier la charge de travail spécifique.
Désactivez la connexion programmatique sur le pool d'employés. Bloque tous les échanges de jetons programmatiques pour le pool, y compris gcloud et kubectl pour vos utilisateurs humains. Google Cloud La connexion à la console continue de fonctionner.

Recommandé lorsque vous ne parvenez pas à localiser immédiatement la charge de travail.
Désactiver le pool ou le fournisseur Bloque l'authentification pour l'ensemble du pool ou du fournisseur d'employés.

Pour désactiver la connexion programmatique :

gcloud iam workforce-pools update WORKFORCE_POOL_ID \
    --location=global \
    --disable-programmatic-signin

Après avoir arrêté la charge de travail problématique, réactivez la connexion programmatique en exécutant la commande avec l'option --no-disable-programmatic-signin.

Étape 4 : Évitez que le problème ne se reproduise

  • Migrez les charges de travail automatisées vers la fédération d'identité de charge de travail.
  • Réessayez les requêtes limitées avec un intervalle exponentiel entre les tentatives et une gigue. Des boucles de nouvelles tentatives serrées accentuent la saturation et prolongent l'interruption.
  • Alerte à 80 % de votre quota pour que vous soyez prévenu avant la saturation.
  • Si votre demande en régime permanent dépasse régulièrement la limite, nous vous recommandons de demander une augmentation de quota via Cloud Customer Care avant d'en avoir besoin.

Erreurs de connexion

Cette section fournit des suggestions permettant de résoudre les erreurs courantes qu'un utilisateur de la fédération des identités des employés peut rencontrer lorsqu'il se connecte.

Erreurs de connexion courantes

L'identifiant donné est rejeté par la condition d'attribut

Cette erreur se produit lorsque la condition d'attribut définie sur le fournisseur de pool d'identité des employés n'a pas été respectée.

Par exemple, considérons la condition d'attribut suivante :

SAML

'gcp-users' in assertion.attributes.groups

OIDC

'gcp-users' in assertion.groups

Dans ce cas, l'erreur s'affiche si la liste des groupes envoyés dans l'attribut groups par votre IdP ne contient pas gcp-users.

Pour résoudre cette erreur, procédez comme suit :

  1. Décrivez le fournisseur utilisé pour vous connecter et vérifiez que attributeCondition est correct. Pour en savoir plus sur les opérations compatibles dans les conditions, consultez la section Définition de langage.

  2. Suivez la procédure décrite dans la section Inspecter la réponse du fournisseur d'identité pour afficher les attributs renvoyés par le fournisseur d'identité, et vérifiez si la condition d'attribut est juste et correctement formée.

  3. Connectez-vous à la console d'administration de votre IdP et vérifiez si les attributs IdP référencés dans la condition d'attribut sont correctement configurés. Si nécessaire, consultez la documentation de votre fournisseur d'identité.

L'attribut mappé doit être de type STRING

Cette erreur se produit pour un fournisseur de pools d'identités des employés SAML lorsque l'attribut spécifié dans le message d'erreur est censé être une chaîne à valeur unique, mais qu'il est mappé à une liste dans le mappage des attributs.

Prenons l'exemple d'un fournisseur de pools d'identités des employés SAML disposant du mappage d'attributs attribute.role=assertion.attributes.userRole. Dans une assertion SAML, un Attribute peut comporter plusieurs tags AttributeValue, comme illustré dans l'exemple suivant. Par conséquent, tous les attributs SAML sont considérés comme des listes, donc assertion.attributes.userRole est une liste.

<saml:Attribute Name="userRole">
    <saml:AttributeValue>
      security-admin
    </saml:AttributeValue>
    <saml:AttributeValue>
      user
    </saml:AttributeValue>
</saml:Attribute>

Dans cet exemple, l'erreur suivante peut s'afficher :

The mapped attribute 'attribute.role' must be of type STRING

Pour résoudre ce problème, procédez comme suit :

  1. Décrivez le fournisseur utilisé pour vous connecter et identifiez l'attribut IdP défini dans le fichier attributeMapping. Vérifiez l'attribut en le comparant à l'attribut présenté dans le message d'erreur. Dans l'exemple précédent, un attribut IdP appelé userRole est mappé à l'attribut role, et l'attribut role apparaît dans l'exemple d'erreur.

  2. Lorsque vous mettez à jour le mappage d'attributs, tenez compte des points suivants :

    • Si l'attribut à l'origine de l'erreur est de type liste, identifiez un autre attribut valable, stable et de type chaîne. Ensuite, mettez à jour le mappage d'attributs de façon à l'utiliser en référençant son premier élément. Dans l'exemple précédent, si myRole était identifié comme étant l'attribut IdP à valeur unique de substitution, le mappage d'attributs serait le suivant :

      attribute.role=assertion.attributes.myRole[0]
      
    • Si l'attribut est connu pour être à valeur unique, vous pouvez également mettre à jour le mappage d'attributs pour utiliser le premier élément de la liste. Pour l'exemple précédent, si userRole ne contient qu'un seul rôle, vous pouvez utiliser le mappage suivant :

      attribute.role=assertion.attributes.userRole[0]
      
    • Pour vous aider à sélectionner un identifiant de substitution stable et à valeur unique dans la liste, consultez la section Définition de langage et modifiez le mappage d'attributs en conséquence.

Consultez la section Inspecter la réponse du fournisseur d'identité pour voir la réponse renvoyée par le fournisseur d'identité.

Impossible d'obtenir une valeur pour google.subject à partir des identifiants fournis

Cette erreur se produit lorsque la revendication requise google.subject n'a pas pu être mappée à l'aide du mappage d'attributs que vous avez défini dans votre configuration de fournisseur de pools d'identités des employés.

Pour résoudre cette erreur, procédez comme suit :

  1. Décrivez le fournisseur et inspectez l'élément attributeMapping. Identifiez le mappage configuré pour google.subject. Si le mappage est incorrect, mettez à jour le fournisseur de pools d'identités des employés.

  2. Consultez la section Inspecter la réponse du fournisseur d'identité pour voir la réponse renvoyée par le fournisseur d'identité. Inspectez la valeur de l'attribut à partir de la réponse du fournisseur d'identité mappée à google.subject dans vos mappages d'attributs.

    Si la valeur est vide ou incorrecte, connectez-vous à la console d'administration de votre IdP et inspectez les attributs configurés. Pour les attributs, vérifiez si l'utilisateur concerné dispose des données correspondantes dans votre IdP. Mettez à jour la configuration de votre IdP pour corriger les attributs ou les informations utilisateur en conséquence.

  3. Essayez de vous connecter à nouveau.

La taille des attributs mappés dépasse la limite

L'erreur suivante se produit lorsqu'un utilisateur fédéré tente de se connecter :

The size of the entire mapped attributes exceeds the 16 KB limit.

Pour résoudre ce problème, demandez à votre administrateur IdP de réduire le nombre d'attributs émis par votre IdP. Votre IdP n'a besoin d'émettre que les attributs nécessaires pour fédérer les utilisateurs vers Google Cloud. Pour en savoir plus sur les limites de mappage d'attributs, consultez Mappages d'attributs.

Par exemple, si votre IdP émet un grand nombre de google.groups qui sont des attributs mappés dans votre fournisseur de pool d'identités des employés, une tentative de connexion peut échouer. Demandez à votre administrateur de limiter le nombre de groupes émis par votre IdP.

Le nombre de groupes dépasse la limite

L'erreur suivante se produit lorsqu'un utilisateur fédéré tente de se connecter :

The current count of GROUPS_COUNT mapped attribute google.groups exceeds the GROUPS_COUNT_LIMIT count limit. Either modify your attribute mapping or the incoming assertion to produce a mapped attribute that has fewer than GROUPS_COUNT_LIMIT groups.

Cette erreur inclut les valeurs suivantes :

  • GROUPS_COUNT : nombre de groupes émis par le fournisseur d'identité

  • GROUPS_COUNT_LIMIT : limite de nombre de groupes de Google Cloud

Cette erreur se produit lorsque le nombre de groupes émis par l'IdP dépasse la limite deGoogle Cloud. Les groupes sont mappés à Google Cloud à l'aide de l'attribut google.groups.

Pour résoudre ce problème, demandez à votre administrateur de réduire le nombre de groupes émis par votre IdP. Votre IdP n'a besoin d'émettre que les groupes utilisés pour fédérer les utilisateurs vers Google Cloud. En savoir plus sur les limites liées aux groupes dans les mappages d'attributs

400. Il s'agit d'une erreur

Cette erreur se produit lorsque la requête n'a pas été reçue comme prévu ou qu'elle était incorrecte.

Pour résoudre cette erreur, procédez comme suit :

  1. Suivez les étapes de la section Indiquer à vos utilisateurs comment se connecter pour vérifier si vous suivez la bonne procédure de connexion.

  2. Comparez votre configuration de fournisseur de pools d'identités des employés avec votre configuration d'IdP.

Erreurs de connexion aux attributs supplémentaires

Cette section fournit des suggestions pour corriger les erreurs lors de l'utilisation d'attributs supplémentaires.

Échec de la connexion lorsque des attributs supplémentaires sont configurés

Si vous avez configuré des attributs supplémentaires, tout problème de configuration (par exemple, un ID client, un code secret du client ou un URI d'émetteur incorrect) entraîne l'échec de la tentative de connexion.

Pour résoudre cette erreur, procédez comme suit :

  1. Décrivez le fournisseur et vérifiez que l'ID client et l'URI de l'émetteur sont corrects.
  2. Vérifiez que le code secret du client est valide et n'a pas expiré.
  3. Dans votre IdP, vérifiez que l'application dispose des autorisations requises.

Les groupes de l'assertion SAML ou OIDC sont ignorés

Lorsque des attributs supplémentaires sont configurés, la fédération d'identité des employés ignore toutes les informations de groupe fournies directement dans les revendications SAML ou OIDC. À la place, il n'utilise que les groupes récupérés à l'aide du canal secondaire (par exemple, à l'aide de l'API Microsoft Graph).

Si vos utilisateurs ne voient pas les groupes attendus, assurez-vous que les groupes sont correctement récupérés à l'aide du canal secondaire et que tous les filtres d'attributs sont correctement configurés.

Erreurs de connexion OIDC

Cette section fournit des suggestions permettant de résoudre les erreurs spécifiques à OIDC qu'un utilisateur de la fédération des identités des employés peut rencontrer lorsqu'il se connecte.

Erreur lors de la connexion à l'émetteur de l'identifiant donné

Cette erreur se produit lorsqu'un fournisseur de pools d'identités des employés OIDC ne parvient pas à atteindre le document de découverte OIDC ou l'URI JWKS.

Pour résoudre cette erreur, procédez comme suit :

  1. Décrivez le fournisseur et inspectez l'élément issuerUri configuré. Créez l'URL du document de découverte en ajoutant /.well-known/openid-configuration à votre URI d'émetteur. Par exemple, si votre issuerUri est https://example.com, l'URL du document de découverte sera https://example.com/.well-known/openid-configuration.

  2. Ouvrez l'URL du document de découverte dans une fenêtre de navigation privée.

    1. Si l'URL ne s'ouvre pas ou si le navigateur affiche une erreur 404, consultez la documentation de votre fournisseur d'identité pour identifier l'URI d'émetteur approprié. Si nécessaire, mettez à jour le issuerUri dans votre fournisseur de pools d'identités d'employés.

      Si votre fournisseur d'identité s'exécute sur site, consultez la documentation de votre IdP afin de le provisionner pour l'accès via Internet.

    2. Si l'URL s'ouvre, vérifiez les conditions suivantes :

      1. Vérifiez que l'URL ne redirige pas trop de fois avant de diffuser le document de découverte. Si tel est le cas, contactez l'administrateur de votre IdP pour résoudre le problème.
      2. Vérifiez le temps de réponse du fournisseur d'identité. Consultez votre administrateur IdP pour réduire la latence de réponse.
      3. Le document de découverte ouvert doit être au format JSON.
      4. Recherchez un champ jwks_uri dans le fichier JSON.

        1. Vérifiez que la valeur d'URL associée s'ouvre également.
        2. Vérifiez que l'URL remplit les conditions décrites précédemment dans ce guide.
    3. Essayez de vous connecter à nouveau.

Erreurs de connexion SAML

Cette section fournit des suggestions permettant de résoudre les erreurs spécifiques à SAML qu'un utilisateur de la fédération des identités des employés peut rencontrer lorsqu'il se connecte.

Échec de validation de la signature dans SAMLResponse

Cette erreur se produit pour un fournisseur de pools d'identités des employés SAML lorsque la signature sur la réponse IdP ne peut être validée par aucun des certificats X.509 fournis dans le fichier XML de métadonnées IdP que vous avez configuré dans votre fournisseur de pools d'identités des employés. Cette erreur est souvent due à la rotation du certificat de validation de votre IdP alors que vous n'avez pas mis à jour la configuration du fournisseur de pools d'identités des employés avec le dernier fichier XML de métadonnées IdP.

Pour résoudre cette erreur, procédez comme suit :

  1. Facultatif : suivez la procédure décrites dans la section Inspecter la réponse du fournisseur d'identité pour voir la réponse renvoyée par le fournisseur d'identité et localiser le champ X509Certificate. Décrivez le fournisseur que vous avez utilisé pour vous connecter et inspectez le champ X509Certificate présent dans la valeur idpMetadataXml définie sur le fournisseur de pools d'identités des employés. Comparez le certificat à celui vu dans la réponse renvoyée par votre IdP. Les certificats doivent correspondre.

  2. Connectez-vous à la console d'administration de votre IdP et téléchargez le dernier XML de métadonnées.

  3. Mettez à jour le fournisseur de pools d'identités des employés avec le XML de métadonnées IdP téléchargé.

  4. Essayez de vous connecter à nouveau.

Le destinataire de l'assertion SAML n'est pas défini sur l'URL ACS appropriée

Cette erreur se produit pour un fournisseur de pools d'identités des employés SAML lorsque la réponse du fournisseur d'identité contient une valeur incorrecte pour le champ Recipient sur le tag SubjectConfirmationData.

Pour résoudre cette erreur, mettez à jour le champ Recipient URL / Redirect URL, ou le champ équivalent dans la configuration de votre IdP, afin d'utiliser l'URL de redirection décrite dans la section Configurer des URL de redirection dans votre fournisseur d'identité, puis essayez de vous connecter à nouveau.

Suivez la procédure décrite dans la section inspecter la réponse du fournisseur d'identité pour voir la réponse renvoyée, et vérifiez que le champ Recipient est correct.

Par exemple, pour le fournisseur de pools d'identités des employés locations/global/workforcePools/example-pool/providers/example-provider, le Recipient contenant l'URL de redirection apparaît comme suit dans la réponse SAML du fournisseur d'identité :

<SubjectConfirmationData Recipient="https://auth.cloud.google/signin-callback/locations/global/workforcePools/example-pool/providers/example-provider"

La destination SAMLResponse ne correspond pas à l'URL de rappel RP

Cette erreur se produit pour un fournisseur de pools d'identités des employés SAML lorsque la réponse du fournisseur d'identité contient une valeur incorrecte pour le champ Destination sur le tag Response.

Pour résoudre cette erreur, mettez à jour le champ Destination URL / Redirect URL, ou le champ équivalent dans la configuration de votre IdP, afin d'utiliser l'URL de redirection décrite dans la section Configurer des URL de redirection dans votre fournisseur d'identité.

Suivez la procédure décrite dans la section inspecter la réponse du fournisseur d'identité pour voir la réponse renvoyée, et vérifiez que le champ Destination est correct.

Par exemple, pour un fournisseur de pools d'identités des employés locations/global/workforcePools/example-pool/providers/example-provider, le Destination contenant l'URL de redirection apparaîtra comme suit dans la réponse SAML du fournisseur d'identité :

<Response Destination="https://auth.cloud.google/signin-callback/locations/global/workforcePools/example-pool/providers/example-provider"

Assertion non valide : NameID manquant ou vide

Cette erreur se produit lorsque la réponse SAML reçue de votre fournisseur d'identité ne contient pas le champ NameId ou qu'il contient une valeur vide.

Pour résoudre cette erreur, consultez la documentation de votre IdP pour la configurer de façon à envoyer le NameID, qui est le sujet d'une assertion SAML, généralement l'utilisateur authentifié.

Suivez la procédure décrite dans la section Inspecter la réponse du fournisseur d'identité pour voir la réponse renvoyée par le fournisseur d'identité et le NameID qui a été défini.

Tous les <AudienceRestriction> doivent contenir l'ID d'entité RP SAML

Cette erreur se produit lorsque les tags AudienceRestriction de la réponse SAML de votre IdP ne définissent pas de tag Audience avec une valeur représentant l'ID d'entité du fournisseur de pools d'identités des employés.

Pour résoudre cette erreur, procédez comme suit :

  1. Consultez la documentation de votre IdP pour savoir comment configurer l'audience dans les tags AudienceRestriction qu'elle envoie dans la réponse SAML. En règle générale, l'audience est configurée en définissant le champ Entity ID ou Audience dans votre configuration d'IdP. Consultez la section Créer un fournisseur de pools d'identités des employés SAML pour connaître la valeur SP Entity ID à définir.

  2. Après avoir mis à jour votre configuration d'IdP, essayez de vous connecter à nouveau.

Suivez la procédure décrite dans la section Inspecter la réponse du fournisseur d'identité pour voir la réponse renvoyée par le fournisseur d'identité et les AudienceRestriction qui ont été définis.

Erreurs de connexion SCIM

Cette section explique comment résoudre les erreurs spécifiques à SCIM qu'un utilisateur de la fédération des identités des employés peut rencontrer lorsqu'il se connecte.

Locataire SCIM introuvable

Cette erreur se produit lorsqu'un utilisateur tente de se connecter à l'aide d'un fournisseur de pool d'identités des employés configuré pour utiliser SCIM, mais qu'aucun locataire SCIM n'est configuré pour ce fournisseur.

Dans ce cas, les utilisateurs reçoivent l'erreur suivante lorsqu'ils tentent de se connecter :

There was an issue signing in with your identity provider.

Pour résoudre cette erreur, procédez comme suit pour votre fournisseur d'identité :

  1. Configurez un locataire et un jeton SCIM sur Google Cloud (Microsoft Entra ID | Okta).
  2. Associez le fournisseur à un locataire SCIM (Microsoft Entra ID | Okta).

Échec de la connexion lorsque l'utilisation de SCIM est activée pour les utilisateurs et les groupes

Lorsque --scim-usage est défini sur enabled-for-users-groups, les tentatives de connexion Web et OAuth peuvent échouer avec les messages d'erreur suivants :

  • Utilisateur SCIM introuvable ou inactif :

    • Erreur : The workforce identity pool provider is configured to use identity information that is provided using SCIM, but a SCIM User could not be associated with the google.subject from the given credential. ou ... the SCIM User associated with the google.subject from the given credential is not active.
    • Cause : l'utilisateur n'a pas été synchronisé avec Google Cloud à l'aide de SCIM, l'google.subject mappé dans le fournisseur ne correspond pas au mappage d'utilisateur SCIM, ou l'utilisateur est marqué comme active: false dans l'IdP.
    • Résolution : Dans votre IdP, vérifiez que l'utilisateur est provisionné à l'aide de SCIM, assurez-vous que son état est actif et vérifiez que le mappage d'attributs du fournisseur et le mappage de revendication du locataire SCIM pour google.subject font référence à la même identité.
  • Erreur d'évaluation CEL ou de mappage de revendication :

    • Erreur : Failed to map attributes from the given credential with SCIM Tenant config.
    • Cause : une expression CEL dans --claim-mapping n'est pas valide ou a échoué lors de l'évaluation.
    • Résolution : Examinez les expressions --claim-mapping de votre locataire SCIM pour vous assurer que la syntaxe CEL est valide et que les noms d'attributs sont compatibles.
  • Limites de taille des attributs mappés dépassées :

    • Erreur : The size of SCIM mapped attribute google.display_name exceeds the 100 bytes limit. ou The size of entire SCIM mapped attributes exceeds the 16 kB limit.
    • Cause : un attribut mappé individuel a dépassé sa limite de taille (par exemple, 100 octets pour google.display_name, 32 octets pour google.posix_username, 127 octets pour google.subject) ou le total des revendications mappées sérialisées a dépassé 16 ko.
    • Résolution : Ajustez les mappages de revendications de votre locataire SCIM ou mettez à jour les valeurs d'attributs de l'IdP pour rester dans les limites autorisées.

Erreurs de provisionnement et de synchronisation SCIM

Cette section explique comment résoudre les problèmes de provisionnement et de synchronisation SCIM dans la fédération des identités des employés.

Échec de l'authentification du jeton SCIM (HTTP 401 ou 403)

Cette erreur se produit lorsque les journaux du fournisseur d'identité (IdP) signalent des échecs d'authentification (HTTP 401 Unauthorized ou HTTP 403 Forbidden). Les causes courantes sont les suivantes :

  • Le jeton SCIM est manquant, non valide ou arrivé à expiration.
  • Le jeton SCIM contient des espaces supplémentaires.
  • L'en-tête Authorization: Bearer <TOKEN> est manquant dans la requête.
  • Le jeton SCIM ne dispose pas des autorisations suffisantes.

Pour résoudre ce problème, procédez comme suit :

  1. Dans la configuration de provisionnement de votre IdP, vérifiez que le jeton SCIM correspond au jeton secret généré dans Google Cloud sans espace supplémentaire.
  2. Si le jeton est perdu ou non valide, générez-en un nouveau :

    gcloud iam workforce-pools providers scim-tenants tokens create SCIM_TOKEN_ID \
        --workforce-pool="WORKFORCE_POOL_ID" \
        --provider="PROVIDER_ID" \
        --scim-tenant="SCIM_TENANT_ID" \
        --location="global"
    

    Remplacez les éléments suivants :

    • SCIM_TOKEN_ID : ID du nouveau jeton SCIM.
    • WORKFORCE_POOL_ID : ID du pool d'identités de personnel.
    • PROVIDER_ID : ID du fournisseur du pool d'employés.
    • SCIM_TENANT_ID : ID du locataire SCIM.
  3. Mettez à jour le jeton secret dans la configuration de votre IdP.

Limitation du débit dépassée (HTTP 429 : trop de requêtes)

Cette erreur se produit lorsque les taux de demandes du fournisseur d'identité dépassent le quota du locataire SCIM. Par défaut, les requêtes d'écriture et de lecture sont limitées à 3 000 requêtes par locataire SCIM,par organisation et par minute, ce qui équivaut à 50 requêtes par seconde (RPS). Pour en savoir plus, consultez la page Quotas et limites.

Pour résoudre ce problème, procédez comme suit :

  1. Vérifiez que le taux de requêtes de synchronisation de votre IdP ne dépasse pas les limites de quota.
  2. Dans la console Google Cloud , accédez à IAM et administration > Quotas, puis filtrez par iamscim.googleapis.com pour surveiller l'utilisation des quotas.
  3. Si vous avez besoin d'un débit plus élevé, demandez une augmentation de quota dans la console Google Cloud .

Échec de la création du locataire SCIM

Cette erreur se produit lorsque la commande gcloud iam workforce-pools providers scim-tenants create échoue.

Les causes les plus courantes sont les suivantes :

  • Un locataire SCIM existe déjà dans le pool d'employés. Chaque pool d'employés n'est compatible qu'avec un seul locataire SCIM.
  • Un locataire SCIM récemment supprimé se trouve toujours dans sa période de suppression réversible de 30 jours.
  • Vous ne disposez pas du rôle IAM d'administrateur de pools d'employés (roles/iam.workforcePoolAdmin).
  • L'option --claim-mapping contient des expressions CEL (Common Expression Language) non compatibles.

Pour résoudre ce problème, procédez comme suit :

  1. Vérifiez que vous disposez du rôle IAM Administrateur de pool d'employés (roles/iam.workforcePoolAdmin).
  2. Répertoriez les locataires SCIM existants pour vérifier si un locataire existe déjà :

    gcloud iam workforce-pools providers scim-tenants list \
        --workforce-pool="WORKFORCE_POOL_ID" \
        --provider="PROVIDER_ID" \
        --location="global"
    

    Remplacez les éléments suivants :

    • WORKFORCE_POOL_ID : ID du pool d'identités de personnel.
    • PROVIDER_ID : ID du fournisseur de pools d'employés.
  3. Si un locataire précédemment supprimé est soumis à une suppression réversible, supprimez-le définitivement à l'aide de l'option --hard-delete :

    gcloud iam workforce-pools providers scim-tenants delete SCIM_TENANT_ID \
        --workforce-pool="WORKFORCE_POOL_ID" \
        --provider="PROVIDER_ID" \
        --location="global" \
        --hard-delete
    

    Remplacez SCIM_TENANT_ID par l'ID du locataire SCIM.

  4. Assurez-vous que --claim-mapping n'utilise que des expressions CEL compatibles. Pour en savoir plus, consultez Mappage de revendication.

Échec de la création du jeton SCIM

Cette erreur se produit lorsque la commande gcloud iam workforce-pools providers scim-tenants tokens create échoue.

Les causes les plus courantes sont les suivantes :

  • Le locataire SCIM a déjà atteint le nombre maximal de deux jetons SCIM.
  • Vous ne disposez pas du rôle IAM d'administrateur de pools d'employés (roles/iam.workforcePoolAdmin).

Pour résoudre ce problème, procédez comme suit :

  1. Vérifiez que vous disposez du rôle IAM Administrateur de pool d'employés (roles/iam.workforcePoolAdmin).
  2. Répertoriez les jetons SCIM existants pour vérifier si la limite de deux jetons a été atteinte :

    gcloud iam workforce-pools providers scim-tenants tokens list \
        --workforce-pool="WORKFORCE_POOL_ID" \
        --provider="PROVIDER_ID" \
        --scim-tenant="SCIM_TENANT_ID" \
        --location="global"
    

    Remplacez les éléments suivants :

    • WORKFORCE_POOL_ID : ID du pool d'identités de personnel.
    • PROVIDER_ID : ID du fournisseur de pools d'employés.
    • SCIM_TENANT_ID : ID du locataire SCIM.
  3. Si le locataire SCIM possède déjà deux jetons, supprimez un jeton inutilisé ou non valide :

    gcloud iam workforce-pools providers scim-tenants tokens delete SCIM_TOKEN_ID \
        --workforce-pool="WORKFORCE_POOL_ID" \
        --provider="PROVIDER_ID" \
        --scim-tenant="SCIM_TENANT_ID" \
        --location="global"
    

    Remplacez SCIM_TOKEN_ID par l'ID du jeton SCIM à supprimer.

  4. Après avoir supprimé le jeton, réessayez de créer le jeton SCIM.

Conflit de mappage d'attributs en double (HTTP 409 Conflict)

Cette erreur se produit lorsque les journaux du fournisseur d'identité (IdP) signalent une erreur HTTP 409 Conflict lors de la synchronisation, car l'IdP envoie des valeurs en double pour google.subject ou google.group, ou des valeurs userName ou displayName non uniques.

Pour résoudre ce problème, procédez comme suit :

  1. Dans la console d'administration de votre IdP, vérifiez que les attributs mappés à google.subject et google.group produisent des valeurs qui ne se chevauchent pas.
  2. Assurez-vous que chaque utilisateur dispose d'un userName unique et que chaque groupe dispose d'un displayName unique.

Échec des requêtes PATCH Microsoft Entra ID

Cette erreur se produit lorsque les requêtes de mise à jour ou PATCH des utilisateurs depuis Microsoft Entra ID échouent, car le paramètre de requête ?aadOptscim062020 est manquant dans l'URL du locataire, ce qui est requis pour les requêtes PATCH conformes à la RFC.

Pour résoudre ce problème, procédez comme suit :

  1. Dans Microsoft Entra ID, accédez à votre application d'entreprise, puis sélectionnez Provisioning > Manage provisioning > Admin Credentials (Provisionnement > Gérer le provisionnement > Identifiants d'administrateur).
  2. Dans le champ URL du locataire, ajoutez ?aadOptscim062020 à l'URI de base :

    https://iamscim.googleapis.com/v1alpha1/tenants/SCIM_TENANT_UID?aadOptscim062020
    

    Remplacez SCIM_TENANT_UID par l'identifiant unique de votre locataire SCIM.

  3. Cliquez sur Tester la connexion, puis enregistrez la configuration.

L'accès ou le partage basé sur l'utilisateur ou le groupe ne fonctionne pas

Ce problème se produit lorsque les utilisateurs synchronisés ne peuvent pas accéder aux ressources Google Cloud, ou lorsque le partage de notebooks dans Gemini Notebook pour les entreprises ou d'agents dans l'application Gemini Enterprise échoue.

Les causes les plus courantes sont les suivantes :

  • Échecs ou retards de synchronisation silencieux de l'IdP.
  • Mappages de revendications incohérents entre le fournisseur (--attribute-mapping) et le locataire SCIM (--claim-mapping).
  • Modifications apportées aux attributs mappés sur google.subject ou google.group dans le fournisseur d'identité. Google Cloud s'attend à ce que les valeurs mappées sur ces attributs soient immuables.
  • L'utilisation de SCIM (--scim-usage=enabled-for-users-groups ou --scim-usage=enabled-for-groups) n'est pas activée sur le fournisseur de pool d'employés qui possède le locataire SCIM.

Pour résoudre ce problème, procédez comme suit :

  1. Vérifier la synchronisation et l'appartenance : vérifiez que les utilisateurs, les groupes et l'appartenance aux groupes ont bien été synchronisés avec Google Cloud :

    • Vérifier la synchronisation des utilisateurs :

      curl -G -H "Authorization: Bearer SCIM_TOKEN" \
        "https://iamscim.googleapis.com/v1alpha1/tenants/SCIM_TENANT_UID/Users" \
        --data-urlencode 'filter=userName eq "USER_NAME"'
      
    • Vérifiez la synchronisation des groupes :

      curl -G -H "Authorization: Bearer SCIM_TOKEN" \
        "https://iamscim.googleapis.com/v1alpha1/tenants/SCIM_TENANT_UID/Groups" \
        --data-urlencode 'filter=displayName eq "GROUP_NAME"'
      
    • Vérifier l'appartenance à un groupe : vérifiez qu'un utilisateur est membre d'un groupe :

      curl -G -H "Authorization: Bearer SCIM_TOKEN" \
        "https://iamscim.googleapis.com/v1alpha1/tenants/SCIM_TENANT_UID/Groups" \
        --data-urlencode 'filter=id eq "GROUP_ID" and members eq "USER_ID"'
      

      Si l'utilisateur est membre du groupe, la réponse renvoie totalResults: 1. Si l'utilisateur n'est pas membre, la réponse renvoie totalResults: 0.

    Remplacez les éléments suivants :

    • SCIM_TOKEN : votre jeton secret SCIM.
    • SCIM_TENANT_UID : identifiant unique de votre locataire SCIM.
    • USER_NAME : nom d'utilisateur de l'utilisateur synchronisé.
    • GROUP_NAME : nom à afficher du groupe synchronisé.
    • GROUP_ID : ID SCIM du groupe synchronisé, renvoyé dans le champ id de la réponse à la requête de groupe.
    • USER_ID : ID SCIM de l'utilisateur synchronisé, renvoyé dans le champ id de la réponse à la requête utilisateur.
  2. Vérifiez les mappages de revendications : assurez-vous que l'attribut mappé à google.subject dans le fournisseur (par exemple, google.subject=assertion.email.lowerAscii()) correspond au mappage d'identité dans le locataire SCIM (par exemple, google.subject=user.emails[0].value.lowerAscii()). Étant donné que les mappages de revendications sont immuables, si les mappages sont incohérents, vous devez supprimer définitivement le locataire SCIM et le recréer avec le mappage correct.

  3. Assurez-vous de l'immuabilité des identifiants : vérifiez que les attributs du fournisseur d'identité mappés à google.subject et google.group n'ont pas changé. Google Cloudtraite les valeurs mappées à ces attributs comme des identifiants immuables. Si une valeur d'attribut a été modifiée dans votre IdP, annulez la modification dans votre IdP ou supprimez définitivement l'utilisateur ou le groupe concerné de votre IdP, puis recréez-le avec la nouvelle valeur afin que l'identifiant corresponde à ce que Google Cloudattend.

  4. Vérifiez l'utilisation de SCIM sur le fournisseur : vérifiez le champ scimUsage sur le fournisseur de pool d'employés qui possède le locataire SCIM :

    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 de pools d'employés.
    • WORKFORCE_POOL_ID : ID du pool d'identités de personnel.

    Dans le résultat, vérifiez que scimUsage est défini sur ENABLED_FOR_USERS_GROUPS (recommandé) ou ENABLED_FOR_GROUPS. Si scimUsage est omis ou défini sur SCIM_USAGE_UNSPECIFIED, les revendications d'utilisateur et de groupe synchronisées par SCIM ne sont pas évaluées pour les vérifications d'accès IAM.

  5. Activer l'utilisation de SCIM sur le fournisseur : si l'utilisation de SCIM n'est pas activée, exécutez la commande de mise à jour pour votre type de fournisseur. Nous vous recommandons d'utiliser enabled-for-users-groups. Pour en savoir plus sur les modes d'utilisation de SCIM, consultez Considérations sur le provisionnement SCIM.

    OIDC

    gcloud iam workforce-pools providers update-oidc PROVIDER_ID \
        --workforce-pool="WORKFORCE_POOL_ID" \
        --location="global" \
        --scim-usage="enabled-for-users-groups"
    

    SAML

    gcloud iam workforce-pools providers update-saml PROVIDER_ID \
        --workforce-pool="WORKFORCE_POOL_ID" \
        --location="global" \
        --scim-usage="enabled-for-users-groups"
    

Les modifications apportées au fournisseur d'identité sont retardées ou ne sont pas prises en compte

Ce problème se produit lorsque les mises à jour de l'IdP concernant les utilisateurs, les appartenances à un groupe ou les suppressions n'apparaissent pas immédiatement dans Google Cloud.

Comme SCIM est basé sur le push, les mises à jour dépendent de votre calendrier de synchronisation IdP. Par exemple, Microsoft Entra ID se synchronise toutes les 40 minutes environ.

Pour résoudre ce problème, procédez comme suit :

  1. Attendez le prochain cycle de synchronisation planifié de votre IdP.
  2. Pour appliquer les modifications immédiatement, déclenchez une synchronisation à la demande dans la console d'administration de votre IdP.

Échec du provisionnement des utilisateurs en raison du format de l'adresse e-mail

Cette erreur se produit lorsque la synchronisation de certains utilisateurs avec Google Cloudéchoue et que les journaux de votre fournisseur d'identité (IdP) signalent une erreur HTTP 400 Bad Request avec une erreur SCIM invalidValue.

Google Cloud SCIM nécessite exactement une adresse e-mail professionnelle par utilisateur. Le provisionnement échoue si l'IdP envoie plusieurs adresses e-mail ou si l'adresse e-mail n'est pas de type work.

Pour résoudre ce problème, configurez le mappage d'attributs de votre IdP de sorte qu'il n'envoie que l'adresse e-mail professionnelle principale.

Échec des mises à jour de groupe (HTTP PUT non compatible)

Cette erreur se produit lorsque les mises à jour de groupe échouent, car le client utilise HTTP PUT, qui n'est pas compatible. L'API SCIM Google Cloud n'est compatible qu'avec HTTP PATCH pour les mises à jour de groupes.

Pour résoudre ce problème, configurez votre IdP ou votre client personnalisé de sorte qu'il utilise HTTP PATCH pour les mises à jour de groupes.

Échec de la mise à jour du fournisseur avec des configurations mutuellement exclusives

Cette erreur se produit lorsque la création ou la mise à jour du fournisseur échoue avec l'un des messages suivants :

  • Select one of scim_usage - ENABLED_FOR_USERS_GROUPS or extra_attributes_oauth2_client, but not both.
  • Select one of scim_usage or extended_attributes_oauth2_client, but not both.

La définition de --scim-usage=enabled-for-users-groups s'exclut mutuellement avec les attributs supplémentaires (extra_attributes_oauth2_client) et les attributs étendus (extended_attributes_oauth2_client).

Pour résoudre ce problème, supprimez la configuration des attributs supplémentaires ou étendus en conflit du fournisseur, ou modifiez le paramètre --scim-usage.

Erreurs d'échange de jetons de l'API Cloud OAuth

Lorsqu'une requête d'échange de jetons échoue, l'API Cloud OAuth renvoie un état HTTP 400 Bad Request ou 401 Unauthorized avec une réponse JSON d'erreur OAuth 2.0 (RFC 6749). Le champ error indique l'un des codes d'erreur suivants :

Code d'erreur Description Correction
invalid_request La requête ne contient pas un paramètre obligatoire, inclut une valeur de paramètre non valide, inclut un paramètre plusieurs fois ou est incorrecte. Vérifiez que tous les paramètres encodés au format URL requis (grant_type, code ou refresh_token, redirect_uri) sont fournis.
invalid_client Échec de l'authentification du client. Vérifiez que les valeurs client_id et client_secret OAuth enregistrées correspondent, que le client OAuth est activé pour votre pool d'identités de personnel et que l'en-tête Authorization: Basic est correctement encodé en Base64.
invalid_grant Le code d'autorisation ou le jeton d'actualisation fourni n'est pas valide, a expiré, a été révoqué, ne correspond pas à l'URI de redirection utilisé dans la demande d'autorisation ou a été émis pour un autre client. Assurez-vous que le code ou le jeton n'a pas expiré ou n'a pas déjà été échangé.
unauthorized_client Le client OAuth authentifié n'est pas autorisé à utiliser le grant_type demandé. Vérifiez que l'enregistrement de votre client OAuth autorise l'octroi de codes d'autorisation ou de jetons d'actualisation.
unsupported_grant_type Le type d'attribution d'autorisation n'est pas accepté par le serveur d'autorisation. Définissez grant_type sur authorization_code ou refresh_token.
invalid_scope Le niveau d'accès demandé n'est pas valide, est inconnu, est incorrect ou dépasse les niveaux d'accès accordés par le propriétaire de la ressource. Vérifiez que les champs d'application demandés correspondent à ceux configurés sur le client OAuth et qu'ils sont valides pour votre application.
resource_exhausted La requête a dépassé le quota d'échange de jetons de l'API Cloud OAuth. Vérifiez l'utilisation de l'API dans la console Google Cloud ou demandez une augmentation de quota.

Erreurs liées aux informations utilisateur et aux groupes Cloud OAuth

Lorsqu'une requête adressée au point de terminaison /userinfo ou /groups échoue, l'API Cloud OAuth renvoie un état HTTP 400 Bad Request, 401 Unauthorized ou 403 Forbidden avec une réponse d'erreur de jeton de support OAuth 2.0 (RFC 6750/OpenID Connect Core). Le champ error indique l'un des codes d'erreur suivants :

Code d'erreur État HTTP Description Correction
invalid_request 400 Bad Request/401 Unauthorized L'en-tête Authorization requis est manquant dans la requête ou son format est incorrect (par exemple, il ne commence pas par Bearer). Vérifiez que l'en-tête Authorization: Bearer ACCESS_TOKEN est correctement formaté.
invalid_token 401 Unauthorized Le jeton d'accès fourni n'est pas valide, a expiré ou a été révoqué. Actualisez le jeton d'accès à l'aide de l'attribution refresh_token ou répétez le flux avec code d'autorisation.
insufficient_scope 403 Forbidden Le jeton d'accès ne dispose pas du champ d'application openid requis, ou le locataire du jeton ne correspond pas à l'organisation spécifiée dans l'URL du point de terminaison au niveau de l'organisation. Vérifiez que le jeton a été demandé avec le champ d'application openid requis et que vous appelez le bon point de terminaison.