참고자료

이 페이지는 Apigee 및 Apigee Hybrid에 적용됩니다.

Apigee Edge 문서 보기

apigee-remote-service-cli 명령줄 인터페이스(CLI)는 Envoy용 Apigee 어댑터를 프로비저닝하고 관리하는 데 도움이 됩니다.

‑‑config 옵션으로 CLI 명령어 간소화

‑‑config 옵션은 provision 명령어로 생성된 config.yaml 파일의 위치를 지정합니다. 이 옵션은 CLI가 config.yaml 파일에서 직접 가져오기 때문에 대부분의 다른 명령어 매개변수를 생략할 수 있다는 점에서 유용합니다.

모든 지정된 명령줄 매개변수에 따라 config.yaml 파일의 값이 재정의됩니다.

다음과 같은 옵션을 지정할 수 있습니다.
  • 조직
  • 환경
  • 런타임
  • management
  • 안전하지 않음
  • 네임스페이스
  • legacy
  • opdk

이 옵션은 어댑터를 업그레이드할 때 사용할 수 있습니다. 하지만 이 경우에도 --force-proxy-install 플래그를 포함해야 합니다. 예를 들어 다음과 같이 provision 명령어를 실행할 수 있습니다. 

apigee-remote-service-cli provision --config='old-config.yaml' > new-config.yaml

이전 구성 파일의 값을 변경하지 않으면 새 값이 원본과 동일하므로 새로 저장할 필요가 없습니다.

binding 명령어 나열

원격 서비스에 binding되는 모든 API 제품을 나열합니다.

사용

apigee-remote-service-cli bindings list [flags]

매개변수

매개변수 Presence 제품과 함께 사용 설명
-c,
‑‑config 		선택사항 전체 (문자열) Apigee 원격 서비스 구성 파일의 경로입니다.
팁: 이 플래그를 사용하면 CLI가 구성 파일에서 명령어 매개변수를 직접 가져올 수 있으므로 대부분의 다른 명령어 매개변수를 생략할 수 있습니다. ‑‑config 옵션 사용을 참조하세요.
-e,
‑‑environment 		--config가 있으면 선택사항이고, 그렇지 않으면 필수입니다. 전체 (문자열) 조직의 환경입니다.
-h,
‑‑help 		선택사항 전체 명령어 매개변수에 관한 도움말을 표시합니다.
‑‑insecure 선택사항 전체 SSL 사용 시 안전하지 않은 서버 연결을 허용합니다.
‑‑legacy 해당 사항 없음 Edge Public Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.
-m,
‑‑management 		해당 사항 없음 Edge Private Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.
‑‑mfa 해당 사항 없음 Edge Public Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.
‑‑opdk 해당 사항 없음 Edge Private Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.
-o,
‑‑organization 		--config가 있으면 선택사항이고, 그렇지 않으면 필수입니다. 전체 (문자열) Apigee 조직입니다. 사용하려면 조직 관리자여야 합니다.
-p,
‑‑password 		해당 사항 없음
(기본 인증만 해당)		 Edge Public 및 Private Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.
-r,
‑‑runtime 		--config가 있으면 선택사항이고, 그렇지 않으면 필수입니다. Apigee Hybrid에만 해당 (문자열) 프라이빗 클라우드 또는 Apigee Hybrid 인스턴스의 런타임 URL을 지정합니다. URL은 https://로 시작해야 합니다. 예를 들면 https://apitest.example.net입니다.
‑‑tls‑cert
‑‑tls‑key
‑‑tls‑ca 		해당 사항 없음 Edge Private Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.
-t,
‑‑token 		필수
(OAuth 토큰 인증에만 해당)		 전체 (문자열) Apigee 계정 정보에서 생성되는 OAuth 또는 SAML 토큰입니다. 제공되는 다른 사용자 인증 정보를 재정의합니다.
-u,
‑‑username 		해당 사항 없음
(기본 인증만 해당)		 Edge Public 및 Private Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.
-v,
‑‑verbose 		선택사항 전체 (선택사항) 상세 출력을 생성합니다.

예

