프라이빗 클라우드용 Edge v4.18.01
Edge SSO 모듈은 두 가지 유형의 계정을 지원합니다.
- administrator
- 시스템 사용자
apigee-ssoadminapi.sh 유틸리티를 사용하면 Edge SSO 모듈과 연결된 관리자 및 머신 사용자를 관리할 수 있습니다.
apigee-ssoadminapi.sh 유틸리티를 사용하여 다음을 수행합니다.
- 관리자/머신 사용자 목록 보기
- 관리자/머신 사용자 추가 또는 삭제
- 관리자/머신 사용자의 비밀번호 변경
관리자 사용자에 대한 정보
모듈의 속성을 관리하려면 Edge SSO 모듈의 관리자 계정이 필요합니다. 또한 API BaaS 또는 포털을 구성하여 모듈에 연결하려면 관리자 계정 사용자 인증 정보가 필요합니다.
기본적으로 Edge SSO 모듈을 설치하면 다음 사용자 인증 정보로 관리자 계정이 생성됩니다.
- username: Edge SSO 모듈을 구성하는 데 사용되는 구성 파일의 SSO_ADMIN_NAME 속성으로 정의됩니다. 기본값은 ssoadmin입니다.
- password: Edge SSO 모듈을 구성하는 데 사용되는 구성 파일의 SSO_ADMIN_SECRET 속성으로 정의됩니다.
머신 사용자 정보
머신 사용자는 비밀번호를 지정하지 않고도 OAuth2 토큰을 가져올 수 있습니다. 즉, Edge Management API를 사용하여 OAuth2 토큰을 가져오고 새로고침하는 프로세스를 완전히 자동화할 수 있습니다.
일반적으로 다음과 같은 경우에 머신 사용자를 사용합니다.
- Edge와 통신하도록 개발자 서비스 포털 구성
- 개발 환경에서 테스트 자동화 또는 지속적 통합/지속적 배포 (CI/CD)와 같은 일반적인 개발 태스크에 대한 자동화를 지원하는 경우
자세한 내용은 자동화된 작업에 SAML 사용을 참조하세요.
apigee-ssoadminapi.sh 설치
Edge SSO 모듈을 설치한 Edge Management Server 노드에 apigee-ssoadminapi.sh 유틸리티를 설치합니다. 일반적으로 Edge SSO 모듈을 설치할 때 apigee-ssoadminapi.sh 유틸리티를 설치합니다.
apigee-ssoadminapi.sh 유틸리티를 아직 설치하지 않은 경우:
- Management Server 노드에 로그인합니다. Edge apigee-setup 유틸리티 설치에 설명된 대로 해당 노드에 이미 apigee-service가 설치되어 있어야 합니다.
- Edge SSO 모듈의 관리자 및 머신 사용자를 관리하는 데 사용되는 apigee-ssoadminapi.sh 유틸리티를 설치합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-ssoadminapi install - 셸에서 로그아웃한 후 다시 로그인하여 apigee-ssoadminapi.sh 유틸리티를 경로에 추가합니다.
apigee-ssoadminapi.sh의 도움말 정보 보기
유틸리티에 사용할 수 있는 명령어는 다음과 같습니다.
- 관리자 추가
- 관리자 삭제
- 관리자 목록
- admin setpassword
- saml machineuser add
- saml machineuser delete
- aaml machineuser list
- saml machineuser setpassword
이러한 명령어에 대한 정보는 /opt/apigee/apigee-ssoadminapi/README.md 파일에서 확인할 수 있습니다. 또한 각 명령어에 '-h' 옵션을 지정하여 사용 정보를 볼 수 있습니다. 예를 들어 다음 명령어를 실행합니다.
> apigee-ssoadminapi.sh admin list -h
returns:
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
}
]관리자 비밀번호와 같은 필수 정보를 생략하면 메시지가 표시됩니다.
이 예시에서는 Edge SSO 모듈이 --port에 기본값 9099를 사용하고 --ssl에 http를 사용하므로 --port 및 --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