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