Apigee SSO 모듈은 두 가지 유형의 계정을 지원합니다.
apigee-ssoadminapi.sh
유틸리티를 사용하면 Apigee SSO 모듈과 연결된 관리자 및 머신 사용자 계정을 관리할 수 있습니다.
apigee-ssoadminapi.sh
유틸리티를 사용하여 다음을 수행합니다.
- 관리자/머신 사용자 목록 보기
- 관리자/머신 사용자 추가 또는 삭제
- 관리자/컴퓨터 사용자의 비밀번호 변경
관리자 사용자에 대한 정보
Apigee SSO 모듈의 관리자 계정은 모듈의 속성을 관리하는 데 필요합니다.
기본적으로 Apigee SSO 모듈을 설치하면 다음 사용자 인증 정보로 관리자 계정이 생성됩니다.
- username: Apigee SSO 모듈을 구성하는 데 사용된 구성 파일의
SSO_ADMIN_NAME
속성으로 정의됩니다. 기본값은ssoadmin.
입니다. - password: Apigee SSO 모듈을 구성하는 데 사용되는 구성 파일의
SSO_ADMIN_SECRET
속성으로 정의됩니다.
머신 사용자 정보
머신 사용자는 비밀번호를 지정하지 않고도 OAuth2 토큰을 가져올 수 있습니다. 즉, Edge 관리 API를 사용하여 OAuth2 토큰을 가져오고 새로고침하는 프로세스를 완전히 자동화할 수 있습니다.
일반적으로 머신 사용자를 사용하는 목적은 다음과 같습니다.
- Edge와 통신하도록 Apigee Developer Services 포털 (또는 간단히 포털) 구성
- 개발 환경에서 테스트 자동화 또는 CI/CD와 같은 일반적인 개발 작업을 위한 자동화를 지원하는 경우
자세한 내용은 외부 IDP의 작업 자동화를 참조하세요.
apigee-ssoadminapi.sh 설치
Apigee SSO 모듈을 설치한 에지 관리 서버 노드에 apigee-ssoadminapi.sh
유틸리티를 설치합니다. 일반적으로 Apigee SSO 모듈을 설치할 때 apigee-ssoadminapi.sh
유틸리티를 설치합니다.
apigee-ssoadminapi.sh
유틸리티를 아직 설치하지 않은 경우:
- 관리 서버 노드에 로그인합니다. Edge Apigee-setup 유틸리티 설치에 설명된 대로 이 노드에는 이미
apigee-service
가 설치되어 있어야 합니다. - 다음 명령어를 실행하여 Apigee SSO 모듈의 관리자 및 머신 사용자를 관리하는 데 사용되는
apigee-ssoadminapi.sh
유틸리티를 설치합니다./opt/apigee/apigee-service/bin/apigee-service apigee-ssoadminapi install
- 셸에서 로그아웃한 다음 다시 로그인하여 경로에
apigee-ssoadminapi.sh
유틸리티를 추가합니다.
apigee-ssoadminapi.sh에 대한 도움말 정보 보기
유틸리티에서 사용할 수 있는 명령은 다음과 같습니다.
admin add
admin delete
admin list
admin setpassword
saml machineuser add
(LDAP 및 SAML을 포함한 모든 IDP에saml
명령어 사용)saml machineuser delete
aaml machineuser list
saml machineuser setpassword
이러한 명령어에 관한 정보는 /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
값을 생략합니다. Apigee SSO 모듈이 --port
에 기본값 9099를 사용하고 --ssl
에 http를 사용하기 때문입니다. 설치에서 이러한 기본값을 사용하지 않는 경우 이러한 기본값을 지정합니다.
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