Résoudre les problèmes liés à OS Login

Ce document explique comment résoudre les problèmes liés à OS Login à l'aide du serveur de métadonnées. Pour plus d'informations sur la configuration d'OS Login ou pour obtenir des instructions détaillées, consultez la section Configurer OS Login.

Vous pouvez interroger le serveur de métadonnées à partir d'une instance Compute Engine. Pour en savoir plus, consultez la page Stocker et récupérer les métadonnées d'instances.

Avant de commencer

  • Si ce n'est pas déjà fait, configurez l'authentification. L'authentification permet de valider votre identité pour accéder aux services et aux API Google Cloud . Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine en sélectionnant l'une des options suivantes :

    Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :

    Console

    Lorsque vous utilisez la console Google Cloud pour accéder aux services et aux API Google Cloud , vous n'avez pas besoin de configurer l'authentification.

    gcloud

    1. Installez la Google Cloud CLI. Une fois l'installation terminée, initialisez la Google Cloud CLI en exécutant la commande suivante :

      gcloud init

      Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

  • Définissez une région et une zone par défaut.
  • REST

    Pour utiliser les exemples API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.

      Installez la Google Cloud CLI.

      Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

    Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud .

Messages d'erreur fréquents

Vous trouverez ci-dessous des exemples d'erreurs courantes que vous pouvez rencontrer en utilisant OS Login.

Nom du groupe introuvable

Sur certaines instances de calcul utilisant OS Login, il est possible que vous receviez le message d'erreur suivant une fois que la connexion est établie :

/usr/bin/id: cannot find name for group ID 123456789

Ignorez ce message d'erreur. Cette erreur n'affecte pas vos instances de calcul.

Échec de l'obtention des groupes

Lorsque vous créez des instances de calcul, des journaux semblables à ce qui suit peuvent s'afficher :

Dec 10 22:31:05 instance-1 google_oslogin_nss_cache[381]: oslogin_cache_refresh[381]: Refreshing group entry cache
Dec 10 22:31:05 instance-1 google_oslogin_nss_cache[381]: oslogin_cache_refresh[381]: Failure getting groups, quitting

Ces journaux indiquent que votre organisation n'a pas de groupes OS Login Linux configurés. Ignorez ces messages.

Condition préalable non remplie

Une erreur semblable à celle-ci peut s'afficher lorsque vous vous connectez à l'instance de calcul à l'aide de SSH :

ERROR: (gcloud.compute.ssh) FAILED_PRECONDITION: The specified username or UID is not unique within given system ID.

Cette erreur se produit lorsque OS Login tente de générer un nom d'utilisateur qui existe déjà dans une organisation. Cette situation est fréquente lorsqu'un compte utilisateur est supprimé et qu'un nouvel utilisateur associé à la même adresse e-mail est créé peu de temps après. Une fois le compte utilisateur supprimé, la suppression des informations POSIX de l'utilisateur peut prendre jusqu'à 48 heures.

Pour résoudre ce problème, effectuez l'une des opérations suivantes :

Taille limite du profil OS Login dépassée

Vous pouvez rencontrer l'une des erreurs suivantes lorsque vous vous connectez à une instance de calcul Linux à l'aide de SSH ou utilisez SCP pour transférer des fichiers :

ERROR: (gcloud.compute.ssh) FAILED_PRECONDITION: Login profile size exceeds 32 KiB. Delete profile values to make additional space.
ERROR: (gcloud.compute.scp) INVALID_ARGUMENT: Login profile size exceeds 32 KiB. Delete profile values to make additional space.

OS Login stocke les informations utilisateur, y compris les clés publiques SSH, dans un compte POSIX dont la taille est limitée à 32 Kio par utilisateur. Si votre profil OS Login dépasse cette limite ou si vous avez plus de 64 clés SSH dans votre profil, vous ne pouvez pas y ajouter de clés SSH supplémentaires, ce qui vous empêche de vous connecter aux VM via SSH.

Pour résoudre ces erreurs, procédez comme suit :

  1. Vérifiez la taille de votre profil OS Login. Pour vérifier la taille de votre profil, exportez-le vers un fichier JSON temporaire et vérifiez la taille du fichier en exécutant la commande suivante :

    gcloud compute os-login describe-profile --format="json" | wc
    

    Si la taille est proche de 32 Kio ou la dépasse, vous devez supprimer les clés SSH inutilisées.

  2. Examinez votre profil OS Login pour identifier les clés SSH inutilisées :

    gcloud compute os-login describe-profile
    

    Le résultat ressemble à ce qui suit :

    name: '00000000000000'
    posixAccounts:
    ...
    sshPublicKeys:
     ...:
       fingerprint: ...
       key: |
         ssh-rsa AAAAB3NzaC1yc2...
       name: ...
     ...
    
  3. Supprimez toutes les clés inutilisées à l'aide de la commande gcloud compute os-login ssh-keys remove :

    gcloud compute os-login ssh-keys remove --key=KEY
    

    Remplacez KEY par l'empreinte de la clé ou la chaîne de clé publique SSH complète.