apigee-remote-service-cli bindings list -o myorg -e test --token $TOKEN \
-c config.yaml

출력 예 

API Products
============
Bound
-----
envoy-test:
  Quota: 5 requests every 1 minute
  Target bindings:
    httpbin.org
  Paths:
httpbin:
  Quota: 5 requests every 1 minute
  Target bindings:
    httpbin.org
  Paths:
    /httpbin
    /

Unbound
-------
product-1:
  Quota: 100 requests every 1 hour
product-2:
  Quota: 1000 requests every 1 month
product-3:
product-4:

도움말 명령어

모든 apigee-remote-service-cli 명령어에 온라인 도움말이 제공됩니다. 다음을 입력하세요.

apigee-remote-service-cli help

모든 명령어에 대한 도움말을 보려면 다음을 입력합니다.

apigee-remote-service-cli [command] help

예를 들면 다음과 같습니다.

apigee-remote-service-cli provision help

프로비저닝 명령어

apigee-remote-service-cli provision 명령어는 Apigee Edge 조직에 API 프록시 두 개를 설치하고 인증서를 설정하며 Envoy용 Apigee 어댑터를 구성하는 데 필요한 사용자 인증 정보를 생성합니다.

사용

apigee-remote-service-cli provision [flags]

매개변수

매개변수 Presence 제품과 함께 사용 설명
‑‑analytics-sa 선택사항 Apigee Hybrid 및 Apigee만 해당

(문자열) 서비스 계정에 Apigee Analytics Agent 역할이 있는 Google Cloud 서비스 계정 키 파일의 경로를 지정하려면 이 플래그를 사용합니다. 이 SA는 어댑터가 Apigee에 분석 데이터를 직접 업로드하기 위해 사용됩니다. 이 옵션을 사용하면 호스트에 애플리케이션 기본 사용자 인증 정보를 지정하지 않아도 어댑터가 분석을 업로드할 수 있습니다. 이 옵션을 지정하지 않으면 어댑터에 기본 서비스 계정 사용자 인증 정보가 사용됩니다.
-c,
‑‑config 		선택사항 전체 (문자열) Apigee 원격 서비스 구성 파일의 경로입니다.
팁: 이 플래그를 사용하면 CLI가 구성 파일에서 명령어 매개변수를 직접 가져올 수 있으므로 대부분의 다른 명령어 매개변수를 생략할 수 있습니다. --config 옵션 사용을 참조하세요.
-e,
‑‑environment 		--config가 있으면 선택사항이고, 그렇지 않으면 필수입니다. 전체 (문자열) 조직의 환경입니다.
-f, ‑‑force-proxy-install 선택사항 전체 (선택사항) 조직에 remote-service 프록시가 이미 설치된 경우 강제로 이를 다시 설치합니다.
-h,
‑‑help 		선택사항 전체 명령어 매개변수에 관한 도움말을 표시합니다.
‑‑insecure 선택사항 전체 SSL 사용 시 안전하지 않은 서버 연결을 허용합니다.
‑‑legacy 해당 사항 없음 Edge Public Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.
-m,
‑‑management 		해당 사항 없음 Edge Private Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.
‑‑mfa 해당 사항 없음 Edge Public Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.
-n, ‑‑namespace --config가 있으면 기본적으로 apigee로 지정됩니다. Kubernetes 배포만 해당 지정된 네임스페이스에서 Envoy ConfigMap으로 구성을 내보냅니다. 기본값: apigee
‑‑opdk 해당 사항 없음 Edge Private Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.
-o,
‑‑organization 		--config가 있으면 선택사항이고, 그렇지 않으면 필수입니다. 전체 (문자열) Apigee 조직입니다. 프로비저닝하려면 조직 관리자여야 합니다.
-p,
‑‑password 		해당 사항 없음
(기본 인증만 해당)		 Edge Public 및 Private Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.
‑‑rotate 선택사항 Apigee Hybrid에만 해당 (정수) n > 0이면 새 비공개 키를 생성하고 공개 키 n개를 보관합니다(Hybrid에만 해당).
-r,
‑‑runtime 		--config가 있으면 선택사항이고, 그렇지 않으면 필수입니다. Apigee Hybrid에만 해당 (문자열) Apigee Hybrid 인스턴스의 런타임 URL을 지정합니다. URL은 https://로 시작해야 합니다. 예를 들면 https://apitest.example.net입니다.
‑‑tls‑cert
‑‑tls‑key
‑‑tls‑ca 		해당 사항 없음 Edge Private Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.
-t,
‑‑token 		필수
(OAuth 토큰 인증에만 해당)		 전체 (문자열) Apigee 계정 정보에서 생성되는 OAuth 또는 SAML 토큰입니다. 제공되는 다른 사용자 인증 정보를 재정의합니다.
-u,
‑‑username 		해당 사항 없음
(기본 인증만 해당)		 Edge Public 및 Private Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.
-v,
‑‑verbose 		선택사항 전체 (선택사항) 상세 출력을 생성합니다.
‑‑virtual-hosts 해당 없음 Edge Private Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.

