Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Turvalisus ja parimad tavad

Õppetund 11 / 12 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Mida serveri ühendamine kaasa toob
  2. HTTPS ja autentimine: tingimusteta alustala
  3. Lubatud nimekirjad kui teine kaitseliin
  4. Kontekst on lõplik ressurss
  5. Kirjeldused, mis parandavad täpsust
  6. Peamised punktid

Mida serveri ühendamine kaasa toob

Grok’i ühendamine väliste MCP-serveritega annab mudelile võime tegutseda sinu süsteemides. See võim kaasneb riskidega ning eelmistes tundides tutvustasime parameetreid, mis seda kontrollivad. Nüüd on aeg need koondada terviklikuks turvapoliitikaks, mis sobib tootmiskeskkonda viimiseks.

HTTPS ja autentimine: tingimusteta alustala

Reegel on lihtne: iga tootmises olev MCP-server peab kasutama HTTPS-i ja nõudma autentimist. xAI jõustab esimest punkti juba ise ja lükkab tagasi kõik lihtsa HTTP-i URL-id. Teine punkt sõltub aga täielikult sinust ja just siin hiilivad sisse vead.

Ilma autentimiseta server on kättesaadav kõigile, kes teavad selle URL-i. See tähendab, et igaüks saab kutsuda sinu sisemisi tööriistu, andmed liiguvad ilma juurdepääsu kontrollita ja anomaalia korral puudub võimalus tuvastada, kes mida tegi. URL ei ole saladus: see liigub võrkudes, satub logidesse ja on ära arvatav, kui see järgib kindlat konventsiooni.

# Tootmine: ALATI koos autentimisega
mcp(
    server_url="https://api.monentreprise.com/mcp",
    server_label="interne",
    authorization=f"Bearer {os.getenv('MCP_TOKEN')}"
)

# Ainult arendus: ilma autentimiseta
# MITTE KUNAGI ei tohi tootmisse viia
mcp(
    server_url="https://mcp.deepwiki.com/mcp",
    server_label="deepwiki"
)

Tokenite haldamine nõuab nelja lihtsat distsipliini, millest tuleb aja jooksul kinni pidada. Salvesta tokenid keskkonnamuutujatesse, mitte lähtekoodi. Vastasel juhul saadab sinu esimene avalik git push tokeni kogu maailmale. Vaheta neid perioodiliselt, vähemalt iga 90 päeva tagant. Planeeritud vahetamine muudab võimaliku lekke piiratud ajaks kestvaks ohuks. Genereeri need minimaalsete õigustega, nii et ainult lugemisõigusega agendile varastatud token oleks kirjutada püüdja jaoks kasutu. Kui token on kompromiteeritud, tühistada see viivitamatult enne uue genereerimist. Järjekord loeb: tagantjärele tühistatud token töötab kogu aja, mille kulutad selle asendaja otsimisele.

Lubatud nimekirjad kui teine kaitseliin

Kehtiv token tõendab helistaja identiteeti, kuid ei ütle midagi selle kohta, mida helistaja tegema peaks. Siin tuleb mängu allowed_tool_names. See rakendab vähimate õiguste printsiipi, paljastades mudelile ainult hädavajaliku.

Konkreetne piirang sõltub agendi profiilist. Avalik vestlusrobot piirdub ainult lugemisoperatsioonidega, ilma et kirjutamistööriistad oleksid kättesaadavad.

allowed_tool_names=["search_docs", "get_article", "list_categories"]
# Puudub juurdepääs: create_article, update_article, delete_article

Sisemine agent võib endale lubada suuremat juurdepääsu, sealhulgas piletitele kommentaaride lisamist, hoides samal ajal pöördumatuid tegevusi või kolmandatele isikutele nähtavaid toiminguid eemal.

allowed_tool_names=[
    "search_tickets", "get_ticket", "add_comment",
    # Puudub juurdepääs: close_ticket, delete_ticket, reassign_ticket
]

Lõpuks vajab automatiseeritud torustik vaid kahte tööriista, mida selle töövoog aheldab. Sellel pole mingit põhjust midagi ümber seadistada.

allowed_tool_names=["run_analysis", "get_results"]
# Puudub juurdepääs: configure_pipeline, delete_results

Stsenaarium, mille eest need nimekirjad sind kaitsevad, on vihje sisestamine (prompt injection). Analüüsitud dokument, pilet või saabuv e-kiri võib sisaldada mudelile mõeldud juhendit. Ilma piiranguta võib see juhend viia mudeli andmete kustutamiseni delete_* tööriista kaudu, seadistuse muutmiseni update_config kaudu või soovimatute teadete saatmiseni send_email kaudu. Tööriista, mida kunagi ei paljastatud, ei saa ka üle võtta. See on ainus tõeliselt kindel garantii.

Kontekst on lõplik ressurss

Iga paljastatud tööriist tarbib kontekstiaknas tokeneid, kuna selle nimi, kirjeldus ja parameetrite skeem peavad seal asuma. Server, mis avaldab kolmkümmend tööriista, võib tarbida mitu tuhat tokenit enne, kui kasutaja on esitanud ühegi küsimuse.

Tagajärjed ilmnevad kolmel viisil: vähem ruumi vestlusele endale, pikem töötlemisaeg analüüsitava mahu tõttu ja suurem segaduse oht, kui mitu tööriista näevad sarnased välja. Kolm tava lahendavad selle. Esiteks, piira kasutades allowed_tool_names, mis jääb kõige otsesemaks hoovaks. Teiseks, segmenteerida kasutusjuhtumite järgi, selle asemel et hallata ühteainust konfiguratsiooni. Klienditoe agent, sisemine agent ja torustik ei pea jagama sama kataloogi. Lõpuks, hinda olukorda perioodiliselt üle. Kontrolli oma jälgi, et näha, milliseid tööriistu tegelikult kutsutakse. Sageli leiad mitu, mida pole kunagi kasutatud, kuid mis maksavad konteksti iga päringu korral.

Kirjeldused, mis parandavad täpsust

Hoolikalt koostatud kirjeldused nii serveri kui ka tööriista tasandil vähendavad märgatavalt ekslikke kutseid. Allpool olev kontrast illustreerib erinevust kasutatava ja kasutu kirjelduse vahel.

# Hea: spetsiifiline ja tegevust suunav
server_description="Toodete teadmiste baas. Otsi abiarikleid, KKK-sid ja tõrkeotsingu juhendeid toodetele A, B ja C."

# Halb: ebamäärane ja üldine
server_description="Andmebaas"

Süsteemi vihje on selle seadistuse viimane kiht. See võimaldab väljendada kasutuseeskirju, mida konfiguratsioon üksi jõustada ei saa, nagu allikate vaheline prioriteedijärjestus või kinnituse nõue.

Kui kasutaja küsib tehnilist küsimust, otsi esmalt sisemisest teadmiste baasist (kb).
Kui vastust ei leita, kasuta täiendusena veebiotsingut.
Ära kunagi muuda piletit ilma kasutaja selge kinnituseta.

Pea siiski meeles, et need juhised suunavad mudeli käitumist, kuid ei piira seda. Need täiendavad lubatud nimekirja; need ei asenda seda kunagi.

Peamised punktid

  • xAI jõustab HTTPS-i, kuid autentimine on sinu vastutus
  • Salvesta tokenid keskkonnamuutujatesse ja vaheta neid regulaarselt
  • Kasuta allowed_tool_names, et rakendada vähimate õiguste printsiipi
  • Jälgi konteksti koormust: iga tööriist tarbib tokeneid
  • Kirjuta täpseid kirjeldusi, et parandada Grok’i tööriistade valikut