OpenAI
Αυτή η σελίδα μεταφράστηκε αυτόματα. Δείτε το πρωτότυπο άρθρο στα αγγλικά.

Βέλτιστες πρακτικές για την ασφάλεια κλειδιού API

Protect your API keys with secure storage, access controls, monitoring, rotation, and IP restrictions.

Τελευταία ενημέρωση: yesterday

1. Χρησιμοποιείτε πάντα ένα μοναδικό κλειδί API για κάθε μέλος της ομάδας στον λογαριασμό σας.

Ένα κλειδί API είναι ένας μοναδικός κωδικός που προσδιορίζει τα αιτήματά σας προς το API. Το κλειδί API σας προορίζεται να χρησιμοποιείται από εσάς. Η κοινοποίηση κλειδιών API αντίκειται στους Όρους Χρήσης.

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

2. Μην αναπτύσσετε ποτέ το κλειδί σας σε περιβάλλοντα πλευράς πελάτη, όπως προγράμματα περιήγησης ή εφαρμογές για κινητά.

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

3. Μην καταχωρίζετε ποτέ το κλειδί σας στο αποθετήριό σας

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

4. Χρησιμοποιήστε μεταβλητές περιβάλλοντος αντί για το κλειδί API σας

Η μεταβλητή περιβάλλοντος είναι μια μεταβλητή που ορίζεται στο λειτουργικό σας σύστημα και όχι μέσα στην εφαρμογή σας. Αποτελείται από ένα όνομα και μια τιμή. Συνιστούμε να ορίσετε ως όνομα της μεταβλητής το OPENAI_API_KEY. Διατηρώντας αυτό το όνομα μεταβλητής ίδιο σε όλη την ομάδα σας, μπορείτε να κάνετε commit και να μοιράζεστε τον κώδικά σας χωρίς τον κίνδυνο αποκάλυψης του κλειδιού API σας.


Ρύθμιση σε Windows

Επιλογή 1: Ορίστε τη μεταβλητή περιβάλλοντος «OPENAI_API_KEY» μέσω της γραμμής εντολών cmd

Εκτελέστε την ακόλουθη εντολή στη γραμμή εντολών cmd, αντικαθιστώντας το <yourkey> με το κλειδί API σας:

setx OPENAI_API_KEY "<yourkey>"

Αυτό θα ισχύει για τα νέα παράθυρα της γραμμής εντολών cmd, επομένως θα χρειαστεί να ανοίξετε ένα νέο παράθυρο για να χρησιμοποιήσετε αυτή τη μεταβλητή με το curl. Μπορείτε να επαληθεύσετε ότι αυτή η μεταβλητή έχει οριστεί ανοίγοντας ένα νέο παράθυρο γραμμής εντολών cmd και πληκτρολογώντας

echo %OPENAI_API_KEY%

Επιλογή 2: Ορίστε τη μεταβλητή περιβάλλοντος «OPENAI_API_KEY» μέσω του Πίνακα Ελέγχου

  1. Ανοίξτε τις ιδιότητες Συστήματος και επιλέξτε Ρυθμίσεις συστήματος για προχωρημένους

Windows 10 System settings with Advanced system settings highlighted in Control Panel

  1. Επιλέξτε Μεταβλητές περιβάλλοντος...

Windows System Properties Advanced tab with Environment Variables button highlighted

  1. Επιλέξτε Δημιουργία… στην ενότητα «Μεταβλητές χρήστη» (επάνω). Προσθέστε το ζεύγος ονόματος/τιμής κλειδιού, αντικαθιστώντας το <yourkey> με το κλειδί API σας.

Όνομα μεταβλητής: OPENAI_API_KEY
Τιμή μεταβλητής: <yourkey>

Ρύθμιση σε Linux/macOS

Επιλογή 1: Ορίστε τη μεταβλητή περιβάλλοντος «OPENAI_API_KEY» χρησιμοποιώντας το zsh

  1. Εκτελέστε την ακόλουθη εντολή στο τερματικό σας, αντικαθιστώντας το yourkey με το κλειδί API σας.