예

다음 예시에서와 같이 다른 Envoy용 Apigee 어댑터 작업의 입력으로 사용되는 provision 명령어의 출력을 파일에 캡처하는 것이 중요합니다.

예:

apigee-remote-service-cli provision --legacy --mfa $MFA --username $USER --password $PASSWORD \
--organization $ORG --environment $ENV > config.yaml

샘플 명령어

샘플 구성 파일을 만들고 나열합니다.

샘플 구성 파일 만들기

기본 Envoy 및 Istio 배포에 사용되는 샘플 구성 파일을 만듭니다.

사용

apigee-remote-service-cli samples create [flags]

설명

이 명령어에는 유효한 config.yaml 파일이 입력으로 필요합니다. 이 입력 파일은 프로비저닝을 통해 생성된 파일입니다. 기본적으로 샘플 파일은 ./samples라는 디렉터리에 출력됩니다. 이 디렉터리는 이 명령어로 자동으로 생성됩니다.

기본 Envoy를 사용하는 경우 명령어에 대상 서비스 호스트 및 원하는 클러스터 이름이 사용됩니다. 또한 tls.key 및 tls.crt가 포함된 폴더가 --tls를 통해 제공되는 경우 Envoy 프록시에서 원격 서비스 클러스터로의 커스텀 SSL 연결이 설정됩니다.

Envoy 프록시가 사이드카로 작동하는 Istio를 사용하는 경우, 대상을 지정하지 않으면 httpbin 예시가 생성됩니다. 그렇지 않으면 대상 서비스 배포와 관련된 구성 파일을 준비해야 합니다.

매개변수

매개변수 Presence 제품과 함께 사용 설명
‑‑adapter‑host Envoy 템플릿에만 사용 전체 (문자열) 어댑터 호스트 이름(기본값: localhost)
-c, ‑‑config 필수 전체 (문자열) Apigee 원격 서비스 구성 파일의 경로입니다.
팁: 이 플래그를 사용하면 CLI가 구성 파일에서 명령어 매개변수를 직접 가져올 수 있으므로 대부분의 다른 명령어 매개변수를 생략할 수 있습니다. --config 옵션 사용을 참조하세요.
-f, ‑‑force 선택사항 전체 기존 디렉터리를 강제로 덮어씁니다.
-h, ‑‑help 선택사항 전체 명령어 매개변수에 관한 도움말을 표시합니다.
‑‑host Envoy 템플릿에만 사용 전체 (문자열) 대상 서비스 호스트(기본값: httpbin.org)
-n, ‑‑name 선택사항 전체 (문자열) 대상 서비스 이름(기본값: httpbin.org)
‑‑out 선택사항 전체 (문자열) 샘플 구성 파일을 만들 디렉터리입니다.
기본값: ./samples
‑‑tag Istio 템플릿에만 사용 전체 (문자열) Envoy 어댑터 이미지의 버전 태그입니다. 기본값: 현재 출시 버전
-t, ‑‑template 선택사항 전체 (문자열) Envoy 또는 Istio 템플릿 이름입니다. 사용 가능한 템플릿 목록을 보려면 apigee-remote-service samples templates 명령어를 실행합니다. 기본값: istio-1.9 기본값은 1.9 이상의 모든 Istio 버전에서 작동합니다.
‑‑tls 선택사항, Envoy 템플릿에만 해당 전체 (문자열) 어댑터 서비스에 사용되는 tls.key 및 tls.crt 파일이 포함된 디렉터리입니다.

