אישור

ממשק ה-API של הבדיקות משתמש ב-OAuth 2.0 כדי לאשר בקשות.

היקף ההרשאות של OAuth הוא https://www.googleapis.com/auth/checks.

מתן הרשאה באמצעות OAuth 2.0

במדריך למתחילים הזה מוסבר איך לאשר בקשות באמצעות חשבון שירות באמצעות ה-CLI של gcloud.

הגדרת ה-CLI של gcloud

1. להתקין את ה-CLI של gcloud.

2. מתחברים באמצעות ה-CLI של gcloud ומגדירים פרויקט ברירת מחדל:

   gcloud auth login
   gcloud config set project PROJECT_ID

3. יוצרים חשבון שירות ומפתח של חשבון שירות, ומגדירים פרטי כניסה שמוגדרים כברירת מחדל לאפליקציה:

   gcloud iam service-accounts create SA_NAME
   gcloud iam service-accounts keys create key.json \
       --iam-account=SA_NAME@PROJECT_ID.iam.gserviceaccount.com
   export GOOGLE_APPLICATION_CREDENTIALS=key.json

הענקת גישת API לחשבון Checks

למשתמשים ששולחים קריאות ל-API צריך להיות חשבון ב-Checks והרשאות קריאה או כתיבה מתאימות.

1. עוברים לדף הגדרות במסוף הבדיקות ולוחצים על ניהול משתמשים.

2. מזמינים את חשבון השירות שיצרתם קודם:

   SA_NAME@PROJECT_ID.iam.gserviceaccount.com
   

איתור מספר החשבון

מזהה החשבון שלכם ב-Checks הוא מזהה המשאב לבקשות של משאב החשבון.

לדוגמה, השיטה accounts.apps.list שמציגה רשימה של האפליקציות שלכם היא בפורמט הבא:

https://checks.googleapis.com/v1alpha/accounts/ACCOUNT_ID/apps

אפשר למצוא את מספר החשבון בדף הגדרות בקטע פרטי חשבון במסוף הבדיקות.

קבלת טוקן גישה

gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/checks

שליחת בקשה

curl -X GET \
    -H "X-Goog-User-Project: PROJECT_ID" \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/checks)" \
    "https://checks.googleapis.com/v1alpha/accounts/ACCOUNT_ID/apps"