Awentikazzjoni

Żewġ kredenzjali — ċavetta API għall-magni, sessjoni għall-console — u r-regoli li jżommuhom separati.

Żewġ tipi ta' kredenzjali

L-API tieħu ċavetta API. Il-console tieħu cookie tas-sessjoni. Mhumiex interkambjabbli, u l-API tinfurza dan minflok ma tiddeċiedi talba b'talba jekk cookie kinitx maħsuba li tkun hemm.

Browser illoggjat ma jistax isejjaħ l-API

Talba awtentikata b'cookie tas-sessjoni tirċievi 403 api_key_required, b'messaġġ li jindika lejn il-paġna taċ-ċwievet tal-console. Dan huwa intenzjonat: peress li m'hemmx triq awtentikata bil-cookie lejn l-API, m'hemm xejn li talba cross-site tista' tiffalsifika.

L-header

Ibgħat iċ-ċavetta bħala bearer token. Ċavetta hija prefiss, tikka u sigriet; il-prefiss jidentifika r-ringiela, għalhekk ir-revoka hija immedjata u tiswa tiftixa waħda.

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"}]}'

Skopijiet

Ċavetta ġġorr skop wieħed jew aktar. Talba li ċ-ċavetta tagħha ma jkollhiex l-iskop li jeħtieġ endpoint tiġi miċħuda b'403 insufficient_scope, qabel ma jiġi pparsjat il-body.

Skop	Jiftaħ
inference	Chat completions, embeddings, u l-endpoints tal-lista u tad-dettalji tal-mudelli.
platform_read	Aqra l-organizzazzjoni tiegħek: profil, ċwievet, użu, traċċi u politiki.
platform_write	Oħloq u revoka ċwievet, u oħloq jew editja politiki. Dan huwa l-iskop li jbiddel min jista' jagħmel xiex, għalhekk oħloqha b'mod intenzjonat.

L-iskopijiet jiġu ċċekkjati għal kull endpoint, mhux għal kull ċavetta. Ċavetta b'platform_read ma tistax tonfoq kreditu mill-playground.

Ħolqien ta' ċavetta

Fil-console, jew permezz tal-API tal-pjattaforma b'ċavetta li diġà ġġorr platform_write. Is-sigriet jintwera darba, meta jinħoloq: jinħażen biss hash scrypt, għalhekk ħadd — inkluż aħna — ma jista' jerġa' jaqrah.

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"]}'

Azzjonijiet amministrattivi fil-console — politiki, tim, impostazzjonijiet, kreditu, revoka ta' ċwievet — huma biss għas-sid jew għall-admin, tkun xi tkun l-iskopijiet li ġġorr ċavetta.

Revoka, u x'ma hijiex ċavetta

Ċavetta tappartjeni lil organizzazzjoni, u l-organizzazzjoni tiġi risolta mill-ċavetta stess — qatt minn field fil-body tat-talba, għalhekk min isejjaħ ma jistax jindirizza tenant ieħor billi jitlob bil-ħlewwa. Ir-revoka tieħu effett fuq it-talba li jmiss. Rotazzjoni tfisser toħloq it-tieni ċavetta, ċċaqlaq it-traffiku, imbagħad tirrevoka l-ewwel; m'hemmx tieqa ta' sovrappożizzjoni x'jiġi kkonfigurat.

Għall-console minflok

Id-dħul, l-irkupru tal-password u l-verifika tal-indirizz huma dokumentati mal-console. M'hemmx OAuth, m'hemmx SAML u m'hemmx token ta' aċċess personali: il-console tuża cookie tas-sessjoni, l-API tuża ċwievet.