Authentification CLI

Gérez vos sessions CLI et sécurisez vos accès avec des tokens d'API.

Connexion (Login)

La commande login permet d'associer la CLI à votre compte EnvSafe via un Token d'Accès Personnel (Personal Access Token).

envsafe login

Étapes :

  1. Exécutez envsafe login
  2. La CLI vous demandera de coller votre token
  3. Le token est stocké de manière sécurisée sur votre machine
  4. Vous êtes maintenant authentifié !

🔑 Générer un token

Rendez-vous dans votre Dashboard → API Tokens (ou Tokens API) pour créer un nouveau token. Copiez-le immédiatement car il ne sera plus affiché ultérieurement.

Vérifier l'identité (Whoami)

Affichez les informations du compte actuellement connecté.

envsafe whoami

Cette commande affiche votre email et les informations de votre profil.

Déconnexion (Logout)

Supprimez le token stocké localement sur votre machine.

envsafe logout

⚠️ Note : Cette commande ne révoque pas le token côté serveur. Pour révoquer définitivement un token, rendez-vous dans votre Dashboard.

Authentification en CI/CD

Dans des environnements automatisés (GitHub Actions, GitLab CI, etc.), vous ne pouvez pas utiliser le prompt interactif. Utilisez l'une de ces méthodes :

Méthode 1 : Variable d'environnement (Recommandé)

# Définissez ENVSAFE_TOKEN comme secret dans votre CI/CD
export ENVSAFE_TOKEN=es_live_xxxxxxxxxxxxx

# Utilisez directement les commandes sans login
envsafe pull my-project
envsafe run --project my-project npm test

✅ Plus sécurisé : le token n'apparaît jamais dans les logs

Méthode 2 : Flag --token

envsafe login --token es_live_xxxxxxxxxxxxx

⚠️ Moins sécurisé : le token peut apparaître dans l'historique et les logs

Exemples CI/CD

GitHub Actions

name: Deploy
on: [push]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install EnvSafe CLI
        run: npm install -g @envsafes-org/cli
      
      - name: Deploy with EnvSafe
        env:
          ENVSAFE_TOKEN: ${{ secrets.ENVSAFE_TOKEN }}
        run: |
          envsafe run --project my-project -p npm run build
          envsafe run --project my-project -p npm run deploy

GitLab CI

deploy:
  script:
    - npm install -g @envsafes-org/cli
    - envsafe run --project my-project -p npm run deploy
  variables:
    ENVSAFE_TOKEN: $ENVSAFE_TOKEN_SECRET

Docker

FROM node:20
RUN npm install -g @envsafes-org/cli
COPY . /app
WORKDIR /app
CMD ["envsafe", "run", "--project", "my-project", "-p", "npm", "start"]

🔒 Bonnes pratiques de sécurité

  • ✓ Ne commitez jamais vos tokens dans Git
  • ✓ Utilisez des tokens avec des permissions minimales (lecture seule si possible)
  • ✓ Configurez une date d'expiration pour vos tokens
  • ✓ Révoquez immédiatement les tokens compromis
  • ✓ En CI/CD, utilisez toujours la variable d'environnement ENVSAFE_TOKEN
PrécédentInstallationSuivantCommandes & Usage