Vodnik in vpogled

Kontrolniki skupine, ki jih poganja SCIM, za prehod AI API: zagotavljanje uporabnikov, preklic ključev in ohranjanje delovanja računov storitev

Uporabite SCIM in SSO kot vhode življenjskega cikla, nato pa pustite, da prehod uveljavlja eksplicitne vloge, profile modelov, pooblastilo za porabo, lastništvo ključa in pravila za prenos storitvenega računa. Cilj je hitra odstranitev brez prekinitve proizvodnih aplikacij.

Izključitev osebe ne sme postati vaja za izpad. V mnogih skupinah lahko ponudnik identitete zaposlenega hitro onemogoči, vendar ima prehod AI API še vedno dolgotrajne razvijalske ključe, skripte v skupni rabi, račune proizvodnih storitev, najemnike preprodajalcev in privilegije za zaračunavanje, ki se ne preslikajo čisto v en človeški račun. Praktični vzorec je uporaba SCIM kot vnos življenjskega cikla, nato pa avtorizacija, lastništvo ključa, omejitve porabe, dostop do modela in revizijski zapisi ostanejo kot izrecni objekti prehoda.

Težava: Spremembe identitete niso enake avtorizaciji API

SSO odgovori, ali se uporabnik lahko prijavi. SCIM pomaga avtomatizirati oskrbo uporabnikov in skupin. Nobeden sam po sebi ne odgovori na vsa operativna vprašanja, ki jih mora uveljaviti prehod AI: katerega najemnika lahko ta uporabnik upravlja, katere modelne profile lahko uporablja, kateri ključi so osebni, kateri ključi vodijo proizvodnjo, kdo lahko odobri povišanje proračuna in katerih predmetov strank API-ja partnerja se lahko dotakne?

Čista arhitektura obravnava identiteto kot vir dogodkov v življenjskem ciklu in ne kot popoln model avtorizacije. Prehod mora prejemati spremembe uporabnikov in skupin od ponudnika identitete, jih normalizirati in prevesti v izvorne zapise prehoda. Te zapise je treba nato med izvajanjem oceniti za skrbniška dejanja, ustvarjanje ključa API-ja, dostop do modela, omejitve porabe, lastništvo storitvenega računa in revizijske izvoze.

Dejstvo: SCIM 2.0 je protokol standarda IETF za upravljanje identitete med domenami. Njegovo vedenje protokola je določeno v RFC 7644, njegove sheme virov pa so določene v RFC 7643. SCIM daje ekipam standarden način za ustvarjanje, posodabljanje, deaktiviranje in združevanje uporabnikov v sistemih.

Priporočilo: Avtorizacije prehoda ne postavljajte neposredno v imena skupin IdP ali poti zahtev. Uporabite skupine SCIM kot vnose v tabelo nadzorovanega preslikave, nato pa ocenite vloge in pravilnike prehoda iz zapisov v lasti prehoda.

Osnovni predmeti, ki bi jih moral imeti prehod

Prehod potrebuje lasten avtorizacijski model, ker dostop LLM združuje varnost, stroške in kontinuiteto delovanja. Najmanj te zapise definirajte kot prvorazredne objekte:

  • Identiteta: omogočen človeški uporabnik, povezan s subjektom IdP, e-pošto, statusom in članstvom v skupini.
  • Najemnik ali delovni prostor: upravna meja za uporabnike, ključe, proračune, profile modelov, integracije in uporabo.
  • Vloga: dovoljenja prehoda, kot so razvijalec, skrbnik najemnika, skrbnik za obračunavanje, skrbnik modela, revizor ali skrbnik API-ja partnerja.
  • Profil modela: dovoljen nabor modelov, pravil usmerjanja, omejitev za ravnanje s podatki in vrat funkcij.
  • Proračunski organ: kdo lahko porabi, zviša omejitve, ustvari drage ključe ali odobri začasne izjeme.
  • Ključ API v lasti človeka: ključ, ustvarjen za eno osebo, ki je običajno preklican ali začasno onemogočen, ko ta oseba odide.
  • Račun storitve: identiteta aplikacije z lastniki, namenom, okoljem, metapodatki o vrtenju, zadnjim uporabljenim časovnim žigom in priloženim pravilnikom.
  • Revizijski dogodek: hitro pomanjšan zapis o identiteti, vlogi, ključu, proračunu in odločitvah o avtorizaciji.

