API ja MCP GRC-s: määrake juurdepääs enne süsteemide ühendamist

Agent, kes saab lugeda nõuetele vastavuse dokumenti, ei peaks saama automaatselt toimingut heaks kiita, täielikku andmebaasi eksportida ega teise organisatsiooni kirjeid muuta. Enne integreerimismeetodi valimist määratlege äriülesanne ja lubatud toimingud. Kasulik tulemus on kontrollitud vahetus kontrollitava tulemuse ja vastutava isikuga.

Esmalt tuleb kindlaks määrata tootepiir. Pulsar GRC praegune avaliku andmevahetuse dokumentatsioon kirjeldab kontrollitud importi ja eksporti ning rakenduse enda kasutaja töövooge. See ei paku selgesõnaliselt avalikku integratsiooni API-d, iseteenindusega API võtmeid ega veebihaake väliste ERP-, HR-, SharePointi või Google Drive’i ühenduste jaoks. API ja MCP disaini käsitlev artikkel ei tee sellist integratsiooni prooviversioonis kättesaadavaks.

Allpool toodud integratsiooninäited on sünteetilise arhitektuuri harjutused. Pulsari saate kasutada nende nõuete, riskide, tegevuste ja tõendite registreerimiseks ning dokumenteeritud vahetustoimingute kontrollimiseks. Arutage konkreetset välisühendust eraldi. Ärge suunake klienti dokumenteerimata lõpp-punktile ega kasutage jagatud kasutajakontot, et imiteerida integratsiooni, mida toode pole pakkunud.

Alustage ülesande ja andmepiiriga

Kirjutage soovitud ülesanne tavalises keeles. Näiteks: assistent loeb heakskiidetud protseduuri ja koostab kontrollilünga kirjelduse kavandi läbivaatamiseks. Seejärel tuvastage organisatsioon, kirjed, versioonid ja väljad, mida ta vajab. Kui ülesanne ei vaja töötajate nimesid ega täielikku juhtumiaruannet, jätke need andmed sisendist välja.

Nimetage isik, kellele protsess kuulub, ja isik, kes saab selle tulemuse üle vaadata. Tehniliselt korrektsel ühendusel ei saa ikkagi olla vastutavat omanikku. Läbivaatamisel tuleks hinnata, kas heakskiidetud allikas toetab eelnõu ja kas see jääb eelnõuks. Teksti genereerimine ei kinnita juhtelementi ega sulge toimingut.

Määrake ka eeldatav väljund. Kavandatud lõik, salvestatud kirje mustand ja kinnitatud otsus on erinevad tulemused. Määrake, millist integratsioonil on lubatud luua ja mis peab juhtuma, enne kui see jõustub. See väldib agendile laialdase kirjutamisõiguse andmist, kuna projekti lühikirjelduses kasutati mitmetähenduslikku sõna „värskenda”.

Eraldi lugemine, ettepanekute tegemine, kinnitamine ja eksport

Looge ülesande jaoks toimingute loend. Valitud heakskiidetud kirjete lugemiseks võib olla vaja ühte luba; eelnõu esitamine võib nõuda teist. Kinnitamisel, avaldamisel, kustutamisel, lubade muutmisel ja eksportimisel võivad olla suuremad tagajärjed ja nende enda autoriseerimisnõuded. Hoidke need eristused alles juurdepääsu jõustavas teenuses, mitte ainult mudelile kuvatavas viipas.

Sünteetilises harjutuses lubage etteantud protseduur läbi lugeda ja mustand ette valmistada. Välista kinnitamine ja avaldamine. Ülevaataja peaks nägema allikat ja soovitust redigeerima või tagasi lükkama. Kui ühendus proovib välistatud toimingut, registreerige keeldumine ja veenduge, et vastav olek ei muutunud.

Käsitlege eksporti eraldi otsusena. Konkreetset kirjet lugeda oskaval kasutajal ei pruugi olla õigustatud vajadust kõike organisatsiooniga seonduvat alla laadida. Enne paki koostamist määrake saaja, eesmärk, periood ja väljad. Praegune Pulsari juhend muudab load ja ulatuse osaks kontrollitud vahetusest, mis on kasulik piir, mida edaspidi integreerimisel säilitada.

Kasutage transpordi jaoks mõeldud luba

