Authentification de la CLI
Connectez-vous en local, fournissez des identifiants d’authentification pour la CI et vérifiez l’identité qu’une commande utilisera.
La CLI utilise les premiers identifiants d’authentification disponibles : d’abord l’option globale --api-key de l’appel, puis LINGO_API_KEY, puis la clé ou la session de navigateur enregistrée dans ~/.lingo/credentials.json. Cet ordre compte lorsque vous changez de compte : une nouvelle connexion enregistrée ne peut pas prendre le pas sur une clé déjà fournie par votre shell.
Connexion #
lingo login
lingo whoamiUne connexion sans clé lance l’authentification OAuth dans le navigateur et enregistre une session. La CLI renouvelle les sessions à l’approche de leur expiration ; reconnectez-vous si le renouvellement échoue.
Une connexion réussie ne termine pas la configuration de l’organisation et ne répond pas nécessairement aux exigences SSO de chaque organisation. Si l’association vous redirige vers l’application web, terminez la configuration de cette organisation ou connectez-vous via son SSO avant de réessayer.
lingo login --api-key <value> vérifie et enregistre une clé. En revanche, l’option globale --api-key utilisée avec une autre commande ne s’applique qu’à cet appel. La forme séparée et la forme --api-key=value sont toutes deux reconnues. Privilégiez l’injection de secrets plutôt que leur saisie en ligne de commande : ils peuvent apparaître dans l’historique du shell, lors de l’inspection des processus ou dans les diagnostics.
La CLI crée son répertoire d’identifiants d’authentification avec le mode 0700 et son fichier d’identifiants d’authentification avec le mode 0600.
Identité actuelle #
lingo whoami --jsonLe résultat indique le type d’authentification ainsi que le contexte disponible pour l’organisation et le moteur de localisation. La commande de vérification de l’identité contrôle les identifiants d’authentification en ligne. En cas de problème de connexion, elle peut renvoyer un nombre limité d’informations enregistrées ; une authentification rejetée ne permet pas d’établir une identité valide.
Vérifiez cette identité avant d’associer un checkout. Un ID de ressource enregistré détermine la ressource à utiliser ; il ne donne pas aux identifiants d’authentification l’autorisation de l’utiliser.
Déconnexion #
lingo logoutLa déconnexion supprime les identifiants d’authentification enregistrés. Une clé définie dans l’environnement ou une option passée lors de l’appel peut toujours authentifier les commandes suivantes. Supprimez la valeur prioritaire définie dans le shell lorsque vous souhaitez cesser de l’utiliser. La déconnexion ne révoque aucune clé, ne supprime aucune ressource et ne dissocie pas le projet.
CI #
Fournissez LINGO_API_KEY via le mécanisme de gestion des secrets de l’exécuteur et ne committez que la configuration du projet qui ne contient aucun secret. Exécutez la CLI depuis la racine du projet concerné. Ne copiez pas dans la CI une session issue du répertoire personnel d’un développeur ou d’une développeuse.
L’intégration GitHub native dispose de ses propres autorisations et de son propre mécanisme d’approbation des exécutions, distincts de ceux d’un exécuteur CLI autogéré.