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

Επαλήθευση του κλειδιού διαχείρισης

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

Επαληθεύστε την ακεραιότητα των κλειδιών σας

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

Σημείο τελικού ελέγχου επικύρωσης

GET /auth/management-keys/validation
curl "https://management-api.x.ai/auth/management-keys/validation" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

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

Περιπτώσεις σφάλματος

  • 401 Unauthorized: Το κλειδί είναι μη έγκυρο, έχει λήξει ή έχει διαγραφεί
  • 403 Forbidden: Το κλειδί είναι έγκυρο, αλλά δεν διαθέτει τις απαραίτητες άδειες για την ζητούμενη ενέργεια

Ενσωμάτωση στα σενάριά σας

Επαλήθευση κατά την εκκίνηση

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

import requests
import sys

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

def validate_management_key():
    """Ελέγχει ότι το κλειδί διαχείρισης είναι έγκυρο."""
    try:
        response = requests.get(
            f"{MANAGEMENT_API}/auth/management-keys/validation",
            headers={"Authorization": f"Bearer {MGMT_KEY}"},
            timeout=10
        )
        if response.status_code == 200:
            print("Το κλειδί διαχείρισης είναι έγκυρο")
            return True
        elif response.status_code == 401:
            print("ΣΦΑΛΜΑ: Το κλειδί διαχείρισης είναι μη έγκυρο ή έχει λήξει")
            return False
        else:
            print(f"ΣΦΑΛΜΑ: Αναπάντεχη κατάσταση {response.status_code}")
            return False
    except requests.exceptions.RequestException as e:
        print(f"ΣΦΑΛΜΑ ΣΥΝΔΕΣΗΣ: {e}")
        return False

if not validate_management_key():
    sys.exit(1)

Περιοδικός έλεγχος υγείας (Healthcheck)

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

#!/bin/bash
# healthcheck-xai.sh — εκτέλεση κάθε ώρα μέσω cron

STATUS=$(curl -s -o /dev/null -w "%{http_code}" \
  "https://management-api.x.ai/auth/management-keys/validation" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY")

if [ "$STATUS" != "200" ]; then
    echo "ΕΙΔΟΠΟΙΗΣΗ: Το κλειδί διαχείρισης xAI είναι μη έγκυρο (HTTP $STATUS)"
    # Αποστολή ειδοποίησης (PagerDuty, Slack, email)
fi

Έλεγχος κλειδιών συμπερασμάτων

Ο περιοδικός έλεγχος απαντά σε τρία ερωτήματα για τα οποία καμία ειδοποίηση δεν θα ρωτήσει από μόνη της: ποια κλειδιά εξακολουθούν να έχουν χαρακτήρες μπαλαντέρ (wildcard), ποια δεν έχουν όρια ρυθμού και ποια δεν έχουν χρησιμοποιηθεί εδώ και μήνες. Τα δύο πρώτα αποτελούν κινδύνους, το τρίτο μια ευκαιρία για καθαρισμό—και όλα τα τρία διαχειρίζονται σε μία μόνο διέλευση.

import requests
from datetime import datetime

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."

def audit_api_keys():
    """Ελέγχει όλα τα κλειδιά API για την ομάδα."""
    response = requests.get(
        f"{MANAGEMENT_API}/auth/teams/{TEAM_ID}/api-keys",
        headers={"Authorization": f"Bearer {MGMT_KEY}"}
    )
    keys = response.json().get("apiKeys", [])

    print(f"=== Έλεγχος Κλειδιών API — {datetime.now().strftime('%d/%m/%Y %H:%M')} ===")
    print(f"Συνολικός αριθμός κλειδιών: {len(keys)}")

    for key in keys:
        name = key.get("name", "Ανώνυμο")
        acls = key.get("acls", [])
        expire = key.get("expireTime", "Ποτέ")
        created = key.get("createdAt", "Μ/Δ")

        # Ειδοποιήσεις
        warnings = []

        # Κλειδί με πρόσβαση wildcard
        if "api-key:endpoint:*" in acls and "api-key:model:*" in acls:
            warnings.append("ΠΛΗΡΗΣ ΠΡΟΣΒΑΣΗ (wildcards)")

        # Κλειδί χωρίς ημερομηνία λήξης
        if expire == "Ποτέ" or not expire:
            warnings.append("ΧΩΡΙΣ ΛΗΞΗ")

        # Κλειδί χωρίς όρια ρυθμού
        if not key.get("qps") and not key.get("qpm"):
            warnings.append("ΧΩΡΙΣ ΟΡΙΑ ΡΥΘΜΟΥ")

        status = " | ".join(warnings) if warnings else "OK"
        print(f"  [{name}] ACLs: {len(acls)} | Λήξη: {expire} | {status}")

audit_api_keys()

Λίστα ελέγχου ασφαλείας κλειδιών

Κλειδιά διαχείρισης

Τα κλειδιά διαχείρισης ελέγχουν τα πάντα—η παραβίασή τους παρέχει πρόσβαση για δημιουργία, τροποποίηση και διαγραφή όλων των κλειδιών συμπερασμάτων. Επομένως, απαιτούν τον αυστηρότερο χειρισμό: αποκλειστική αποθήκευση σε θησαυροφυλάκιο (vault), ποτέ σε απλό κείμενο μέσα στον κώδικα ή σε διαμορφώσεις με έλεγχο εκδόσεων· πρόσβαση περιορισμένη αποκλειστικά στους διαχειριστές υποδομής και όχι στους προγραμματιστές εφαρμογών· και τακτική επικύρωση μέσω GET /auth/management-keys/validation, ιδανικά αυτοματοποιημένη ως έλεγχος υγείας—ένα ληγμένο κλειδί διαχείρισης που ανακαλύπτεται όταν το χρειάζεστε επειγόντως αποτελεί το χειρότερο επιχειρησιακό σενάριο.

Κλειδιά συμπερασμάτων (Κλειδιά API)

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

Αρχή του διαχωρισμού των καθηκόντων

Διατηρήστε έναν σαφή διαχωρισμό μεταξύ των κλειδιών:

ΤύποςΧρήσηΠοιος έχει πρόσβαση
Κλειδί διαχείρισηςΔιαχείριση, χρέωση, αναλυτικά στοιχείαΔιαχειριστές υποδομής
Κλειδί ΠαραγωγήςΚλήσεις API σε παραγωγήΕφαρμογή παραγωγής
Κλειδί StagingΔοκιμές προ-παραγωγήςΟμάδα ανάπτυξης
Κλειδί ΑνάπτυξηςΤοπική ανάπτυξηΜεμονωμένος προγραμματιστής

Κάθε κλειδί έχει καθορισμένο πεδίο εφαρμογής. Εάν ένας προγραμματιστής αποχωρήσει από την ομάδα, διαγράφεται μόνο το δικό του κλειδί ανάπτυξης—τα υπόλοιπα παραμένουν άθικτα.

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

  • Το GET /auth/management-keys/validation ελέγχει την εγκυρότητα του κλειδιού διαχείρισής σας
  • Ενσωματώστε την επικύρωση στην εκκίνηση των σεναρίων σας και στην παρακολούθηση
  • Ελέγχετε τακτικά όλα τα κλειδιά για να εντοπίζετε υπερβολικά ευρείες πρόσβασης
  • Διαχωρίζετε τα κλειδιά ανά περιβάλλον και αρμοδιότητα
  • Ειδοποιείτε άμεσα για ένα μη έγκυρο κλειδί (ληγμένο ή διαγραμμένο)