การใช้ apigee-ssoadminapi.sh

Edge for Private Cloud v4.18.01

โมดูล Edge SSO รองรับบัญชี 2 ประเภทดังนี้

  • ผู้ดูแลระบบ
  • ผู้ใช้เครื่อง

apigee-ssoadminapi.sh ยูทิลิตีช่วยให้คุณจัดการผู้ดูแลระบบและผู้ใช้เครื่องที่เชื่อมโยงกับ Edge SSO

ใช้ยูทิลิตี apigee-ssoadminapi.sh เพื่อดำเนินการต่อไปนี้

  • ดูรายชื่อผู้ใช้ที่ดูแลระบบ/ผู้ใช้เครื่อง
  • เพิ่มหรือลบผู้ใช้ที่ดูแลระบบ/ผู้ใช้เครื่อง
  • เปลี่ยนรหัสผ่านของผู้ดูแลระบบ/ผู้ใช้เครื่อง

เกี่ยวกับผู้ใช้ที่ดูแลระบบ

ต้องมีบัญชีผู้ดูแลระบบในโมดูล Edge SSO เพื่อจัดการพร็อพเพอร์ตี้ของ นอกจากนี้ คุณต้องใช้ข้อมูลเข้าสู่ระบบบัญชีผู้ดูแลระบบเพื่อกำหนดค่า API BaaS หรือพอร์ทัลสำหรับ เชื่อมต่อกับโมดูล

โดยค่าเริ่มต้น เมื่อคุณติดตั้งโมดูล Edge SSO จะเป็นการสร้างบัญชีผู้ดูแลระบบพร้อมด้วย ข้อมูลเข้าสู่ระบบต่อไปนี้

  • username: กำหนดโดยพร็อพเพอร์ตี้ SSO_ADMIN_NAME ในไฟล์การกำหนดค่าที่ใช้กำหนดค่าโมดูล SSO ของ Edge ค่าเริ่มต้นคือ ssoadmin.
  • password: กำหนดโดยพร็อพเพอร์ตี้ SSO_ADMIN_SECRET ใน ไฟล์การกำหนดค่าที่ใช้เพื่อกำหนดค่าโมดูล SSO ของ Edge

เกี่ยวกับผู้ใช้เครื่อง

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

โดยปกติแล้ว คุณจะใช้ผู้ใช้เครื่องสำหรับการดำเนินการต่อไปนี้

  • การกำหนดค่าพอร์ทัลบริการสำหรับนักพัฒนาแอปเพื่อสื่อสารกับ Edge
  • เมื่อสภาพแวดล้อมในการพัฒนาซอฟต์แวร์รองรับระบบอัตโนมัติสำหรับงานการพัฒนาทั่วไป เช่น การทดสอบ การทำงานอัตโนมัติ หรือการรวมอย่างต่อเนื่อง/การติดตั้งใช้งานอย่างต่อเนื่อง (CI/CD)

ดูข้อมูลเพิ่มเติมได้ที่การใช้ SAML กับงานอัตโนมัติ

กำลังติดตั้ง apigee-ssoadminapi.sh

ติดตั้งยูทิลิตี apigee-ssoadminapi.sh ในโหนดเซิร์ฟเวอร์การจัดการ Edge ที่คุณติดตั้งโมดูล SSO ของ Edge โดยปกติแล้วคุณจะติดตั้ง ยูทิลิตี apigee-ssoadminapi.sh เมื่อติดตั้งโมดูล EDGE SSO

