Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Laikinieji prieigos raktai WebSocket ryšiams

Paskaita 5 iš 12 Atnaujinta 2026 m. liepos 28 d. Pažengusiems
Šiame puslapyje
  1. Problema: kliento autentifikavimas neatskleidžiant savo rakto
  2. Kaip veikia laikinieji prieigos raktai
  3. Tinkamos trukmės pasirinkimas
  4. „Backend“ įgyvendinimas
  5. Svarbiausi punktai

Problema: kliento autentifikavimas neatskleidžiant savo rakto

Kuriant balso ar realiuoju laiku veikiančią programą su „Grok“ API, turi tiesiogiai iš naršyklės ar mobiliojo įrenginio kliento užmegzti WebSocket ryšį. Srauto maršrutizavimas per tavo serverį pridėtų delsos, kuri sutrikdytų sklandų balso pokalbį. Tačiau tiesioginiai ryšiai kelia autentifikavimo problemą: niekada neturi įtraukti savo API rakto į kliento pusės kodą.

Priežastis paprasta: bet koks raktas, įterptas į „frontend“ JavaScript kodą, dekompiliuojamą mobiliąją programėlę ar platinamą dvejetainį failą, yra pažeidžiamas tą akimirką, kai jį paskelbi. Bet kuris vartotojas gali atidaryti naršyklės kūrėjo įrankius ir jį perskaityti. Norint tai išspręsti, „xAI“ siūlo laikinus prieigos raktus: laikinus žetonus, kuriuos klientai gali naudoti niekada nematydami pagrindinio rakto.

600s
Numatytoji trukmė
3600s
Maksimali trukmė
POST
/v1/realtime/client_secrets
Bearer
Laikinas žetonas

Kaip veikia laikinieji prieigos raktai

Architektūra remiasi vienu principu: API raktas niekada nepalieka tavo serverio, o klientas gauna tik trumpalaikį žetoną. Procesas trumpas. Klientas iš tavo „backend“ prašo žetono, kuris iškviečia POST /v1/realtime/client_secrets naudodamas tavo API raktą. Tai vienintelė vieta, kur raktas atsiranda, ir tai vyksta visiškai serverio pusėje. „xAI“ grąžina laikiną žetoną su jo galiojimo pabaigos data, kurį tavo „backend“ perduoda klientui. Tada klientas atidaro WebSocket ryšį su wss://api.x.ai/v1/realtime, pateikdamas šį žetoną. Nei vienu momentu naršyklė nemato pagrindinio rakto; ji tvarko žetoną, kuris savaime nustoja galioti.

Žetono kūrimo užklausa iš tavo „backend“ atrodo taip:

curl -X POST https://api.x.ai/v1/realtime/client_secrets \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"expires_after": {"seconds": 600}}'

O atsakymas:

{
  "value": "Bearer eyJhbGciOiJSUzI1NiIs...",
  "expires_at": 1712001200
}

Dėl trukmės turi tris orientyrus: nėra dokumentuotos minimalios ribos (galimos kelios sekundės), numatytoji reikšmė yra 600 sekundžių (10 minučių), o maksimali – 3600 sekundžių (1 valanda).

Tinkamos trukmės pasirinkimas

Žetono trukmė turi atitikti tavo naudojimo atvejį, ir šis pasirinkimas yra tikras saugumo sprendimas. Epizodinėms balso sąveikoms – klausimų ir atsakymų sesijoms, balso komandoms, diktavimui – pakanka 300–600 sekundžių lango: sesija baigsis gerokai prieš pasibaigiant galiojimui. Ilgesniems balso pokalbiams, pavyzdžiui, klientų aptarnavimui, pokalbiui dėl darbo ar pagalbiniam susirinkimui, siek 600–1800 sekundžių, kad išvengtum ryšio nutraukimo pokalbio viduryje. Ilgoms darbo sesijoms – transkripcijai realiuoju laiku, nuolatiniam balso stebėjimui – gali būti pateisinama 1800–3600 sekundžių trukmė, tačiau maksimalią trukmę naudok atsargiai: ji išplečia išnaudojimo langą, jei žetonas būtų pavogtas.

Auksinė taisyklė skamba taip: visada rinkis trumpiausią trukmę, suderinamą su tavo naudojimo atveju. Jei žetonas būtų perimtas, dešimties minučių galiojimo laikas paverstų potencialiai rimtą incidentą nedideliu nepatogumu.

„Backend“ įgyvendinimas

Štai saugaus tarpinio serverio („proxy“) pavyzdys naudojant „Node.js“:

// Backend maršrutas - NIEKADA neatskleisk kliento pusėje
app.post("/api/realtime-token", authenticateUser, async (req, res) => {
  const response = await fetch(
    "https://api.x.ai/v1/realtime/client_secrets",
    {
      method: "POST",
      headers: {
        "Authorization": `Bearer ${process.env.XAI_API_KEY}`,
        "Content-Type": "application/json"
      },
      body: JSON.stringify({
        expires_after: { seconds: 600 }
      })
    }
  );

  const token = await response.json();
  res.json({ token: token.value, expires_at: token.expires_at });
});

Šiame pavyzdyje trys detalės lemia visą sąrankos saugumą. API raktas saugomas serverio aplinkos kintamajame, niekada – kode. Tarpinė programinė įranga authenticateUser patikrina vartotojo tapatybę prieš išduodant žetoną – be jos bet kas galėtų gauti žetonus ir eikvoti tavo kvotą tavo sąskaita. Ir klientui grąžinamas tik laikinas žetonas, niekada – raktas.

Kodų peržiūrose reguliariai iškyla keletas spąstų. API raktas, „tik prototipui“ įterptas į „frontend“, neišvengiamai atsiduria gamybinėje aplinkoje. Žetonas sistemingai kuriamas naudojant maksimalią trukmę dėl patogumo, nors naudojimo atvejis reikalauja ketvirtadalio tos trukmės. Generavimo galutinė punkto paliekama be autentifikavimo patikros, prieinama visiems. Ir trūksta atnaujinimo apdorojimo kliento pusėje, dėl ko sesijos viduryje kyla galiojimo pabaigos klaidos užuot vykus perjungimui be trikdžių: kadangi atsakyme gauni expires_at, tavo klientas turi viską, ko reikia naujam žetonui paprašyti prieš terminą, o ne po jo.

Svarbiausi punktai

  • Laikinieji prieigos raktai leidžia WebSocket autentifikavimą neatskleidžiant tavo API rakto
  • Galutinis punktas: POST /v1/realtime/client_secrets (tik serverio pusės užklausa)
  • Konfigūruojama trukmė nuo kelių sekundžių iki maksimalių 3600 sekundžių (numatytoji: 600 s)
  • Tavo „backend“ veikia kaip autentifikavimo tarpininkas tarp kliento ir „xAI“
  • Visada rinkis trumpiausią trukmę, suderinamą su tavo naudojimu