Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Turvallisuus ja parhaat käytännöt

Oppitunti 11 / 12 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Mitä palvelimen yhdistäminen avaa
  2. HTTPS ja todennus: ehdoton perusta
  3. Sallituslistat toisena puolustuslinjana
  4. Konteksti on äärellinen resurssi
  5. Tarkkuutta parantavat kuvaukset
  6. Keskeiset asiat

Mitä palvelimen yhdistäminen avaa

Grokin yhdistäminen etä-MCP-palvelimiin antaa mallille kyvyn toimia järjestelmissäsi. Tähän voimaan liittyy riskejä, ja aiemmissa oppitunneissa esiteltiin sitä ohjaavat parametrit. Nyt on aika järjestää ne johdonmukaiseksi turvallisuusasenteeksi tuotantokäyttöön ottoa varten.

HTTPS ja todennus: ehdoton perusta

Sääntö on yksinkertainen: jokaisen tuotantoympäristön MCP-palvelimen on käytettävä HTTPS:ää ja vaadittava todennusta. xAI valvoo jo ensimmäistä kohtaa ja hylkää kaikki pelkät HTTP-URL-osoitteet. Toinen kohta riippuu kuitenkin täysin sinusta, ja juuri siihen hiipii virheitä.

Palvelin ilman todennusta on kaikkien niiden saatavilla, jotka tuntevat URL-osoitteen. Tämä tarkoittaa, että kuka tahansa voi kutsua sisäisiä työkalujasi, tietosi kiertävät ilman pääsynvalvontaa, eikä sinulla ole keinoa jäljittää tekijöitä poikkeamatilanteissa. URL-osoite ei ole salaisuus: se kulkee verkkojen yli, päätyy lokitiedostoihin ja on arvattavissa, jos se noudattaa jotakin käytäntöä.

# Tuotanto: AINA todennuksen kanssa
mcp(
    server_url="https://api.monentreprise.com/mcp",
    server_label="interne",
    authorization=f"Bearer {os.getenv('MCP_TOKEN')}"
)

# VAIN kehitys: ilman todennusta
# ÄLÄ KOSKAAN ota käyttöön tuotannossa
mcp(
    server_url="https://mcp.deepwiki.com/mcp",
    server_label="deepwiki"
)

Tokenien hallinta noudattaa neljää yksinkertaista periaatetta, mutta sinun on pidettävä niistä kiinni ajan myötä. Tallenna tokenit ympäristömuuttujiin, älä koskaan lähdekoodiin. Muuten ensimmäinen julkinen git push -komentosi lähettää tokenisi koko maailmalle. Kierrätä niitä määräajoin, vähintään 90 päivän välein. Ajoitettu kierrätys muuttaa mahdollisen vuodon rajatuksi altistumisajaksi. Luo ne käyttäen vain tarvittavia vähimmäisoikeuksia, jotta lukuoikeuksilla varustetulle agentille varastettu token on hyödytön kirjoitusyrityksissä. Jos token vaarantuu, kumoa se välittömästi ennen uuden luomista. Järjestyksellä on väliä: jälkikäteen kumottu token toimii edelleen koko sen ajan, jonka käytät korvaavan etsimiseen.

Sallituslistat toisena puolustuslinjana

Voimassa oleva token todistaa kutsujan henkilöllisyyden, mutta se ei kerro mitään siitä, mitä kutsujan pitäisi saada tehdä. Tässä tulee kuvaan allowed_tool_names. Se soveltaa vähimmäisoikeuksien periaatetta paljastamalla mallille vain ehdottoman välttämättömän.

Tarkka rajoitus riippuu agentin profiilista. Julkinen chatbot pysyy vain lukutoiminnoissa, eikä sillä ole pääsyä kirjoitustyökaluihin.

allowed_tool_names=["search_docs", "get_article", "list_categories"]
# Ei pääsyä: create_article, update_article, delete_article

Sisäinen agentti voi sallia laajemman pääsyn, kuten kommentoinnin tukipyynnöissä, pitäen kuitenkin peruuttamattomat toiminnot tai ulkopuolisille näkyvät toiminnot ulottumattomissa.

