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

Περιστροφή και διαγραφή κλειδιών

Μάθημα 4 / 14 Ενημερώθηκε 29 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Περιστροφή: Ανανέωση χωρίς διακοπή
  2. Εκτέλεση περιστροφής
  3. Διαγραφή κλειδιού
  4. Αυτοματοποίηση περιστροφής
  5. Βασικά σημεία

Περιστροφή: Ανανέωση χωρίς διακοπή

Η περιστροφή κλειδιών αποτελεί κρίσιμη πρακτική ασφαλείας. Δημιουργεί ένα νέο μυστικό κλειδί για να αντικαταστήσει το παλιό, χωρίς να διαγράφει το ίδιο το κλειδί. Το παλιό μυστικό ακυρώνεται άμεσα και οριστικά.

Εκτέλεση περιστροφής

Η περιστροφή λύνει ένα πρόβλημα που η διαγραφή δεν μπορεί: την ανανέωση του μυστικού χωρίς απώλεια της ταυτότητας του κλειδιού. Οι λίστες ελέγχου πρόσβασης (ACLs), τα όρια ρυθμού και το όνομα επιβιώνουν της διαδικασίας, οπότε δεν χρειάζεται να επαναρυθμίσετε τίποτα· αλλάζει μόνο το μυστικό στο θησαυροφυλάκιό σας. Αυτό καθιστά πρακτική την τακτική περιστροφή· η επαναδημιουργία ενός κλειδιού θα απαιτούσε επαναρυθμίσεις κάθε φορά.

POST /auth/api-keys/{apiKeyId}/rotate
curl -X POST "https://management-api.x.ai/auth/api-keys/$API_KEY_ID/rotate" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Συμπεριφορά κατά την περιστροφή

  • Το παλιό μυστικό κλειδί ακυρώνεται άμεσα· οποιοδήποτε αίτημα που το χρησιμοποιεί θα αποτύχει με σφάλμα 401
  • Ένα νέο μυστικό κλειδί δημιουργείται και επιστρέφεται στην απόκριση
  • Το ID κλειδιού (apiKeyId), το όνομα, οι ACLs και τα όρια ρυθμού παραμένουν αμετάβλητα
  • Το νέο μυστικό κλειδί εμφανίζεται μόνο μία φορά· αποθηκεύστε το αμέσως

Ασφαλής διαδικασία περιστροφής

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

  1. Προετοιμάστε τις υποδομές σας για να δεχτούν ένα νέο κλειδί (μεταβλητή περιβάλλοντος, θησαυροφυλάκιο)
  2. Εκτελέστε την περιστροφή μέσω του API
  3. Ενημερώστε το μυστικό στο θησαυροφυλάκιό σας αμέσως
  4. Επαναναπτύξτε τις υπηρεσίες σας με το νέο κλειδί
  5. Επαληθεύστε ότι τα αιτήματα επιτυγχάνουν με το νέο κλειδί
  6. Επαληθεύστε τη διάδοση μέσω GET /auth/api-keys/{apiKeyId}/propagation

Πότε να κάνετε περιστροφή

Τρεις καταστάσεις πυροδοτούν την περιστροφή, η καθεμία με διαφορετικό βαθμό επείγοντος. Η υποψία διαρροής απαιτεί άμεση περιστροφή: όταν ένα μέλος της ομάδας με πρόσβαση στο κλειδί αποχωρεί, όταν ένα αρχείο καταγραφής που περιέχει κλειδί εκτίθεται δημόσια, ή όταν ένα αποθετήριο Git περιέχει ένα κλειδί σε απλό κείμενο. Σε αυτές τις περιπτώσεις, κάθε ώρα αναμονής είναι μια ώρα έκθεσης, οπότε κάντε περιστροφή πριν ολοκληρώσετε την ανάλυση του συμβάντος. Η περιστροφή βάσει πολιτικής είναι προληπτική: κάθε 30, 60 ή 90 ημέρες, ανάλογα με τις απαιτήσεις ασφαλείας σας, περιορίζει τη διάρκεια ζωής ενός κλειδιού που ενδέχεται να έχει διαρρεύσει απαρατήρητο. Τέλος, οι αλλαγές στο περιβάλλον—μετάβαση υποδομής ή αλλαγή παρόχου—αποτελούν φυσική ευκαιρία για νέα αρχή με καθαρά κλειδιά, αντί να μεταφέρετε παλιά κλειδιά σε ένα πλαίσιο για το οποίο δεν σχεδιάστηκαν ποτέ.

