שימוש במפתחות API עם Air Quality API

מוצרי הפלטפורמה של מפות Google מאובטחים מפני שימוש לא מורשה על ידי הגבלת קריאות ה-API למשתמשים שמספקים פרטי כניסה מתאימים לאימות. פרטי הכניסה האלה הם מפתח API - מחרוזת אלפאנומרית ייחודית שמשייכת את החשבון לחיוב שלך ב-Google לחשבון ולפרויקט ה-API או ה-SDK הספציפיים.

במדריך הזה מוסבר איך ליצור מפתח API, להגביל אותו ולהשתמש בו בפלטפורמה של מפות Google.

לפני שמתחילים: לפני שמתחילים להשתמש ב-Air Quality API, צריך פרויקט עם חשבון לחיוב וגם ממשק API של איכות האוויר מופעל. מומלץ ליצור כמה בעלים של פרויקט ואדמינים לענייני חיוב, כדי תמיד יהיה מישהו עם התפקידים האלה שזמין לצוות שלך. מידע נוסף זמין במאמר הבא: ההגדרה מתבצעת במסוף Cloud.

יצירת מפתחות API

מפתח ה-API הוא מזהה ייחודי שמאמת בקשות שמשויכות לפרויקט שלכם, למטרות שימוש וחיוב. צריך להיות לכם לפחות מפתח API אחד שמשויך לפרויקט.

כך יוצרים מפתח API:

המסוף

1. עוברים אל הפלטפורמה של מפות Google > הדף 'פרטי כניסה'.

   כניסה לדף Credentials

2. בדף Credentials, לוחצים על Create credentials > מפתח API.
   תיבת הדו-שיח מפתח API שנוצר מציגה את מפתח ה-API החדש שיצרתם.
3. לוחצים על סגירה.
   מפתח ה-API החדש מופיע בדף Credentials בקטע API Keys.
   (חשוב לזכור להגביל את ה-API לפני שמשתמשים בו בסביבת הייצור.)

Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

מידע נוסף על Google Cloud SDK , התקנת Cloud SDK ואת הפקודות הבאות:

• gcloud alpha services api-keys create

הגבלת מפתחות API

Google ממליצה מאוד להגביל את מפתחות ה-API ולהגביל את השימוש בהם רק למפתחות ה-API ממשקי API הנדרשים לאפליקציה שלכם. הגבלת מפתחות API מוסיפה אבטחה לאפליקציה על ידי להגן עליו מפני בקשות לא מוצדקות. מידע נוסף זמין במאמר הבא: שיטות מומלצות לשמירה על אבטחה ב-API.

כשמגבילים מפתח API במסוף Cloud, הגבלות על אפליקציות מבטלות כל ממשקי API שמופעלים בכפוף להגבלות על ממשקי API. כדי לפעול לפי השיטות המומלצות, צריך ליצור מפתח API נפרד לכל אפליקציה ולכל פלטפורמה שבה האפליקציה זמינה.

כדי להגביל מפתח API:

המסוף

1. עוברים אל הפלטפורמה של מפות Google > הדף 'פרטי כניסה'.

   כניסה לדף Credentials

2. בוחרים את מפתח ה-API שבו רוצים להגדיר הגבלה. יופיע דף המאפיין של מפתח API.
3. בקטע Key restrictions, מגדירים את ההגבלות הבאות:
• הגבלות על אפליקציות:
1. כדי לקבל בקשות מרשימת כתובות ה-IP של שרתי האינטרנט שאתם מספקים, בוחרים באפשרות כתובות IP (שרתי אינטרנט, משימות cron וכו') מהרשימה של הגבלות על אפליקציות. מציינים כתובת IPv4 או IPv6 אחת או יותר, או תת-רשת עם סימון CIDR. כתובות ה-IP חייבות להתאים לכתובת המקור תצפית על השרתים של הפלטפורמה של מפות Google. אם משתמשים רשת תרגום כתובת (NAT), בדרך כלל כתובת ה-IP הזו תואמת לכתובת ה-IP הציבורית של המחשב שלך.
• הגבלות על ממשקי API:
1. לוחצים על Restrict key.
2. בוחרים באפשרות Air Quality API בתפריט הנפתח Select APIs. אם Air Quality API לא מופיע ברשימה, אתם צריכים: להפעיל אותו.
4. כדי להשלים את השינויים, לוחצים על שמירה.
   

Cloud SDK

הצגת רשימה של המפתחות הקיימים.

gcloud services api-keys list --project="PROJECT"

הסרת ההגבלות הקיימות במפתח הקיים.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

הגדרת הגבלות חדשות למפתח קיים.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="airquality.googleapis.com"
    --allowed-ips="IP_ADDRESS"

מידע נוסף על Google Cloud SDK , התקנת Cloud SDK ואת הפקודות הבאות:

• gcloud alpha services api-keys update
• gcloud alpha services api-keys lookup
• gcloud services api-keys list

הוספה של מפתח ה-API לבקשה

חובה לכלול מפתח API בכל בקשה של Air Quality API. בדוגמה הבאה, מחליפים את YOUR_API_KEY במפתח ה-API שלכם.

https://airquality.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY

נדרש HTTPS בבקשות שמשתמשות במפתח API.

הערה: כשמשתמשים בשירותי אינטרנט, כל התווים המיוחדים בפרמטרים חייבים להיות מקודדים בכתובות URL. כתובות ה-URL צריכות להיות מקודדות באופן תקין כדי שיהיו חוקיות ומוגבלות ל-2,048 תווים בכל שירותי האינטרנט. חשוב לשים לב למגבלה הזו כשיוצרים את כתובות ה-URL. דפדפנים, שרתי proxy שונים עשויות להיות גם מגבלות תווים שונות בכתובות URL.