การใช้ยูทิลิตีและ Edge ของผู้ดูแลระบบ Edge หลังจากเปิดใช้ SAML

Edge for Private Cloud v4.19.01

ส่วนนี้จะอธิบายวิธีเรียกใช้เครื่องมือและคำสั่งของผู้ดูแลระบบ Edge หลังจากเปิดใช้ SAML งานหลายอย่างใน Edge ต้องใช้ข้อมูลเข้าสู่ระบบของผู้ดูแลระบบ เช่น

• การสร้างองค์กรและสภาพแวดล้อม
• การเพิ่มและการนำคอมโพเนนต์ Edge ออก
• การเรียกใช้คำสั่ง apigee-adminapi.sh

อย่างไรก็ตาม หลังจากเปิดใช้ SAML ใน Edge โดยปกติแล้วคุณจะปิดใช้การตรวจสอบสิทธิ์พื้นฐานเพื่อให้วิธีเดียวในการตรวจสอบสิทธิ์คือผ่าน SAML IDP ดังนั้นคุณต้องตรวจสอบว่าได้เพิ่มบัญชีผู้ดูแลระบบลงใน SAML IDP แล้ว

การเรียกใช้ Management API ของ Edge ในฐานะผู้ดูแลระบบ

การเรียก Edge API หลายรายการกำหนดให้คุณต้องส่งข้อมูลเข้าสู่ระบบของผู้ดูแลระบบ การใช้ SAML กับ Edge Management API มีวิธีการรับและโทเค็นการรีเฟรชเมื่อทำการเรียก API Edge Management

การใช้ยูทิลิตี apigee-adminapi.sh กับการตรวจสอบสิทธิ์ SAML

ใช้ยูทิลิตี apigee-adminapi.sh เพื่อทำงานการกำหนดค่า Edge เดียวกันกับที่คุณทำโดยการเรียกใช้ Edge Management API ข้อดีของยูทิลิตี apigee-adminapi.sh คือ

• ใช้อินเทอร์เฟซบรรทัดคำสั่งที่เรียบง่าย
• ใช้การเติมคำสั่งอัตโนมัติโดยใช้แท็บ
• ให้ความช่วยเหลือและข้อมูลการใช้งาน
• แสดงการเรียก 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 ของโมดูล Edge SSO แก้ไขพอร์ตหรือโปรโตคอลหากคุณเปลี่ยนจาก 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 มีโทเค็น