예 

apigee-remote-service-cli samples create -c ./config.yaml

사용 가능한 템플릿 옵션 나열

samples 명령어의 --templates 매개변수와 함께 사용할 수 있는 템플릿을 나열합니다.

사용

apigee-remote-service-cli samples templates

매개변수

없음.

예 

apigee-remote-service-cli samples templates
 
Supported templates (native is deprecated):
  envoy-1.15
  envoy-1.16
  envoy-1.17
  istio-1.7
  istio-1.8
  istio-1.9

토큰 명령어

API 키를 사용하는 대신 JWT 토큰을 사용하여 인증된 API 프록시 호출을 수행할 수 있습니다. 토큰 명령어를 사용하면 이 목적으로 JWT 토큰을 생성, 검사, 순환할 수 있습니다.

JWT 토큰 만들기

JWT 토큰을 사용하여 원격 서비스 대상에 인증된 API 프록시 호출을 수행할 수 있습니다. JWT 기반 인증 사용도 참조하세요.

사용

apigee-remote-service-cli token create [flags]

매개변수

매개변수 Presence 제품과 함께 사용 설명
-c,
‑‑config 		필수 전체 (문자열) Apigee 원격 서비스 구성 파일의 경로입니다.
팁: 이 플래그를 사용하면 CLI가 구성 파일에서 명령어 매개변수를 직접 가져올 수 있으므로 대부분의 다른 명령어 매개변수를 생략할 수 있습니다. --config 옵션 사용을 참조하세요.
-e,
‑‑environment 		--config가 있으면 선택사항이고, 그렇지 않으면 필수입니다. 전체 (문자열) 조직의 환경입니다.
-h,
‑‑help 		선택사항 전체 명령어 매개변수에 관한 도움말을 표시합니다.
--i, --id 필수 전체 (문자열) API 키를 가져오는 방법의 설명대로 Apigee 개발자 앱에서 찾은 키 사용자 인증 정보입니다.
‑‑insecure 선택사항 전체 SSL 사용 시 안전하지 않은 서버 연결을 허용합니다.
‑‑legacy 해당 사항 없음 Edge Public Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.
‑‑opdk 해당 사항 없음 Edge Private Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.
-o,
‑‑organization 		--config가 있으면 선택사항이고, 그렇지 않으면 필수입니다. 전체 (문자열) Apigee 조직입니다. 사용하려면 조직 관리자여야 합니다.
-r,
‑‑runtime 		--config가 있으면 선택사항이고, 그렇지 않으면 필수입니다. Apigee Hybrid에만 해당 (문자열) 프라이빗 클라우드 또는 Apigee Hybrid 인스턴스의 런타임 URL을 지정합니다. URL은 https://로 시작해야 합니다. 예를 들면 https://apitest.example.net입니다.
--s, ‑‑secret 필수 전체 (문자열) API 키를 가져오는 방법의 설명대로 Apigee 개발자 앱에서 찾은 보안 비밀 사용자 인증 정보입니다.
‑‑tls‑cert
‑‑tls‑key
‑‑tls‑ca 		해당 사항 없음 Edge Private Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.
-v,
‑‑verbose 		선택사항 전체 (선택사항) 상세 출력을 생성합니다.

예

apigee-remote-service-cli token create -o myorg -e test -i YUmlZAcBKNsTAelJqPZFl3sh58ObATX9 \
-s icTARgaKHqvUH1dq -c config.yaml

출력