Zaradi te ločitve je izstopanje deterministično. Uporabnik lahko postane nedejaven, ne da bi izbrisal storitvene račune, ki so bili pravilno registrirani kot identitete aplikacije. Skrbnik najemnika lahko izgubi pooblastilo za obračunavanje, ne da bi izgubil osnovni revizijski dostop samo za branje. Prodajalec lahko upravlja dodeljene najemnike strank, ne da bi mogel našteti nepovezane najemnike.

Potek zagotavljanja: od dogodka SCIM do dostopa do prehoda

Uporaben tok zagotavljanja je že po zasnovi dolgočasen. Tolerirati mora ponovne poskuse, delne posodobitve in zakasnjeno skupinsko sinhronizacijo. Implementacije SCIM se razlikujejo po časovnem razporedu, vedenju brisanja proti deaktiviranju, preslikavah atributov in podpori skupin, zato se mora prehod izogibati krhkim predpostavkam.

1. Zaužij in normaliziraj uporabnika

Ko prehod prejme dogodek ustvarjanja ali posodobitve uporabnika SCIM, mora obrniti zapis identitete z uporabo stabilnega zunanjega identifikatorja. Shranite status uporabnika, prikazano ime, e-pošto, oddelek ali stroškovno mesto, če je na voljo, in neobdelane reference skupine IdP v normalizirani obliki. Izogibajte se uporabi elektronske pošte kot edinega nespremenljivega identifikatorja; sprememba e-pošte.

Primer normaliziranih polj identitete:

{
  "zunanji_subjekt": "idp-uporabnik-12345",
  "email": "[email protected]",
  "aktivno": res,
  "groups": ["llm-developers", "support-ai-prod"],
  "cost_center": "podpora",
  "last_scim_event_at": "2026-08-30T10:14:00Z"
}

2. Prevedi skupine v vloge prehoda

Uporabite prevajalsko tabelo, ki jo upravlja prehod. Vsaka vrstica mora povezovati referenco skupine IdP z najemnikom, vlogo in neobveznimi profili, kot so dovoljeni modeli ali proračunski razredi. Nepreslikane skupine ne smejo dati ničesar. Privilegirane preslikave je treba pregledati, zlasti skrbnik za obračunavanje, skrbnik modela, lastnik najemnika in skrbnik API-ja partnerja.

{
  "idp_group": "support-ai-prod",
  "najemnik": "podpora",
  "vloga": "razvijalec",
  "model_profile": "podprti-odobreni-modeli",
  "budget_profile": "standard-team-budget",
  "requires_review": napačno
}

Priporočilo: Uporabite privzeto zavrnitev za nepreslikane skupine. Za novo ustvarjeno skupino je bolje, da ne ustvari dostopa AI, kot da pomotoma podeduje proizvodni model ali pooblastilo za obračunavanje, ker se niz ujema s predpono poti.

3. Materializirajte učinkovit dostop

Po prevajanju skupine materializirajte uporabnikov učinkovit dostop do prehoda: članstva najemnikov, vloge, profili modelov, dovoljenja za ustvarjanje ključev, pooblastilo za proračun in dovoljenja za integracijo. Preverjanja izvajalnega časa bi morala prebrati ta materializiran pogled ali zelo dosledno avtorizacijsko storitev, ne pa razčleniti nizov skupine IdP pri vsaki zahtevi.

