Επισκόπηση
Η λίστα επιτρεπόμενων IP είναι μια προαιρετική λειτουργία ασφαλείας που σας επιτρέπει να περιορίζετε ποιες διευθύνσεις IP έχουν πρόσβαση στο API της OpenAI που χρησιμοποιείτε.
Όταν είναι ενεργοποιημένη, επιτρέπονται μόνο αιτήματα που προέρχονται από τις διευθύνσεις IP ή τα εύρη IP που έχετε ορίσει. Τα αιτήματα από όλες τις άλλες IP απορρίπτονται, ακόμη και αν περιλαμβάνουν έγκυρο κλειδί API.
Αυτή η λειτουργία έχει σχεδιαστεί για να βοηθά στη μείωση του κινδύνου μη εξουσιοδοτημένης χρήσης του API, περιορίζοντας την πρόσβαση σε αξιόπιστα περιβάλλοντα δικτύου.
Σημείωση: Η λίστα επιτρεπόμενων IP ισχύει μόνο για αιτήματα API. Δεν επηρεάζει την πρόσβαση στο platform.openai.com ούτε τη σύνδεση των χρηστών.
Γιατί να χρησιμοποιήσετε λίστα επιτρεπόμενων IP
Η λίστα επιτρεπόμενων IP μπορεί να σας βοηθήσει να:
Περιορίσετε την πρόσβαση στο API σε γνωστές υποδομές (για παράδειγμα, στους διακομιστές ή στα περιβάλλοντα cloud σας)
Μειώσετε την έκθεση σε κίνδυνο σε περίπτωση διαρροής κλειδιού API
Προσθέσετε ένα επιπλέον επίπεδο ελέγχου της προέλευσης της κίνησης προς το API
Η λίστα επιτρεπόμενων IP χρησιμοποιείται κυρίως σε περιβάλλοντα παραγωγής, όπου η κίνηση προς το API προέρχεται από σταθερά ή σαφώς καθορισμένα εύρη διευθύνσεων δικτύου.
Πώς λειτουργεί
Ορίζετε μια λίστα με επιτρεπόμενες διευθύνσεις IP ή εύρη CIDR.
Τα αιτήματα από επιτρεπόμενες IP γίνονται δεκτά.
Τα αιτήματα από IP που δεν περιλαμβάνονται στη λίστα επιτρεπόμενων IP απορρίπτονται.
Η λίστα επιτρεπόμενων IP μπορεί να εφαρμοστεί:
Σε επίπεδο οργανισμού ή
Σε επίπεδο έργου
Διαθεσιμότητα
Η λειτουργία λίστας επιτρεπόμενων IP είναι διαθέσιμη σε όλους τους πελάτες του API.
Για να ρυθμίσετε τη λίστα επιτρεπόμενων IP, ακολουθήστε τα παρακάτω βήματα.
Ρύθμιση λίστας επιτρεπόμενων IP
Σημείωση: Μπορείτε να προσθέσετε έως 50 διευθύνσεις IP ή εύρη CIDR.
Ανοίξτε τις Ρυθμίσεις.
Επιλέξτε Ασφάλεια.
Επιλέξτε Λίστα επιτρεπόμενων IP.
Προσθέστε μία ή περισσότερες διευθύνσεις IP ή εύρη CIDR.
(Προαιρετικό) Χρησιμοποιήστε το εργαλείο Έλεγχος για να επαληθεύσετε αν μια IP περιλαμβάνεται στη λίστα επιτρεπόμενων IP.
Ενεργοποιήστε τη λίστα επιτρεπόμενων IP για:
Ένα συγκεκριμένο έργο ή
Ολόκληρο τον οργανισμό σας.
Δοκιμάστε αιτήματα από τα περιβάλλοντα που σκοπεύετε να χρησιμοποιήσετε.
Συνιστούμε να ξεκινήσετε με ένα μόνο έργο πριν εφαρμόσετε τους περιορισμούς σε ολόκληρο τον οργανισμό.
Αφού κάνετε αλλαγές, μπορεί να χρειαστούν έως 15 λεπτά για να τεθούν σε ισχύ.
Σημείωση: Πρέπει να έχετε τα κατάλληλα δικαιώματα στον οργανισμό για να διαμορφώσετε τις ρυθμίσεις της λίστας επιτρεπόμενων IP.
Αντιμετώπιση προβλημάτων
Αν αντιμετωπίζετε απρόσμενες αποτυχίες αιτημάτων:
Επιβεβαιώστε ότι το αίτημα προέρχεται από επιτρεπόμενη διεύθυνση IP.
Ελέγξτε αν έχουν αλλάξει οι διευθύνσεις IP της υποδομής σας.
Ελέγξτε ότι τα εύρη IP που έχετε ορίσει είναι σωστά.
Περιμένετε έως 15 λεπτά για να εφαρμοστούν παντού οι αλλαγές στις ρυθμίσεις.
Χρησιμοποιήστε το εργαλείο Έλεγχος για να επαληθεύσετε αν μια IP επιτρέπεται.
Τι συμβαίνει όταν ένα αίτημα αποκλείεται
Αν ένα αίτημα προέρχεται από διεύθυνση IP που δεν περιλαμβάνεται στη λίστα επιτρεπόμενων IP, αποτυγχάνει με:
Κατάσταση HTTP: 401 Unauthorized
Κωδικός σφάλματος: ip_not_authorized
Παράδειγμα απόκρισης:
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
Συχνές ερωτήσεις
Η λίστα επιτρεπόμενων IP αποτρέπει κάθε μη εξουσιοδοτημένη χρήση του κλειδιού API μου;
Όχι. Η λίστα επιτρεπόμενων IP μπορεί να βοηθήσει στη μείωση του κινδύνου, περιορίζοντας την προέλευση των αιτημάτων API, αλλά δεν αποτρέπει πλήρως όλες τις μορφές κατάχρησης. Θα πρέπει να χρησιμοποιείται σε συνδυασμό με άλλες βέλτιστες πρακτικές ασφαλείας, όπως η ασφαλής αποθήκευση κλειδιών, η τακτική αντικατάστασή τους και η ισχυρή προστασία του λογαριασμού. Για πρόσθετη ασφάλεια, συμβουλευτείτε τους οδηγούς του κέντρου βοήθειας σχετικά με τις Βέλτιστες πρακτικές για την ασφάλεια των κλειδιών API και την Αποτροπή μη εξουσιοδοτημένης χρήσης.
Η λίστα επιτρεπόμενων IP επηρεάζει τον χρόνο απόκρισης;
Η λίστα επιτρεπόμενων IP μπορεί να προκαλέσει ελάχιστη καθυστέρηση σε ορισμένες περιπτώσεις, συνήθως στα αρχικά αιτήματα. Δεν αναμένεται να επηρεάσει σημαντικά τη συνολική απόδοση του API.
Πώς μπορώ να ξέρω αν ένα αίτημα αποτυγχάνει λόγω της λίστας επιτρεπόμενων IP;
Τα αιτήματα που αποτυγχάνουν λόγω της λίστας επιτρεπόμενων IP επιστρέφουν:
HTTP status: 401 UnauthorizedError code: ip_not_authorized