성공하면 다음과 비슷한 JST 토큰 출력이 표시됩니다.
eyJraWQiOiIxIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJhY2Nlc3NfdG9rZW4iOiJ0a2tlVzVKQTY2a0pZYTB4bFV1cVBsUW1BMU43IiwiYXVkIjoiaXN0aW8iLCJuYmYiOjE1MzAxMzg1OTEsImFwaV9wcm9kdWN0X2xpc3QiOlsiaXN0aW8tcHJvZHVjdCJdLCJhcHBsaWNhdGlvbl9uYW1lIjoiaXN0aW8tYXBwIiwiZGV2ZWxvcGVyX2VtYWlsIjoicFluZ2Zsb3lkQGdvb2dsZS5jb20iLCJpc3MiOiJodHRwczovL2FwaWdlZXNlYXJjaC10ZXN0LmFwaWdlZS5uZXQvaXN0aW8tYXV0aC90b2tlbiIsImV4cCI6MTUzMDEzOTQ5MSwiaWF0IjoxNTMwMTM4NTkxLCJqdGkiOiIxODgzMzViZi0wMmE4LTRjZGUsOGFkOS0yMWJmNDZjNmRjZDkiLCJjbGllbnRfaWQiOiJZVW1sWkFjQktOc1RBZWxKcVBZRmwzc2g1OE9iQVRYOSJ9.AL7pKSTmond-NSPRNNHVbIzTdAnZjOXcjQ-BbOJ_8lsQvF7PuiOUrGIhY5XTcJusisKgbCdtIxBl8Wq1EiQ_fKnUc3JYYOqzpTB5bGoFy0Yqbfu96dneuWyzgZnoQBkqwZkbQTIg7WNTGx1TJX-UTePvBPxAefiAbaEUcigX9tTsXPoRJZOTrm7IOeKpxpB_gQYkxQtV1_NbERxjTPyMbHdMWal9_xRVzSt7mpTGudMN9OR-VtQ1uXA67GOqhZWcOzq57qImOiCMbaoKnKUADevyWjX_VscN5ZZUtzQUQhTrmv8aR69-uVhMIPKp9juMyYKaYn2IsYZEeCWfhfV45Q

JWT 토큰 검사

이 명령어로 JWT 토큰을 검사할 수 있습니다. 토큰 검사도 참조하세요.

사용

apigee-remote-service-cli token inspect [flags]

매개변수

매개변수

매개변수 Presence 제품과 함께 사용 설명
-c,
‑‑config 		필수 전체 (문자열) Apigee 원격 서비스 구성 파일의 경로입니다.
팁: 이 플래그를 사용하면 CLI가 구성 파일에서 명령어 매개변수를 직접 가져올 수 있으므로 대부분의 다른 명령어 매개변수를 생략할 수 있습니다. ‑‑config 옵션 사용을 참조하세요.
-e,
‑‑environment 		--config가 있으면 선택사항이고, 그렇지 않으면 필수입니다. 전체 (문자열) 조직의 환경입니다.
-f,
‑‑file 		필수 전체 (문자열) 토큰 파일(기본값: stdin 사용)
-h,
‑‑help 		선택사항 전체 명령어 매개변수에 관한 도움말을 표시합니다.
‑‑insecure 선택사항 전체 SSL 사용 시 안전하지 않은 서버 연결을 허용합니다.
‑‑legacy 해당 사항 없음 Edge Public Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.
‑‑opdk 해당 사항 없음 Edge Private Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.
-o,
‑‑organization 		--config가 있으면 선택사항이고, 그렇지 않으면 필수입니다. 전체 (문자열) Apigee 조직입니다. 사용하려면 조직 관리자여야 합니다.
-r,
‑‑runtime 		--config가 있으면 선택사항이고, 그렇지 않으면 필수입니다. Apigee Hybrid에만 해당 (문자열) 프라이빗 클라우드 또는 Apigee Hybrid 인스턴스의 런타임 URL을 지정합니다. URL은 https://로 시작해야 합니다. 예를 들면 https://apitest.example.net입니다.
‑‑tls‑cert
‑‑tls‑key
‑‑tls‑ca 		해당 사항 없음 Edge Private Cloud에만 해당 이 매개변수는 Apigee 설치의 경우 적용되지 않습니다.
-v,
‑‑verbose 		선택사항 전체 (선택사항) 상세 출력을 생성합니다.

