מומלץ להשתמש בחשבון שירות לאימות כשמשלבים עם Google Spectrum Access System (SAS) Portal API.
הגדרה של חשבון שירות
כדי להשתמש בחשבון שירות לצורך אימות, פועלים לפי השלבים הבאים:
- יוצרים חשבון שירות.
יוצרים מפתח לחשבון השירות ובוחרים באפשרות JSON בתור סוג המפתח.
אחרי שמבצעים את השלב הזה, מפתח חשבון השירות מורד למיקום ברירת המחדל בדפדפן.
קבלת טוקן למוכ"ז
צריך לספק את האימות של חשבון השירות כאסימון למוכ"ז. אם אתם קוראים ישירות ל-SAS Portal API, למשל על ידי שליחת בקשת HTTP עם curl, אתם מעבירים את האימות שלכם כאסימון bearer בכותרת Authorization.
כדי לקבל אסימון bearer באמצעות חשבון השירות:
ב-CLI של gcloud, מבצעים אימות לחשבון השירות:
gcloud auth activate-service-account --key-file ${KEY_FILE}מחליפים את
${KEY_FILE}בנתיב של קובץ המפתח של חשבון השירות.משתמשים בחשבון השירות כדי לקבל אסימון הרשאה:
gcloud auth print-access-token
הפקודה מחזירה ערך של אסימון גישה.
כשמשתמשים ב-API, מעבירים את ערך האסימון כאסימון מסוג Bearer בכותרת
Authorization. בדוגמת הקוד הבאה אפשר לראות איך מעבירים את ערך האסימון כאסימון מסוג Bearer:curl -X GET -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${TOKEN}" \ "https://sasportal.googleapis.com/v1alpha1/customers"מחליפים את מה שכתוב בשדות הבאים:
-
${CLIENT_PROJECT}: מזהה Google Cloud הפרויקט שממנו נשלחות הבקשות -
${TOKEN}: טוקן ההרשאה
-
המאמרים הבאים
- סקירה כללית של SAS Portal API זמינה במאמר סקירה כללית של Google SAS Portal API.
- מידע על כל API מופיע בדפים Customers ו-Device Manager API.
- דוגמאות לשימוש ב-API מופיעות במאמר דוגמאות קוד ל-API.
- מאמרי עזרה בנושא API זמינים במאמר ממשקי API והפניות.