Pour éviter de générer de nouvelles clés lors de la connexion à des VM, vous pouvez également effectuer l'une des opérations suivantes :

  • Réutilisez une paire de clés existante en spécifiant l'option --ssh-key-file avec la commande gcloud compute ssh :

    gcloud compute ssh VM_NAME --ssh-key-file=PATH_TO_PRIVATE_KEY
    
  • Si vous vous connectez fréquemment à des VM via SSH avec la gcloud CLI, créez une paire de clés SSH par défaut nommée google_compute_engine dans votre répertoire .ssh/. La ligne de commande gcloud CLI utilise cette paire de clés si elle existe et n'en génère pas de nouvelle à chaque connexion. Pour générer une paire de clés par défaut, exécutez la commande suivante :

    ssh-keygen -t rsa -f ~/.ssh/google_compute_engine -C USERNAME -b 2048
    

    Ensuite, ajoutez la clé publique à votre profil OS Login :

    gcloud compute os-login ssh-keys add --key-file=~/.ssh/google_compute_engine.pub
    

Cloud Build

Si vous utilisez Cloud Build et que le profil OS Login de votre compte de service dépasse la limite de 32 Kio, vous risquez de rencontrer des échecs de connexion SSH et de voir le message d'erreur suivant : Login profile size exceeds 32 KiB.... Pour résoudre ce problème, vous pouvez configurer Cloud Build de manière à utiliser des comptes de service spécifiés par l'utilisateur au lieu du compte de service Cloud Build par défaut.

Pour éviter que ce problème ne se reproduise, ajoutez un délai d'expiration pour les clés SSH. Les clés expirées sont automatiquement supprimées de votre profil de connexion 48 heures après leur expiration ou lorsque vous ajoutez une nouvelle clé à votre profil.

Code de réponse HTTP : 429

L'erreur suivante peut s'afficher lorsque vous essayez de vous connecter à une instance de calcul à l'aide de SSH :

Failed to validate organization user USERNAME has login permission, got HTTP response code: 429

Ce problème est dû à la limite de débit du serveur de métadonnées, qui est de 100 requêtes par seconde et par instance de calcul. Cette limite ne peut pas être ajustée. Pour résoudre ce problème, attendez quelques secondes, puis réessayez d'établir la connexion.

Pour éviter que ce problème ne se reproduise, essayez les solutions suivantes :

Entrées par défaut de métadonnées OS Login

Compute Engine définit un ensemble d'entrées de métadonnées par défaut qui fournit des informations OS Login. Les métadonnées par défaut sont toujours définies et configurées par le serveur. Les clés de métadonnées par défaut sont sensibles à la casse.

Le tableau suivant décrit les entrées que vous pouvez interroger.

Par rapport à http://metadata.google.internal/computeMetadata/v1/
Entrée de métadonnées Description
project/attributes/enable-oslogin Vérifie si OS Login est activé sur le projet Google Cloud en cours.
instance/attributes/enable-oslogin Vérifie si OS Login est activé sur l'instance de calcul actuelle.
oslogin/users/ Récupère les informations de profil des utilisateurs d'OS Login. Vous pouvez transmettre des paramètres de requête tels que username, uid, pagesize et pagetoken.
oslogin/authorize/

Récupère les paramètres d'autorisation de connexion ou d'administration pour un utilisateur d'OS Login.

Pour vérifier une autorisation, vous devez spécifier le paramètre de requête policy. La valeur du paramètre de règle doit être login (pour vérifier l'autorisation de connexion) ou adminLogin (pour vérifier l'accès sudo).

Vérifier si OS Login est configuré

Interrogez les métadonnées à l'aide de la console Google Cloud ou de Google Cloud CLI pour déterminer si OS Login est activé. OS Login est activé lorsque la clé de métadonnées enable-oslogin est définie sur TRUE dans les métadonnées d'un projet ou d'une instance. Si les métadonnées d'instance et de projet sont toutes deux définies, les métadonnées d'instance sont prioritaires.

Afficher les utilisateurs d'OS Login

Pour afficher les informations de profil de plusieurs utilisateurs, vous pouvez spécifier le paramètre pagesize. Remplacez pagesize par la valeur numérique requise.

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?pagesize=PAGE_SIZE" -H "Metadata-Flavor: Google"

