B2BB2B LLM
Пословни увид

Како дизајнирати ЛЛМ АПИ систем управљања кључем за тимове

Практични водич за издавање, одређивање опсега, ротирање, праћење и опозив ЛЛМ АПИ кључева у тимовима, апликацијама, окружењима и интеграцијама партнера без дистрибуције сирових акредитива добављача.

<п>Дељени кључеви добављача ЛЛМ-а су згодни до првог искључења, пораста наплате, интеграције партнера или процуреле тајне. Практични проблем није само то што један кључ може бити откривен. Ради се о томе да дељени кључ чини власништво нејасним, трошење је тешко приписати и хитан опозив ризичним јер више апликација може зависити од истог акредитива. <п>Радљив систем управљања АИ АПИ кључем треба да одговори на пет питања за сваки захтев: ко је власник овог приступа, шта му је дозвољено да ради, колико може да потроши, како ће се открити ненормално коришћење и како се може опозвати без уклањања неповезаних система? <п>Овај водич одваја проверене чињенице од препорука за примену. Чињенице описују могућности и ризике које су документовали главни провајдери или безбедносни оквири. Препоруке описују практичан оперативни модел за тимове који користе више ЛЛМ провајдера. <х2>Почните са двослојним моделом акредитива <п>Најважнија дизајнерска одлука је да се престане са дистрибуцијом необрађених кључева добављача узводно широм апликација, скрипти, лаптопова, ЦИ послова и партнерских система. Уместо тога, користите двослојни модел: <ул> <ли><стронг>Акредитиви добављача: Кључеви или акредитиви услуге које су издали претходни добављачи вештачке интелигенције. Ово треба да се чува само у контролисаној позадини, мрежном пролазу, тајном менаџеру или сличном ограниченом сервису. <ли><стронг>Уређени интерни акредитиви: Кључеви издати тимовима, апликацијама, окружењима, ЦИ пословима или партнерима. Ови кључеви позивају ваш ниво контролисаног приступа, који примењује смернице, рутирање, телеметрију, ограничења и опозив. <п><стронг>Чињеница: Смернице добављача обично саветују да не делите АПИ кључеве са саиграчима, препоручује безбедно складиштење и упозорава да процурели кључеви могу да доведу до неовлашћене активности или наплате. Конзоле добављача такође могу да подржавају контролу пројекта, радног простора, коришћења на нивоу кључа, ограничења стопе и буџета, иако се могућности разликују у зависности од добављача и плана. <п><стронг>Препорука: Третирајте кључеве добављача као тајне инфраструктуре, а не токене погодности програмера. Програмери би требало да добију управљане кључеве који се могу независно одредити и опозвати. Овај приступ подржава <а хреф="/ен/топицс/ентерприсе-ллм-апи-инфраструцтуре/">ентерприсе ЛЛМ АПИ операције јер се политика акредитива, аналитика и контрола трошкова могу доследно применити на више модела и добављача. <х2>Дефинишите таксономију кључева пре издавања више кључева <п>Тимови често стварају проблеме са управљањем издавањем кључева пре него што дефинишу шта сваки кључ представља. Кључ би требао бити више од насумичне тајне. То би требало да буде управљани објекат са метаподацима, власништвом, смерницама и стањем животног циклуса. <х3>Минимални метаподаци за сваки управљани кључ <ул> <ли><стронг>Власнички тим: Одговорна група, а не само појединачни подносилац захтева. <ли><стронг>Апликација или радно оптерећење: Систем, услуга, скрипта или интеграција помоћу кључа. <ли><стронг>Окружење: Производња, постављање, развој, ЦИ, сандбок или партнер. <ли><стронг>Пословна сврха: Резиме корисничке подршке, интерна претрага, помоћ коду, екстракција докумената, радни ток агента или други одобрени случај употребе. <ли><стронг>Дозвољена породица модела или рута добављача: Којим моделима или добављачима кључ може да приступи. <ли><стронг>Ниво осетљивости података: Да ли захтеви могу да обухватају јавне, интерне, поверљиве, регулисане или податке о клијентима. <ли><стронг>Граница буџета: Дневно, недељно, месечно или ограничење потрошње на нивоу пројекта. <ли><стронг>Ограничења брзине: Захтеви по минуту, токени по минуту, истовремени послови или ограничења групе. <ли><стронг>Датум истека: Обавезно за привремене кључеве и препоручено за већину непроизводних кључева. <ли><стронг>Контакт за хитне случајеве: Тимски канал или особа одговорна током инцидената. <п>Једноставна конвенција о именовању помаже оператерима да брзо разумеју радијус експлозије. На пример: <пре><цоде>тим: суппорт-опс апликација: тикет-сумаризер енв: прод усе_цасе: резиме корисничке подршке ниво_података: поверљиво за купца моделс_алловед: [модел-фамили-а, модел-фамили-б] месечни_буџет_усд: 2500 ротацијски_интервал_даис: 90 овнер_цонтацт: #суппорт-платформ-алертс <п><стронг>Препорука: Немојте издавати генеричке кључеве назване по особи, као што је <цоде>алице-опенаи-кеи, за производне системе. Користите власништво над налогом за услугу и одговорност тима тако да кључ преживи промене улоге запослених, а да остане следљив. <х2>Одвојена окружења за смањење радијуса експлозије<п>Никада немојте поново користити један ЛЛМ АПИ кључ у производним, сценским, развојним, ЦИ и партнерским окружењима. Оперативни разлог је једноставан: ова окружења имају различите профиле ризика. Вероватније је да ће се кључ који се користи у локалном развоју појавити у историји љуске, привременим датотекама, бележницама или тестним репозиторијумима. Производни кључ обично има веће квоте и приступ осетљивим радним оптерећењима. Њихово комбиновање чини свако цурење озбиљнијим. <х3>Практична политика животне средине <ул> <ли><стронг>Производња: Строго одобрење, власништво над налогом за услугу, ниска толеранција за приступ широком моделу, надгледани буџети и процедуре за хитно опозив. <ли><стронг>Стапање: Слично рутирању као у производњи, али ниже границе и без производних података осим ако није изричито одобрено. <ли><стронг>Развој: Ниже квоте, кратак рок трајања, ограничена осетљивост података и ограничења модела која подстичу безбедно експериментисање. <ли><стронг>ЦИ и аутоматизација: Наменски кључеви за задатке тестирања, послове бенцхмарка, цевоводе евалуације и токове рада издања. <ли><стронг>Партнерски приступ: Делегирани или партнерски кључеви са строгим квотама, документацијом и видљивошћу по партнеру. <п><стронг>Компром: Фино одвајање окружења повећава број акредитива којима се управља. Одговор није да се све скупи у један заједнички кључ. Одговор је да се аутоматизује обезбеђивање, хватање метаподатака, тајно складиштење и статус ротације. <х2>Примени политику најмањих привилегија на АПИ слој <п>ЛЛМ АПИ кључ не би требало да значи неограничен приступ сваком моделу, крајњој тачки, величини контекста и нивоу потрошње. Најмања привилегија за ЛЛМ акредитиве захтева више од провере дозволе да или не. <х3>Контроле које вреди применити <ул> <ли><стронг>Дозвољени модели: Дозволите само одобрене породице модела или руте за случај употребе кључа. <ли><стронг>Максимална величина контекста: Спречите случајно подношење необично великих докумената или брзих пакета. <ли><стронг>Максимални излазни токени: Ограничите трошкове производње и смањите утицај злоупотребе. <ли><стронг>Ограничења крајње тачке: Одвојени приступ ћаскању, уграђивању, групи, сликама, коришћењу алата и агентском току рада где је релевантно. <ли><стронг>Ограничења буџета: Поставите горње границе на нивоу кључа, на нивоу апликације и на нивоу тима. <ли><стронг>Ограничења стопе: Ограничите скокове захтева и заштитите квоте у току. <ли><стронг>ИП или мрежна ограничења: Примените када је подржано и оперативно практично. <ли><стронг>Блокирани случајеви коришћења: Одбијте познате недозвољене токове посла, неодобрене нивое података или путање аутоматизације високог ризика. <п>На пример, помоћнику за интерну документацију може бити дозвољено да користи уградње и модел генерисања текста са средњом ценом, али не и премијум моделе резоновања, групне послове или генерисање слика. Финансијски ток посла може захтевати строжије руковање подацима и ужи модел рутирања. Заштићено окружење за развој може имати ниско дневно ограничење и приступ само неосетљивим тестним подацима. <п><стронг>Препорука: Ставите примену смерница у слој контролисаног приступа уместо да се у потпуности ослањате на код апликације. Провере на нивоу апликације су корисне, али их је лакше случајно заобићи када тимови брзо копирају исечке, креирају скрипте или додају нове интеграције. <х2>Инструментирајте сваки кључ помоћу аналитике употребе <п>Управљање кључем не успе када се акредитиви издају, али се не поштују. Надгледање би требало да учини да сваки управљани кључ може да се припише и дијагностикује. <х3>Телеметрија за снимање по подразумеваној вредности <ул> <ли>ИД кључа и назив кључа, искључујући саму тајну вредност. <ли>Ознаке власничког тима, апликације, окружења и центра трошкова. <ли>Временска ознака, број захтева, количина токена и процењена цена. <ли>Добављач, модел, крајња тачка, кашњење, статусни код и категорија грешке. <ли>Изворна апликација, налог услуге, регион или порекло мреже где је доступно. <ли>Одлуке о смерницама, као што су дозвољено, одбијено, ограничено, блокирано буџетом или преусмерено на резервни. <п><стронг>Чињеница: Главни добављачи вештачке интелигенције нуде неки облик извештавања о коришћењу, трошковима, пројекту, радном простору или на нивоу кључа. Тачна поља за извештавање и административни АПИ-ји се разликују у зависности од добављача и плана. <п><стронг>Препорука: Нормализујте метаподатке о коришћењу у сопственом систему ако користите више добављача. Контролне табле изворне добављача су корисне, али преглед међу добављачима је неопходан када један тим може да користи различите моделе за различита оптерећења.<п>Евидентирање брзих одговора и одговора захтева посебну пажњу. Детаљни записници садржаја могу помоћи у истрази инцидената и квалитетном отклањању грешака, али такође могу створити обавезе за приватност и усклађеност. Сигурније подразумевано је евидентирање метаподатака, одлука о политици, трошкова и хешова или референци. Омогућите евидентирање садржаја само за одобрене случајеве коришћења са правилима задржавања и контролама приступа. <х2>Креирајте упозорења која рано откривају злоупотребу акредитива <п>Прагови потрошње су неопходни, али нису довољни. Кључ који је процурио може да изазове сумњиве обрасце саобраћаја пре него што дође до већег рачуна. Упозорење треба да комбинује цену, обим, руту и сигнале понашања. <х3>Корисна упозорења о аномалијама <ул> <ли>Развојни кључ изненада шаље обим саобраћаја сличан производном. <ли>Кључ користи породицу модела коју раније није користио. <ли>Обим токена се нагло повећава у поређењу са истим сатом или даном у претходним периодима. <ли>Захтеви долазе из нове мреже, региона, партнера или циља примене. <ли>Стопе грешака расту јер аутоматизовани клијент поново агресивно покушава. <ли>Кључ се приближава 50%, 80% и 100% свог буџета. <ли>Неактивни кључ постаје активан након недеља или месеци некоришћења. <п><стронг>Предвиђање: Како тимови примењују више агентских токова посла и аутоматизованих ЛЛМ послова, откривање аномалија на нивоу кључа ће постати важније од месечног прегледа фактура. Проблеми ће се дешавати при брзини машине, па су системима управљања потребни сигнали скоро у реалном времену. <х2>Изградите ток рада ротације који не узрокује прекиде <п>Ротација кључева се често избегава јер се тимови плаше прекида производње. Тај страх је оправдан када је ротација ручна и непраћена. Сигурнији ток рада ротације користи прозоре валидности који се преклапају. <х3>Ротатион рунбоок <ол> <ли><стронг>Направите заменски кључ са истим или намерно ажурираним смерницама. <ли><стронг>Сачувајте га у одобреном тајном менаџеру и приложите исте метаподатке о власнику, апликацији и окружењу. <ли><стронг>Примените нови кључ у апликацију или радно оптерећење користећи нормалан процес издавања. <ли><стронг>Потврдите промену саобраћаја тако што ћете проверити да ли захтеви стижу под новим ИД-ом кључа. <ли><стронг>Сачекајте договорени период посматрања довољно дуго да покријете заказане послове и позадинске раднике. <ли><стронг>Опозовите стари кључ тек након што потврдите да нема легитимног саобраћаја. <ли><стронг>Завршетак записа са временском ознаком, власником, разлогом и свим променама смерница. <п>За привремене партнерске доказе концепта, краткотрајне развојне кључеве или једнократне послове процене, користите датуме истека и аутоматизоване подсетнике. За производна радна оптерећења, изаберите интервал ротације који одговара вашим безбедносним захтевима и зрелости примене. Веома кратак животни век смањује изложеност, али може да доведе до прекида рада ако је тајна примена непоуздана. <п><стронг>Компром: Фреквенција ротације је баланс. Краћи интервали смањују дуготрајно излагање. Дужи интервали смањују радну буку. Аутоматизација мења равнотежу чинећи честе ротације мање ометајућим. <х2>Припремите рунбоок за одговор на цурење пре него што дође до цурења <п>Реакција на цурење не би требало да почиње расправом о томе ко је власник кључа. Систем управљања треба да учини очигледним власништво, недавну употребу и опције опозива. <х3>Контролна листа за одговор на цурење <ол> <ли><стронг>Идентификујте кључ из процуреле вредности, префикса, хеша, ИД-а кључа, проналажења складишта или евиденције мрежног пролаза. <ли><стронг>Пронађите власника и окружење помоћу регистра кључева. <ли><стронг>Замрзните или опозовите кључ у зависности од озбиљности и доступних опција континуитета. <ли><стронг>Проверите недавну употребу за ненормалан обим захтева, моделе, регионе, крајње тачке и цену. <ли><стронг>Процените изложеност укључујући потрошњу, приступ подацима и системе на нижем току које сте додирнули. <ли><стронг>Ротирајте повезане тајне ако је кључ био ускладиштен у близини других акредитива. <ли><стронг>Обавестите заинтересоване стране као што су власнички тим, безбедносни, финансијски, правни, партнерски менаџер или тим клијената према потреби. <ли><стронг>Основни узрок документа као што је предана тајна, изложеност на страни клијента, копирана бележница, несигурна ЦИ варијабла или погрешно руковање партнером. <ли><стронг>Додајте превентивну контролу као што је тајно скенирање, краћи рок трајања, строже смернице или промена примене. <п><стронг>Чињеница: Излагање АПИ кључева у окружењима на страни клијента као што су прегледачи или мобилне апликације је широко препознато као небезбедно јер се тајне дистрибуирају уређајима крајњих корисника могу издвојити. Истраживање екосистема мобилних апликација је такође пријавило стално цурење акредитива за ЛЛМ АПИ, појачавајући потребу да се акредитиви провајдера држе изван дистрибуираних клијената. <х2>Рукујте интеграцијама партнера уз делегирани приступ <п>Партнерске интеграције стварају посебан проблем управљања. Партнерима је потребан стабилан приступ, али им предаја сировог кључа добављача даје превише контроле и слаби приписивање. Ако партнер погрешно конфигурише складиште или премаши уговорену употребу, власник кључа провајдера сноси оперативни и финансијски ризик. <п>Уместо тога, издајте кључеве за опсег партнера или делегиране токене за приступ. Сваки партнерски акредитив треба да има сопствену квоту, одобрене крајње тачке, дозвољени случај употребе, датум истека или обнове и путању подршке. Саобраћај партнера треба да буде видљив одвојено од интерног саобраћаја апликације. <х3>Пример смерница за кључ партнера <пре><цоде>партнер: ацме-интегратион енв: производња дозвољене_крајње тачке: [ћаскање] дозвољени_модели: [аппровед-лов-латенци-модел] месечни_буџет_усд: 500 лимит_рате_рпм: 60 мак_оутпут_токенс: 800 цонтент_логгинг: онемогућено реневал_ревиев: 31.12.2026 суппорт_цонтацт: партнер-апи-опс@екампле.цом <п><стронг>Препорука: Покрените партнерске кључеве са нижим подразумеваним квотама и повећајте их након посматрања стабилног саобраћаја. Ово штити обе стране: партнер добија јасан пут интеграције, а власник платформе задржава опозив и контролу потрошње. <х2>Користите изворне контроле добављача, али не зависите од модела једног добављача <п>Пројекти добављача, радни простори, налози услуга, упозорења о буџету, ограничења стопе и извештаји о коришћењу су драгоцени. Користите их. Они смањују ризик на извору и могу да обезбеде додатни слој заштите. <п>Међутим, тимови са више добављача брзо наиђу на недоследност. Један провајдер може да изложи извештаје о коришћењу на нивоу кључа; други може структурирати приступ око радних простора; други може да нуди различите административне АПИ-је или контроле засноване на плану. Ако тимови користе неколико ЛЛМ провајдера, управљање би требало да нормализује оперативни модел за њих. <п><стронг>Препорука: Одржавајте интерни регистар кључева и слој смерница чак и када постоје контроле које су изворне код добављача. Мапирајте интерне кључеве у пројекте или радне просторе добављача где је то могуће. Ово даје тимовима за безбедност, платформу и финансије једно место да одговоре на основна питања: ко је власник овог саобраћаја, која се политика примењује, колико је то коштало и како да га искључимо? <х2>Контролна листа имплементације <ул> <ли>Креирајте регистар кључева са власником, апликацијом, окружењем, сврхом, нивоом података, буџетом, истеком и контактом за хитне случајеве. <ли>Преместите кључеве добављача у ограничену позадину, мрежни пролаз или услугу којом се управља тајно. <ли>Издајте управљане кључеве за тимове, апликације, окружења, ЦИ послове и партнере. <ли>Примени рутирање са најмањим привилегијама: дозвољени модели, крајње тачке, ограничења токена, ограничења стопе и ограничења буџета. <ли>Одвојена производња, припрема, развој, ЦИ и приступ партнера. <ли>Захтевати власништво над налогом за услугу за радна оптерећења производних машина-машина. <ли>Снимите телеметрију коришћења на нивоу кључа и нормализујте је међу добављачима. <ли>Подесите упозорења о аномалијама за скокове потрошње, активност неактивног кључа, коришћење новог модела и необичне мрежне изворе. <ли>Примените ротацију кључева који се преклапају и пратите завршетак централно. <ли>Напишите и тестирајте рунбоок за одговор на цурење. <ли>Подразумевано користите евиденцију само са метаподацима осим ако евидентирање садржаја није изричито одобрено. <ли>Прегледајте неактивне кључеве, кључеве без власника, са прекомерном дозволом и кључеве који су близу истека по редовном распореду. <х2>Закључак који се може спровести <п>Циљ управљања кључем ЛЛМ АПИ-ја није успоравање тимова. То је да се безбедан приступ учини лаким и небезбедним приступом непотребним. Дељени кључеви добављача стварају нејасно власништво, неконтролисани радијус експлозије и спор одговор на инцидент. Управљани кључеви креирају животни циклус којим се може управљати: захтевајте, одобравајте, издајте, обим, надгледајте, ротирајте и опозовите. <п>Почните од области највећег ризика: производња и приступ партнера. Ставите кључеве добављача иза контролисаног слоја, издајте интерне акредитиве са опсегом, приложите метаподатке о власништву и пратите потрошњу и коришћење по кључу. Када та основа буде постављена, проширите исти образац на развој, ЦИ, цевоводе евалуације и привремене експерименте. <п>Најбољи систем управљања је онај који програмери заправо могу да користе: брз за захтевање, јасан у смерницама, видљив подразумевано и безбедан за опозив када нешто крене наопако.<х2>Повезано читање<ул><ли><а хреф="/ен/блог/пер-теам-ллм-цост-ледгер-мултипле-аи-апис-39/><аЛМ>перед цост<аЛМ>
FAQ