예

apigee-remote-service-cli token inspect -c config.yaml <<< $TOKEN

출력

성공하면 다음과 비슷한 출력이 표시됩니다.
{
	"aud": [
		"remote-service-client"
	],
	"exp": 1591741549,
	"iat": 1591740649,
	"iss": "https://apigee-docs-test.apigee.net/remote-service/token",
	"jti": "99325d2e-6440-4278-9f7f-b252a1a79e53",
	"nbf": 1591740649,
	"access_token": "VfzpXzBGAQ07po0bPMKY4JgQjus",
	"api_product_list": [
		"httpbin"
	],
	"application_name": "httpbin",
	"client_id": "GYDGHy5TRpV8AejXCOlreP7dPVepA8H",
	"developer_email": "user@example.com",
	"scope": ""
}
verifying...
token ok.

JWT 토큰 순환

JWT를 처음 생성한 후 어느 정도 지나면 Apigee에서 저장된 공개 키/비공개 키 쌍을 암호화된 키-값 맵(KVM)으로 변경해야 할 수 있습니다. 새 키 쌍을 생성하는 이 프로세스를 키 순환이라고 합니다. 키를 순환하면 새 비공개/공개 키 쌍이 생성되고 Apigee 조직/환경의 'istio' KVM에 저장됩니다. 또한 이전 공개 키는 원래 키 ID 값과 함께 보관됩니다.

사용

apigee-remote-service-cli token rotate-cert [flags]

매개변수

매개변수 Presence 제품과 함께 사용 설명
-c,
‑‑config 		필수 전체 (문자열) Apigee 원격 서비스 구성 파일의 경로입니다.
팁: 이 플래그를 사용하면 CLI가 구성 파일에서 명령어 매개변수를 직접 가져올 수 있으므로 대부분의 다른 명령어 매개변수를 생략할 수 있습니다. --config 옵션 사용을 참조하세요.
-e,
‑‑environment 		--config가 있으면 선택사항이고, 그렇지 않으면 필수입니다. 전체 (문자열) 조직의 환경입니다.
-h,
‑‑help 		해당 사항 없음 Edge Public 및 Private Cloud에만 해당 명령어 매개변수에 관한 도움말을 표시합니다.
--k, --key 해당 사항 없음 Edge Public 및 Private Cloud에만 해당 (문자열) 프로비저닝 키입니다.
‑‑insecure 해당 사항 없음 Edge Public 및 Private Cloud에만 해당 SSL 사용 시 안전하지 않은 서버 연결을 허용합니다.
‑‑legacy 해당 사항 없음 Edge Public Cloud에만 해당 퍼블릭 클라우드용 Apigee Edge를 사용하는 경우에는 이 플래그를 설정해야 합니다. 퍼블릭 클라우드용 Apigee Edge의 관리 및 런타임 URL을 설정합니다.
‑‑opdk 해당 사항 없음 Edge Private Cloud에만 해당 프라이빗 클라우드용 Apigee Edge를 사용하는 경우에는 이 플래그를 설정해야 합니다.
-o,
‑‑organization 		--config가 있으면 선택사항이고, 그렇지 않으면 필수입니다. Edge Public 및 Private Cloud에만 해당 (문자열) Apigee 조직입니다. 사용하려면 조직 관리자여야 합니다.
-r,
‑‑runtime 		해당 사항 없음 Edge Private Cloud에만 해당 (문자열) 프라이빗 클라우드 또는 Apigee Hybrid 인스턴스의 런타임 URL을 지정합니다. URL은 https://로 시작해야 합니다. 예를 들면 https://apitest.example.net입니다.
--s, ‑‑secret 필수 전체 (문자열) 프로비저닝 보안 비밀입니다.
‑‑tls‑cert
‑‑tls‑key
‑‑tls‑ca 		해당 사항 없음 Edge Private Cloud에만 해당 (문자열) mTLS 연결에 필요한 클라이언트 측 TLS 인증서, 비공개 키, 루트 CA를 지정합니다.
--t, ‑‑truncate 필수 전체 (정수) JWKS에 유지할 인증서 수입니다(기본값: 2).
-v,
‑‑verbose 		선택사항 전체 (선택사항) 상세 출력을 생성합니다.