Le résultat peut contenir un jeton de page, qui peut être utilisé dans les appels suivants pour lister d'autres utilisateurs.

Par exemple, pour définir pagesize sur 1, exécutez la commande suivante :

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?pagesize=1" -H "Metadata-Flavor: Google"

Pour obtenir l'utilisateur suivant, définissez pagesize sur 1 et pagetoken sur le jeton de page de la sortie de la commande précédente.

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?pagesize=1&pagetoken=PAGE_TOKEN" -H "Metadata-Flavor: Google"

Sur la plupart des distributions, vous pouvez également exécuter la commande Unix getent passwd afin de récupérer les entrées de mot de passe des utilisateurs de l'organisation.

Afficher un utilisateur d'OS Login spécifique

Pour afficher les informations de profil d'un utilisateur spécifique sur votre instance de calcul, exécutez la commande suivante :

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?username=USERNAME" -H "Metadata-Flavor: Google"

Remplacez USERNAME par le nom d'utilisateur sur lequel vous souhaitez effectuer la requête.

Par exemple, vous pouvez effectuer une requête pour rechercher l'utilisateur user_example_com. La commande et le résultat ci-dessous ont été mis en forme pour une meilleure lisibilité.

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?username=user_example_com" -H "Metadata-Flavor: Google"

Le résultat ressemble à ce qui suit :

{
    "loginProfiles": [{
        "name": "12345678912345",
        "posixAccounts": [{
            "primary": true,
            "username": "user_example_com",
            "uid": "123451",
            "gid": "123451",
            "homeDirectory": "/home/user_example_com",
            "operatingSystemType": "LINUX"
        }],
        "sshPublicKeys": {
            "204c4b4fb...": {
                "key": "ssh-rsa AAAAB3Nz...",
                "fingerprint": "204c4b4fb..."
            }
        }
    }]
}

Sur la plupart des distributions, vous pouvez également exécuter des commandes Unix telles que getent passwd username ou getent passwd uid pour récupérer les informations de profil.

Pour récupérer les clés SSH d'un utilisateur, vous pouvez également exécuter /usr/bin/google_authorized_keys USERNAME. Si aucune clé n'est renvoyée, l'utilisateur ne dispose peut-être pas des autorisations requises pour se connecter à l'instance de calcul.

Vérifier les autorisations de connexion

Pour afficher les autorisations de connexion et d'administration, vous devez fournir les paramètres de requête policy=login&email=LOGIN_NAME.

  1. Interrogez le profil utilisateur pour obtenir la valeur du champ name :

    curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?username=user_example_com" -H "Metadata-Flavor: Google"
  2. Dans le résultat, notez la valeur du champ name.

  3. Exécutez la commande login suivante en utilisant la valeur du champ name :

    curl "http://metadata.google.internal/computeMetadata/v1/oslogin/authorize?policy=login&email=LOGIN_NAME" -H "Metadata-Flavor: Google"
    

Par exemple, vous pouvez interroger les autorisations de connexion de l'utilisateur user_example_com affichées dans la section précédente.

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/authorize?policy=login&email=12345678912345" -H "Metadata-Flavor: Google"

Le résultat de la commande indique que l'utilisateur est autorisé à se connecter à l'instance de calcul :

{"success":true}

Vérifier si votre instance de calcul dispose d'un compte de service

Vous pouvez interroger le serveur de métadonnées pour trouver le compte de service associé à votre instance de calcul. Connectez-vous à votre instance de calcul et exécutez la commande suivante :

curl "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/" -H "Metadata-Flavor: Google"

Le résultat ressemble à ce qui suit :

12345-sa@developer.gserviceaccount.com/
default/

Si aucun compte de service n'est trouvé, le résultat est vide.

Problèmes SSH lorsque l'A2F est activée

Les sections suivantes expliquent comment OS Login avec authentification à deux facteurs (A2F) est configuré sur votre instance et comment résoudre les erreurs de connexion SSH lorsque l'A2F est activée.

Authentification à deux facteurs

L'A2F ajoute une couche de sécurité supplémentaire à OS Login. Si le compte d'un utilisateur de votre organisation est compromis, l'accès SSH à vos instances de calcul reste protégé jusqu'à ce qu'un deuxième facteur soit authentifié.

Lorsque vous définissez la clé de métadonnées enable-oslogin-2fa sur TRUE, l'agent invité ajoute la configuration PAM suivante pour l'A2F en haut du fichier /etc/pam.d/sshd :

auth       [success=done perm_denied=die default=ignore] pam_oslogin_login.so