allowed_tool_names=[
    "search_tickets", "get_ticket", "add_comment",
    # Ei pääsyä: close_ticket, delete_ticket, reassign_ticket
]

Lopuksi automatisoitu putki tarvitsee vain kaksi työkalua, jotka sen työnkulku ketjuttaa yhteen. Sille ei ole perustetta konfiguroida mitään uudelleen.

allowed_tool_names=["run_analysis", "get_results"]
# Ei pääsyä: configure_pipeline, delete_results

Nämä listat suojaavat sinua kehoteinjektioilta (prompt injection). Analysoitu asiakirja, tukipyyntö tai saapuva sähköposti voi sisältää mallille tarkoitetun ohjeen. Ilman rajoituksia tämä ohje voi saada mallin poistamaan dataa delete_*-työkalulla, muuttamaan asetuksia update_config-komennolla tai lähettämään ei-toivottuja viestejä send_email-toiminnolla. Työkalua, jota ei ole koskaan paljastettu, ei voi kaapata. Tämä on ainoa todella varma takuu.

Konteksti on äärellinen resurssi

Jokainen paljastettu työkalu kuluttaa tokeneita konteksti-ikkunassa, sillä sen nimi, kuvaus ja parametrien skeema on säilytettävä siellä. Kolmekymmentä työkalua julkaiseva palvelin voi kuluttaa useita tuhansia tokeneita ennen kuin käyttäjä esittää kysymystäkään.

Seuraukset näkyvät kolmella tavalla: vähemmän tilaa varsinaiselle keskustelulle, pidempi käsittelyaika analysoitavan määrän vuoksi ja suurempi sekaannusriski, kun useat työkalut näyttävät samankaltaisilta. Kolme käytäntöä ratkaisee tämän. Ensinnäkin rajoita käyttämällä allowed_tool_names, joka on suoraviivaisin vipu. Toiseksi segmentoi käyttötapausten mukaan yhden yleiskonfiguraation ylläpidon sijaan. Asiakastukiagentilla, sisäisellä agentilla ja putkella ei ole syytä jakaa samaa luetteloa. Kolmanneksi arvioi tilanne määräajoin uudelleen. Tarkista jäljet nähdäksesi, mitä työkaluja todella kutsutaan. Huomaat usein, että useita työkaluja ei ole koskaan käytetty, mutta ne maksavat kontekstitilaa jokaisessa pyynnössä.

Tarkkuutta parantavat kuvaukset

Huolelliset kuvaukset sekä palvelin- että työkalutasolla vähentävät mitattavasti virheellisiä kutsuja. Alla oleva kontrasti havainnollistaa eroa käyttökelpoisen ja hyödyttömän kuvauksen välillä.

# Hyvä: spesifi ja toiminnallinen
server_description="Product knowledge base. Search help articles, FAQ, and troubleshooting guides for products A, B, and C."

# Huono: epämääräinen ja yleinen
server_description="Database"

Järjestelmäkehote (system prompt) on tämän asetelman viimeinen kerros. Sen avulla voit ilmaista käyttö sääntöjä, joita pelkkä konfiguraatio ei voi valvoa, kuten lähteiden välisen prioriteettijärjestyksen tai vahvistusvaatimuksen.

When the user asks a technical question, search the internal knowledge base (kb) first.
If the answer is not found, use web search as a supplement.
Never modify a ticket without explicit user confirmation.

Muista kuitenkin, että nämä ohjeet suuntaavat mallin käyttäytymistä rajoittamatta sitä. Ne täydentävät sallituslistaa, mutta eivät koskaan korvaa sitä.

Keskeiset asiat

  • xAI valvoo HTTPS:n käyttöä, mutta todennus on sinun vastuullasi
  • Tallenna tokenit ympäristömuuttujiin ja kierrätä niitä säännöllisesti
  • Käytä allowed_tool_names-parametria vähimmäisoikeuksien periaatteen toteuttamiseen
  • Valvo kontekstikuormitusta: jokainen työkalu kuluttaa tokeneita
  • Kirjoita tarkat kuvaukset parantaaksesi Grokin työkalujen valintaa