Διαγραφή κλειδιού

Η διαγραφή είναι οριστική και αμετάκλητη. Το ερώτημα που πρέπει να θέσετε πριν τη διαγραφή δεν είναι «Είναι αυτό το κλειδί συμβιβασμένο;» αλλά «Χρειάζομαι ακόμα αυτό το εύρος πρόσβασης;». Αν η απάντηση είναι ναι, χρειάζεστε περιστροφή: εξουδετερώνει το εκτεθειμένο μυστικό διατηρώντας παράλληλα τη διαμόρφωση. Η διαγραφή δικαιολογείται μόνο για ένα κλειδί που δεν είναι πλέον χρήσιμο—ένα σταματημένο έργο, έναν προμηθευτή που αποχώρησε ή ένα περιβάλλον που έχει απενεργοποιηθεί.

DELETE /auth/api-keys/{apiKeyId}
curl -X DELETE "https://management-api.x.ai/auth/api-keys/$API_KEY_ID" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Συνέπειες της διαγραφής

  • Το κλειδί και όλες οι παράμετροί του διαγράφονται οριστικά
  • Όλα τα αιτήματα που χρησιμοποιούν αυτό το κλειδί θα αποτύχουν αμέσως
  • Η ενέργεια είναι μη αναστρέψιμη· θα χρειαστεί να δημιουργήσετε ένα νέο κλειδί με νέες παραμέτρους
  • Το ιστορικό χρήσης του κλειδιού παραμένει διαθέσιμο στα αναλυτικά στοιχεία

Περιστροφή έναντι διαγραφής

ΠτυχήΠεριστροφήΔιαγραφή
Το κλειδί υπάρχει ακόμαΝαιΌχι
Δημιουργία νέου μυστικούΝαιΌχι
Διατήρηση ACLsΝαιΌχι
Διατήρηση ορίωνΝαιΌχι
ΑντιστρέψιμοΌχι (απώλεια παλιού μυστικού)Όχι (διαγραφή κλειδιού)
Τυπική χρήσηΤακτική ανανέωσηΠαρωχημένο κλειδί ή επιβεβαιωμένος συμβιβασμός

Αυτοματοποίηση περιστροφής

Η αυτοματοποιημένη περιστροφή έχει νόημα μόνο εάν η εγγραφή στο θησαυροφυλάκιο αποτελεί μέρος του ίδιου σεναρίου, χωρίς καμία χειροκίνητη παρέμβαση ενδιάμεσα. Διαφορετικά, απλώς μετατοπίζετε τον κίνδυνο: ένα μυστικό που δημιουργείται από μηχάνημα και αντιγράφεται χειροκίνητα είναι πιο πιθανό να καταλήξει στο πρόχειρο ή στο ιστορικό του τερματικού από ό,τι ένα κλειδί που δημιουργείται από την κονσόλα.

import requests
import json

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
KEY_ID = "key-123"

# Rotate
response = requests.post(
    f"{MANAGEMENT_API}/auth/api-keys/{KEY_ID}/rotate",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)

new_key = response.json()
new_secret = new_key.get("secret")

# Store in your vault (example with a .env file)
# In production, use Vault, AWS Secrets Manager, etc.
print(f"New key generated. Update your vault.")

Προγραμματισμένη περιστροφή

Ενσωματώστε την περιστροφή στον αγωγό CI/CD ή σε μια εργασία cron:

# Cron example: rotation on the 1st of each month at 3 AM
0 3 1 * * /opt/scripts/rotate-xai-keys.sh

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

  • Το POST /auth/api-keys/{apiKeyId}/rotate ακυρώνει το παλιό μυστικό και δημιουργεί ένα νέο
  • Η ακύρωση του παλιού μυστικού είναι άμεση και οριστική
  • Το DELETE /auth/api-keys/{apiKeyId} διαγράφει το κλειδί μη αναστρέψιμα
  • Προτιμήστε την περιστροφή αντί της διαγραφής για να διατηρήσετε τις υπάρχουσες ACLs και τα όρια
  • Αυτοματοποιήστε την περιστροφή με ένα σενάριο και ένα θησαυροφυλάκιο μυστικών
  • Επαληθεύετε πάντα τη διάδοση μετά από μια περιστροφή