סקירה כללית

רשימת כתובות IP מורשות היא תכונת אבטחה אופציונלית שמאפשרת להגביל את הגישה ל-API של OpenAI שלכם לכתובות IP מסוימות.

כשהתכונה מופעלת, רק בקשות שמגיעות מכתובות IP או מטווחי IP שהוגדרו ברשימה מתקבלות. בקשות מכל כתובות ה-IP האחרות נדחות, גם אם הן כוללות מפתח API תקף.

התכונה נועדה לסייע בצמצום הסיכון לשימוש לא מורשה ב-API באמצעות הגבלת הגישה לסביבות רשת מהימנות.


הערה: רשימת כתובות IP מורשות חלה רק על בקשות API. היא לא משפיעה על הגישה אל platform.openai.com או על כניסת משתמשים לחשבון.


למה להשתמש ברשימת כתובות IP מורשות

רשימת כתובות IP מורשות יכולה לעזור לכם:

• להגביל את הגישה ל-API לתשתיות מוכרות (למשל, השרתים או סביבות הענן שלכם)

• לצמצם את החשיפה לסיכון במקרה של דליפת מפתח API

• להוסיף שכבת בקרה על מקורות תעבורת ה-API

השימוש ברשימת כתובות IP מורשות נפוץ בעיקר בסביבות ייצור שבהן תעבורת ה-API מגיעה מטווחי רשת קבועים או מוגדרים היטב.

איך זה עובד

מגדירים רשימה של כתובות IP או טווחי CIDR מורשים.

• בקשות מכתובות IP מורשות מתקבלות

• בקשות מכתובות IP שאינן ברשימת הכתובות המורשות נדחות

אפשר להחיל רשימת כתובות IP מורשות:

• ברמת הארגון, או

• ברמת הפרויקט

זמינות

האפשרות להגדיר רשימת כתובות IP מורשות זמינה לכל לקוחות ה-API.

אפשר להגדיר אותה בפלטפורמה תחת:


הגדרות ← אבטחה ← רשימת כתובות IP מורשות

איך מגדירים רשימת כתובות IP מורשות

1. עברו אל הגדרות ← אבטחה ← רשימת כתובות IP מורשות

2. הוסיפו כתובת IP אחת או יותר, או טווחי CIDR

3. הערה: אפשר להוסיף עד 50 כתובות IP או טווחי CIDR.

4. (אופציונלי) השתמשו בכלי הבדיקה כדי לבדוק אם כתובת IP כלולה ברשימת הכתובות המורשות שלכם

5. הפעילו את רשימת הכתובות המורשות עבור:

   • פרויקט מסוים, או

   • הארגון כולו

6. בדקו בקשות מהסביבות שבהן אתם מתכננים להשתמש

מומלץ להתחיל בפרויקט אחד לפני שמפעילים אכיפה בכל הארגון.

לאחר ביצוע שינויים, ייתכן שיחלפו עד 15 דקות עד שהעדכונים ייכנסו לתוקף.


הערה: כדי להגדיר רשימת כתובות IP מורשות, נדרשות הרשאות מתאימות בארגון.

פתרון בעיות

אם בקשות נכשלות באופן לא צפוי:

• ודאו שהבקשה מגיעה מכתובת IP מורשית

• בדקו אם כתובות ה-IP של התשתית שלכם השתנו

• ודאו שטווחי ה-IP שהגדרתם נכונים

• המתינו עד 15 דקות להחלת שינויי ההגדרות בכל המערכת

• השתמשו בכלי הבדיקה כדי לבדוק אם כתובת 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