АПИ кључеви за АИ у опсегу корисника: изолујте станаре, буџете и злоупотребу без ширења кључева добављача

<п>Када производ омогућава многим купцима да позивају АИ моделе, погрешан примитив је често кључ добављача на врху. Кључ добављача обично представља налог, пројекат, радни простор или налог услуге. Вашем производу је потребно нешто уже: кључ окренут клијенту који идентификује једног закупца, клијента, апликацију, окружење, политику модела, буџет и правило ревизије. <п>То је сврха АИ АПИ кључева на нивоу корисника. Мрежни пролаз издаје кључ, аутентификује захтеве, примењује смернице, мери употребу, а затим позива упстреам провајдере користећи скривене акредитиве. Нижи клијенти никада не добијају кључ провајдера. Они добијају стабилан уговор са вашом платформом. <х2>Проблем са читачем: изолација корисника без једног пројекта добављача по кориснику <п>СааС градитељи, агенције и платформе за препродаваче обично морају да одговоре на практична питања пре него што могу да открију приступ вештачкој интелигенцији у наставку: <ул> <ли>Који клијент је генерисао ову употребу? <ли>Која апликација, окружење или интеграција је упутила позив? <ли>Који модели и модалитети су дозвољени? <ли>Колико овај клијент може да потроши овог месеца? <ли>Шта се дешава ако кључ процури? <ли>Може ли овај клијент бити суспендован без утицаја на све остале? <ли>Може ли се касније ускладити употреба са извештајима добављача? <п>Пројекти и радни простори на страни добављача могу да помогну, али они нису увек права јединица за сваког клијента у наставку. Креирање једне узводне границе по кориснику може побољшати чврсту изолацију и извештавање, али такође ствара додатне трошкове, фрагментацију квота, ширење акредитива и више рада на усаглашавању. <п>Кључ који издаје мрежни пролаз даје производу контролну тачку на нивоу корисника чак и када се упстреам акредитиви обједињују. Такође подржава јаче режиме, као што су акредитиви добављача везани за станара или „донесите свој кључ“, када је клијенту потребно уговорно одвајање, границе пребивалишта или директно власништво над налогом добављача. <х2>Чињенице, препоруке и предвиђања <х3>Чињенице <ул> <ли>ОпенАИ пројекти подржавају чланове, сервисне налоге, АПИ кључеве, ограничења коришћења, буџете и ресурсе пројекта. То чини пројекте корисним као узводне границе, али не и аутоматски прави примитив за сваког крајњег купца. <ли>Извештавање о коришћењу ОпенАИ може да групише употребу према димензијама као што су пројекат, корисник, АПИ кључ, модел, серија и ниво услуге. СааС повраћај средстава и даље треба да се ти записи добављача придруже идентификаторима купаца у власништву производа. <ли>Антропски радни простори одвајају АПИ ресурсе према случају коришћења, тиму, одељењу, пројекту или производу. АПИ кључеви су везани за радни простор где су креирани и не могу се премештати између радних простора. <ли>Антропско извештавање о употреби и трошковима подржава груписање према АПИ кључу, радном простору, моделу, нивоу услуге, прозору контекста, резиденцији података и опцијама везаним за брзину, са трошковима који се враћају у дневним сегментима у УСД. <ли>Упутства за кључеве Гоогле Гемини АПИ-ја препоручују ограничавање кључева, а Гемини АПИ кључеви су подразумевано ограничени на АПИ за генеративни језик. Ограничења апликација као што су ИП адресе могу бити доступна у зависности од облика примене. <ли>ОВАСП упутства третирају АПИ кључеве као неопходне контроле за заштићене крајње тачке и кажу да кључеве треба опозвати када клијенти крше уговоре о коришћењу. <ли>ОВАСП упутства за тајне наглашавају најмање привилегије, опозив када тајне више нису потребне или су угрожене, и аутоматску ротацију ради смањења грешака у примени. <х3>Препоруке <ул> <ли>Користите кључеве клијената које издаје мрежни пролаз као рукохвате смерницама, а не само токене за потврду идентитета. <ли>Држите акредитиве упстреам провајдера скривене од нижих клијената. <ли>Напишите књигу коришћења мрежног пролаза у време захтева, пре него што се ослоните на контролне табле добављача. <ли>Користите пројекте или радне просторе добављача селективно за клијенте високог ризика, великог обима, регулисане, осетљиве на пребивалиште или уговорно одвојене клијенте. <ли>Изградите ротацију кључа као ток посла који се преклапа, а не као тренутни догађај прекида. <х3>Предвиђања <ул> <ли>Више провајдера ће открити богатије груписање коришћења и контроле буџета, али ће приписивање клијената у власништву производа и даље бити неопходно за СааС наплату и извештавање о препродавцима. <ли>Платформе за препродаваче и агенције ће све више третирати кључеве пролаза као комерцијалне објекте: везане за планове, кредитна стања, обим и токове рада подршке. <ли>Купци са стриктном усклађеношћу или потребама набавке ће тражити власништво над налогом БИОК или провајдером, док ће већина обичних купаца преферирати уговор о управљаном приступном пролазу. <х2>Кључни објекат мрежног пролаза <п>Кључ у опсегу корисника треба да се разреши у структурисани објекат смерница. У најмању руку, моделирајте кључ као више од хеша и имена. <пре><цоде>{ "кеи_ид": "кеи_01Ј9...", "тенант_ид": "тенант_ацме", "цустомер_ид": "цуст_4812","апплицатион_ид": "апп_суппорт_бот", "окружење": "производња", "власник": { "типе": "сервице_аццоунт", "ид": "свц_суппорт_аи" }, "модел_профиле_ид": "профиле_суппорт_стандард", "алловед_модалитиес": ["тект", "имаге_инпут"], "тоол_полици_ид": "тоолс_реадонли_кб", "монтхли_будгет": { "валута": "УСД", "износ": "500,00" }, "рате_лимитс": { "рекуестс_пер_минуте": 120, "инпут_токенс_пер_минуте": 250000, "оутпут_токенс_пер_минуте": 80000 }, "ретентион_полици": "метадата_онли", "статус": "активан", "цреатед_ат": "2026-09-05Т10:00:00З", "ласт_усед_ат": нулл } <п>Тачна поља ће се разликовати, али принцип не би требало: сваки долазни захтев решава кључ у политику закупца пре слања. Аутентификација одговара „ко зове?“ Резолуција смерница одговара „шта овај позивалац може да уради, колико може да потроши, где може да се упути захтев и шта мора да се евидентира?“ <п>Овде је такође важна семантичка стратегија производа. Платформи која продаје <а хреф="/ен/топицс/партнер-реселлер-апи-аи-аццесс/">АИ АПИ за агенције ће можда бити потребне димензије клијената и кампање. Алатку за програмере ће можда бити потребне димензије радног простора и спремишта. Препродавцу ће можда бити потребни спољни ИД-ови клијената који одговарају његовом систему обрачуна. <х2>Ток рада креирања кључева <п>Креирање кључа треба да буде довољно детерминистичко за аутоматизацију и довољно строго за безбедносни преглед. <х3>1. Прво креирајте кориснички запис <п>Не креирајте кључеве без родитеља. Кључ треба да припада закупцу и запису о клијенту пре него што постоји. За платформе препродавача, евиденција о клијентима треба да садржи екстерне ИД-ове из ЦРМ-а или система наплате препродавца, метаподатке плана, груписање пореза или фактура ако је потребно и поље статуса које може суспендовати све подређене кључеве. <х3>2. Приложите профил модела <п>Профил модела мапира називе модела окренутих према клијентима у моделе и могућности добављача. На пример, <цоде>суппорт-стандард може дозволити уравнотежени текстуални модел, унос слике и без извршавања кода. <цоде>ресеарцх-премиум може да дозволи моделе са дугим контекстом, веб претрагу и више горње границе по захтеву. <п>Не присиљавајте низводне апликације на ИД-ове модела добављача чврстог кода. Користите профил мрежног пролаза да бисте управљали доступношћу, резервним, ценама и застарелом. <х3>3. Поставите ограничења потрошње и стопе <п>Користите буџете и ограничења стопе заједно. Месечни буџет спречава оштећење фактура током времена. Ограничења стопе спречавају да изненадна злоупотреба, поновни покушај олује или случајне петље потроше цео буџет за неколико минута. <п>Корисне контроле укључују: <ул> <ли>Месечни буџет корисника. <ли>Дневна мека капа за откривање аномалија. <ли>Стопа захтева по кључу. <ли>Стопа улазних и излазних токена. <ли>Максимална процењена цена по захтеву. <ли>Ограничења специфична за алат за хостовану претрагу, обраду датотека или извршавање кода. <п>Спровођење буџета треба да резервише процењене трошкове пре отпреме, измири стварне трошкове након завршетка и ослободи неискоришћену резерву. Ово повезује кључну политику са <а хреф="/ен/">наплатом за АИ АПИ уместо да се обрачун третира као задатак са одложеним извештавањем. <х3>4. Генеришите и правилно сачувајте тајну <п>Прикажи тајну отвореног текста једном. Чувајте само јак хеш, плус кратак префикс или отисак прста за тражење подршке. Префикс помаже тимовима за подршку да идентификују „кључ који се завршава на 8Ф2А“ а да не виде тајну. <п>Типичан образац складиштења је: <ул> <ли><цоде>кеи_ид: идентификатор стабилне базе података. <ли><цоде>сецрет_хасх: хеш пуне тајне помоћу одговарајуће стратегије хеширања лозинке или токена. <ли><цоде>сецрет_префик: кратак неосетљиви префикс за приказ. <ли><цоде>отисак прста: детерминистички идентификатор за тражење ревизије. <ли><цоде>цреатед_би: корисник или партнер АПИ клијент који је креирао кључ. <ли><цоде>статус: активан, исцрпљен, опозван, у карантину, истекао. <п>Никада не складиштите кључеве добављача узводно на објекту кључа клијента. Акредитиви добављача припадају засебном трезору акредитива са сопственим правилима приступа. <х2>Примена времена захтева <п>Гатеваи треба да третира сваки позив модела као одлуку о политици након које следи слање добављача. Практична путања захтева изгледа овако: <ол> <ли>Распоредите представљени кључ мрежног пролаза. <ли>Потражите хеш и статус кључа. <ли>Решите профил закупца, клијента, апликације, окружења, власника и модела. <ли>Проверите да ли су закупац и клијент активни. <ли>Потврдите тражени псеудоним модела, модалитет, алате, режим задржавања, регион и ниво услуге. <ли>Процените цену захтева и резервишите буџет. <ли>Проверите ограничења стопе и прагове злоупотребе. <ли>Изаберите упстреам режим акредитива: обједињени, везани за станара или БИОК. <ли>Пошаљите добављачу.<ли>Снимите коришћење, цену, референце добављача, грешке и безбедносне сигнале. <ли>Одредите резервацију буџета и запишите догађај завршне књиге. <п>Ова секвенца држи да је мрежни пролаз одговоран за уговор са клијентом. Контролне табле добављача постају инпути за помирење, а не једини извор истине. <х2>Користите поља главне књиге која ће вам касније помоћи <п>Књига мрежног пролаза треба да сачува довољно детаља да одговори на питања подршке, наплате, злоупотребе и рутирања, а да не захтева подразумевано складиштење сировог обавештења. <п>Корисна поља укључују: <ул> <ли><цоде>рекуест_ид и <цоде>траце_ид. <ли><цоде>ид_станара, <цоде>ид_цустомер_ид, <цоде>апплицатион_ид и <цоде>кеи_ид. <ли>Идентификатор крајњег корисника, пожељно псеудоним где је прикладно. <ли>Псеудоним модела који је захтевао клијент. <ли>Решен добављач и модел узвода. <ли>Унос, излаз, резоновање, кеширање, аудио, слика, видео и употреба алата где је применљиво. <ли>Наведена цена, резервисани износ, измирени трошак, валута и верзија каталога цена. <ли>ИД захтева добављача, референца извештаја о коришћењу, димензија груписања пројекта, радног простора или АПИ кључева ако је доступна. <ли>Примењене су смернице задржавања. <ли>Кодови одлука о безбедности, злоупотреби или смерницама. <ли>Категорија грешке и покушајте поново са метаподацима. <п>Ова структура подржава повраћај средстава, корисничку подршку, одговор на инциденте и <а хреф="/ен/топицс/апи-кеи-манагемент-аи-апис/">управљање АПИ кључевима који може да одговори на питање „шта је урадио овај кључ?“ без откривања неповезаних станара. <х2>Режими акредитива: обједињени, везани за станара и БИОК <х3>Обједињени акредитиви добављача <п>У подразумеваном режиму, многи кључеви корисника пролазе кроз мањи скуп акредитива добављача. Ово је оперативно једноставно и смањује ширење на страни провајдера. Функционише када мрежни пролаз има јаку атрибуцију закупца, спровођење буџета, ограничавање стопе, изолацију злоупотребе и контроле граница кеша. <п>Замена је у томе што извештавање на страни провајдера може да приказује само акредитиве мрежног пролаза или пројекат добављача. Морате поново да спојите записе добављача са записима главне књиге пролаза да бисте произвели наплату и аналитику на нивоу корисника. <х3>Акредитиви добављача везани за закупца <п>За веће или ризичније закупце, повежите закупца за пројекат наменског добављача, радни простор, налог услуге или кључ. Ово даје јаче раздвајање узводно и може поједноставити извештавање на страни провајдера. Такође може да обезбеди чврсту блокаду квоте ако добављач подржава ограничења на тој граници. <п>Цена је оперативна сложеност. Додељивање, ротација, ограничења добављача, одговор на инциденте и помирење се сада дешавају на више објеката на врху. <х3>Донесите свој кључ <п>БИОК може бити користан када клијенти морају да поседују налог провајдера, да преговарају о сопственом уговору са добављачем или да наплату провајдера држе одвојено. Мрежни пролаз и даље примењује профиле модела, смернице за рутирање, аналитику и контроле на нивоу апликације где је то могуће. <п>Компромис је сложеност подршке. Сваки налог добављача клијента може имати другачији приступ моделу, квоте, цене, подешавања задржавања и статус инцидента. Гејтвеј мора да открије и јасно објасни ове разлике. <х2>Опозив и карантин <п>Опозив би требало да одмах блокира нове захтеве за кључ клијента без ротирања неповезаних акредитива добављача узводно. Ово је једна од главних предности виртуелних кључева. <п>Користите одвојена стања за различите оперативне радње: <ул> <ли><цоде>активан: захтеви су дозвољени. <ли><цоде>драининг: стари кључ се прихвата током прозора ротације, али се емитују упозорења и догађаји ревизије. <ли><цоде>опозвано: нови захтеви се трајно одбијају. <ли><цоде>у карантину: нови захтеви су блокирани због злоупотребе, плаћања, смерница или одговора на инцидент. <ли><цоде>истекао: кључ је прекорачио свој животни век и мора се заменити. <п>Карантин би требало да буде реверзибилан када се инцидент реши. Опозив обично не би требало да буде реверзибилан, јер враћање старих тајни повећава конфузију и ризик. <п>Када кључ крши смернице за коришћење, забележите разлог, актера, време и обим примене. Ако је одлука аутоматизована, сачувајте верзију правила и сигнале који су је покренули. Ово одржава разговоре клијената чињеничним. <х2>Ротација без прекида производње <п>Ротација тастера треба да користи ток рада који се преклапа са два кључа: <ол> <ли>Направите резервни кључ са истим клијентом, апликацијом, профилом модела и ограничењима, осим ако их оператер намерно не промени. <ли>Прикажи нову тајну једном. <ли>Означите стари кључ као <цоде>пражњење. <ли>Прихватите оба кључа на ограничени период, као што је 7, 14 или 30 дана у зависности од плана клијента и ризика.<ли>Емитујте упозорења о употреби на кључу за пражњење. <ли>Обавестите власника или Партнер АПИ клијента када се стари кључ још увек користи близу рока. <ли>Опозовите стари кључ на крају прозора. <ли>Задржите приписивање за оба кључна ИД-а под истим клијентом и апликацијом. <п>Овим се избегава уобичајени режим квара у којем побољшање безбедности постаје прекид производње. Ротација је и даље контрола, али постаје оперативни ток рада са доказима и роковима. <х2>Партнер АПИ Сурфаце <п>Ако низводне платформе управљају клијентима програмски, изложите кључне операције преко АПИ-ја партнера. АПИ би требало да подржава кључеве идемпотенције и догађаје ревизије јер се обезбеђивање често дешава унутар токова наплате, укључивања или ЦРМ-а. <п>Минималне крајње тачке: <ул> <ли><цоде>ПОСТ /цустомерс: креирајте или узнемирите клијента. <ли><цоде>ПОСТ /цустомерс/{цустомер_ид}/кеис: направите кључ. <ли><цоде>ГЕТ /цустомерс/{цустомер_ид}/кеис: листа кључева и статуса. <ли><цоде>ПАТЦХ /кеис/{кеи_ид}: ажурирање опсега, власника, ограничења, профила модела или статуса. <ли><цоде>ПОСТ /кеис/{кеи_ид}/ротате: направите замену и означите стари кључ као неисправан. <ли><цоде>ПОСТ /кеис/{кеи_ид}/ревоке: опозови одмах. <ли><цоде>ГЕТ /цустомерс/{цустомер_ид}/усаге: врати употребу и цену према временском опсегу, кључу, апликацији, моделу или димензији крајњег корисника. <п>Сваки захтев за мутирање треба да прихвати кључ идемпотенције. Свака промена треба да напише догађај ревизије са пољима актера, циља, пре и после, изворне ИП адресе или идентитета клијента и разлога где је то доступно. <х2>Када користити пројекте или радне просторе добављача <п>Не третирајте кључеве мрежног пролаза и границе добављача као међусобно искључиве. Они решавају различите проблеме. <п>Користите кључеве пролаза за нормалну контролу на нивоу корисника: <ул> <ли>Приписивање по кориснику. <ли>Кључеви за сваку апликацију. <ли>Ограничења буџета и стопе. <ли>Брза суспензија. <ли>Токови рада ротације. <ли>Аналитика коришћења и извештавање о препродавцима. <п>Додајте пројекте добављача, радне просторе или наменске акредитиве добављача када је клијенту потребно јаче раздвајање: <ул> <ли>Велик месечни обим који заслужује наменске квоте. <ли>Реговано радно оптерећење са изричитим захтевима за пребивалиште или задржавање. <ли>Уговорно раздвајање фактура. <ли>Тврди буџет или квоте на страни добављача. <ли>Намјенски надзор злоупотребе или безбедносни преглед граница. <ли>Налози добављача у власништву клијената преко БИОК-а. <п>Практично подразумевано је изолација наметнута мрежним пролазом са селективним узводним чврстим границама. То чини заједнички пут једноставним, а истовремено задржава ескалацију за клијенте којима је потребно више раздвајања. <х2>Контролна листа имплементације <ул> <ли>Дефинишите шему кључева клијента са закупцем, клијентом, апликацијом, окружењем, власником, профилом модела, ограничењима, политиком задржавања и статусом. <ли>Хеширајте тајне у мировању и прикажите отворени текст само једном. <ли>Одвојите кључеве мрежног пролаза од складишта акредитива упстреам добављача. <ли>Сваки захтев решите у смерницу пре слања. <ли>Резервишите буџет пре позива провајдера и поравнајте га након што се сазна коначно коришћење. <ли>Забележите коришћење са клијентом, кључем, псеудонимом модела, узводним моделом, категоријама токена, употребом алата, наведеним трошковима, измиреним трошковима и референцама добављача. <ли>Примените активно стање, стање које се испразни, опозвано, у карантину и истекло. <ли>Подржава преклапање ротације са два тастера. <ли>Откријте операције АПИ-ја партнера помоћу кључева идемпотенције. <ли>Користите пројекте или радне просторе добављача само тамо где су њихови оперативни трошкови оправдани. <х2>Закључак који се може спровести <п>Изолација корисника за приступ вештачкој интелигенцији обично треба да почне од кључа мрежног пролаза, а не од кључа добављача. Кључ пролаза је уговор окренут клијенту: он именује закупца, клијента, апликацију, профил модела, буџет, ограничење стопе, правило задржавања и политику ревизије. Кључ добављача је детаљ имплементације иза тог уговора. <п>Ова архитектура омогућава креаторима СааС-а и платформама препродавача брзо опозив, тачну атрибуцију, буџете по клијенту, контролисану ротацију и корисну аналитику коришћења без креирања једног пројекта добављача узводно за сваког клијента по подразумеваној вредности. Користите упстреам пројекте, радне просторе, акредитиве везане за станаре или БИОК када ризик, обим, пребивалиште или уговор то захтевају. За уобичајену путању, примените изолацију корисника у гејтваи књизи и механизму смерница, а затим ускладите записе добављача након тога.<х2>Сродно читање<ул><ли><а хреф="/ен/блог/идемпотент-партнер-апи-аутоматион-провисион-аи-цустомерс-кеис-цредитс-33/">додељивање кључева за клијенте за клијенте, АПИ-је за кључеве и партнере-33/"> кредити