Intlayer CLI Login-Befehl

Beschreibung

Der login-Befehl der Intlayer-CLI ermöglicht es Ihnen, sich beim Intlayer CMS zu authentifizieren. Dieser Befehl öffnet automatisch Ihren Standardbrowser, um den Authentifizierungsprozess abzuschließen und die notwendigen Zugangsdaten (Client ID und Client Secret) zu erhalten, um die Intlayer-Dienste zu nutzen.

Verwendung

npx intlayer login [options]

oder

intlayer login [options]

Optionen

--cms-url <url>

Geben Sie die URL des Intlayer CMS an, zu dem die Verbindung zur Authentifizierung hergestellt werden soll.

• Typ: string
• Standardwert: Der in intlayer.config.* konfigurierte Wert oder https://intlayer.org
• Beispiel:

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

Konfigurationsoptionen

Sie können auch gängige Konfigurationsoptionen verwenden:

• --env-file <path>: Pfad zur Umgebungsdatei
• -e, --env <env>: Ausführungsumgebung
• --base-dir <dir>: Basisverzeichnis des Projekts
• --verbose: Detaillierte Ausgabe aktivieren (Standard: true)
• --prefix <prefix>: Präfix für Logs

Wie es funktioniert

1. Lokaler Serverstart: Der Befehl startet einen lokalen HTTP-Server auf einem zufälligen Port, um Zugangsdaten vom CMS zu empfangen
2. Browser öffnen: Der Befehl öffnet automatisch Ihren Standardbrowser zur CMS-Anmelde-URL
3. Authentifizierung: Schließen Sie die Authentifizierung im Browser mit Ihrem Intlayer-Konto ab
4. Empfang der Anmeldedaten: Der lokale Server empfängt die Client ID und das Client Secret vom CMS
5. Anleitungen: Der Befehl zeigt Anweisungen an, wie Sie die Anmeldedaten in Ihrem Projekt konfigurieren

Ausgabe

Nach erfolgreichem Login zeigt der Befehl Folgendes an:

1. Die empfangenen Anmeldedaten (Client ID und Client Secret)
2. Anleitungen für die .env-Datei:

INTLAYER_CLIENT_ID=your_client_id
INTLAYER_CLIENT_SECRET=your_client_secret

3. Anleitungen für die Intlayer-Konfigurationsdatei:

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

Zugriffsschlüssel sicher aufbewahren

intlayer login gibt einen Zugriffsschlüssel aus: ein clientId / clientSecret Paar, das von jedem authentifizierten Befehl (push, pull, fill, configuration push, live, …) zur Authentifizierung verwendet wird.

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 ist eine serverseitige Anmeldedaten. Sie gewährt vollständigen projektbezogenen API-Zugriff — Lesen und Schreiben Ihrer Wörterbücher, Ihres Projekts und Ihrer Organisation. Bewahren Sie es in .env (von git ignoriert) oder in Ihrem CI-Geheimnisspeicher auf und fügen Sie es niemals inline in die Konfigurationsdatei ein.

Intlayer erzwingt dies, anstatt es nur zu dokumentieren:

• clientSecret wird aus der Konfiguration entfernt, die Ihr Bundler inline setzt, sodass es unabhängig von der Framework-Integration kein Browser-Bundle erreichen kann. Es wird nur serverseitig zur Laufzeit aus der Umgebung gelesen.
• clientId ist anders: Es ist der öffentliche Projektschlüssel, sicher zu versenden und wird von @intlayer/analytics verwendet, um ein kurzlebiges, nur zum Erfassen bestimmtes Token zu erhalten.

Das Auskommentieren von clientId reicht aus, um jedes authentifizierte Verhalten zu deaktivieren — Remote-Wörterbuchabruf, CMS-Zugriff, Analytics — auch wenn die Umgebungsvariablen noch definiert sind.

Für CI-Pipelines bevorzugen Sie den ci Befehl, der die Anmeldedaten für die Dauer eines einzelnen Laufs injiziert, anstatt sie dauerhaft zu speichern.

Manuelle Konfiguration

Wenn der Browser nicht automatisch geöffnet wird, können Sie die im Terminal angezeigte URL manuell aufrufen.

Beispiele

Login mit benutzerdefinierter CMS-URL

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

Anmeldung mit spezifischer Umgebungsdatei

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

Anmeldung im verbose-Modus

npx intlayer login --verbose

Fehlerbehebung

Browser öffnet sich nicht

Wenn der Browser sich nicht automatisch öffnet, kopieren Sie die im Terminal angezeigte URL und öffnen Sie sie manuell in Ihrem Browser.

Verbindungsprobleme

Wenn Sie Verbindungsprobleme feststellen, überprüfen Sie:

1. Dass die CMS-URL korrekt ist
2. Dass Ihre Internetverbindung ordnungsgemäß funktioniert
3. Dass keine Firewalls die Verbindung blockieren
4. Dass Ihre Internetverbindung ordnungsgemäß funktioniert
5. Dass keine Firewalls die Verbindung blockieren

Anmeldeinformationen nicht erhalten

Wenn Sie keine Anmeldeinformationen erhalten haben:

1. Stellen Sie sicher, dass Sie den Authentifizierungsprozess im Browser abgeschlossen haben
2. Überprüfen Sie, dass der lokale Port nicht blockiert ist
3. Versuchen Sie den Befehl erneut

Nächste Schritte

Nach dem Abschluss der Anmeldung:

1. Fügen Sie die Anmeldeinformationen zu Ihrer .env-Datei hinzu
2. Konfigurieren Sie Ihre intlayer.config.*-Datei mit den Anmeldeinformationen
3. Verwenden Sie CLI-Befehle, um Ihre Wörterbücher zu verwalten:
   • npx intlayer push - Wörterbücher in das CMS pushen
   • npx intlayer pull - Wörterbücher aus dem CMS pullen
   • npx intlayer fill - Fehlende Übersetzungen auffüllen
   • npx intlayer fill - Fehlende Übersetzungen auffüllen

Siehe auch

• CLI-Dokumentation
• Intlayer-Konfiguration
• Intlayer CMS