예

apigee-remote-service-cli token rotate-cert -c config.yaml -o myorg -e test \
-k 2e238ffa15dc5ab6a1e97868e7581f6c60ddb8575478582c256d8b7e5b2677a8 \
-s 51058077223fa7b683c3bea845c5cca138340d1d5583922b6d465f9f918a4b08

출력

certificate successfully rotated

내부 토큰 만들기

원격 서비스 API 호출을 승인할 수 있도록 JWT 토큰을 만듭니다.

사용

apigee-remote-service-cli token internal [flags]

매개변수

매개변수

매개변수 Presence 제품과 함께 사용 설명
-c,
‑‑config 		필수 Apigee Hybrid에만 해당 (문자열) Apigee 원격 서비스 구성 파일의 경로입니다.
팁: 이 플래그를 사용하면 CLI가 구성 파일에서 명령어 매개변수를 직접 가져올 수 있으므로 대부분의 다른 명령어 매개변수를 생략할 수 있습니다. --config 옵션 사용을 참조하세요.
-d,
‑‑duration 		필수 Apigee Hybrid에만 해당 (문자열) 생성 시 내부 JWT의 유효 시간입니다(기본값: 10m0s(10분))
-e,
‑‑environment 		--config가 있으면 선택사항이고, 그렇지 않으면 필수입니다. Apigee Hybrid에만 해당 (문자열) 조직의 환경입니다.
-h,
‑‑help 		선택사항 Apigee Hybrid에만 해당 명령어 매개변수에 관한 도움말을 표시합니다.
‑‑insecure 선택사항 Apigee Hybrid에만 해당 SSL 사용 시 안전하지 않은 서버 연결을 허용합니다.
-o,
‑‑organization 		--config가 있으면 선택사항이고, 그렇지 않으면 필수입니다. Apigee Hybrid에만 해당 (문자열) Apigee 조직입니다. 사용하려면 조직 관리자여야 합니다.
-r,
‑‑runtime 		--config가 있으면 선택사항이고, 그렇지 않으면 필수입니다. Apigee Hybrid에만 해당 (문자열) Apigee Hybrid 인스턴스의 런타임 URL을 지정합니다. URL은 https://로 시작해야 합니다. 예를 들면 https://apitest.example.net입니다.
-v,
‑‑verbose 		선택사항 Apigee Hybrid에만 해당 (선택사항) 상세 출력을 생성합니다.

버전 명령어

CLI 버전을 표시합니다.

apigee-remote-service-cli version

구성 파일

이 섹션에서는 사용 가능한 모든 옵션이 포함된 구성 파일의 예시를 보여줍니다.

global:
  temp_dir: /tmp/apigee-istio
  keep_alive_max_connection_age: 10m
  api_address: :5000
  metrics_address: :5001
  tls:
    cert_file: tls.crt
    key_file: tls.key
tenant:
  internal_api: https://istioservices.apigee.net/edgemicro
  remote_service_api: https://org-test.apigee.net/remote-service
  org_name: org
  env_name: env
  key: mykey
  secret: mysecret
  client_timeout: 30s
  tls:
    ca_file: /opt/apigee/tls/ca.crt
    cert_file: /opt/apigee/tls/tls.crt
    key_file: /opt/apigee/tls/tls.key
    allow_unverified_ssl_cert: false
products:
  refresh_rate: 2m
analytics:
  legacy_endpoint: false
  file_limit: 1024
  send_channel_size: 10
  collection_interval: 10s
auth:
  api_key_claim: claim
  api_key_cache_duration: 30m
  api_key_header: x-api-key
  api_header: :authority
  allow_unauthorized: false
  jwt_provider_key: https://org-test.apigee.net/remote-token/token
  append_metadata_headers: true