Fejlesztői dokumentáció
Hitelesítés, engedélyek és biztonságos hitelesítő adatok
Ügynökhöz OAuth-hitelesítést, a szervereden személyes hozzáférési tokent használj, és minden hívónak válaszd ki a szükséges engedélyeket.
Olvasás Markdown formátumbanEllenőrizte a SosoAPI csapata ·
Válassz hitelesítő adatot a hívóhoz
Ügynökhöz böngészős OAuth-ot használj: a felhasználó bejelentkezik és hozzáférést választ, a CLI pedig tárolja és frissíti a hitelesítő adatokat. Háttérszkripthez vagy CI-feladathoz adj személyes hozzáférési tokent a VICKY_API_KEY változóval. Hitelesítő adat ne kerüljön böngészőkódba, nyilvános adattárba, promptba, képernyőképre vagy megosztott naplóba.
A HTTP-példák a SOSOAPI_ACCESS_TOKEN szerveroldali környezeti változót használják a Bearer értékhez. Ez példaváltozó, nem CLI-beállítás. Ellenőrizd az egyes műveleteknél felsorolt hitelesítő adatokat; személyes hozzáférési tokennel nem kezelhetők API-kulcsok.
npx sosoapi auth loginnpx sosoapi auth statusnpx sosoapi auth logoutHatókör és képességek
Minden kérés ellenőrzi a munkaterületi tagságot és a művelethez szükséges szerepkört. A delegált OAuth a kiválasztott munkaterületekre és képességekre is korlátozza a hozzáférést. Az agent:operate az olvasást és előkészítést, az agent:publish az időzítést és közzétételt, az agent:engage a közösségi írásokat fedi le. Az API-kulcsok kezeléséhez külön engedély kell.
A személyes hozzáférési tokent a tulajdonosa szerepköre, valamint a tárolt képesség- vagy munkaterület-korlátok határolják. Csak az integrációhoz szükséges hozzáférést válaszd; az opcionális korlátok kihagyása széles hozzáférést hagyhat a kulcsnak. A core és full profil a látható eszközlistát változtatja, nem az engedélyeket. A közzétételi hozzáférés a megadott hatókörben minden bejegyzéshez új böngészős jóváhagyás nélkül folytatódik.
Hitelesítő adatok tárolása és visszavonása
A CLI a hitelesítő adatokat az operációs rendszer kulcstárában tárolja, ha elérhető, egyébként csak a tulajdonos által olvasható helyi fájlban. Az OAuth-hozzáférési tokenek egy óráig élnek, a bejelentkezési folyamat frissíti őket. Kapcsolatdiagnózishoz auth status használható, ne másold a hitelesítőadat-fájlt.
Vonj vissza eszközt vagy engedélyt a Beállítások → Ügynökök és API-hozzáférés alatt, vagy az auth logout paranccsal jelentkeztesd ki az aktuális helyi eszközt. Ez leállítja a jövőbeli hozzáférést. Nem von vissza közzétett bejegyzést vagy a SosoAPI által már elfogadott időzítést; ezeket külön ellenőrizd és kezeld.
Hitelesítési előkészítő végpontok
A négy agent-auth végpont a bejelentkezési protokollt dokumentálja. Bejelentkezéshez támogatott CLI-t vagy távoli OAuth-klienst használj; ezek a végpontok api post paranccsal nem érhetők el. A config, request, session és revoke-current eltérő hitelesítő adatokat és mezőket fogad. Kövesd a végpontok sémáit; a munkamenet-hitelesítő adatok ne kerüljenek kimenetre vagy naplóba.