CLI-Authentifizierung
Melde dich lokal an, stelle Zugangsdaten für CI bereit und vergewissere dich, welche Identität ein Befehl verwendet.
Die CLI verwendet die ersten verfügbaren Zugangsdaten: zuerst das globale --api-key des jeweiligen Aufrufs, dann LINGO_API_KEY und schließlich den gespeicherten Schlüssel oder die Browsersitzung in ~/.lingo/credentials.json. Das ist beim Kontowechsel wichtig: Eine neu gespeicherte Anmeldung kann einen Schlüssel, den deine Shell bereits bereitstellt, nicht überschreiben.
Anmelden #
lingo login
lingo whoamiEine Anmeldung ohne Schlüssel startet den OAuth-Anmeldevorgang im Browser und speichert eine Sitzung. Die CLI erneuert Sitzungen kurz vor ihrem Ablauf. Melde dich erneut an, wenn die Erneuerung fehlschlägt.
Eine erfolgreiche Anmeldung schließt weder die Einrichtung der Organisation ab noch erfüllt sie die SSO-Anforderungen jeder Organisation. Wenn du beim Verknüpfen zurück zur Web-App geleitet wirst, schließe die Einrichtung oder die SSO-Anmeldung für diese Organisation ab, bevor du es erneut versuchst.
lingo login --api-key <value> validiert und speichert einen Schlüssel. Das globale --api-key bei einem anderen Befehl gilt dagegen nur für den jeweiligen Aufruf. Sowohl die getrennte Schreibweise als auch die Form --api-key=value werden erkannt. Übergib geheime Werte vorzugsweise über einen Mechanismus zur sicheren Einspeisung statt direkt in der Befehlszeile: Dort können sie im Shell-Verlauf, bei der Einsicht in Prozesse oder in Diagnosedaten sichtbar werden.
Die CLI erstellt ihr Verzeichnis für Zugangsdaten mit dem Modus 0700 und ihre Zugangsdaten-Datei mit dem Modus 0600.
Identität anzeigen #
lingo whoami --jsonDas Ergebnis zeigt die Authentifizierungsart und den verfügbaren Kontext für Organisation und Lokalisierungs-Engine. Whoami validiert die Zugangsdaten online. Bei einem Verbindungsfehler kann der Befehl gespeicherte Informationen in eingeschränktem Umfang zurückgeben. Eine abgelehnte Authentifizierung bestätigt keine gültige Identität.
Vergewissere dich, dass die Identität stimmt, bevor du ein checkout verknüpfst. Eine gespeicherte Ressourcen-ID legt fest, welche Ressource verwendet werden soll. Sie erteilt den Zugangsdaten jedoch keine Berechtigung, diese Ressource zu nutzen.
Abmelden #
lingo logoutDie Abmeldung entfernt dauerhaft gespeicherte Zugangsdaten. Ein Schlüssel aus der Umgebung oder eine Option beim Aufruf kann nachfolgende Befehle weiterhin authentifizieren. Entferne die überschreibende Einstellung in der Shell, wenn du sie nicht mehr verwenden möchtest. Die Abmeldung widerruft keinen Schlüssel, löscht keine Ressourcen und hebt die Verknüpfung des Projekts nicht auf.
CI #
Stelle LINGO_API_KEY über den Mechanismus des Runners für geheime Werte bereit und nimm nur Projektkonfiguration ohne geheime Werte in Commits auf. Führe die CLI im vorgesehenen Projektstammverzeichnis aus. Kopiere keine Sitzung aus dem Home-Verzeichnis einer Entwicklerin oder eines Entwicklers in CI.
Die native GitHub-Integration hat eigene Berechtigungen und eine eigene Freigabe für Ausführungen, getrennt von einem selbst verwalteten CLI-Runner.