Commande login de l'Intlayer CLI

Description

La commande login de l'Intlayer CLI vous permet de vous authentifier auprès du CMS Intlayer. Cette commande ouvre automatiquement votre navigateur par défaut pour compléter le processus d'authentification et recevoir les identifiants nécessaires (Client ID et Client Secret) pour utiliser les services Intlayer.

Utilisation

npx intlayer login [options]

ou

intlayer login [options]

Options

--cms-url <url>

Spécifie l'URL du CMS Intlayer auquel se connecter pour l'authentification.

• Type: string
• Par défaut: la valeur configurée dans intlayer.config.* ou https://intlayer.org
• Exemple:

npx intlayer login --cms-url https://intlayer.org

Options de configuration

Vous pouvez également utiliser les options de configuration courantes :

• --env-file <path> : Chemin vers le fichier d'environnement
• -e, --env <env> : Environnement d'exécution
• --base-dir <dir> : Répertoire de base du projet
• --verbose : Activer la sortie détaillée (par défaut : true)
• --prefix <prefix> : Préfixe pour les logs

Fonctionnement

1. Démarrage du serveur local : la commande lance un serveur HTTP local sur un port aléatoire pour recevoir les identifiants depuis le CMS
2. Ouverture du navigateur : La commande ouvre automatiquement votre navigateur par défaut à l'URL de connexion du CMS
3. Authentification : Complétez l'authentification dans le navigateur en utilisant votre compte Intlayer
4. Réception des identifiants : Le serveur local reçoit le Client ID et le Client Secret depuis le CMS
5. Instructions : La commande affiche des instructions pour configurer les identifiants dans votre projet

Sortie

Après une connexion réussie, la commande affichera :

1. Les identifiants reçus (Client ID et Client Secret)
2. Instructions pour le fichier .env :

INTLAYER_CLIENT_ID=your_client_id
INTLAYER_CLIENT_SECRET=your_client_secret

3. Instructions pour le fichier de configuration Intlayer :

{
  editor: {
    cmsURL: 'https://intlayer.org',
    clientId: process.env.INTLAYER_CLIENT_ID,
    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
  },
}
    clientId: process.env.INTLAYER_CLIENT_ID,
    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
  },
}

Conserver la clé d'accès en sécurité

intlayer login émet une clé d'accès : une paire clientId / clientSecret que chaque commande authentifiée (push, pull, fill, configuration push, live, …) utilise pour s'authentifier.

import type { IntlayerConfig } from "intlayer";

const config: IntlayerConfig = {
  editor: {
    clientId: process.env.INTLAYER_CLIENT_ID,
    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
  },
};

export default config;

clientSecret est une credential côté serveur. Elle accorde un accès API complet avec portée projet — lecture et écriture de vos dictionnaires, votre projet et votre organisation. Conservez-la dans .env (ignorée par git) ou votre stockage secret CI, et ne l'insérez jamais en dur dans le fichier de configuration.

Intlayer force cela plutôt que de simplement le documenter :

• clientSecret est supprimée de la configuration que votre bundler inline, elle ne peut donc pas atteindre un bundle navigateur quel que soit l'intégration de framework que vous utilisez. Elle n'est lue que côté serveur, au runtime, depuis l'environnement.
• clientId est différente : c'est la clé publique du projet, sûre à déployer, et utilisée par @intlayer/analytics pour obtenir un token à courte durée de vie, réservé à l'ingestion.

Commenter clientId suffit pour désactiver tout comportement authentifié — récupération de dictionnaire distant, accès CMS, analytics — même quand les variables d'environnement sont toujours définies.

Pour les pipelines CI, préférez la commande ci, qui injecte les credentials pour la durée d'une seule exécution au lieu de les persister.

Configuration manuelle

Si le navigateur ne s'ouvre pas automatiquement, vous pouvez visiter manuellement l'URL affichée dans le terminal.

Exemples

Connexion avec une URL CMS personnalisée

npx intlayer login --cms-url https://custom-cms.example.com

Connexion avec un fichier d'environnement spécifique

npx intlayer login --env-file .env.production

Connexion en mode verbeux

npx intlayer login --verbose

Dépannage

Le navigateur ne s'ouvre pas

Si le navigateur ne s'ouvre pas automatiquement, copiez l'URL affichée dans le terminal et ouvrez-la manuellement dans votre navigateur.

Problèmes de connexion

Si vous rencontrez des problèmes de connexion, vérifiez :

1. Que l'URL du CMS est correcte
2. Que votre connexion internet fonctionne correctement
3. Qu'aucun pare-feu ne bloque la connexion

Identifiants non reçus

Si les identifiants ne sont pas reçus :

1. Assurez-vous d'avoir complété le processus d'authentification dans le navigateur
2. Vérifiez que le port local n'est pas bloqué
3. Réessayez la commande

Étapes suivantes

Après avoir terminé la connexion :

1. Ajoutez les identifiants à votre fichier .env
2. Configurez votre fichier intlayer.config.* avec les identifiants
3. Utilisez les commandes CLI pour gérer vos dictionnaires :
   • npx intlayer push - Pousser les dictionnaires vers le CMS
   • npx intlayer pull - Récupérer les dictionnaires depuis le CMS
   • npx intlayer fill - Remplir les traductions manquantes

Voir aussi

• Documentation CLI
• Configuration d'Intlayer
• CMS Intlayer