אימות בקשות API

במכשיר Vertex AI on Google Distributed Cloud (GDC) air-gapped, אתם יכולים לגשת לממשקי API באופן פרוגרמטי על ידי אימות הבקשות באמצעות אסימונים. אתם יכולים לקבל אסימון אימות באמצעות חשבון משתמש או חשבון שירות.

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

חשבון משתמש

כדי לקבל אסימון אימות עם הרשאות משתמש:

  1. שימו לב לנקודת הקצה של ה-API שבו אתם רוצים להשתמש.

  2. כדי לקבל גישה לשירות Vertex AI שבו רוצים להשתמש, צריך להקצות לחשבון המשתמש את התפקיד המתאים שמפורט בקטע הכנת הרשאות IAM.

  3. נכנסים לציוד של GDC עם air gap באמצעות חשבון המשתמש שצריך כדי לקיים אינטראקציה עם ה-API:

    gdcloud auth login
    
  4. מקבלים את אסימון האימות:

    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 בערך של אסימון האימות שמוצג בפלט.

חשבון שירות

כדי לקבל אסימון אימות באמצעות חשבון שירות:

  1. שימו לב לנקודת הקצה של ה-API שבו אתם רוצים להשתמש.

  2. מגדירים את חשבון השירות שבו רוצים להשתמש כדי לגשת לשירות Vertex AI.

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

  4. משיגים את זוגות המפתחות של חשבון השירות.

  5. מתקינים את ספריית הלקוח של google-auth:

    pip install google-auth
    
  6. מוסיפים את הקוד הבא לסקריפט 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".
  7. שומרים את הסקריפט של Python.

  8. מריצים את הסקריפט של Python כדי לאחזר את האסימון:

    python SCRIPT_NAME
    

    מחליפים את SCRIPT_NAME בשם שנתתם לסקריפט Python, למשל token.py.

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

-H "Authorization: Bearer TOKEN"

מחליפים את TOKEN בערך של אסימון האימות שמוצג בפלט.