Често постављана питања

Да ли сваки програмер треба да има лични ЛЛМ АПИ кључ?
Лични кључеви могу бити прихватљиви за ограничено експериментисање, али употреба производне машине-машина треба да користи сервисне налоге или кључеве којима управља апликација. Сваки кључ треба да буде у складу са одговорним тимом, оптерећењем, окружењем и политиком.
Колико често треба ротирати ЛЛМ АПИ кључеве?
Не постоји универзални интервал. Привремени и развојни кључеви би обично требали брзо да истекну. Производни кључеви треба да се ротирају по распореду који одговара безбедносним захтевима и зрелости примене. Користите прозоре валидности који се преклапају како ротација не би изазвала прекиде.
Да ли је довољно управљање пројектом или радним простором који је изворни добављач?
Провајдерске контроле су корисне и треба их користити тамо где су доступне. Тимовима са више провајдера обично је потребан додатни слој унутрашњег управљања да би нормализовали власништво, извештавање о потрошњи, смернице за рутирање и опозив међу добављачима.
Да ли тимови треба да евидентирају упите и одговоре за сваки АПИ кључ?
Не подразумевано. Евидентирање метаподатака је обично сигурније за широко управљање: ИД кључа, модел, цена, токени, статус, кашњење и одлуке о политици. Евидентирање садржаја упита или одговора треба да буде резервисано за одобрене случајеве коришћења са ограничењима задржавања и контролама приступа.