MCP autoriseerimise spetsifikatsioon kirjeldab HTTP transpordi suhet kliendi, kaitstud serveri ja autoriseerimisserveri vahel. See seab nõuded loa kasutamisele ja sihtressursi valideerimisele. Samuti käsitleb see STDIO-d erinevalt, kasutades tavaliselt keskkonnast saadud mandaate. Lugege selle transpordi spetsifikatsiooni, mida te tegelikult rakendate; akronüüm MCP ei tuvasta üht universaalset autentimisseadet.

Disaini ülevaatamiseks tehke kindlaks, kes mandaate väljastab, milline teenus neid aktsepteerib ja kuidas otsustatakse lubatud ulatus. Token peaks olema mõeldud seda vastuvõtvale teenusele ja vastuvõttev teenus peab selle piiri kinnitama. Vältige juurdepääsulubade paigutamist URL-i päringu stringidesse. Need on teie pakutud ühenduse arhitektuurinõuded, mitte väited, et Pulsar paljastab konkreetse avaliku lõpp-punkti.

Dokumenteerige, kuidas mandaadid aeguvad, kuidas juurdepääs tühistatakse ja milline isik omab uuendamist. Lühiajalised mandaadid on kasulikud ainult siis, kui ümbritseva süsteemi aegumiskäepidemed on õiged. Ühendus, mis vaikselt taandub võimsamale jagatud kontole, kaotab kavandatud piirangu. Kaasake proovis tühistamine, selle asemel, et kontrollida ainult esimest edukat taotlust.

Hoidke organisatsiooni konteksti jõustamise poolel

Ärge käsitlege agendi antud rentniku või organisatsiooni identifikaatorit selle organisatsiooni andmete kasutamise õigusena. Teenus peab looma konteksti autentitud osaleja ja volitatud suhte kaudu. Helistaja, kes muudab päringus identifikaatorit, ei tohi omandada erineva kliendi andmeid.

Selle kujunduse kontrollimisel kasutage spetsiaalses testkeskkonnas kahte sünteetilist organisatsiooni. Volitage abiline ühe jaoks ja proovige toimingut teise jaoks. Registreerige keeldumine ja veenduge, et ühtegi kirjet ega teisest ulatust eksporditud pakki ei tagastatud. Ärge korraldage harjutust tegelike sõltumatute klientide vastu.

Testige ka liikmesuse või rolli muudatusi. Kui inimene kaotab asjakohase loa, ei tohiks varem kasulik luba või seanss jätkata eemaldatud toimingu pakkumist väljaspool süsteemi dokumenteeritud reegleid. Registreerige konkreetne testitud käitumine. Üks oma organisatsiooni edu ei ütle teistsuguse organisatsiooni piiride kohta vähe.

Käsitlege lähtedokumente andmetena

Protseduur, tarnija aruanne või kommentaar võib sisaldada lugejale suunatud juhiseid. Need juhised ei anna volitust integratsiooni lubade muutmiseks ega andmete mujale saatmiseks. Kiire süstimine muutub asjakohaseks, kui agent loeb ebausaldusväärset materjali ja tõlgendab seda tööriistade juhisena. Hoidke kinnitatud ülesanne ja tööriistapoliitika dokumendi sisust eraldi.

Sünteetilise harjutuse jaoks lisage näidisdokumendi sisse kahjutu juhis, milles palutakse assistendil eksportida mitteseotud kirjed. Oodatav tulemus on see, et assistent käsitleb seda dokumendi sisuna ja jõustamisteenus ei luba eksporti. Ärge lisage testiviipale tõelisi saladusi ega klienditeavet.

Piirake dokumendi ulatust ja näidake mustandi kõrval lähteversiooni. Retsensent peab teadma, milline heakskiidetud materjal ettepanekut toetab. Kui assistent kasutas vananenud versiooni või ilma kontekstita lõiku, peaks tulemus jääma parandamiseks avatuks. Kontrolllünga ladus kirjeldus ei ole piisav tõend selle tühimiku olemasolu kohta.

Logige toimingu rekonstrueerimiseks piisavalt

Määratlege sündmuse kirje enne esimest ühendust. See peaks identifitseerima osaleja, asjakohase ülesande või taotluse, sihtkirje, toimingu, autoriseerimise tulemuse, aja ja tulemuse oleku lubatud ulatuses. Säilitage korrelatsiooniidentifikaator, et tehnilist taotlust saaks siduda domeenikirjega ilma kogu dokumenti logi kopeerimata.