echo "export OPENAI_API_KEY='yourkey'" >> ~/.zshrc

  1. Ενημερώστε το shell με τη νέα μεταβλητή:

source ~/.zshrc

  1. Επιβεβαιώστε ότι έχετε ορίσει τη μεταβλητή περιβάλλοντος χρησιμοποιώντας την ακόλουθη εντολή.

echo $OPENAI_API_KEY

Η τιμή του κλειδιού API σας θα είναι το αποτέλεσμα εξόδου.


Επιλογή 2: Ορίστε τη μεταβλητή περιβάλλοντος «OPENAI_API_KEY» χρησιμοποιώντας bash

Ακολουθήστε τις οδηγίες στην Επιλογή 1, αντικαθιστώντας το .zshrc με το .bash_profile.

Είστε έτοιμοι! Τώρα μπορείτε να αναφέρεστε στο κλειδί στο curl ή να το φορτώνετε στην Python σας:

import os
import openai
 
openai.api_key = os.environ["OPENAI_API_KEY"]

5. Χρησιμοποιήστε μια Υπηρεσία Διαχείρισης Κλειδιών

Υπάρχει ποικιλία διαθέσιμων προϊόντων για την ασφαλή διαχείριση μυστικών κλειδιών API. Αυτά τα εργαλεία σάς επιτρέπουν να ελέγχετε την πρόσβαση στα κλειδιά σας και να βελτιώνετε τη συνολική ασφάλεια των δεδομένων σας. Σε περίπτωση παραβίασης δεδομένων στην εφαρμογή σας, το κλειδί ή τα κλειδιά σας δεν θα παραβιάζονταν, καθώς θα ήταν κρυπτογραφημένα και διαχειριζόμενα σε μια εντελώς ξεχωριστή τοποθεσία.

Για ομάδες που αναπτύσσουν τις εφαρμογές τους σε παραγωγή, συνιστούμε να εξετάσετε μία από αυτές τις υπηρεσίες.

6. Παρακολουθείτε τη χρήση του λογαριασμού σας και αντικαθιστάτε τα κλειδιά σας όταν χρειάζεται

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

Μπορείτε να παρακολουθείτε τη χρήση των ομάδων σας από τη σελίδα Χρήση. Αν ανησυχείτε για πιθανή κατάχρηση, μπορείτε να προστατεύσετε τον λογαριασμό σας με τους εξής τρόπους:

  • Ελέγξτε τη χρήση σας για να διαπιστώσετε αν συνάδει με την εργασία της ομάδας σας. Για χρήστες που ανήκουν σε πολλούς οργανισμούς (π.χ. εταιρικό και προσωπικό), βεβαιωθείτε ότι ο χρήστης έχει ενεργοποιήσει την παρακολούθηση και έχει ορίσει τον προεπιλεγμένο οργανισμό του για τη χρήση και την παρακολούθηση.

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

  • Επικοινωνήστε μαζί μας μέσω του help.openai.com για περαιτέρω διερεύνηση.

7. Περιορίστε την πρόσβαση στο API χρησιμοποιώντας λίστα επιτρεπόμενων IP

Η λίστα επιτρεπόμενων IP σάς επιτρέπει να περιορίζετε ποιες διευθύνσεις IP μπορούν να έχουν πρόσβαση στο OpenAI API σας. Όταν είναι ενεργοποιημένη, επιτρέπονται μόνο αιτήματα από διαμορφωμένες διευθύνσεις ή εύρη IP και όλα τα υπόλοιπα απορρίπτονται—even αν περιλαμβάνουν έγκυρο κλειδί API.

Αυτό προσθέτει ένα επιπλέον επίπεδο προστασίας, διασφαλίζοντας ότι το API σας είναι προσβάσιμο μόνο από αξιόπιστη υποδομή, όπως οι backend διακομιστές σας ή το περιβάλλον cloud σας.

Για περισσότερες πληροφορίες, δείτε το άρθρο Λίστα επιτρεπόμενων IP για το OpenAI API.

Σας βοήθησε αυτό το άρθρο;