# gt: General Translation CLI tool: gt login URL: https://generaltranslation.com/fr/docs/cli/reference/commands/login.mdx Docs index: https://generaltranslation.com/llms.txt Description: Connectez-vous à votre compte pour les workflows CLI hébergés. Référence de l'API de la commande gt login. Utilisez login pour authentifier une configuration existante. Pour une configuration de projet guidée, exécutez [`gt init`](/docs/cli/reference/commands/init); cette commande vous connecte lorsqu'elle crée un projet ou une clé et qu'aucune tooling key ni aucune connexion enregistrée n'est disponible. Pour créer une clé à portée restreinte, utilisez [`gt api-key create`](/docs/cli/reference/commands/api-key-create). ## Présentation [#overview] Nécessite [Node.js 20 ou une version ultérieure](/docs/cli/quickstart#quickstart) ; privilégiez une version LTS encore prise en charge. ```bash npx gt login [options] ``` | Paramètre | Description | Type | Facultatif | Valeur par défaut | | ------------------------------- | ---------------------------------------------------------------------------------------------- | --------- | ---------- | ----------------- | | [`--no-browser`](#flags) | Utilise l'autorisation par appareil au lieu d'un callback local via le navigateur. | `boolean` | Oui | `false` | | [`-c, --config `](#flags) | Fichier de configuration dont la valeur `baseUrl` détermine l'API à laquelle se connecter. | `string` | Oui | `gt.config.json` | **Modifié dans la v2.22 :** l'ancienne commande auth et son option de type de clé ont été supprimées ; elles ne sont pas conservées comme alias. La commande login remplace la connexion au compte, tandis que init et la création explicite de clés prennent en charge le provisionnement. Les clés API existantes restent utilisables. ## Fonctionnement [#how-it-works] * Ouvre votre navigateur pour que vous puissiez autoriser l’accès de la CLI à votre compte. * Les permissions de votre compte déterminent les projets et les opérations auxquels vous avez accès. * Utilise l’autorisation par appareil avec `--no-browser`, ou si la commande ne peut pas écouter le callback du navigateur sur cette machine. Elle affiche alors une URL de vérification et un code à approuver sur un autre appareil. * Utilise automatiquement l’autorisation par appareil dans les sessions SSH. Un échec d’ouverture du navigateur ne suffit pas à changer de mode : ouvrez vous-même l’URL d’autorisation affichée, ou relancez la commande avec `--no-browser`. * Enregistre une session de compte, et non une sélection de projet. La commande ne crée pas de clés API et n’écrit pas de fichier `.env.local`. Les SDK d’exécution ne chargent pas les sessions de la CLI. Pour l’association à un projet, la priorité des clés explicites et les identifiants en CI, consultez [Configurer la CLI](/docs/cli/guides/configuring#credentials). ## Options [#flags] **`--no-browser`** · **Type** `boolean` · **Facultatif** · **Valeur par défaut** `false` Utilise l'autorisation par appareil sans ouvrir de navigateur. Une approbation humaine reste nécessaire : il ne s'agit pas d'une authentification CI sans intervention. **`-c, --config `** · **Type** `string` · **Facultatif** · **Valeur par défaut** `gt.config.json` Lit [`baseUrl`](/docs/cli/reference/config#base-url) depuis ce fichier de configuration plutôt que depuis le fichier `gt.config.json` détecté. `GT_API_URL` reste prioritaire. Nécessite `gt` 2.23.0 ou une version ultérieure. Les [options globales](/docs/cli/reference/global-options) s'appliquent également. ## Exemples [#examples] ```bash # Se connecter via un navigateur sur cette machine npx gt login # Approuver la connexion depuis un autre appareil npx gt login --no-browser ``` Une fois l'autorisation accordée, vérifiez le compte connecté avec [`gt whoami`](/docs/cli/reference/commands/whoami). Utilisez [`gt logout`](/docs/cli/reference/commands/logout) pour supprimer la session enregistrée. ## Stockage et dépannage [#storage] Les sessions sont stockées dans `$XDG_STATE_HOME/gt/credentials.json` lorsque `XDG_STATE_HOME` est un chemin absolu, sinon dans `~/.local/state/gt/credentials.json`. Les valeurs XDG relatives sont ignorées. Lorsque le système le permet, les identifiants sont protégés par des permissions de fichier réservées au propriétaire ; ils ne sont ni chiffrés ni stockés dans un trousseau du système d'exploitation. Les anciens formats de connexion enregistrée ne sont pas migrés automatiquement. Reconnectez-vous si vos identifiants enregistrés sont obsolètes ou invalides. Les fichiers d'identifiants corrompus sont préservés sous forme de sauvegardes `.corrupt-`. La CLI conserve votre session d'une commande à l'autre. Évitez de mettre à jour la même connexion enregistrée depuis plusieurs processus CLI en même temps. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.