Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Εφήμερα διακριτικά για συνδέσεις WebSocket

Μάθημα 5 / 12 Ενημερώθηκε 28 Ιουλίου 2026 Προχωρημένος
Σε αυτήν τη σελίδα
  1. Το πρόβλημα: Πιστοποίηση πελάτη χωρίς αποκάλυψη του κλειδιού σας
  2. Πώς λειτουργούν τα εφήμερα διακριτικά
  3. Επιλογή της κατάλληλης διάρκειας
  4. Υλοποίηση Backend
  5. Βασικά σημεία

Το πρόβλημα: Πιστοποίηση πελάτη χωρίς αποκάλυψη του κλειδιού σας

Όταν δημιουργείτε μια εφαρμογή φωνής ή πραγματικού χρόνου με το Grok API, πρέπει να establish μια σύνδεση WebSocket απευθείας από τον browser ή τον κινητό πελάτη. Η δρομολόγηση της κίνησης μέσω του διακομιστή σας προσθέτει λανθάνουσα χρονική καθυστέρηση που διακόπτει τη ρευστή φωνητική συνομιλία. Ωστόσο, οι άμεσες συνδέσεις δημιουργούν ένα πρόβλημα πιστοποίησης: δεν πρέπει ποτέ να συμπεριλάβετε το κλειδί API σας στον κώδικα της πλευράς του πελάτη.

Ο λόγος είναι απλός: κάθε κλειδί ενσωματωμένο σε JavaScript frontend, σε μια αποσυμπιεσμένη κινητή εφαρμογή ή σε έναν διανεμημένο δυαδικό κώδικα, compromitάται τη στιγμή που το δημοσιεύετε. Οποιοσδήποτε χρήστης μπορεί να ανοίξει τα εργαλεία προγραμματιστή του browser του και να το διαβάσει. Για να λύσετε αυτό το πρόβλημα, το xAI προσφέρει εφήμερα διακριτικά: προσωρινά διακριτικά που οι πελάτες μπορούν να χρησιμοποιήσουν χωρίς να δουν ποτέ το κύριο κλειδί.

600s
Προεπιλεγμένη διάρκεια
3600s
Μέγιστη διάρκεια
POST
/v1/realtime/client_secrets
Bearer
Προσωρινό διακριτικό

Πώς λειτουργούν τα εφήμερα διακριτικά

Η αρχιτεκτονική ακολουθεί μία αρχή: το κλειδί API δεν εγκαταλείπει ποτέ τον διακομιστή σας και ο πελάτης λαμβάνει μόνο ένα διακριτικό μικρής διάρκειας. Η ροή είναι σύντομη. Ο πελάτης ζητά ένα διακριτικό από το backend σας, το οποίο καλεί το POST /v1/realtime/client_secrets με το κλειδί API σας. Αυτή η κλήση είναι το μόνο σημείο όπου εμφανίζεται το κλειδί και συμβαίνει εξ ολοκλήρου στην πλευρά του διακομιστή. Το xAI επιστρέφει ένα εφήμερο διακριτικό με την ημερομηνία λήξης του, το οποίο το backend σας περνά στον πελάτη. Στη συνέχεια, ο πελάτης ανοίγει τη σύνδεση WebSocket στο wss://api.x.ai/v1/realtime παρουσιάζοντας αυτό το διακριτικό. Σε κανένα σημείο ο browser δεν βλέπει το κύριο κλειδί· χειρίζεται ένα διακριτικό που λήγει μόνο του.

Η κλήση δημιουργίας από το backend σας μοιάζει με αυτήν:

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}}'

Και η απόκριση:

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

Όσον αφορά τη διάρκεια, έχετε τρία σημεία αναφοράς: δεν υπάρχει τεκμηριωμένο κατώτατο όριο (είναι δυνατά λίγα δευτερόλεπτα), η προεπιλεγμένη τιμή είναι 600 δευτερόλεπτα (10 λεπτά) και το μέγιστο είναι 3600 δευτερόλεπτα (1 ώρα).

Επιλογή της κατάλληλης διάρκειας

