이 페이지는 Cloud Translation API를 통해 번역되었습니다.

apigee-ssoadminapi.sh 사용

Apigee SSO 모듈은 두 가지 유형의 계정을 지원합니다.

관리자
머신 사용자 (외부 IDP가 사용 설정된 조직만 해당)

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

참고: 직접 및 간접 바인딩이 있는 LDAP가 포함된 모든 IDP에 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 값을 생략합니다. 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