Autentifikācija
Divi akreditācijas dati — API atslēga mašīnām, sesija konsoles saskarnei — un noteikumi, kas tos nošķir.
Divi akreditācijas datu veidi
API pieņem API atslēgu. Konsoles saskarne pieņem sesijas sīkdatni. Tie nav savstarpēji aizstājami, un API to ievieš, nevis katrā pieprasījumā lemj, vai sīkdatne tur bija domāta.
Pieprasījums, kas autentificēts ar sesijas sīkdatni, saņem 403 api_key_required ar ziņojumu, kas norāda uz konsoles atslēgu lapu. Tas ir apzināti: tā kā API nav ar sīkdatni autentificēta ceļa, starpvietņu pieprasījumam nav ko viltot.
Galvene
Nosūtiet atslēgu kā bearer marķieri. Atslēga ir prefikss, punkts un noslēpums; prefikss identificē ierakstu, tāpēc atsaukšana ir tūlītēja un prasa vienu uzmeklēšanu.
curl https://api.llmeu.com/v1/chat/completions \
-H "Authorization: Bearer llmeu_live_xxxxxxxx.your-secret" \
-H "Content-Type: application/json" \
-d '{"model":"llmeu-auto","messages":[{"role":"user","content":"Hello"}]}'Tvērumi
Atslēgai ir viens vai vairāki tvērumi. Pieprasījums, kura atslēgai nav galapunkta prasītā tvēruma, tiek noraidīts ar 403 insufficient_scope pirms satura parsēšanas.
| Tvērums | Atbloķē |
|---|---|
| inference | Tērzēšanas pabeigumi, iegultnes un modeļu saraksta un detalizētās informācijas galapunkti. |
| platform_read | Lasīt savu organizāciju: profilu, atslēgas, lietojumu, izsekojumus un politikas. |
| platform_write | Izveidot un atsaukt atslēgas, kā arī izveidot vai rediģēt politikas. Šis ir tvērums, kas maina, kas ko drīkst darīt, tāpēc piešķiriet to apzināti. |
Tvērumi tiek pārbaudīti katrā galapunktā, nevis katrā atslēgā. Atslēga ar platform_read nevar tērēt kredītu caur rotaļu laukumu.
Atslēgas izveide
Konsolē vai platformas API ar atslēgu, kurai jau ir platform_write. Noslēpums tiek parādīts vienreiz, kad tas tiek izveidots: tiek glabāta tikai scrypt jaucējvērtība, tāpēc neviens — arī mēs — nevar to nolasīt atpakaļ.
curl -X POST https://api.llmeu.com/platform/v1/api-keys \
-H "Authorization: Bearer llmeu_live_xxxxxxxx.a-platform-write-key" \
-H "Content-Type: application/json" \
-d '{"name":"ci","scopes":["inference"]}'Administratīvās darbības konsolē — politikas, komanda, iestatījumi, kredīts, atslēgu atsaukšana — ir pieejamas tikai īpašniekam vai administratoram neatkarīgi no tā, kādi tvērumi ir atslēgai.
Atsaukšana un tas, kas atslēga nav
Atslēga pieder organizācijai, un organizācija tiek noteikta no pašas atslēgas — nekad no lauka pieprasījuma saturā, tāpēc izsaucējs nevar uzrunāt citu nomnieku, tikai laipni lūdzot. Atsaukšana stājas spēkā nākamajā pieprasījumā. Rotācija nozīmē izveidot otru atslēgu, pārvietot trafiku un pēc tam atsaukt pirmo; nav konfigurējama pārklāšanās loga.
Savukārt konsolē
Pieteikšanās, paroles atjaunošana un adreses pārbaude ir dokumentēta kopā ar konsoli. Nav OAuth, nav SAML un nav personīgās piekļuves pilnvaras: konsolē izmanto sesijas sīkdatni, API izmanto atslēgas.