OWASPi logimisjuhised selgitavad, miks tuleks saladused, mandaadid ja mittevajalik tundlik sisu välja jätta või neid hoolikalt käsitleda. Rakendage seda põhimõtet ka viipade, vastuste ja tugijälgede puhul. Täielik ärakiri ei ole automaatselt kasulik kontrolljälg, eriti kui see loob isiklikust või konfidentsiaalsest teabest uue kontrollimatu koopia.

Hoidke alles nii keeldumise kui ka edu tõendid. Kinnitamisest keeldumise toiming ja muutmata kirje näitavad lubatud lugemisest erinevat omadust. Nimetage, millist atribuuti iga sündmus toetab. Ärge märgistage vastust “heakskiidetud” ainult seetõttu, et tehniline taotlus täideti veatult.

Kontrollige olekut pärast lubatud kirjutamist

Kui eraldi volitatud projekt lubab eelnõu salvestada, lugege protokoll pärast toimingut läbi. Kontrollige organisatsiooni, versiooni, sisu ja mustandi olekut. Aktsepteeritud päring või genereeritud identifikaator on vahetulemus. Ettevõte peab teadma, kas kavandatud kirje on koos kavandatud suhetega olemas.

Plaani korduskatsed. Võrgutõrge võib jätta helistaja ebakindlaks, kas toimingut rakendati. Kui seda toetatakse, kasutage selgesõnalist idempotentsuse korraldust ja kontrollige salvestatud olekut enne uuesti proovimist. Sobiv meetod sõltub teenuslepingust. Ärge leiutage Pulsari jaoks konkreetset päist või lõpp-punkti, kui see pole avalikult dokumenteeritud.

Ebaõnnestunud ja osalised tulemused selgelt salvestada. Kui tõendite ettevalmistamine õnnestus, kuid kinnitamine jääb ootele, öelge see tegevusprotokolli. See muudab ülejäänud töö ülevaatajale nähtavaks. Jada kokkutõmbamine üheks õnnestumise lipuks võib muuta integratsiooni täielikuks, samas kui domeeniülesanne jääb lahendamata.

Alustage dokumenteeritud vahetustoimingutega

Kui äriülesannet saab täita kontrollitud impordi või ekspordi kaudu, kontrollige seda teed enne reaalajas ühenduse loomist. Pulsari avalik juhend kirjeldab toetatud failivormingu ettevalmistamist, kirjete ja seoste kinnitamist, aktsepteeritud ja tagasilükatud tulemuste ülevaatamist ning valitud kirjete tagasilugemist pärast importimist. Saadaolev toiming määrab vormingu.

Ekspordi jaoks määrake ulatus, saaja ja eesmärk ning kontrollige paketi versioone, manifesti ja aruannet, kui toiming seda võimaldab. Vastuvõttev isik peaks kontrollima täielikkust ja loetavust. Faili eksportimine ei taga edukat migratsiooni teise süsteemi; vastuvõtuvorming ja seosed nõuavad oma kontrolli.

Kasutage prooviharjutuse jaoks väikest sünteetilist komplekti. Säilitage identifikaatorid ja seosed ning registreerige erandid. Kui toiming ei saa nõutavat seost kanda, registreerige see lünk integreerimisnõudes. Käsitsi vahetamine võib paljastada tegeliku andmelepingu enne, kui investeerite automatiseeritud ühendustesse.

Valmistage ette integratsioonijuhend, millele tarnija võib vastata

Kirjutage üles vahetuse suund, lähtesüsteem, vastuvõtusüsteem ja täpsed kaasatud kirjed. Lisage sagedus, eeldatav maht, identifikaatorite kuuluvus ja nõutav tulemus. Lühikokkuvõte, mis ütleb: “Ühendage meie tehisintellekt vastavusega”, jätab kõige olulisemad otsused vastuseta. Tarnija peab teadma, kas soovite mustandit, sünkroonitud viidet või kinnitatud domeenimuudatust.

Loetlege toimingud, mis on välistatud. Sünteetilises näites tähendab see mitteseotud kirjete kinnitamist, avaldamist ega eksportimist. Täpsustage, kuidas volitatud isik ettepanekut läbi vaatab ja kus lõplik otsus salvestatakse. Juhend peaks võimaldama juurutusmeeskonnal luua kitsa ühenduse, selle asemel et küsida laia administraatorijuurdepääsu otseteena.

