ניהול ספקי אימות של זהויות סוכנים

ספקי אימות של Agent Identity מאפשרים לכם לאחסן ולנהל את מפתחות ה-API ואת פרטי הכניסה ל-OAuth שהסוכנים שלכם משתמשים בהם כדי לאמת כלים ושירותים חיצוניים. במנהל האימות של Agent Identity, אתם יכולים לערוך את פרטי הספקים, להפעיל או להשבית ספקים, או למחוק ולשחזר אותם בהתאם לשינויים בדרישות הגישה.

לפני שמתחילים

  1. מוודאים שבחרתם בשיטת האימות הנכונה.
  2. מוודאים שיש לכם את התפקידים הנדרשים כדי להשלים את המשימה.

התפקידים הנדרשים

כדי לקבל את ההרשאות שנדרשות לניהול ספקי אימות של Agent Identity, בקשו מהאדמין להקצות לכם את התפקיד עריכת מחברים ב-IAM (roles/iamconnectors.editor) בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

זהו תפקיד מוגדר מראש שכולל את ההרשאות שנדרשות כדי לנהל את ספקי האימות של Agent Identity. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:

ההרשאות הנדרשות

כדי לנהל את ספקי האימות של Agent Identity, צריך את ההרשאות הבאות:

  • iamconnectors.connectors.update
  • iamconnectors.connectors.delete

יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.

עריכת ספק אימות

כדי לעדכן את התיאור או את פרטי האימות של ספק אימות, משתמשים במסוףGoogle Cloud או ב-Google Cloud CLI.

המסוף

  1. נכנסים לדף Agent Registry במסוף Google Cloud .

    כניסה ל-Agent Registry

  2. לוחצים על שם הנציג שרוצים לנהל את ספק האימות שלו.
  3. לוחצים על זהות.
  4. בקטע Auth Providers, מאתרים את ספק האימות שרוצים לנהל.
  5. לוחצים על תפריט הפעולות של ספק האימות ובוחרים באפשרות עריכה.
  6. מעדכנים את התיאור או את פרטי האימות לפי הצורך.
  7. לוחצים על Save.

Google Cloud CLI

  1. כדי לעדכן ספק אימות, מריצים את הפקודה הבאה:

    gcloud alpha agent-identity connectors update AUTH_PROVIDER_NAME \
        --location="LOCATION" \
        --description="NEW_DESCRIPTION" \
        --three-legged-oauth-client-id="NEW_CLIENT_ID" \
        --three-legged-oauth-client-secret="NEW_CLIENT_SECRET" \
        --three-legged-oauth-authorization-url="NEW_ENDPOINT"

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫AUTH_PROVIDER_NAME: השם של ספק האימות.
    • ‫LOCATION: המיקום של ספק האימות.
    • ‫NEW_DESCRIPTION: תיאור חדש של ספק האימות.
    • ‫NEW_CLIENT_ID: מזהה לקוח חדש מהאפליקציה של הצד השלישי.
    • ‫NEW_CLIENT_SECRET: סוד לקוח חדש מאפליקציית הצד השלישי.
    • ‫NEW_ENDPOINT: כתובת URL חדשה של שרת ההרשאות של הצד השלישי.

הפעלה או השבתה של ספק אימות

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

המסוף

  1. נכנסים לדף Agent Registry במסוף Google Cloud .

    כניסה ל-Agent Registry

  2. לוחצים על שם הנציג שרוצים לנהל את ספק האימות שלו.
  3. לוחצים על זהות.
  4. בקטע Auth Providers, מאתרים את ספק האימות שרוצים לנהל.
  5. בספק האימות, לוחצים על פעולות ובוחרים באפשרות הפעלה או השבתה.
  6. בתיבת הדו-שיח לאישור, לוחצים על הפעלה או השבתה.

Google Cloud CLI

  1. כדי להפעיל ספק אימות, מריצים את הפקודה הבאה:

    gcloud alpha agent-identity connectors update AUTH_PROVIDER_NAME \
        --location="LOCATION" \
        --state=enabled
  2. כדי להשבית ספק אימות, מריצים את הפקודה הבאה:

    gcloud alpha agent-identity connectors update AUTH_PROVIDER_NAME \
        --location="LOCATION" \
        --state=disabled

מחליפים את מה שכתוב בשדות הבאים:

  • ‫AUTH_PROVIDER_NAME: השם של ספק האימות.
  • ‫LOCATION: המיקום של ספק האימות.

מחיקה של ספק אימות

אם אתם לא צריכים יותר ספק אימות מסוים, אתם יכולים למחוק אותו. כשמוחקים ספק אימות, הוא מושבת ונשמר במצב של מחיקה זמנית למשך 30 יום. במהלך התקופה הזו, אתם יכולים לשחזר את ספק האימות אם אתם רוצים. אחרי 30 יום, נדרש יום נוסף כדי למחוק את המדיניות שלו, ואז אפשר ליצור ספק אימות עם אותו שם.

המסוף

  1. נכנסים לדף Agent Registry במסוף Google Cloud .

    כניסה ל-Agent Registry

  2. לוחצים על שם הנציג שרוצים לנהל את ספק האימות שלו.
  3. לוחצים על זהות.
  4. בקטע Auth Providers, מאתרים את ספק האימות שרוצים לנהל.
  5. בספק האימות, לוחצים על Actions ובוחרים באפשרות Delete.
  6. בתיבת הדו-שיח לאישור, לוחצים על מחיקה.

gcloud

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

    gcloud alpha agent-identity connectors delete AUTH_PROVIDER_NAME \
        --location="LOCATION"

מחליפים את מה שכתוב בשדות הבאים:

  • ‫AUTH_PROVIDER_NAME: השם של ספק האימות.
  • ‫LOCATION: המיקום של ספק האימות.

שחזור ספק אימות שנמחק

אם מחקתם בטעות ספק אימות, אתם יכולים לשחזר אותו ממצב המחיקה עם יכולת השחזור תוך 30 יום מהמחיקה. במהלך התקופה הזו, אתם יכולים לשחזר את ספק האימות אם אתם רוצים. אחרי 30 יום, נדרש יום נוסף כדי למחוק את המדיניות שלו, ואז אפשר ליצור ספק אימות עם אותו שם.

המסוף

  1. נכנסים לדף Agent Registry במסוף Google Cloud .

    כניסה ל-Agent Registry

  2. לוחצים על שם הנציג שרוצים לנהל את ספק האימות שלו.
  3. לוחצים על זהות.
  4. בקטע Auth Providers, מאתרים את ספק האימות שרוצים לנהל.
  5. בספק האימות, לוחצים על פעולות ובוחרים באפשרות שחזור.
  6. בתיבת הדו-שיח לאישור, לוחצים על שחזור.

gcloud

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

    gcloud alpha agent-identity connectors undelete AUTH_PROVIDER_NAME \
        --location="LOCATION"

מחליפים את מה שכתוב בשדות הבאים:

  • ‫AUTH_PROVIDER_NAME: השם של ספק האימות.
  • ‫LOCATION: המיקום של ספק האימות.

המאמרים הבאים