To skrbnikom omogoča tudi uporaben pregled dostopa: »pokaži mi vse, ki lahko ustvarijo ključe v najemniku podpore«, »pokaži mi, kdo lahko zviša omejitve mesečne porabe« in »pokaži mi vse uporabnike, ki lahko dostopajo do dragih modelov sklepanja.«

Ločite človeške ključe od storitvenih računov

Najpomembnejše operativno razlikovanje je preprosto: človeški ključ predstavlja osebo; storitveni račun predstavlja aplikacijo. Obravnavanje obojega kot generičnih ključev API-ja ustvarja tveganje za izstop.

Ključi v lasti človeka bi morali podedovati življenjski cikel človeka. Ko uporabnik postane nedejaven, mora prehod blokirati ustvarjanje novega ključa in začasno preklicati ali preklicati osebne ključe. Ti ključi bi morali imeti tudi lastnika, najemnika, profil modela, profil proračuna, zadnji uporabljeni časovni žig in metapodatke o namenu, tako da lahko ekipe opazijo zlorabo pred dnevom izključitve.

Ključi storitvenega računa ne smejo biti v lasti enega odhajajočega zaposlenega na način, ki prekine proizvodnjo. Storitveni račun mora imeti vsaj dva človeška lastnika ali lastniško skupino, oznako okolja, pravilnik rotacije, zadnjo uporabljeno vidnost in profil pravilnika. Ostati mora aktiven, ko en lastnik odide, pod pogojem, da obstaja drug veljaven lastnik ali postopek razbitja stekla.

Dejstvo: Glavne smernice v oblaku na splošno odsvetujejo neupravljane dolgotrajne ključe storitvenega računa in priporočajo omejevalne izjeme. Enako načelo velja za ključe prehoda AI: identitete aplikacij naj bodo eksplicitne, omejene, pregledane in rotirane.

Priporočilo: Če osebni ključ uporablja nenadzorovano opravilo, ga ne shranite tiho med izstopom. Postavite ga v karanteno, označite kot napačno razvrščeno produkcijsko uporabo, zahtevajte prenos lastništva in ga zamenjajte s ključem storitvenega računa v skladu s pravilnikom.

Design Deprovisioning kot State Machine

Odvzem uporabe bi moral biti potek dela, ne en sam ukaz za brisanje. Stroj stanja daje prehodu dovolj strukture za hitro zmanjšanje tveganja, hkrati pa ohranja možnost revizije in kontinuiteto proizvodnje.

Stanje 1: Prejeta onemogočanje uporabe

Prehod prejme dogodek deaktivacije, brisanja, odstranitve skupine ali enakovreden dogodek življenjskega cikla SCIM. Zabeležite dogodek, njegov vir in prejšnji dejanski dostop. Ker je mogoče dogodke IdP poskusiti znova ali prispeti nepravilno, naredite ta korak idempotenten.

Stanje 2: Uporabnik označen kot neaktiven

Identiteto prehoda nastavite na neaktivno. Blokiraj interaktivno prijavo, skrbniška dejanja, ustvarjanje novega ključa, ustvarjanje novega storitvenega računa in spremembe proračuna. To bi se moralo zgoditi, preden se zaženejo počasnejša opravila čiščenja.

Stanje 3: Osebni ključi začasno ustavljeni

Začasno onemogočite ključe v lasti ljudi takoj ali po kratkem prehodnem obdobju, ki ga določa pravilnik. Varnejša privzeta možnost je takojšnja prekinitev. Za izkušnjo razvijalcev lahko prehod vrne jasno napako pri preverjanju pristnosti, ki skrbnike usmeri na neaktivnega lastnika, ID ključa, najemnika in zadnjo uspešno uporabo.

Stanje 4: Potreben je prenos lastništva

Poiščite vire v lasti neaktivnega uporabnika: storitvene račune, najemnike, profile modelov, integracije, kontakte za obračunavanje, poverilnice API-ja za partnerje in kanale za opozarjanje. Samodejni prenos lastništva, ko obstaja veljavna lastniška skupina. V nasprotnem primeru postavite vir v čakalno vrsto »potrebuje lastnika«.

