FastAPI — מנגנוני אבטחה
אמ;לק
מדריך האבטחה הרשמי ל-FastAPI, לרבות OAuth2 ו-JWT.
סיכום בעברית: מערכת VibeSec · מדיניות המקורות
נוסף ל-VibeSec:
>מדריך האבטחה הרשמי ל-FastAPI, לרבות OAuth2 ו-JWT.
התוכן המלא בעברית
תרגום אוטומטי מהמקור; מונחים טכניים נשארו באנגלית. לנוסח המחייב — הכתבה המקורית.
ישנן דרכים רבות לטפל באבטחה, אימות והרשאה.
ובדרך כלל זה נושא מורכב ו"קשה".
במסגרות ומערכות רבות רק טיפול באבטחה ובאימות דורש כמות גדולה של מאמץ וקוד (במקרים רבים זה יכול להיות 50% או יותר מכל הקוד שנכתב).
FastAPI מספק מספר כלים שיעזרו לך להתמודד עם אבטחה בקלות, במהירות ובצורה סטנדרטית, מבלי שתצטרך ללמוד את כל מפרטי האבטחה לעומק.
אבל קודם כל, בואו נבדוק כמה מושגים קטנים.
קצרים בזמן? ¶
אם לא אכפת לך מאף אחד מהתנאים האלה ואתה רק צריך להוסיף אבטחה עם אימות המבוסס על שם משתמש וסיסמה עכשיו, דלג לפרקים הבאים.
OAuth2 ¶
OAuth2 הוא מפרט המגדיר מספר דרכים לטיפול באימות והרשאה.
זה מפרט די נרחב ומכסה כמה מקרי שימוש מורכבים.
הוא כולל דרכים לאימות באמצעות "צד שלישי".
זה מה שכל המערכות המאפשרות "כניסה באמצעות Facebook, Google, X (Twitter), GitHub" משתמשות בו מאחורי הקלעים.
OAuth ¶
היה OAuth 1, שהוא שונה מאוד מ-OAuth2, ומורכב יותר, מכיוון שהוא כלל מפרט ישיר כיצד להצפין את התקשורת.
זה לא מאוד פופולרי או בשימוש בימינו.
OAuth2 אינו מציין כיצד להצפין את התקשורת, הוא מצפה שהאפליקציה שלך תוגש עם HTTPS.
בסעיף העוסק בפריסה (deployment) תראה כיצד להגדיר HTTPS בחינם, באמצעות Traefik ו-Let's Encrypt.
OpenID Connect ¶
OpenID Connect הוא מפרט נוסף, המבוסס על OAuth2 .
הוא בסך הכל מרחיב את OAuth2 ומגדיר כמה היבטים שהם יחסית מעורפלים ב-OAuth2, במטרה לשפר את יכולת הפעולה ההדדית (interoperability).
לדוגמה, התחברות של Google משתמשת ב-OpenID Connect (אשר מתחת משתמש ב-OAuth2).
אבל התחברות ל-Facebook לא תומכת ב-OpenID Connect, אלא משתמשת בגרסה משלה של OAuth2.
OpenID (לא "OpenID Connect") ¶
היה גם מפרט "OpenID". זה ניסה לפתור את אותו הדבר כמו OpenID Connect , אבל לא היה מבוסס על OAuth2.
אז זו הייתה מערכת נוספת שלמה.
זה לא מאוד פופולרי או בשימוש בימינו.
OpenAPI ¶
OpenAPI (שנודע בעבר בשם Swagger) הוא המפרט הפתוח לבניית APIs (כיום חלק מ-Linux Foundation).
זה מה שמאפשר לקיים מספר ממשקי תיעוד אינטראקטיביים אוטומטיים, יצירת קוד וכו'.
OpenAPI יש דרך להגדיר "סכימות" אבטחה מרובות.
על ידי שימוש בהם, אתה יכול לנצל את כל הכלים מבוססי התקן הללו, כולל מערכות התיעוד האינטראקטיביות הללו.
OpenAPI מגדיר את סכימות האבטחה הבאות:
• apiKey : מפתח ספציפי ליישום שיכול להגיע מ: פרמטר שאילתה (query parameter).
• http : מערכות אימות HTTP סטנדרטיות, כולל: bearer : כותרת Authorization עם ערך של Bearer בתוספת אסימון (token). מאפיין זה מבוסס על OAuth2.
• oauth2 : כל דרכי הפעולה של OAuth2 לטיפול באבטחה (הנקראות "flows"). כמה מתוך הזרימות הללו מתאימות לבניית ספק אימות OAuth 2.0 (כמו Google, Facebook, X (Twitter), GitHub וכו'): implicit
• אבל יש "זרימה" אחת ספציפית שניתן להשתמש בה בצורה מושלמת לטיפול באימות באותו יישום ישירות: סיסמה: חלק מהפרקים הבאים יכסו דוגמאות לכך.
• openIdConnect : יש דרך להגדיר כיצד לגלות נתוני אימות OAuth2 באופן אוטומטי. הגילוי האוטומטי הזה הוא מה שמוגדר במפרט OpenID Connect.
שילוב ספקי אימות והרשאה אחרים כמו Google, Facebook, X (Twitter), GitHub וכו' הוא גם אפשרי וקל יחסית.
הבעיה המורכבת ביותר היא בניית ספק אימות והרשאה מהסוג הזה, אך FastAPI מספק לך את הכלים לעשות זאת בקלות, תוך שהוא מבצע את העבודה הקשה עבורך.
כלי עזר ב-FastAPI ¶
FastAPI מספק במודול fastapi.security מספר כלים עבור כל אחת מסכימות האבטחה הללו, שמפשטים את השימוש במנגנוני אבטחה אלו.
בפרקים הבאים תראה כיצד להוסיף אבטחה ל-API שלך באמצעות הכלים שסופקו על ידי FastAPI .
ותראה גם איך זה משתלב אוטומטית במערכת התיעוד האינטראקטיבית.
קריאה וכלים קשורים
אבטחת Python- Bandit — סריקה סטטית לקוד Python לאיתור בעיות אבטחה נפוצות.
- Bearer — SAST עם התמקדות בפרטיות ו-PII
- CodeQL — מנוע ניתוח סטטי של GitHub
- Vibe Coding לכולם: מי בודק את האבטחה של האפליקציות שנוצרות ע"י AI?
- למה חשוב להפריד בין כותב הקוד לכותב הבדיקות ב-AI?
- ניהול מאובטח של סודות וסיסמאות בפייתון