Η διάρκεια του διακριτικού πρέπει να ταιριάζει με τη χρήση σας και αυτή η επιλογή αποτελεί πραγματική απόφαση ασφαλείας. Για σποραδικές φωνητικές αλληλεπιδράσεις—μια ερώτηση-απάντηση, μια φωνητική εντολή, υπαγόρευση—ένα παράθυρο 300 έως 600 δευτερολέπτων είναι αρκετό: η συνεδρία θα τελειώσει πολύ πριν από τη λήξη. Για παρατεταμένες φωνητικές συνομιλίες όπως υποστήριξη πελατών, συνέντευξη ή assisted meeting, στοχεύστε σε 600 έως 1800 δευτερόλεπτα για να αποφύγετε τη διακοπή στη μέση της συνομιλίας. Παρατεταμένες συνεδρίες εργασίας—μεταγραφή σε πραγματικό χρόνο, συνεχής φωνητική παρακολούθηση—μπορεί να δικαιολογούν 1800 έως 3600 δευτερόλεπτα, αλλά χρησιμοποιήστε τη μέγιστη διάρκεια με προσοχή: επεκτείνει το παράθυρο εκμετάλλευσης εάν το διακριτικό κλαπεί.

Ο χρυσός κανόνας συνοψίζεται ως εξής: επιλέγετε πάντα τη μικρότερη διάρκεια που είναι συμβατή με τη χρήση σας. Εάν ένα διακριτικό αναχαιτιστεί, μια λήξη δέκα λεπτών μετατρέπει ένα δυνητικά σοβαρό περιστατικό σε μια μικρή ενόχληση.

Υλοποίηση Backend

Ακολουθεί ένα παράδειγμα ασφαλούς διακομιστή μεσολάβησης σε Node.js:

// Διαδρομή Backend - ΜΗΝ την εκθέσετε στην πλευρά του πελάτη
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 });
});

Τρεις λεπτομέρειες σε αυτό το παράδειγμα φέρουν όλη την ασφάλεια της ρύθμισης. Το κλειδί API βρίσκεται σε μια μεταβλητή περιβάλλοντος του διακομιστή, ποτέ στον κώδικα. Το middleware authenticateUser επαληθεύει την ταυτότητα του χρήστη πριν από την έκδοση διακριτικού—χωρίς αυτό, ο καθένας θα μπορούσε να αποκτήσει διακριτικά και να καταναλώσει την ποσόσωσή σας με δικά σας έξοδα. Και μόνο το εφήμερο διακριτικό, ποτέ το κλειδί, επιστρέφεται στον πελάτη.

Μερικές παγίδες εμφανίζονται τακτικά στις αναθεωρήσεις κώδικα. Το κλειδί API γλιστρά στο frontend «απλώς για το πρωτότυπο» και καταλήγει αναπόφευκτα στην παραγωγή. Το διακριτικό δημιουργείται συστηματικά με τη μέγιστη διάρκεια, για ευκολία, όταν η χρήση απαιτεί το ένα τέταρτο αυτού. Το endpoint δημιουργίας αφήνεται χωρίς επαλήθευση πιστοποίησης, ανοιχτό σε όλους. Και η έλλειψη διαχείρισης ανανέωσης στην πλευρά του πελάτη, η οποία παράγει σφάλματα λήξης στη μέση της συνεδρίας αντί για μια διαφανή επανασύνδεση: δεδομένου ότι η απόκριση σας δίνει το expires_at, ο πελάτης σας έχει όλα όσα χρειάζεται για να ζητήσει ένα νέο διακριτικό πριν από την προθεσμία και όχι μετά.

Βασικά σημεία

  • Τα εφήμερα διακριτικά επιτρέπουν την πιστοποίηση WebSocket χωρίς αποκάλυψη του κλειδιού API σας
  • Endpoint: POST /v1/realtime/client_secrets (κλήση μόνο στην πλευρά του διακομιστή)
  • Ρυθμιζόμενη διάρκεια από λίγα δευτερόλεπτα έως 3600 δευτερόλεπτα μέγιστο (προεπιλογή: 600s)
  • Το backend σας λειτουργεί ως διακομιστής μεσολάβησης πιστοποίησης μεταξύ του πελάτη και του xAI
  • Επιλέγετε πάντα τη μικρότερη διάρκεια που είναι συμβατή με τη χρήση σας