CLI-hitelesítés
Böngészős bejelentkezés eszközfolyamattal, vagy API-kulcs környezeti változóban.
Melyiket válaszd
| Helyzet | Módszer |
|---|---|
| Saját gép, van böngésző. | posty auth:login |
| Szerver, konténer, ütemezett futás, CI. | POSTY_API_KEY környezeti változó |
Böngészős bejelentkezés
posty auth:loginA parancs megnyit egy böngészőt, ahol egy kóddal jóváhagyod a hozzáférést. A hitelesítő adatot ezután a gépeden tárolja a CLI, így nem kell a szkriptjeidbe írnod, és nem kerül a parancselőzményekbe.
Ez szándékos: aki nincs belépve, előbb lássa, mit hagy jóvá, melyik eszközt és melyik kódot, és csak utána jelentkezzen be. Jóváhagyás bejelentkezés nélkül nem történik.
API-kulcs változóból
Ha nincs böngésző, add meg az API-kulcsot környezeti változóban. A kulcsot a Postyban készíted, az Automatizálások → Fejlesztőknek oldalon; lásd a Fejlesztői beállítások oldalt.
export POSTY_API_KEY=psty_a_kulcsod
posty integrations:list- Ha van tárolt bejelentkezés, az élvez elsőbbséget a környezeti változóval szemben.
- A kulcsot titokkezelőből add át, ne írd bele a szkriptbe és ne verziókövesd.
- Ütemezett futásnál a
POSTY_TIMEZONEváltozót is érdemes beállítani, hogy a dátumok egyértelműek legyenek.
Állapot és kilépés
posty auth:status # melyik munkaterülethez van kötve a gép
posty auth:logout # a tárolt hitelesítő adat törléseAz auth:status nemcsak kiírja az állapotot, hanem ellenőrzi is a hitelesítő adatot egy valódi hívással. Ha ez működik, a hitelesítés rendben van, és minden további hiba már a parancsról szól.
Munkaterületek
posty workspaces:list # mit ér el a kulcs; a "current" az aktív
posty workspaces:use <id> # innentől minden parancs ezen dolgozik
posty workspaces:current # melyiken dolgoznak most a parancsok
posty posts:list --workspace <id> # egy parancs másik munkaterületenEgy kulcs egy vagy több munkaterületre szólhat. A jóváhagyási oldalon az „Az összes munkaterületem” lehetőséggel a többihez is hozzáférést adhatsz. A csatornaazonosítók munkaterülethez tartoznak, ezért a parancssornak tudnia kell, melyikről van szó. Az auth:login rákérdez a munkaterületre, ha a kulcs többre is szól. A választás a bejelentkezéssel együtt tárolódik. A POSTY_WORKSPACE vagy a --workspace felülírja ezt. Választás nélkül az API minden útvonalon 403-mal utasítja el a kérést, a workspaces:list kivételével. Így a parancssor soha nem posztol találgatás alapján kiválasztott munkaterületre.
Saját háttérszerver
Alapértelmezés szerint a CLI a posty.hu szolgáltatáshoz csatlakozik. Ha másik példányhoz csatlakoznál, a --auth-server kapcsolóval, illetve a POSTY_API_URL változóval állítható át.
export POSTY_API_URL=https://sajat-peldany.example/api
posty auth:login --auth-server https://sajat-peldany.example/api