LearnAI

מפתח API (API key)

מפתח API הוא מחרוזת סודית שתוכנה שולחת יחד עם הבקשות שלה לשירות, כדי שהשירות יזהה מי פונה ומה מותר לו לעשות. מי שמחזיק את המפתח יכול להשתמש בו בשם החשבון שאליו הוא שייך. [1]

במילים פשוטות

כשכלי שבניתם פונה למודל AI או לשירות אחר, הוא מזדהה במפתח. Google מזהירה שחשיפה של מפתח API עלולה להוביל לחיובים לא צפויים בחשבון או לגישה לא מורשית לנתונים. [1] לכן Google ממליצה לא לכתוב מפתחות בקוד שרץ אצל המשתמש ולא לשמור אותם במאגר קוד, כי שם אפשר ליירט או לגנוב אותם. את המפתח מוסיף השרת, לא הדפדפן. [1] GitHub סורקת את כל ההיסטוריה של מאגר, בכל הענפים, כדי לאתר מפתחות וסיסמאות שנשארו בקוד. [2]

דוגמה

בניתם דף קטן שמסכם טקסט בעזרת מודל AI, והדבקתם את המפתח ישר בקוד של הדף. הקוד הזה רץ בדפדפן של כל מי שפותח את הדף, ולכן כל אחד מהם יכול למצוא את המפתח ולהשתמש בו על חשבונכם. [1]

מה זה API key, ואיפה שומרים אותו?

API key הוא השם האנגלי של מפתח API. שומרים אותו מחוץ לקוד, ולא בקובץ שעולה למאגר. [1] OWASP מציינת שמשתני סביבה נגישים בדרך כלל לכל התהליכים במחשב ועלולים להופיע ביומנים, ולכן בארגון עדיף לנהל סודות במערכת ייעודית. [3] ההמלצה שלנו: בכלי אישי, משתנה סביבה שלא נשמר במאגר הוא התחלה סבירה. על ההפרדה בין קוד, הגדרות וערכים סודיים יש שיעור טעימה פתוח, Config ומשתני סביבה.

אילו הרשאות לתת למפתח API?

כמה שפחות. Google ממליצה להוסיף למפתח הגבלות שמצמצמות את הדרכים שבהן אפשר להשתמש בו, כדי להקטין את הנזק אם הוא דולף. היא ממליצה גם לתת לכל אדם ולכל אפליקציה מפתח נפרד, למחוק מפתחות שלא בשימוש ולהחליף מפתחות מדי פעם. [1] OWASP ממליצה להחיל את עקרון ההרשאה המינימלית גם על הגישה לסודות עצמם. [3]

איך זה נוגע לבדיקה · הגישה שלנו

לפני שמשתפים כלי שבניתם, מחפשים בקוד ובהיסטוריה שלו כל דבר שנראה כמו מפתח או סיסמה. בעינינו מפתח שהופיע אפילו פעם אחת במקום ציבורי הוא מפתח שדלף: מחליפים אותו ומבטלים את הישן. גם Simon Willison מזהיר במיוחד מסודות כמו מפתח API כשבונים כלים בשיטת וייב קודינג. [4]

להעמיק

מקורות

  1. Google Cloud Documentation, «Best practices for managing API keys». נפתח ב-3.11.2026
  2. GitHub Docs, «Secret scanning». נפתח ב-3.11.2026
  3. OWASP Cheat Sheet Series, «Secrets Management Cheat Sheet». נפתח ב-3.11.2026
  4. Simon Willison, «Not all AI-assisted programming is vibe coding (but vibe coding rocks)», 19.3.2025. נפתח ב-3.11.2026

מונחים קשורים

לפני שממשיכים