Δημιουργία και ασφάλιση του κλειδιού API σας
Σε αυτήν τη σελίδα
Τα διαπιστευτήρια που πιστοποιούν τα αιτήματά σας
Το κλειδί API σας πιστοποιεί κάθε αίτημα που αποστέλλεται στα μοντέλα της Mistral: χωρίς αυτό, καμία κλήση δεν γίνεται δεκτή. Θεωρήστε το ως έναν τεχνικό κωδικό πρόσβασης, ο οποίος όμως ταξιδεύει μέσω κώδικα, αρχείων διαμόρφωσης και αγωγών ανάπτυξης (deployment pipelines), καταλήγοντας έτσι σε πολύ περισσότερα σημεία από έναν τυπικό κωδικό πρόσβασης. Όποιος το κατέχει μπορεί να καταναλώσει την ποσόστωσή σας και να δημιουργήσει κόστος στον λογαριασμό σας.
Δημιουργία του πρώτου σας κλειδιού
Στην Κονσόλα της Mistral, ανοίξτε τον χώρο εργασίας σας και μεταβείτε στην ενότητα API Keys στην πλευρική γραμμή. Κάντε κλικ στο Create new key και δώστε του ένα περιγραφικό όνομα, όπως dev-chatbot-mars-2026. Αυτό το όνομα δεν έχει τεχνική λειτουργία, αλλά θα σας σώσει τη στιγμή που συνυπάρχουν έξι κλειδιά στη λίστα και πρέπει να ανακαλέσετε μόνο ένα: το “key 3” δεν σας λέει τίποτα, ενώ το dev-chatbot-mars-2026 σας τα λέει όλα.
Το κλειδί εμφανίζεται μόνο μία φορά, τη στιγμή της δημιουργίας του. Αντιγράψτε το αμέσως και αποθηκεύστε το σε ασφαλές μέρος. Αν κλείσετε το παράθυρο πριν το αντιγράψετε, δεν υπάρχει τρόπος ανάκτησής του: πρέπει να δημιουργήσετε ένα νέο. Ένα κλειδί της Mistral αποτελείται από ένα πρόθεμα ακολουθούμενο από μια μεγάλη αλφαριθμητική συμβολοσειρά. Μην το συγχέετε με το ID του χώρου εργασίας σας ή με ένα διακριτικό JWT: σε αντίθεση με το τελευταίο, δεν λήγει μόνο του και παραμένει έγκυρο μέχρι να το ανακαλέσετε εσείς.
Αποθήκευση χωρίς ποτέ να το ενσωματώνετε στον κώδικα
Ο χρυσός κανόνας είναι απλός: μην ενσωματώνετε ποτέ το κλειδί API σας απευθείας στον πηγαίο κώδικα. Την ημέρα που αυτό το αρχείο θα καταλήξει σε ένα κοινόχρηστο αποθετήριο, το κλειδί θα πάει μαζί του. Χρησιμοποιείτε πάντα μια μεταβλητή περιβάλλοντος.
Σε Linux και macOS, δηλώστε το στο τερματικό:
export MISTRAL_API_KEY="your-api-key-here"
Αυτή η μεταβλητή εξαφανίζεται όταν κλείνετε το τερματικό· για να την κάνετε μόνιμη, προσθέστε τη γραμμή στο αρχείο ~/.bashrc, ~/.zshrc ή ~/.profile.
Στα Windows, το ισοδύναμο στο PowerShell έχει ως εξής:
$env:MISTRAL_API_KEY = "your-api-key-here"
Και για να επιβιώσει μετά από επανεκκίνηση της συνεδρίας:
[System.Environment]::SetEnvironmentVariable("MISTRAL_API_KEY", "your-api-key-here", "User")
Σε ένα έργο εφαρμογής, η πιο συνηθισμένη πρακτική είναι η δημιουργία ενός αρχείου .env στη ρίζα του έργου:
MISTRAL_API_KEY=your-api-key-here
Προσθέστε το .env στο .gitignore αμέσως—πριν την πρώτη σας υποβολή (commit), όχι μετά. Στην Python, η βιβλιοθήκη python-dotenv διαβάζει αυτό το αρχείο και εισάγει τις μεταβλητές κατά την εκκίνηση, προσφέροντας την ευκολία ενός τοπικού αρχείου χωρίς τον κίνδυνο έκδοσης μυστικών σε έλεγχο εκδόσεων.
Περιστροφή των κλειδιών σας
Αντικαθιστάτε ένα κλειδί για τρεις λόγους. Άμεσα, εάν έχει εκτεθεί με οποιονδήποτε τρόπο: μια υποβολή (commit) σε δημόσιο αποθετήριο Git, ένα βιαστικό μήνυμα στο Slack ή ίχνη στα αρχεία καταγραφής (logs) του διακομιστή. Τακτικά σε περιβάλλον παραγωγής, με κάθε ενενήντα ημέρες να αποτελεί μια λογική συχνότητα. Και όταν ένας συνεργάτης αποχωρεί που είχε πρόσβαση, την ίδια ημέρα που επιστρέφει την ταυτότητά του.
Η διαδικασία αποφεύγει τη διακοπή της υπηρεσίας εάν σεβαστείτε τη σειρά:
- Δημιουργήστε ένα νέο κλειδί στην Κονσόλα
- Ενημερώστε τη μεταβλητή περιβάλλοντος σε όλες τις αναπτύξεις σας
- Επαληθεύστε ότι όλα λειτουργούν με το νέο κλειδί
- Ανακαλέστε το παλιό κλειδί μόνο μετά από αυτή την επαλήθευση
Η εναλλαγή των βημάτων 3 και 4 είναι το κλασικό λάθος: ανακαλείτε πρώτα “για ασφάλεια”, μόνο για να ανακαλύψετε ότι μια ξεχασμένη υπηρεσία χρησιμοποιούσε ακόμα το παλιό κλειδί. Αυτή η περιστροφή χωρίς διακοπή λειτουργίας (zero-downtime) διασφαλίζει ότι κανένα στοιχείο δεν θα αποτύχει κατά τη μετάβαση.
Μείωση της επιφάνειας έκθεσης
Εάν πολλαπλές εφαρμογές καλούν το API, δημιουργήστε ένα κλειδί ανά εφαρμογή. Εάν μία από αυτές compromiserθεί, χρειάζεται να ανακαλέσετε μόνο αυτό το συγκεκριμένο κλειδί χωρίς να σταματήσετε τις άλλες. Με την ίδια αρχή, μην επαναχρησιμοποιείτε ποτέ ένα κλειδί παραγωγής στην ανάπτυξη: αυτό είναι ακριβώς το περιβάλλον όπου τα μυστικά κυκλοφορούν πιο ελεύθερα.
Στη συνέχεια, παρακολουθείτε τη χρήση από την Κονσόλα, η οποία εκθέτει αρχεία καταγραφής χρήσης για κάθε κλειδί. Μια ξαφνική αύξηση στα tokens ή στις κλήσεις από μια άγνωστη διεύθυνση IP θα πρέπει να πυροδοτήσει άμεση περιστροφή, χωρίς να περιμένετε επιβεβαίωση του συμβάντος.
Τρία τελικά λάθη αξίζουν αναφοράς επειδή τα συναντάμε κάθε εβδομάδα. Ένα κλειδί που δημοσιεύεται σε ένα δημόσιο αποθετήριο Git παραμένει αναγνώσιμο στο ιστορικό ακόμα και μετά τη διαγραφή του αρχείου: η μόνη έγκυρη αντίδραση είναι η ανάκληση. Ένα κλειδί που αποστέλλεται σε καθαρό κείμενο μέσω email ή άμεσου μηνύματος αρχειοθετείται για πάντα σε διακομιστές που δεν ελέγχετε. Και ένα κλειδί που έχει λήξει ή ανακληθεί και παραμένει σε μια ανάπτυξη παράγει σφάλματα 401 Unauthorized, των οποίων η διάγνωση συχνά παίρνει μία ώρα, απλώς επειδή κανείς δεν σκέφτηκε να το ελέγξει.
Βασικά σημεία
- Δημιουργήστε τα κλειδιά σας από την ενότητα API Keys του χώρου εργασίας σας στην Κονσόλα της Mistral
- Αποθηκεύστε τα αποκλειστικά σε μεταβλητές περιβάλλοντος ή σε έναν διαχειριστή μυστικών
- Εκτελείτε τακτική περιστροφή και άμεση περιστροφή σε περίπτωση έκθεσης
- Δημιουργείτε ένα κλειδί ανά εφαρμογή για να περιορίσετε τον αντίκτυπο μιας παραβίασης
- Προσθέτετε πάντα το
.envστο.gitignore