หากยังไม่ได้ติดตั้งยูทิลิตี apigee-ssoadminapi.sh ให้ทำดังนี้

  1. เข้าสู่ระบบโหนดเซิร์ฟเวอร์การจัดการ โหนดดังกล่าวควรมี apigee-service ติดตั้งอยู่แล้วตามที่อธิบายไว้ที่หัวข้อติดตั้งยูทิลิตี apigee-setup ของ Edge
  2. ติดตั้งยูทิลิตี apigee-ssoadminapi.sh ที่ใช้เพื่อ จัดการผู้ใช้ของผู้ดูแลระบบและผู้ใช้เครื่องสำหรับ โมดูลสำหรับ EDGE SSO:
    >
    /opt/apigee/apigee-service/bin/apigee-service ติดตั้ง apigee-ssoadminapi
  3. ออกจากระบบ Shell แล้วเข้าสู่ระบบอีกครั้งเพื่อเพิ่มยูทิลิตี apigee-ssoadminapi.sh ให้กับ เส้นทาง

การดูข้อมูลความช่วยเหลือสําหรับ apigee-ssoadminapi.sh

คำสั่งที่ใช้ได้สำหรับยูทิลิตีมีดังนี้

  • เพิ่มผู้ดูแลระบบ
  • ลบผู้ดูแลระบบ
  • รายการผู้ดูแลระบบ
  • admin setpassword
  • saml machineuser add
  • saml machineuser delete
  • รายการ machineuser ของ aaml
  • setpassword ของ SAML

คุณดูข้อมูลเกี่ยวกับคําสั่งเหล่านี้ได้ในไฟล์ /opt/apigee/apigee-ssoadminapi/README.md นอกจากนี้ คุณยังระบุตัวเลือก "-h" ให้กับแต่ละคําสั่งเพื่อดูข้อมูลการใช้งานได้ด้วย เช่น คำสั่งต่อไปนี้

> apigee-ssoadminapi.sh admin list -h

แสดงผลดังนี้

admin list 
  --admin SSOADMIN_CLIENT_NAME      Name of the client having administrative privilege on sso
  --secret SSOADMIN_CLIENT_SECRET   Secret/Password for the client
  --host SSO_HOST                   Hostname of SSO server to connect
  --port SSO_PORT                   Port to use during request
  --ssl SSO_URI_SCHEME              Set to https, defaults to http
  --debug                           Set in debug mode, turns on verbose in curl
  -h                                Displays Help

การเรียกใช้ยูทิลิตี apigee-ssoadminapi.sh

คุณสามารถเรียกใช้ยูทิลิตี apigee-ssoadminapi.sh ได้โดยการส่งผ่าน เป็นอาร์กิวเมนต์บรรทัดคำสั่ง หรือในโหมดอินเทอร์แอกทีฟด้วยการตอบกลับพรอมต์

เช่น ระบุข้อมูลที่จำเป็นทั้งหมดในบรรทัดคำสั่งเพื่อดูรายการผู้ดูแลระบบ ผู้ใช้:

> apigee-ssoadminapi.sh admin list --admin ssoadmin --secret Secret123 --host 35.197.94.184

แสดงผลดังนี้

[
  {
    "client_id": "ssoadmin",
    "access_token_validity": 300
  }
]

หากไม่ระบุข้อมูลที่จำเป็น เช่น รหัสผ่านของผู้ดูแลระบบ ระบบจะแจ้งให้คุณทราบ

ในตัวอย่างนี้ คุณไม่ต้องระบุค่าสำหรับ --port และ --ssl เนื่องจากโมดูล SSO ของ Edge จะใช้ค่าเริ่มต้น 9099 สำหรับ --port และ http สำหรับ --ssl หาก การติดตั้งไม่ได้ใช้ค่าเริ่มต้นเหล่านี้ โปรดระบุ:

> apigee-ssoadminapi.sh admin list --admin ssoadmin --secret Secret123 --host 35.197.94.184 --port 9443 --ssl https

หรือใช้ฟอร์มแบบอินเทอร์แอกทีฟที่ระบบจะแจ้งให้คุณป้อนข้อมูลทั้งหมด ดังนี้

> apigee-ssoadminapi.sh admin list

จากนั้นคุณจะได้รับแจ้งให้กรอกข้อมูลที่จำเป็นทั้งหมด

SSO admin name (current): ssoadmin
SSO Admin secret (current): 
SSO host: 35.197.94.184