Stanje 5: Obvestila in pregled

Obvestite lastnike najemnikov, varnostne skrbnike ali skrbnike za obračunavanje. Obvestilo mora vključevati prizadete ključe, zadnje uporabljene časovne žige, uporabo v zadnjih 30 in 90 dneh, storitvene račune, ki potrebujejo novega lastnika, in vse osebne ključe, ki so nedavno služili proizvodnemu prometu.

Stanje 6: Dokončanje

Ko pravila hrambe to dovolijo, dokončajte brisanje ali anonimiziranje uporabniških atributov, pri tem pa ohranite zahtevane revizijske zapise. Revizija življenjskega cikla identitete običajno ne zahteva neobdelanih pozivov. Shranjujte minimizirane dogodke, ki opisujejo odločitev pravilnika, ID-je objektov, akterja, najemnika, časovni žig in rezultat.

Omejitve dostopa do modela in porabe spadajo v isti pregled

Pooblastilo prehoda AI ne zadeva le tega, kdo lahko kliče končno točko. Uporabniku je morda dovoljeno klicati nizkocenovne modele za razvoj, ne pa tudi dragih modelov razmišljanja, gostujočih orodij, paketnih opravil ali produkcijskih vzdevkov. Uporabniku se lahko dovoli poraba iz proračuna skupine, vendar ne odobri povečanja proračuna.

Za vsako učinkovito vlogo definirajte sorodna dovoljenja za ceno in model:

  • Dovoljeni profili modelov in notranji vzdevki.
  • Ocenjeni najvišji stroški na zahtevo.
  • Profil mesečnega ali dnevnega proračuna.
  • Dovoljenje za ustvarjanje osebnih ključev.
  • Dovoljenje za ustvarjanje ali lastništvo storitvenih računov.
  • Dovoljenje za uporabo gostujočih orodij, obdelavo datotek, sej v realnem času ali paketnih delovnih obremenitev.
  • Dovoljenje za ogled analitike uporabe, računov ali izvozov stroškovnih mest.

Priporočilo: Zgradite en izvoz pregleda dostopa, ki združuje identiteto, vloge prehoda, aktivne ključe, storitvene račune, uporabo v zadnjih 30 in 90 dneh, dovoljenja modela in pooblastilo za proračun. To je bolj uporabno kot preprost seznam uporabnikov, saj prikazuje operativno tveganje in kupno moč skupaj.

Partner API in pooblastilo za več najemnikov

Avtomatizacija API-ja partnerja doda še eno mejo avtorizacije. Agencija, preprodajalec ali platforma lahko strankam zagotovi najemnike, uporabnike, ključe, proračune in izvoze uporabe prek API-ja. Notranji uporabniki, ki jih poganja SCIM, ne bi smeli samodejno pridobiti širokega dostopa do predmetov strank samo zato, ker upravljajo partnerjev lastni najemnik.

Naredite, da vsaka operacija API-ja Partnerja obsega tako klicatelja kot najemnika stranke. Oskrbovanje mora biti idempotentno: dvakratno ustvarjanje istega najemnika stranke, preslikave skupine ali uporabnika bi moralo konvergirati v eno pričakovano stanje. Končne točke izpisa morajo vrniti le objekte, za katere je klicatelj izrecno dovoljen, da jih upravlja.

To je pomembno, ker so napake avtorizacije na ravni objekta in lastnosti objekta običajna tveganja API-ja. V prehodu AI so izpostavljeni predmeti občutljivi: zapisi najemnikov, ključi API-ja, knjige uporabe, proračuni, dovoljenja za modele, seznami članov in računi storitev. Prehod bi moral preizkusiti te poti z več identitetami in več ID-ji najemnikov, ne samo s skrbnikom srečne poti.

