Ověřování v CLI

Přihlaste se lokálně, předejte přihlašovací údaj pro CI a ověřte, jakou identitu příkaz použije.

CLI použije první dostupný přihlašovací údaj v tomto pořadí: globální --api-key pro dané volání, poté LINGO_API_KEY a nakonec uložený klíč nebo relaci prohlížeče v ~/.lingo/credentials.json. To je důležité při přepínání účtů: nově uložené přihlášení nemá přednost před klíčem, který už předává shell.

Přihlášení #

sh
lingo login
lingo whoami

Přihlášení bez klíče spustí ověření přes OAuth v prohlížeči a uloží relaci. CLI relace obnovuje krátce před vypršením jejich platnosti. Pokud obnovení selže, přihlaste se znovu.

Úspěšné přihlášení samo o sobě nedokončí nastavení organizace ani nezaručí splnění požadavků každé organizace na SSO. Pokud vás propojování přesměruje zpět do webové aplikace, dokončete nastavení dané organizace nebo přihlášení přes SSO a poté akci opakujte.

lingo login --api-key <value> ověří a uloží klíč. Globální --api-key u jiného příkazu naproti tomu platí pouze pro dané volání. Rozpoznává se oddělený zápis i zápis --api-key=value. Tajné údaje raději předávejte pomocí mechanismu pro jejich bezpečné vkládání než přímo na příkazovém řádku. Jinak se mohou objevit v historii shellu, při kontrole procesů nebo v diagnostických výstupech.

CLI vytvoří adresář pro přihlašovací údaje s oprávněními 0700 a soubor s přihlašovacími údaji s oprávněními 0600.

Zjištění identity #

sh
lingo whoami --json

Výsledek uvádí typ ověřování a dostupný kontext organizace a lokalizačního engine. Příkaz Whoami ověřuje přihlašovací údaje online. Při potížích s připojením může vrátit uložené informace v omezeném rozsahu; zamítnuté ověření však platnou identitu nepotvrzuje.

Tuto identitu zkontrolujte před propojením checkout. Uložené ID prostředku určuje, co se má použít; samo o sobě ale přihlašovacímu údaji neuděluje oprávnění daný prostředek používat.

Odhlášení #

sh
lingo logout

Odhlášení odstraní trvale uložené přihlašovací údaje. Další příkazy se ale stále mohou ověřovat klíčem z proměnné prostředí nebo přepínačem předaným při volání. Pokud už toto nastavení nechcete používat, odstraňte ho ze shellu. Odhlášení nezneplatní klíč, nesmaže prostředky ani nezruší propojení projektu.

CI #

Předejte LINGO_API_KEY pomocí mechanismu pro tajné údaje v prostředí pro spouštění úloh a do repozitáře ukládejte pouze konfiguraci projektu bez tajných údajů. CLI spouštějte z kořenového adresáře příslušného projektu. Relaci z domovského adresáře vývojáře do CI nekopírujte.

Nativní integrace s GitHub má vlastní oprávnění a schvalování spuštění, nezávislé na prostředí pro spouštění CLI ve vlastní správě.