L'agent invité met également à jour le fichier de configuration OpenSSH à l'échelle du système, /etc/ssh/sshd_config. L'agent invité ne supprime pas les paires mot clé-argument précédemment configurées du fichier, mais comme OpenSSH utilise la première valeur pour chaque paramètre, l'agent invité ajoute les lignes suivantes en haut du fichier /etc/ssh/sshd_config :

AuthenticationMethods publickey,keyboard-interactive
ChallengeResponseAuthentication yes

Résoudre les erreurs de connexion liées à l'A2F

Lorsque vous vous connectez à une instance de calcul en utilisant SSH avec l'A2F activée, Cloud Shell peut renvoyer un message d'erreur générique Permission denied (keyboard-interactive) ou not authorized sans spécifier la raison de l'échec :

Permission denied (keyboard-interactive)
ERROR: (gcloud.compute.start-iap-tunnel) Error while connecting [4033: 'not authorized'].
kex_exchange_identification: Connection closed by remote host
Connection closed by UNKNOWN port 65535

ERROR: (gcloud.compute.ssh) [/usr/bin/ssh] exited with return code [255].

Si vous rencontrez des problèmes pour vous connecter à une instance de calcul à l'aide de SSH lorsque l'A2F est activée, procédez comme suit :

  1. Pour déterminer si le problème est dû à l'A2F, annulez la définition de la clé de métadonnées enable-oslogin-2fa ou définissez-la sur FALSE, puis essayez de vous connecter à l'instance de calcul. Si l'instance de calcul reste inaccessible, il est peu probable que le problème soit lié à l'A2F.

  2. Si vous pouvez accéder à l'instance de calcul après avoir désactivé l'A2F, recherchez les messages d'erreur liés à l'A2F dans les fichiers journaux du répertoire /var/log/ pour déterminer pourquoi l'A2F a échoué.

  3. Une fois connecté à l'instance, réactivez enable-oslogin-2fa et vérifiez que l'agent invité a mis à jour les fichiers /etc/pam.d/sshd et /etc/ssh/sshd_config, par exemple en vérifiant leurs codes temporels de modification avec la commande ls -l. Vérifiez que les fichiers contiennent les entrées pam_oslogin_login.so, AuthenticationMethods publickey,keyboard-interactive et ChallengeResponseAuthentication yes requises, décrites dans Authentification à deux facteurs.

  4. Pour vérifier si la connexion a échoué parce que la validation en deux étapes n'est pas activée sur votre compte Google ou votre domaine, filtrez les journaux d'audit OS Login ou les fichiers journaux du répertoire /var/log/ pour rechercher le message d'erreur suivant :

    "message": "The caller does not have permission"
    
          "@type": "type.googleapis.com/google.cloud.oslogin.v1.StartSessionRequest",
          "supportedChallengeTypes": [
            "INTERNAL_TWO_FACTOR",
            "SECURITY_KEY_OTP",
            "AUTHZEN",
            "TOTP",
            "IDV_PREREGISTERED_PHONE"
          ],
    

    Ce message d'erreur est consigné lorsque vous n'avez pas activé la validation en deux étapes sur votre compte Google ou votre domaine. Votre client SSH peut également renvoyer l'erreur No supported authentication methods available (server sent: keyboard-interactive).

    Vous pouvez vérifier si la validation en deux étapes est activée pour votre compte dans les paramètres de sécurité de votre compte Google. Si la validation en deux étapes n'est pas activée sur votre compte, aucune boîte de dialogue ne vous invite à saisir un code de sécurité, et la tentative de connexion échoue avec une erreur Permission denied générique.

    Vous pouvez également contacter votre administrateur Google Workspace pour vérifier si la validation en deux étapes est activée sur votre domaine.

  5. Si la propriété response.challenges des journaux d'audit ContinueSession d'OS Login affiche un état autre que 'READY', cela peut indiquer un problème avec la question d'authentification que vous utilisez. L'exemple suivant montre des problèmes liés au code de validation par message vocal ou SMS qui n'est pas envoyé sur votre téléphone pour finaliser le processus de connexion :

    "response": {
        "challenges": [
          {
            "challengeId": 2,
            "challengeType": "IDV_PREREGISTERED_PHONE",
            "status": "RETRYABLE_ERROR"
          }
    

    Vous pouvez utiliser une autre méthode de validation, comme Google Authenticator, pour identifier le problème. Si vous parvenez à vous connecter à l'aide d'une autre méthode de validation, mais que vous ne recevez pas de codes de validation par message sur votre téléphone enregistré et que vous voyez RETRYABLE_ERROR pour IDV_PREREGISTERED_PHONE dans les journaux, contactez l'assistance Google Workspace.

Étapes suivantes