אימות ל-Cloud Vision API

שימוש בחשבון שירות

השיטה המועדפת היא לבצע אימות באמצעות חשבון שירות. כדי להשתמש בחשבון שירות לאימות ב-Vision API:

  1. פועלים לפי ההוראות ליצירת חשבון שירות. בוחרים באפשרות JSON בתור סוג המפתח.

אחרי שהתהליך יסתיים, המפתח של חשבון השירות יורד למיקום ברירת המחדל בדפדפן.

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

אסימונים למוכ"ז

אם אתם קוראים ישירות ל-Vision API, למשל על ידי יצירת בקשת HTTP באמצעות cURL, תעבירו את האימות שלכם כטוקן מסוג bearer בכותרת Authorization. כדי לקבל אסימון bearer באמצעות חשבון השירות:

  1. מתקינים את ה-CLI של gcloud.

  2. מאמתים את חשבון השירות. מחליפים את KEY_FILE בנתיב לקובץ המפתח של חשבון השירות:

    gcloud auth activate-service-account --key-file KEY_FILE

  3. מקבלים אסימון הרשאה באמצעות חשבון השירות:

    gcloud auth print-access-token

    הפקודה מחזירה ערך של אסימון גישה.

  4. כשמפעילים את ה-API, צריך לקבל אסימון הרשאה באמצעות חשבון השירות בכותרת Authorization:

    curl -s -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
"https://vision.googleapis.com/v1/images:annotate" -d @request.json

Application Default Credentials

אם אתם משתמשים בספריית לקוח כדי לקרוא ל-Vision API, אתם צריכים להשתמש ב-Application Default Credentials ‏ (ADC). שירותים שמשתמשים ב-ADC מחפשים פרטי כניסה במשתנה הסביבה GOOGLE_APPLICATION_CREDENTIALS. אלא אם אתם רוצים ש-ADC ישתמש בפרטי כניסה אחרים (למשל, פרטי כניסה של משתמש), מומלץ להגדיר את משתנה הסביבה הזה כך שיצביע על קובץ המפתח של חשבון השירות.

export GOOGLE_APPLICATION_CREDENTIALS=PATH_TO_KEY_FILE

מחליפים את PATH_TO_KEY_FILE בנתיב לקובץ ה-JSON של חשבון השירות. ‫GOOGLE_APPLICATION_CREDENTIALS צריך להיות כתוב כמו שהוא (הוא לא placeholder בדוגמה שלמעלה).

שימוש במפתח API

אפשר להשתמש במפתח API של מסוף כדי לבצע אימות ל-Vision API. Google Cloud

כדי לעשות את זה:

  1. פועלים לפי ההוראות ליצירת מפתח API עבור פרויקט Google Cloud בקונסולה.

  2. כששולחים בקשת API ל-Vision API, מעבירים את המפתח כערך של הפרמטר key. לדוגמה:

    POST https://vision.googleapis.com/v1/images:annotate?key=YOUR_API_KEY

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