שימוש בכלים לניהול אתרים ובממשקי API של Edge לאחר הפעלת SAML

Edge for Private Cloud גרסה 4.17.09

בקטע הזה מוסבר איך להריץ פקודות וכלים של מנהלי מערכת ב-Edge אחרי שמפעילים את SAML. הרבה משימות ב-Edge דורשות פרטי כניסה של אדמין מערכת, למשל:

  • יצירת ארגונים וסביבות
  • הוספה והסרה של רכיבי Edge
  • הרצת פקודות apigee-adminapi.sh
  • משימות רבות אחרות

עם זאת, אחרי שמפעילים את SAML ב-Edge, בדרך כלל משביתים את האימות הבסיסי כדי שהדרך היחידה לאימות תהיה באמצעות ה-IDP של SAML. לכן, חשוב לוודא שהוספתם את חשבון מנהל המערכת ל-SAML IDP.

שליחת קריאות לממשקי API לניהול של Edge כאדמין במערכת

בהרבה קריאות ל-Edge API צריך להעביר את פרטי הכניסה של האדמין במערכת. במאמר שימוש ב-SAML עם Edge management API מוסבר איך לקבל ולרענן טוקנים כשמבצעים קריאות ל-Edge management API.

שימוש בכלי apigee-adminapi.sh עם אימות SAML

משתמשים בכלי apigee-adminapi.sh כדי לבצע את אותן משימות הגדרה של Edge שמבצעים באמצעות קריאות ל-Edge management API. היתרון של הכלי apigee-adminapi.sh הוא שהוא:

  • שימוש בממשק שורת פקודה (CLI) פשוט
  • השלמת פקודות אוטומטיות באמצעות מקש Tab
  • מספק מידע על עזרה ושימוש
  • יכול להציג את הקריאה המתאימה ל-API אם תחליטו לנסות את ה-API

מידע נוסף זמין במאמר שימוש ב-apigee-ssoadminapi.sh.

אחרי שמפעילים אימות SAML, יש כמה דרכים להעביר את פרטי הכניסה של מנהל המערכת לכלי apigee-adminapi.sh.

כדי לראות את כל האפשרויות של כל פקודת apigee-adminapi.sh, כולל האפשרויות לציון פרטי כניסה ל-SAML, משתמשים באפשרות ‎-h בפקודה. לדוגמה:

> apigee-adminapi.sh orgs list -h

לדוגמה, אתם יכולים להעביר את פרטי הכניסה של אדמין המערכת:

> apigee-adminapi.sh orgs list --sso-url http://edge_sso_IP_DNS:9099 --oauth-flow password_grant --admin adminEmail --oauth-password adminPword

כאשר:

  • sso-url מציין את כתובת ה-URL של מודול ה-SSO של Edge. אם שיניתם את היציאה או הפרוטוקול מ-9099 ו-HTTP, צריך לשנות אותם.
  • oauth-flow מציין את הערך passcode או password_grant. בדוגמה הזו, מציינים את password_grant.
  • ‫adminEmail היא כתובת האימייל של מנהל המערכת.
  • oauth-password מציין את הסיסמה של מנהל המערכת.

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

> apigee-adminapi.sh orgs list --sso-url http://edge_sso_IP_DNS:9099 --oauth-flow passcode --admin adminEmail --oauth-passcode passcode

כאשר:

  • oauth-flow מציין passcode.
  • oauth-passcode מציין את קוד הגישה שהתקבל מ-http://edge_sso_IP_DNS:9099/passcode.

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

> apigee-adminapi.sh orgs list --sso-url http://edge_sso_IP_DNS:9099 --oauth-flow passcode --admin adminEmail --oauth-token token

כאשר:

  • ‫oauth-flow מציין את הערך passcode או password_grant, בהתאם לאופן שבו קיבלתם את האסימון במקור. בדוגמה הזו, מציינים את passcode כי במקור קיבלתם את האסימון באמצעות get_token. מידע נוסף זמין במאמר שימוש ב-SAML עם Edge management API.
  • ‫oauh_token מכיל את הטוקן.

שימוש בכלי שירות של Edge עם אימות SAML

הרבה כלי שירות של Edge דורשים פרטי כניסה של אדמין, למשל:

  • apigee-provision משמש ליצירת ארגונים, סביבות ומארחים וירטואליים
  • setup.sh משמש להוספת צמתים למערכת קיימת
  • כל כלי אחר שבו צריך לציין את פרטי הכניסה של מנהל המערכת בקובץ תצורה

כקלט, כלי השירות האלה מקבלים קובץ תצורה שמציין את פרטי הכניסה של מנהל המערכת באמצעות המאפיינים הבאים:

ADMIN_EMAIL="adminEmail"
APIGEE_ADMINPW=adminPWord

אם לא תזינו את הסיסמה, תתבקשו להזין אותה.

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

ADMIN_EMAIL="adminEmail"
SSO_LOGIN_URL=http://edge_sso_IP_DNS:9099
OAUTH_FLOW=password_grant
OAUTH_ADMIN_PASSWORD=adminPWord

כאשר:

  • SSO_LOGIN_URL מציין את כתובת ה-URL של מודול Edge SSO. אם שיניתם את היציאה או הפרוטוקול מ-9099 ו-HTTP, צריך לשנות אותם.
  • ‫OAUTH_FLOW מציין passcode או password_grant. בדוגמה הזו, מציינים את password_grant כי מעבירים את הסיסמה של מנהל המערכת.
  • ‫OAUTH_ADMIN_PASSWORD מציין את הסיסמה של מנהל המערכת.

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

ADMIN_EMAIL="adminEmail"
SSO_LOGIN_URL=http://edge_sso_IP_DNS:9099
OAUTH_FLOW=passcode
OAUTH_ADMIN_PASSCODE=passcode

כאשר:

  • ‫OAUTH_FLOW מציין passcode.
  • OAUTH_ADMIN_PASSCODE מציין את קוד הגישה שהתקבל מ-http://edge_sso_IP_DNS:9099/passcode.

לבסוף, אפשר להשתמש בטוקן

ADMIN_EMAIL="adminEmail"
SSO_LOGIN_URL=http://edge_sso_IP_DNS:9099
OAUTH_FLOW=passcode
OAUTH_BEARER_TOKEN=token

כאשר:

  • ‫OAUTH_FLOW מציין את הערך passcode או password_grant, בהתאם לאופן שבו קיבלתם את האסימון במקור. בדוגמה הזו, מציינים את passcode כי במקור קיבלתם את האסימון באמצעות get_token. מידע נוסף זמין במאמר שימוש ב-SAML עם Edge management API.
  • ‫OAUTH_BEARER_TOKEN מכיל את הטוקן.