Kaasake ebaõnnestumise käitumine. Kui lähtesüsteem pole saadaval, kas ülesanne peaks ootama, tegema selgelt märgistatud mittetäieliku mustandi või peatuma? Kui vastuvõttev süsteem lükkab versiooni tagasi, siis kes lahendab konflikti? Kasulik ülevaade muudab need olekud selgeks ja takistab integratsioonil puuduva konteksti põhjal vaikselt tulemust kirjutamast. Kasutage kehtivat teenindusdokumentatsiooni, et teha kindlaks, millist pakutud käitumist toetatakse.

Kavandage tõendid loa piiri kohta

Koostage arhitektuuriharjutuse jaoks vastuvõtutabel. Lisage lubatud lugemine õiges organisatsioonis, välistatud kinnituskatse, vale organisatsiooni katse, aegunud mandaat ja uuesti proovimine pärast ebakindlat vastust. Märkige iga juhtumi puhul oodatud tulemus ja kirje, mis seda näitaks. Hoidke väljamõeldud identifikaatorid ja algdokumendid selgelt märgistatud katseandmetena.

Kontrollige keeldumise juhtumite muutmata olekut. Keeldumisteade on kasulik, kuid soovitud äriomadus on see, et keelatud toimingut ei toimunud. Pärast kinnitamiskatset kontrollige kirje olekut ja ajalugu. Pärast vale korralduse taotlust kontrollige tagastatud ulatust. Jäädvustage ainult testitud piiri demonstreerimiseks vajalikud metaandmed, mandaate või mitteseotud sisu salvestamata.

Säilitage harjutuses kasutatud konfiguratsioon või poliitikaversioon. Kui load hiljem muutuvad, kirjeldavad vanad tõendid vana korraldust. Seda ei tohiks ilma uue asjakohase kontrollita laiema integratsiooni tõestuseks uuesti kasutada. See muudab kontrollkirje ausaks ja võimaldab ülevaatajal näha, milline muudatus tekitas vajaduse uue testi järele.

Otsustage, millal on reaalajas ühendus õigustatud

Võrrelge äritegevuse sagedust ja kiireloomulisust ühenduse säilitamisega seotud tööga. Kui väike ülevaadatud failivahetus vastab vajadusele, võib reaalajas juurdepääs lisada mandaadihalduse, veakäsitluse ja vastutuse juhtumite eest ilma vastava äritulemuseta. Salvestage tegelik maht ja nõutav viivitus, selle asemel, et valida integratsioon pelgalt tehnoloogia olemasolu tõttu.

Kui vajadus on sagedane või ajakriitiline, kasutage toetatud juurutuse arutamiseks lühi- ja loateste. Enne kui käsitlete seda pakkumise osana, leppige kokku leping, tegevuse ulatus ja ülevaatusprotsess. Vestlus võimaliku tulevase ühenduse üle ei muuda seda igale proovikasutajale kättesaadavaks. Hoidke see piirang äriotsuse kõrval.

Hinnake Pulsaris ühte juhtelementi

Looge piiratud juurdepääsu nõue ja lingitud toiming, et harjutada oma sünteetilises kujunduses lubatud ja keelatud toiminguid. Lisage saadaoleva liidese abil tõenditena testi kirjeldus ja tulemus. Määrake arvustaja ja eeldatav kriteerium. Katses hinnatakse, kuidas Pulsar seda tööd korraldab; see ei paku arhitektuuriharjutuses kasutatavat välisagendi käitusaega.

Pärast salvestamist lugege nõuet, tegevust ja tõendeid. Kontrollige, kas mõni teine volitatud kolleeg suudab tuvastada ülesande, allika, ülevaataja ja ülejäänud erandi. Jätke kõik lahendamata integratsiooniküsimused avatud toiminguna. See on konkreetne tulemus, mida avalik pakkumine toetab ilma dokumentideta API-ühenduseta.

14-päevane Pulsari prooviversioon nõuab makseviisi. Enne registreerimise kinnitamist vaadake üle kehtiv plaan, tasu kuupäev ja tühistamistingimused. Kui vajate välist integreerimist, valmistage sellest juhendist ette ülesanne, andmete ulatus ja autoriseerimisnõuded ning arutage neid eraldi. Hinnake pakutud ühendust selle lubatud toimingute ja kontrollitud tulemuste, mitte tehisintellekti või MCP sildi olemasolu järgi.

Vaadake tingimused üle ja alustage 14-päevast prooviperioodi