Koristni testi vključujejo:

  • Skrbnik najemnika A poskuša prebrati, zasukati ali preklicati ključe najemnika B.
  • Blokirani uporabnik poskusi uporabiti stari osebni ključ API.
  • Skrbnik prodajnega posrednika poskuša našteti najemnike strank, ki niso v lasti.
  • Član projekta poskuša spremeniti nastavitve obračunavanja.
  • Lastnik storitvenega računa si poskuša dodeliti skrbnika za obračunavanje.
  • Poverilnica API-ja partnerja poskuša spremeniti profile modelov zunaj dovoljenega obsega strank.

Revizija brez takojšnjega kopičenja

Preiskave življenjskega cikla identitete običajno morajo vedeti, kdo je spremenil dostop, kateri pravilnik je bil ocenjen, kateri objekt je bil prizadet in ali je dejanje uspelo. Običajno ne potrebujejo neobdelanih pozivov. Ohranite ločen revizijski tok za odločitve o identiteti in politiki.

Zabeležite dogodke, kot so:

  • Uporabnik je omogočen, posodobljen, deaktiviran ali izbrisan.
  • Skupina preslikana, nepreslikana ali zavrnjena.
  • Vloga prehoda dodeljena, spremenjena ali odstranjena.
  • Osebni ključ je ustvarjen, začasno ustavljen, preklican ali uporabljen po deaktivaciji.
  • Sprememba lastnika storitvenega računa.
  • Odobreno ali odvzeto proračunsko pooblastilo.
  • Profil modela je pritrjen ali odklopljen.
  • Zahteva za API partnerja je bila zavrnjena zaradi obsega najemnika.

Vsak dogodek mora vsebovati akterja, subjekta, najemnika, vrsto objekta, ID objekta, izvorni sistem, odločitev, kodo vzroka in časovni žig. Uporabite stabilne ID-je namesto neobdelane vsebine poziva. Kjer so potrebne podrobnosti koristnega tovora, shranite strukturirane metapodatke pravilnika namesto vnosov modela.

Kontrolni seznam za implementacijo

Uporabite ta kontrolni seznam, ko izvajate timske kontrole na podlagi SCIM v prehodu AI:

  • Definirajte izvorne objekte prehoda za najemnika, vlogo, uporabnika, ključ, račun storitve, profil modela, profil proračuna in dostop do integracije.
  • Shranite zunanjo zadevo IdP ločeno od e-pošte.
  • Naredi SCIM uporabniške in skupinske vstavitve idempotentne.
  • Uporabite pregledano prevajalsko tabelo iz skupine v vlogo s privzeto zavrnitvijo.
  • Zahtevaj izrecno odobritev za preslikave privilegiranih vlog.
  • V shemi in uporabniškem vmesniku ločite ključe v lasti ljudi od ključev storitvenih računov.
  • Blokirajte nedejavnim uporabnikom prijavo, skrbniška dejanja, ustvarjanje ključev in spremembe proračuna.
  • Začasno prekini osebne ključe med onemogočanjem.
  • Prenos ali karantena virov v lasti neaktivnih uporabnikov.
  • Zahtevajte, da imajo storitveni računi metapodatke o lastniku, namenu, okolju, zadnjem uporabljenem časovnem žigu in metapodatke o vrtenju.
  • Pridružite se pregledom dostopa z analitiko uporabe in pooblastilom za proračun.
  • Preizkusite pooblastilo na ravni objekta za najemnike, stranke, uporabnike, ključe in objekte obračunavanja.
  • Zapise revizije identitete naj bodo privzeto minimizirani.

Kompromisi

SCIM zmanjša nihanje ročnega dostopa, vendar ne odpravi potrebe po avtorizaciji, specifični za prehod. Različni ponudniki identitet različno obravnavajo skupinsko sinhronizacijo, brisanja, deaktivacije, ponovne poskuse in preslikavo atributov. Prehod mora prenašati delne informacije in varno konvergirati.

