Επισκόπηση

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

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

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


Σημείωση: Η λίστα επιτρεπόμενων IP ισχύει μόνο για αιτήματα API. Δεν επηρεάζει την πρόσβαση στο platform.openai.com ή τη σύνδεση χρήστη.


Γιατί να χρησιμοποιήσετε λίστα επιτρεπόμενων IP

Η λίστα επιτρεπόμενων IP μπορεί να σας βοηθήσει να:

• Περιορίσετε την πρόσβαση API σε γνωστή υποδομή (για παράδειγμα, στους διακομιστές ή τα περιβάλλοντα cloud σας)

• Μειώσετε την έκθεση σε περίπτωση διαρροής κλειδιού API

• Προσθέσετε ένα επιπλέον επίπεδο ελέγχου ως προς την προέλευση της κίνησης API

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

Πώς λειτουργεί

Διαμορφώνετε μια λίστα επιτρεπόμενων διευθύνσεων IP ή εύρων CIDR.

• Τα αιτήματα από επιτρεπόμενες IP γίνονται αποδεκτά

• Τα αιτήματα από IP που δεν βρίσκονται στη λίστα επιτρεπόμενων απορρίπτονται

Η λίστα επιτρεπόμενων IP μπορεί να εφαρμοστεί σε:

• Επίπεδο οργανισμού ή

• Επίπεδο έργου

Διαθεσιμότητα

Η λίστα επιτρεπόμενων IP είναι διαθέσιμη σε όλους τους πελάτες API.

Μπορείτε να τη διαμορφώσετε στην πλατφόρμα στην ενότητα:


Ρυθμίσεις → Ασφάλεια → Λίστα επιτρεπόμενων IP

Πώς να διαμορφώσετε τη λίστα επιτρεπόμενων IP

1. Μεταβείτε στις Ρυθμίσεις → Ασφάλεια → Λίστα επιτρεπόμενων IP

2. Προσθέστε μία ή περισσότερες διευθύνσεις IP ή εύρη CIDR

3. Σημείωση: Μπορείτε να προσθέσετε έως 50 διευθύνσεις IP ή εύρη CIDR.

4. (Προαιρετικά) Χρησιμοποιήστε το εργαλείο Check για να επαληθεύσετε αν μια IP περιλαμβάνεται στη λίστα επιτρεπόμενων

5. Ενεργοποιήστε τη λίστα επιτρεπόμενων για:

   • Ένα συγκεκριμένο έργο ή

   • Ολόκληρο τον οργανισμό σας

6. Δοκιμάστε αιτήματα από τα αναμενόμενα περιβάλλοντά σας

Συνιστούμε να ξεκινήσετε με ένα μόνο έργο πριν ενεργοποιήσετε την επιβολή σε επίπεδο οργανισμού.

Αφού γίνουν αλλαγές, οι ενημερώσεις μπορεί να χρειαστούν έως 15 λεπτά για να τεθούν σε ισχύ.


Σημείωση: Πρέπει να έχετε τα κατάλληλα δικαιώματα οργανισμού για να διαμορφώσετε τις ρυθμίσεις λίστας επιτρεπόμενων IP.

Αντιμετώπιση προβλημάτων

Αν αντιμετωπίζετε απροσδόκητες αποτυχίες αιτημάτων:

• Επιβεβαιώστε ότι το αίτημα προέρχεται από επιτρεπόμενη διεύθυνση IP

• Ελέγξτε αν οι IP της υποδομής σας έχουν αλλάξει

• Ελέγξτε τα διαμορφωμένα εύρη IP για ακρίβεια

• Περιμένετε έως 15 λεπτά για τη διάδοση των αλλαγών διαμόρφωσης

• Χρησιμοποιήστε το εργαλείο Check για να επαληθεύσετε αν μια 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 Unauthorized

• Error code: ip_not_authorized