Edge for Private Cloud phiên bản 4.18.01
Mô-đun SSO Edge hỗ trợ hai loại tài khoản:
- quản trị viên
- người dùng máy
Tiện ích apigee-ssoadminapi.sh cho phép bạn quản lý quản trị viên và người dùng máy được liên kết với mô-đun SSO Edge.
Sử dụng tiện ích apigee-ssoadminapi.sh để:
- Xem danh sách quản trị viên/người dùng máy
- Thêm hoặc xoá quản trị viên/người dùng máy
- Thay đổi mật khẩu của quản trị viên/người dùng máy
Giới thiệu về người dùng quản trị
Bạn cần có tài khoản quản trị viên trong mô-đun SSO của Edge để quản lý các thuộc tính của . Bạn cũng cần có thông tin đăng nhập của tài khoản quản trị viên để định cấu hình API BaaS hoặc cổng thông tin để kết nối với mô-đun.
Theo mặc định, khi bạn cài đặt mô-đun SSO của Edge sẽ tạo tài khoản quản trị viên bằng các thông tin xác thực sau:
- username: được xác định bởi thuộc tính SSO_ADMIN_NAME trong thuộc tính tệp cấu hình được dùng để định cấu hình mô-đun SSO của cạnh. Giá trị mặc định là ssoadmin.
- mật khẩu: do thuộc tính SSO_ADMIN_SECRET xác định trong tệp cấu hình được dùng để định cấu hình mô-đun SSO của cạnh.
Giới thiệu về người dùng máy
Người dùng máy có thể lấy mã thông báo OAuth2 mà không cần chỉ định mã xác thực. Điều đó có nghĩa là bạn có thể tự động hoá hoàn toàn quy trình lấy và làm mới mã thông báo OAuth2 bằng cách sử dụng Edge API Quản lý của chúng tôi.
Bạn thường sử dụng người dùng máy cho:
- Định cấu hình cổng Dịch vụ dành cho nhà phát triển để giao tiếp với Edge
- Khi môi trường phát triển hỗ trợ tính năng tự động hoá cho các tác vụ phát triển phổ biến, chẳng hạn như kiểm thử tự động hoá hoặc Tích hợp liên tục/Triển khai liên tục (CI/CD).
Để biết thêm thông tin, hãy xem phần Sử dụng SAML bằng chế độ tự động nhiệm vụ.
Cài đặt apigee-ssoadminapi.sh
Cài đặt tiện ích apigee-ssoadminapi.sh trên Edge Nút Máy chủ quản lý nơi bạn đã cài đặt mô-đun SSO của cạnh. Thông thường, bạn cài đặt Tiện ích apigee-ssoadminapi.sh khi bạn cài đặt mô-đun SSO của cạnh.
Nếu bạn chưa cài đặt tiện ích apigee-ssoadminapi.sh:
- Đăng nhập vào nút Máy chủ quản lý. Nút đó phải đã được cài đặt apigee-service như được mô tả tại Cài đặt trình thiết lập apigee của Edge tiện ích.
- Cài đặt tiện ích apigee-ssoadminapi.sh dùng để
quản lý người dùng quản trị và người dùng máy cho mô-đun SSO của Edge:
> /opt/apigee/apigee-service/bin/apigee-service cài đặt apigee-ssoadminapi - Đăng xuất khỏi shell rồi đăng nhập lại để thêm tiện ích apigee-ssoadminapi.sh vào đường dẫn.
Xem thông tin trợ giúp cho apigee-ssoadminapi.sh
Sau đây là các lệnh có thể dùng cho phần mềm tiện ích này:
- quản trị viên thêm
- quản trị viên xóa
- danh sách quản trị viên
- admin setpassword
- thêm người dùng máy saml
- xoá saml machineuser
- danh sách người dùng máy aaml
- bộ mật khẩu của người dùng máy saml
Bạn có thể xem thông tin về những lệnh này trong /opt/apigee/apigee-ssoadminapi/README.md tệp. Ngoài ra, bạn có thể chỉ định tuỳ chọn "-h" cho từng lệnh để xem thông tin sử dụng. Ví dụ: lệnh sau:
> apigee-ssoadminapi.sh admin list -h
trả về:
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
Gọi tiện ích apigee-ssoadminapi.sh
Bạn có thể gọi tiện ích apigee-ssoadminapi.sh bằng cách truyền tất cả thuộc tính dưới dạng đối số dòng lệnh hoặc ở chế độ tương tác bằng cách phản hồi lời nhắc.
Ví dụ: để chỉ định tất cả thông tin bắt buộc trên dòng lệnh nhằm xem danh sách người dùng quản trị:
> apigee-ssoadminapi.sh admin list --admin ssoadmin --secret Secret123 --host 35.197.94.184
trả về:
[ { "client_id": "ssoadmin", "access_token_validity": 300 } ]
Nếu bỏ qua bất kỳ thông tin bắt buộc nào, chẳng hạn như mật khẩu quản trị viên, thì bạn sẽ được nhắc.
Trong ví dụ này, bạn bỏ qua các giá trị cho --port và --ssl vì mô-đun SSO của Edge sử dụng giá trị mặc định 9099 cho --port và http cho --ssl. Nếu quá trình cài đặt của bạn không sử dụng các giá trị mặc định này, hãy chỉ định các giá trị đó:
> apigee-ssoadminapi.sh admin list --admin ssoadmin --secret Secret123 --host 35.197.94.184 --port 9443 --ssl https
Ngoài ra, bạn có thể sử dụng biểu mẫu tương tác để được nhắc cung cấp tất cả thông tin:
> apigee-ssoadminapi.sh admin list
Sau đó, bạn sẽ được nhắc cung cấp tất cả thông tin bắt buộc:
SSO admin name (current): ssoadmin SSO Admin secret (current): SSO host: 35.197.94.184