במכשיר Vertex AI on Google Distributed Cloud (GDC) air-gapped, אתם יכולים לגשת לממשקי API באופן פרוגרמטי על ידי אימות הבקשות באמצעות אסימונים. אתם יכולים לקבל אסימון אימות באמצעות חשבון משתמש או חשבון שירות.
כדי לקבל אסימון אימות, בוחרים באחת מהאפשרויות הבאות:
חשבון משתמש
כדי לקבל אסימון אימות עם הרשאות משתמש:
שימו לב לנקודת הקצה של ה-API שבו אתם רוצים להשתמש.
כדי לקבל גישה לשירות Vertex AI שבו רוצים להשתמש, צריך להקצות לחשבון המשתמש את התפקיד המתאים שמפורט בקטע הכנת הרשאות IAM.
נכנסים לציוד של GDC עם air gap באמצעות חשבון המשתמש שצריך כדי לקיים אינטראקציה עם ה-API:
gdcloud auth loginמקבלים את אסימון האימות:
gdcloud auth print-identity-token --audiences=https://ENDPOINTמחליפים את
ENDPOINTבנקודת הקצה של השירות שמשמשת את הארגון. למידע נוסף על סטטוס השירות ונקודות הקצהבהתאם לשימוש המיועד באסימון האימות, יכול להיות שתצטרכו לכלול את היציאה אחרי נקודת הקצה של השירות בנתיב הקהלים, באופן הבא:
- אם אתם משתמשים בספריית לקוח לבקשה, אתם צריכים לכלול את היציאה
:443אחרי נקודת הקצה של השירות בנתיב הקהלים. לכן, הנתיב--audiencesבפקודה חייב להיותhttps://ENDPOINT:443. - אם אתם משתמשים ב-gRPC, ב-
curlאו בקריאות REST פרוגרמטיות לבקשה, אל תכללו את היציאה. לכן, הנתיב--audiencesבפקודה חייב להיותhttps://ENDPOINT.
- אם אתם משתמשים בספריית לקוח לבקשה, אתם צריכים לכלול את היציאה
הפלט מציג את אסימון האימות. מוסיפים את הטוקן לכותרת של הבקשות ששולחים בשורת הפקודה, כמו בדוגמה הבאה:
-H "Authorization: Bearer TOKEN"
מחליפים את TOKEN בערך של אסימון האימות שמוצג בפלט.
חשבון שירות
כדי לקבל אסימון אימות באמצעות חשבון שירות:
שימו לב לנקודת הקצה של ה-API שבו אתם רוצים להשתמש.
מגדירים את חשבון השירות שבו רוצים להשתמש כדי לגשת לשירות Vertex AI.
כדי לתת לחשבון השירות גישה לשירות שבו רוצים להשתמש, מקצים לו את התפקיד המתאים שמופיע בקטע הכנת הרשאות IAM.
מתקינים את ספריית הלקוח של
google-auth:pip install google-authמוסיפים את הקוד הבא לסקריפט Python:
import os import google.auth from google.auth.transport import requests import requests as reqs os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "PATH_TO_SERVICE_KEY" os.environ["GRPC_DEFAULT_SSL_ROOTS_FILE_PATH"] = "CERT_NAME" # If you use a client library for your request, # you must include port :443 after the service endpoint # in the audience path. audience = "https://ENDPOINT" creds, project_id = google.auth.default() print(project_id) creds = creds.with_gdch_audience(audience) def test_get_token(): sesh = reqs.Session() req = requests.Request(session=sesh) creds.refresh(req) print(creds.token) if __name__=="__main__": test_get_token()מחליפים את מה שכתוב בשדות הבאים:
-
PATH_TO_SERVICE_KEY: הנתיב לקובץ ה-JSON שמכיל את זוגות המפתחות של חשבון השירות. -
CERT_NAME: השם של קובץ האישור של רשות האישורים (CA), למשלorg-1-trust-bundle-ca.cert. הערך הזה נדרש רק אם אתם נמצאים בסביבת פיתוח. אחרת, משמיטים אותו.
ENDPOINT: נקודת הקצה של השירות שמשמשת את הארגון. למידע נוסף על סטטוס השירות ונקודות הקצה בהתאם לשימוש המיועד באסימון האימות, יכול להיות שתצטרכו לכלול את היציאה אחרי נקודת הקצה של השירות בנתיב הקהל, באופן הבא:- אם אתם משתמשים בספריית לקוח לבקשה, אתם צריכים לכלול את היציאה
:443אחרי נקודת הקצה של השירות בנתיב הקהל. לכן, הנתיב שלaudienceבסקריפט חייב להיות"https://ENDPOINT:443". - אם אתם משתמשים ב-gRPC, ב-
curlאו בקריאות REST פרוגרמטיות לבקשה, אל תכללו את היציאה. לכן, הנתיב שלaudienceבסקריפט חייב להיות"https://ENDPOINT".
- אם אתם משתמשים בספריית לקוח לבקשה, אתם צריכים לכלול את היציאה
-
שומרים את הסקריפט של Python.
מריצים את הסקריפט של Python כדי לאחזר את האסימון:
python SCRIPT_NAMEמחליפים את
SCRIPT_NAMEבשם שנתתם לסקריפט Python, למשלtoken.py.
הפלט מציג את אסימון האימות. מוסיפים את הטוקן לכותרת של הבקשות ששולחים בשורת הפקודה, כמו בדוגמה הבאה:
-H "Authorization: Bearer TOKEN"
מחליפים את TOKEN בערך של אסימון האימות שמוצג בפלט.