Edge for Private Cloud v4.18.01
ส่วนนี้จะอธิบายวิธีเรียกใช้เครื่องมือและคำสั่งของผู้ดูแลระบบ Edge หลังจากเปิดใช้ SAML งานหลายอย่างใน Edge ต้องใช้ข้อมูลเข้าสู่ระบบของผู้ดูแลระบบ เช่น
- การสร้างองค์กรและสภาพแวดล้อม
- การเพิ่มและนำคอมโพเนนต์ Edge ออก
- คำสั่ง Runngin apigee-adminapi.sh
- งานอื่นๆ อีกมากมาย
อย่างไรก็ตาม หลังจากที่คุณเปิดใช้ SAML ใน Edge แล้ว โดยปกติคุณจะต้องปิดใช้การตรวจสอบสิทธิ์พื้นฐาน เพื่อให้ ต้องตรวจสอบสิทธิ์ผ่าน SAML IDP ดังนั้น คุณต้องตรวจสอบว่าได้เพิ่มบัญชีผู้ดูแลระบบไปยัง SAML IDP แล้ว
การเรียกใช้ API การจัดการ Edge เป็น ผู้ดูแลระบบ
การเรียกใช้ Edge API จำนวนมากกำหนดให้คุณส่งข้อมูลเข้าสู่ระบบของผู้ดูแลระบบ การใช้ SAML กับ Edge Management API มีวิธีการรับและรีเฟรชโทเค็นเมื่อเรียกใช้ Edge Management API
การใช้ apigee-adminapi.sh ยูทิลิตีที่มีการตรวจสอบสิทธิ์ SAML
ใช้ apigee-adminapi.sh เพื่อทำงานการกำหนดค่า Edge แบบเดียวกับที่คุณทำด้วยการเรียก Edge 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
where:
- 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 จะระบุ รหัสผ่าน
- 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
where:
- oauth-flow จะระบุอย่างใดอย่างหนึ่ง passcode หรือ password_grant ทั้งนี้ขึ้นอยู่กับวิธีที่คุณ เดิมได้รับโทเค็น ในตัวอย่างนี้ คุณระบุ รหัสผ่าน เนื่องจากคุณได้รับ โดยใช้ 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
where:
- SSO_LOGIN_URL ระบุ URL ของข้อบังคับ SSO ของ Edge แก้ไขพอร์ตหรือโปรโตคอลหากคุณได้เปลี่ยนพอร์ตหรือโปรโตคอลจาก 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 ระบุ รหัสผ่าน
- 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
where:
- OAUTH_FLOW ระบุรายการใดรายการหนึ่ง passcode หรือ password_grant ทั้งนี้ขึ้นอยู่กับวิธีที่คุณ เดิมได้รับโทเค็น ในตัวอย่างนี้ คุณระบุ รหัสผ่าน เนื่องจากคุณได้รับ โดยใช้ get_token โปรดดู การใช้ SAML กับ Edge management API
- OAUTH_BEARER_TOKEN มีโทเค็น