Takojšen preklic osebnega ključa zmanjša tveganje izključitve, vendar lahko izpostavi slabo operativno higieno, ko je ključ razvijalca uporabilo nenadzorovano opravilo. To ni razlog za ohranjanje osebnih ključev pri življenju za nedoločen čas. To je razlog, da zgodaj odkrijete produkcijsko uporabo osebnega ključa in jo preselite v storitvene račune, preden zaposleni odide.

Drobno zrnate preslikave skupin lahko izražajo natančno upravljanje, vendar postane preveč skupin težko revidirati. Manjši nabor vlog prehoda v kombinaciji s profili modela in proračunskimi profili je običajno lažji za uporabo.

Storitveni računi skrbijo za delovanje aplikacij, vendar lahko postanejo brez lastništva ali preveč privilegirani. Zahtevaj lastnike, datume pregleda, metapodatke o rotaciji, profile modelov z obsegom, proračune z obsegom in zadnjo uporabljeno analitiko.

Predvidevanje: Pregledi dostopa do prehoda AI bodo vedno bolj združevali identiteto, uporabo, pooblastila za porabo in dovoljenja modela v enem poročilu. Pregledovanje »kdo ima dostop« brez prikazovanja »kaj lahko porabi in kateri ključi so še vedno aktivni« bo preveč plitko za ekipe, ki izvajajo delovne obremenitve produkcijske umetne inteligence.

Uporabni sklep

Trajni vzorec je, da SCIM in SSO prepustita upravljanju življenjskega cikla, nato pa prepustite avtorizacijo prehodu. Zagotavljanje uporabnikov od ponudnika identitete, prevajanje skupin prek pregledanih preslikav, materializiranje vlog najemnikov, izrecno povezovanje modelov in proračunskih profilov ter obravnavanje človeških ključev drugače kot storitvenih računov.

Za izključitev uporabite stanje stroja: prejmite dogodek identitete, označite uporabnika kot neaktivnega, blokirajte nov dostop, začasno onemogočite osebne ključe, prenesite lastniške vire ali jih postavite v karanteno, obvestite lastnike in dokončajte brisanje, ko to dovoljujejo pravila hrambe. To varnostnim ekipam omogoča hiter preklic, skupinam platform omogoča kontinuiteto proizvodnje, financam in revizorjem pa jasno evidenco o tem, kdo je imel oblast nad modeli, porabo, ključi in najemniki.

Sorodno branje

FAQ

Pogosta vprašanja

Ali naj skupine SCIM preslikajo neposredno v vloge prehoda API?
Uporabite skupine SCIM kot vhodne podatke, vendar jih preslikajte skozi pregledano prevajalsko tabelo prehoda. Neposredno ujemanje nizov oteži revizijo privilegiranega dostopa in lahko nenamerno podeli dovoljenja, ko se imena skupin spremenijo.
Kaj bi se moralo zgoditi z uporabniškimi ključi API med izključitvijo?
Osebne ključe je treba začasno onemogočiti ali preklicati, ko je uporabnik onemogočen. Ključi storitvenih računov se morajo nadaljevati le, če imajo veljavne lastnike, pravilnik v obsegu, metapodatke o rotaciji in kontrolnike za pregled.
Ali revizija življenjskega cikla identitete zahteva shranjevanje pozivov?
Ponavadi ne. Revizijski zapisi življenjskega cikla bi morali zajemati akterje, subjekte, najemnike, ID-je objektov, odločitve pravilnikov, časovne žige in kode vzrokov. Neobdelani pozivi niso potrebni za večino preiskav zagotavljanja, deaktiviranja in avtorizacije.
Kako naj se preizkusi dostop do partnerskega API-ja?
Preizkusite z več klicatelji in ID-ji najemnikov: en skrbnik stranke proti objektom druge stranke, začasno ustavljeni uporabniki proti starim ključem, poverilnice preprodajalca proti najemnikom, ki niso v lasti, in običajni člani proti zaračunavanju ali nastavitvam skrbnika modela.