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

Edge Microgateway의 CLI 참조

<ph type="x-smartling-placeholder"></ph> 현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서. 정보

Edge Microgateway v. 3.1.x

개요

Edge Microgateway CLI를 사용하면 Edge Microgateway의 모든 측면을 제어하고 관리할 수 있습니다. 인스턴스를 만들 수 있습니다

인증서 관리

cert 명령어를 사용하면 공개 키/비공개 키 쌍을 설치하고 관리할 수 있습니다. 클라이언트가 Edge를 통해 보안 호출을 수행하는 데 사용하는 Bearer 토큰을 서명하는 데 사용되는 토큰입니다. Microgateway를 지원합니다. 키는 Apigee Edge의 암호화된 키-값 맵 (KVM)에 저장됩니다. Edge Microgateway는 공개 키를 사용하여 서명된 Bearer 토큰을 검증할 수 있습니다. 이러한 키는 Edgemicro 구성 명령에 대한 설정 및 Edge Microgateway 구성 중 자세히 알아보기 여기에 설명된 cert 명령어를 사용할 수 있습니다. 을 사용하여 키를 다시 생성하고 관리할 수 있습니다.

인증서 설치

암호화된 키-값 맵 (KVM)에 키를 설치하고 공개 키를 출력합니다. 키 쌍의 범위는 지정된 조직으로 지정됩니다.

사용 정보

edgemicro cert install -o [organization] -e [environment] -u [username] -p [password] --force

매개변수

매개변수	설명
`-o, --org`	Edge Microgateway를 구성한 Apigee 조직입니다.
`-e, --env`	Edge Microgateway를 구성한 환경입니다.
`-u, --username`	Apigee 사용자 이름입니다. 지정된 계정의 조직 관리자여야 합니다. 되었습니다.
`-p, --password`	(선택사항) 비밀번호 이 매개변수를 제공하지 않으면 살펴보겠습니다
`-f, --force`	(선택사항) 키가 암호화된 KVM에 이미 저장되어 있다면 강제로 대체합니다.
`-h, --help`	사용량 정보를 출력합니다.

예

edgemicro cert install -o docs -e test -u jdoe@example.com -f

출력

current nodejs version is v12.5.0
current edgemicro version is 3.0.2
password:
deleting vault
creating vault
adding private_key
adding public_key
installed cert

인증서 삭제

조직의 키 쌍을 삭제합니다.

사용 정보

edgemicro cert delete -o [organization] -e [environment] -u [username] -p [password]

매개변수

매개변수	설명
`-o, --org`	Edge Microgateway를 구성한 Apigee 조직입니다.
`-e, --env`	Edge Microgateway를 구성한 환경입니다.
`-u, --username`	Apigee 사용자 이름입니다. 지정된 계정의 조직 관리자여야 합니다. 되었습니다.
`-p, --password`	(선택사항) 비밀번호 이 매개변수를 제공하지 않으면 살펴보겠습니다
`-h, --help`	사용량 정보를 출력합니다.

예

edgemicro cert delete -o docs -e test -u jdoe@example.com

출력

deleting vault
Vault deleted!

인증서 확인

조직에 인증서가 설치되어 있는지 확인합니다.

사용 정보

edgemicro cert check -o [organization] -e [environment] -u [username] -p [password]

매개변수

매개변수	설명
`-o, --org`	Edge Microgateway를 구성한 Apigee 조직입니다.
`-e, --env`	Edge Microgateway를 구성한 환경입니다.
`-u, --username`	Apigee 사용자 이름입니다. 지정된 계정의 조직 관리자여야 합니다. 되었습니다.
`-p, --password`	(선택사항) 비밀번호 이 매개변수를 제공하지 않으면 살펴보겠습니다
`-h, --help`	사용량 정보를 출력합니다.

예

edgemicro cert check -o docs -e test -u jdoe@example.com

출력 (성공)

checked cert successfully

출력 (실패)

인증서가 없으면 오류가 반환됩니다.

공개 키 가져오기

지정된 조직의 공개 키를 반환합니다. 인증이 필요하지 않습니다.

사용 정보

edgemicro cert public-key -o [organization] -e [environment]

매개변수

매개변수	설명
`-o, --org`	Edge Microgateway를 구성한 Apigee 조직입니다.
`-e, --env`	Edge Microgateway를 구성한 환경입니다.
`-h, --help`	사용량 정보를 출력합니다.

예

edgemicro cert public-key -o docs -e test

출력 (샘플)

Apigee Edge Cloud용 Edge Microgateway 구성

Edge Microgateway가 Apigee Edge Cloud 인스턴스와 작동할 수 있도록 지원합니다. 이를 래핑하고 에지에 필수 인증 프록시를 배포하고 인증을 생성하기 위한 명령어 시퀀스 구성 파일을 업데이트하고, 전체 작업 예를 보려면 설정 및 Edge Microgateway 구성 중 자세히 알아보기

사용 정보

edgemicro configure -o [organization] -e [environment] -u [username] -p [password]

매개변수

매개변수	설명
`-o, --org`	Edge Microgateway를 구성한 Apigee 조직입니다.
`-e, --env`	Edge Microgateway를 구성한 환경입니다.
`-u, --username`	Apigee 사용자 이름입니다. 지정된 계정의 조직 관리자여야 합니다. 되었습니다.
`-p, --password`	(선택사항) 비밀번호 이 매개변수를 제공하지 않으면 살펴보겠습니다
`-r, --url`	(선택사항) 조직:환경의 가상 호스트 별칭을 지정합니다. 자세한 내용은 가상 호스트에 대해 알아볼 수 있는 Edge 문서입니다. 기본값: `org-env.apigee.net`
`-c, --configDir`	(선택사항) Edge Microgateway 구성 파일의 경로를 지정합니다. 기본적으로 구성 파일은 ./config/config.yaml에 있습니다. (v2.4.x 추가됨)
`-x, --proxyName`	(선택사항) edgemicro-auth 프록시의 기본 경로를 설정합니다. 만약 edgemicro-auth 프록시가 기본값과 다른 경로에 배포되도록 합니다. /edgemicro-auth를 가진 경우, 이 기능을 사용하면 Edge에 새 경로를 설정할 수 있습니다. Microgateway를 지원합니다. 기본적으로 기본 경로는 /edgemicro-auth입니다. (추가됨 v2.4.x)
`-t, --token`	(선택사항) 인증에 사용자 이름/비밀번호 대신 OAuth 토큰을 사용할 수 있습니다. OAuth2 액세스 토큰을 사용한 보안 API 호출도 참조하세요. 예를 들면 다음과 같습니다. `edgemicro configure -o docs -e test -t <your token>`
`-v, --virtualHosts`	(선택사항) 기본 가상 호스트를 재정의합니다. '`default,secure`'. 에지 조직:환경 환경입니다. Edge 문서를 참조하세요. 배울 것입니다.
`-d, --debug`	(선택사항) 디버그 정보를 제공합니다.
`-h, --help`	사용량 정보를 출력합니다.

사용법 참고사항

이 명령어는 구성 정보를 약 /.edgemicro/org-env-config.yaml입니다.

예

edgemicro configure -o docs -e test -u jdoe@example.com

출력

성공하면 명령어가 Edge를 시작할 때 사용해야 하는 키 집합을 반환합니다. Microgateway를 지원합니다.

...

The following credentials are required to start edge micro
  key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f
  secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372

edgemicro configuration complete!

키 생성

genkeys 명령어는 Edge Microgateway에서 다음을 수행하는 데 사용하는 키와 보안 비밀 쌍을 생성합니다. 자체 인증을 수행합니다.

사용 정보

edgemicro genkeys -o [organization] -e [environment] -u [username] -p [password]

매개변수

매개변수	설명
`-o, --org`	Edge Microgateway를 구성한 Apigee 조직입니다.
`-e, --env`	Edge Microgateway를 구성한 환경입니다.
`-u, --username`	Apigee 사용자 이름입니다. 지정된 계정의 조직 관리자여야 합니다. 되었습니다.
`-p, --password`	(선택사항) 비밀번호 이 매개변수를 제공하지 않으면 살펴보겠습니다
`-t, --token`	(선택사항) 인증에 사용자 이름/비밀번호 대신 OAuth 토큰을 사용할 수 있습니다. OAuth2 액세스 토큰을 사용한 보안 API 호출도 참조하세요. 예를 들면 다음과 같습니다. `edgemicro genkeys -o docs -e test -t <your token>`
`-h, --help`	사용량 정보를 출력합니다.

사용법 참고사항

성공하면 명령어는 3개의 항목을 반환합니다. 첫 번째는 페이지에 배치해야 하는 구성 파일이 생성됩니다 나머지 두 개는 Edge를 시작할 때 필요한 키 쌍입니다. Microgateway 인스턴스

부트스트랩 URL: 이 URL은 Apigee Edge로 분석 데이터를 전송하기 위한 Edge Microgateway 인스턴스 URL을 복사해야 합니다. Edge Microgateway 구성 파일에 ~/.edgemicro/org-env-config.yaml를 입력합니다.
키: 키입니다. 이 키와 보안 비밀은 CLI에 대한 입력으로 필요합니다. 명령어를 사용하여 Edge Microgateway 인스턴스를 시작하는 데 사용됩니다.
secret: 보안 비밀입니다.

예

edgemicro genkeys -o docs -e test -u jdoe@example.com

출력 (샘플)

성공하면 명령어가 Edge를 시작할 때 사용해야 하는 키 집합을 반환합니다. Microgateway를 지원합니다.

configuring host edgemicroservices-us-east-1.apigee.net for region us-east-1
Please copy the following property to the edge micro agent config
  bootstrap: https://edgemicroservices-us-east-1.apigee.net/edgemicro/bootstrap/organization/jdoe/environment/test

The following credentials are required to start edge micro
  key: db39324077989c75eac34c13d285772ea8e3b982b957b3f52916f3048511443f
  secret: 5bf8da39de0056f88fdd5f25a8602d22f312c1c8c870580a5fef55ac6637b7ae

finished

Apigee Edge Private Cloud용 Edge Microgateway 구성

Apigee Edge Private Cloud 설치와 연동되도록 Edge Microgateway를 구성합니다.

사용 정보

edgemicro private configure -o [organization] -e [environment] -u [username] -p [password]

매개변수

매개변수	설명
`-o, --org`	Edge Microgateway를 구성한 Apigee 조직입니다.
`-e, --env`	Edge Microgateway를 구성한 환경입니다.
`-u, --username`	Apigee 사용자 이름입니다. 지정된 계정의 조직 관리자여야 합니다. 되었습니다.
`-p, --password`	(선택사항) 비밀번호 이 매개변수를 제공하지 않으면 살펴보겠습니다
`-r, --runtime-url`	프라이빗 클라우드 인스턴스의 런타임 URL을 지정합니다.
`-m, --mgmt-url`	프라이빗 클라우드 인스턴스의 관리 서버 URL입니다.
`-v, --virtualHosts`	쉼표로 구분된 조직:환경 가상 호스트의 목록입니다. 기본값 '`default,secure`'.
`-c, --configDir`	(선택사항) Edge Microgateway 구성 파일의 경로를 지정합니다. 기본적으로 구성 파일은 ./config/config.yaml에 있습니다. (v2.4.x 추가됨)
`-t, --token`	(선택사항) 인증에 사용자 이름/비밀번호 대신 OAuth 토큰을 사용할 수 있습니다. OAuth2 액세스 토큰을 사용한 보안 API 호출도 참조하세요. 예를 들면 다음과 같습니다. `edgemicro configure -o docs -e test -t <your token>`
`-d, --debug`	(선택사항) 디버그 정보를 제공합니다.
`-h, --help`	사용량 정보를 출력합니다.

사용법 참고사항

이 명령어는 구성 정보를 약 /.edgemicro/org-env-config.yaml입니다.

예

edgemicro private configure -o docs -e test -u jdoe@example.com -r http://192.162.55.100:9002 -m http://192.162.55.100:8080

출력

성공하면 명령어가 Edge를 시작할 때 사용해야 하는 키 집합을 반환합니다. Microgateway를 지원합니다.

...

The following credentials are required to start edge micro
  key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f
  secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372

edgemicro configuration complete!

Edge Microgateway 시작

Edge Microgateway를 시작하기 전에 먼저 edgemicro configuration을 실행해야 합니다. (퍼블릭 클라우드) 또는 edgemicro 비공개 구성 (프라이빗 클라우드) 구성 명령어는 Edge Microgateway를 시작하는 데 필요한 키와 보안 비밀 값을 반환합니다.

사용 정보

edgemicro start -o [organization] -e [environment] -k [public-key] -s [secret-key]

매개변수

매개변수	설명
`-o, --org`	Edge Microgateway를 구성한 Apigee 조직입니다.
`-e, --env`	Edge Microgateway를 구성한 환경입니다.
`-k, --key`	'`edgemicro configure`' 실행 시 반환되는 키 값입니다. 명령어와 함께 사용하면 됩니다
`-s, --secret`	"`edgemicro configure`" 실행 시 반환되는 보안 비밀 값입니다. 명령어와 함께 사용하면 됩니다
`-p, --processes`	(선택사항) 시작할 프로세스 수입니다. 기본값: 애플리케이션의 코어 수 있습니다.
`-d, --pluginDir`	(선택사항) 플러그인 디렉터리의 절대 경로입니다.
`-r, --port`	(선택사항) ~`/.edgemicro/org-env-config.yaml` 파일 기본값: 8000
`-c, --cluster`	(선택사항) 클러스터 모드에서 Edge Microgateway를 시작합니다. 참고: v2.3.1부터 이 옵션은 삭제되었습니다. v2.3.1의 경우 이상 버전에서는 Edge Micro가 항상 클러스터 모드에서 시작됩니다.
`-c, --configDir`	(선택사항) Edge Microgateway 구성 파일의 경로를 지정합니다. 기본적으로 구성 파일은 ./config/config.yaml에 있습니다. (v2.4.x 추가됨)
`-u, --configUrl`	(선택사항) Edge Microgateway가 구성을 다운로드할 엔드포인트를 지정합니다. 파일에서 참조됩니다. (v2.5.x 추가됨)
`-d, --debug`	(선택사항) 디버그 정보를 제공합니다.
`-h, --help`	사용량 정보를 출력합니다.

포트 설정

start 명령어를 사용하면 포트 번호를 지정하여 지정된 포트를 재정의할 수 있습니다. 구성 파일에 있습니다. PORT를 사용하여 포트 번호를 지정할 수도 있습니다. 환경 변수입니다 예를 들면 다음과 같습니다.

edgemicro start -o docs -e test -k abc123 -s xyz456 -p 2 --port 8002

또는

export PORT=8002
edgemicro start -o org -e test -k key -s secret -p 2

포트가 사용 중인 경우 Edge Microgateway에서 오류를 반환합니다.

클러스터링 정보

Edge Microgateway는 Node.js cluster 모듈을 사용하여 클러스터링을 사용 설정합니다. 클러스터링을 통해 Edge Microgateway가 멀티 코어 시스템을 활용할 수 있습니다. 자세한 내용은 Node.js 문서를 참조하세요.

예

edgemicro start -o docs -e test -k abc123 -s xyz456

샘플 출력:

...

current nodejs version is v12.5.0
current edgemicro version is 3.0.2
info: jwk_public_keys download from null returned 200 undefined
info: jwt_public_key download from https://docs-test.apigee.net/edgemicro-auth/publicKey returned 200 OK
info: products download from https://docs-test.apigee.net/edgemicro-auth/products returned 200 OK
info: config download from https://edgemicroservices-us-east-1.apigee.net/edgemicro/bootstrap/organization/docs/environment/test returned 200 OK
PROCESS PID : 17991

토큰 관리

token 명령어를 사용하면 서명된 OAuth2 액세스를 가져오고, 디코딩하고, 확인할 수 있습니다. 토큰입니다. 도 참조하세요. OAuth2 액세스 토큰으로 API 호출 보호

토큰 디코딩

서명되고 인코딩된 Bearer 토큰을 일반 텍스트 JSON JWT (Java 웹 토큰)로 디코딩합니다. 나타냅니다. 토큰은 다음을 제공하는 Apigee Edge 개발자 앱에 대한 정보를 전달합니다. 애플리케이션 이름, client_id, 제품 목록 등을 포함하여 토큰을 만드는 데 사용된 키

사용 정보

edgemicro token decode -f [filename]

매개변수

매개변수	설명
`-f, --file`	디코딩할 JWT 토큰이 포함된 파일의 이름입니다.
`-h, --help`	사용량 정보를 출력합니다.

예

edgemicro token decode -f token.jwt

출력 (샘플)

{ header: { typ: 'JWT', alg: 'RS256' },

  payload:
   { application_name: 'b43342ef-86f6-4666-a121-b9ac2025d217',
     client_id: 'O9ZQRZKnn1rdgcKQgsABSMdOsKS',
     scopes: [],
     api_product_list: [ 'MicroTest' ],
     iat: 1436280566,
     exp: 1436282365 },
  signature: '' }

토큰 생성

서명된 Bearer 토큰을 생성합니다. 토큰을 사용하면 클라이언트 앱에서 인증된 API 호출을 수행할 수 있습니다. Edge Microgateway로 전달됩니다. 토큰은 OAuth 2.0 호환 JSON 웹 토큰 (JWT)입니다. 고객 키 (클라이언트 ID)와 고객 비밀번호 (클라이언트 보안 비밀) 값을 개발자 앱을 빌드할 수 있습니다 도 참조하세요. OAuth2 액세스 토큰으로 API 호출 보호

사용 정보

edgemicro token get -o [org] -e [env] -i [client_id] -s [client_secret]

매개변수

매개변수	설명
`-o, --org`	Edge Microgateway를 구성한 Apigee 조직입니다.
`-e, --env`	Edge Microgateway를 구성한 환경입니다.
`-1, --key`	Microgateway 인식과 연결된 개발자 앱의 클라이언트 ID 사용할 수 있습니다
`-s, --secret`	Microgateway 인식과 연결된 개발자 앱의 클라이언트 보안 비밀번호 사용할 수 있습니다
`-h, --help`	사용량 정보를 출력합니다.

예

edgemicro token get -o docs -e test -i 5UzOwAXGoOeo60aew94PPG5MAZE3aJp -s 6vahKFGS9a3qMLwz

출력 (샘플)

{ token: 'eyJ0eXAiOiJKV1JhbGciOiJSUzI1NiJ9Glvbl9uYW1lIjoiNWNiMGY0NTV6TV3
EtOWMzOC00YmJjLWIzNzEtZGMxZTQzOGMxIiwiY2xpZW50X2lkIjoiNVV6T3dBWEdvSU9lbz
YwYWV3OTRQN0c1TUFaRTNhSnAiLCJzY2MiOltdLCJhcGlfcHJvZHVjdF9saXN0IjpbIkVkZ2
VNaWNyb1Rlc3RQcm9kdWN0Il0sImlhdCI3ODEyMzQ2MSwiZXhwIjoxNDc4MTI1MjYwfQ.Dx5
f5U7PXm8koNGmFX4N6VrxKMJnpndKgoJ5zWSJvBZ6Ccvhlpd85ipIIA5S2A5nx4obYWp_rpY
RJpIGYwyxP6Oq2j0rxnVjdCC4qyYMgthZjhKgEBVBe3s1ndP72GP2vV6PsSA9RQ2-yzsy9r0
TzhAZ3NJTxT1tS0XKqKngE-OhR3fJHVLAzdMDT0AmS9H0Z2NAJtQOuK6RTpCjG9B6Bc48AEM
sj7QSM-1LWiQ8LdY8k_BoC06qsTI7bCQGWwTuqL-ismbcx2bxovUxSemZIaoROfuF-dCZHG3
2aTP75WxBvvNgBBvPvQtPzbeSOtEaww' }

토큰 확인

지정된 중요한 부분입니다.

사용 정보

edgemicro token verify -o [org] -e [env] -f [filename]

매개변수

매개변수	설명
`-o, --org`	Edge Microgateway를 구성한 Apigee 조직입니다.
`-e, --env`	Edge Microgateway를 구성한 환경입니다.
`-f, --file`	확인할 JWT가 포함된 파일의 이름입니다.
`-h, --help`	사용량 정보를 출력합니다.

예

edgemicro token get -o docs -e test -f token.jwt

유효한 토큰의 샘플 출력

{ application_name: 'b43342ef-86f6-4666-a121-b9ac2025d217',

  client_id: 'O9ZQRZKnn1rdgcKQsAZUBkQSMdOsKS',

  scopes: [],

  api_product_list: [ 'MicroTest' ],

  iat: 1436396155,

  exp: 1436397954 }

잘못된 토큰의 샘플 출력

{ [JsonWebTokenError: invalid token] name: 'JsonWebTokenError', message: 'invalid token' }

만료된 토큰의 샘플 출력

{ [TokenExpiredError: jwt expired]

  name: 'TokenExpiredError',

  message: 'jwt expired',

  expiredAt: Tue Jul 07 2015 09:19:25 GMT-0600 (MDT) }

새 Edge Microgateway 구성 초기화

Edge Microgateway를 처음 설치한 후 이 명령어를 한 번 실행합니다. 새 기본값을 만듭니다. 구성 파일: ~/.edgemicro/default.yaml.

사용 정보

edgemicro init

매개변수

매개변수	설명
`-c, --configDir`	(선택사항) Edge Microgateway 구성 파일의 경로를 지정합니다. 기본적으로 구성 파일은 ./config/config.yaml에 있습니다. (v2.4.x 추가됨)
`-h, --help`	사용량 정보를 출력합니다.

예

edgemicro init

출력 (성공)

config initialized to /MyHome/.edgemicro/default.yaml

Edge Microgateway 구성 확인

Edge Microgateway가 올바르게 구성되었는지 확인합니다.

사용 정보

edgemicro verify -o [organization] -e [environment] -k [public-key] -s [secret-key]

매개변수

예

edgemicro verify -o docs -e test -k abc123 -s xyz456

출력 (성공)

logging to /var/tmp/edgemicro-My-Machine.local-a0c48610-a148-11e6-8466-93f081b05988
installed plugin from analytics
installed plugin from oauth
a0c48610-a148-11e6-8466-93f081b05988 edge micro listening on port 8000
verifying analytics negative case: OK
verifying bootstrap url availability:OK
verifying jwt_public_key availability: OK
verifying products availability: OK
verifying quota with configured products: OK
verifying analytics with payload: OK
verification complete

Microgateway 클러스터 상태 확인

기본적으로 Edge Microgateway는 클러스터 모드에서 시작됩니다. 이 명령어를 사용하여 포드의 상태를 변경할 수 있습니다

사용 정보

edgemicro status

매개변수

매개변수	설명
`-h, --help`	사용량 정보를 출력합니다.

예

edgemicro status

출력 (성공)

current nodejs version is v12.5.0
current edgemicro version is 3.0.2
edgemicro is running with 8 workers

Microgateway 클러스터 중지

Edge Microgateway 클러스터를 중지합니다.

사용 정보

edgemicro stop

매개변수

매개변수	설명
`-h, --help`	사용량 정보를 출력합니다.

예

edgemicro stop

출력 (성공)

current nodejs version is v12.5.0
current edgemicro version is 3.0.2
Stop Completed Successfully

Microgateway 클러스터 다시 로드

구성 변경 후 다운타임 없이 다시 시작합니다. 다음과 같은 방법으로 Edge Microgateway를 새로고침합니다. 새 구성을 가져올 수 있습니다

사용 정보

edgemicro reload -o [organization] -e [environment] -k [public-key] -s [secret-key]

매개변수

매개변수	설명
`-o, --org`	Edge Microgateway를 구성한 Apigee 조직입니다.
`-e, --env`	Edge Microgateway를 구성한 환경입니다.
`-k, --key`	'`edgemicro configure`' 실행 시 반환되는 키 값입니다. 명령어와 함께 사용하면 됩니다
`-s, --secret`	"`edgemicro configure`" 실행 시 반환되는 보안 비밀 값입니다. 명령어와 함께 사용하면 됩니다
`-h, --help`	사용량 정보를 출력합니다.

예

edgemicro reload -o docs -e test -k abc123 -s xyz456

출력 (성공)

...

Reload Completed Successfully

KVM 업그레이드

키 순환을 사용하려면 업그레이드된 키 값이 있어야 합니다. Apigee Edge 조직에 설치된 지도입니다. (v2.5.x 추가됨)

참고: 현재 Edge Micro 인스턴스를 버전 2.5.2 이전에 구성한 경우 KVM을 업그레이드해야 합니다. 키 순환을 사용할 수 있습니다 이 업그레이드는 한 번만 수행하면 됩니다.

사용 정보

edgemicro upgradekvm -o [organization] -e [environment] -u [username]

매개변수

매개변수	설명
`-o, --org`	Edge Microgateway를 구성한 Apigee 조직입니다.
`-e, --env`	Edge Microgateway를 구성한 환경입니다.
`-u, --username`	Apigee 사용자 이름입니다. 지정된 계정의 조직 관리자여야 합니다. 되었습니다.
`-p, --password`	(선택사항) 비밀번호 이 매개변수를 제공하지 않으면 살펴보겠습니다
`-v, --virtualhost`	(선택사항) 프록시의 가상 호스트입니다.
`-t, --token`	(선택사항) 인증에 사용자 이름/비밀번호 대신 OAuth 토큰을 사용할 수 있습니다. OAuth2 액세스 토큰을 사용한 보안 API 호출도 참조하세요. 예를 들면 다음과 같습니다. `edgemicro upgradekvm -o docs -e test -t <your token>`
`-b, --baseuri`	(선택사항) Apigee Edge에서 조직의 기본 URI입니다. 기본값은 Apigee 클라우드 배포의 URI는 api.enterprise.apigee.com입니다. 온프레미스 배포의 경우 기본 URL은 다를 수 있습니다.

예

edgemicro upgradekvm -o docs -e test -u jdoe@example.com

출력 (성공)

성공하면 명령어는 다음과 비슷한 출력을 반환합니다.

current nodejs version is v12.5.0
current edgemicro version is 3.0.2
password:
Checking for certificate...
Certificate found!
-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAsT6yVoT/h6pvkPlkUUtv
Hgs7MbDPcWxto7dZqJBwQ4oOQ0IJ2P4XGigc3kYUyPp5lFHg1ssP9+0onRpqn6Lq
z7N5iaTSv5YXb26bU2kSOl4hbwcljIzauAnBzQ13VaQ5SoflRxMGSZmTqZeu5jkQ
3JZ7F6k2bCar5sk1k84vd4WXcCVyngFlrMtlux5z0vOU56QYZFvvKYl/wOHNPLLB
Js54531CV1ZfhV3nDDq9Lh5D1C/oQVlm1Lc7BJoEUmKeFATmSsi50c14ScsmdtJ1
HqC/brSXCd185P6ifu2RH7IHKzNfcD4NlfAVmDScng4w5RxBan2avbmAJrokQ4b5
WQIDAQAB
-----END PUBLIC KEY-----
KVM update complete

Edgemicro-auth 프록시 업그레이드

키 순환을 사용하려면 Apigee Edge 조직에 배포된 Edgemicro-auth 프록시 (v2.5.x 추가됨)

참고: 이전에 현재 Edge Micro 인스턴스를 구성한 경우 버전 2.5.2를 사용하는 경우 키 순환을 사용하려면 이 프록시를 업그레이드해야 합니다. 다음 단계를 수행하기만 하면 됩니다. 이 업그레이드를 한 번 수행할 수 있습니다

사용 정보

edgemicro upgradeauth -o [organization] -e [environment] -u [username]

매개변수

매개변수	설명
`-o, --org`	Edge Microgateway를 구성한 Apigee 조직입니다.
`-e, --env`	Edge Microgateway를 구성한 환경입니다.
`-u, --username`	Apigee 사용자 이름입니다. 지정된 계정의 조직 관리자여야 합니다. 되었습니다.
`-p, --password`	(선택사항) 비밀번호 이 매개변수를 제공하지 않으면 살펴보겠습니다
`-v, --virtualhost`	(선택사항) 프록시의 가상 호스트입니다.
`-b, --baseuri`	(선택사항) Apigee Edge에서 조직의 기본 URI입니다. 기본값은 Apigee 클라우드 배포의 URI는 api.enterprise.apigee.com입니다. 온프레미스 배포의 경우 기본 URL은 다를 수 있습니다.

예

edgemicro upgradeauth -o docs -e test -u jdoe@example.com

출력 (성공)

성공하면 명령어는 다음과 비슷한 출력을 반환합니다.

Going to create revision 2 of API edgemicro-auth
Using /Users/jdoe/npm/lib/node_modules/edgemicro/node_modules/microgateway-edgeauth/apiproxy/edgemicro-auth.xml as the root file
Creating revision 2 of API edgemicro-auth
Uploading java resource micro-gateway-products-javacallout-2.0.0.jar
Uploading jsc resource generate-verify-jwt.js
Uploading jsc resource send-public-key.js
Uploading jsc resource set-jwt-variables.js
Uploading jsc resource set-response.js
Uploading node resource index.js
Uploading node resource node_modules_apigee-access.zip
Uploading node resource node_modules_base64url.zip
Uploading node resource node_modules_buffer-equal-constant-time.zip
Uploading node resource node_modules_ecdsa-sig-formatter.zip
Uploading node resource node_modules_jsrsasign.zip
Uploading node resource node_modules_jwa.zip
Uploading node resource node_modules_jws.zip
Uploading node resource node_modules_safe-buffer.zip
Uploading node resource package.json
Uploading policy Access-App-Info-2.xml
Uploading policy Access-App-Info.xml
Uploading policy AccessTokenRequest.xml
Uploading policy Add-Custom-Claims.xml
Uploading policy Create-OAuth-Request.xml
Uploading policy Create-Refresh-Request.xml
Uploading policy Extract-API-Key.xml
Uploading policy Extract-OAuth-Params.xml
Uploading policy Extract-Refresh-Params.xml
Uploading policy Get-Private-Key.xml
Uploading policy Get-Public-Key.xml
Uploading policy Get-Public-Keys.xml
Uploading policy JavaCallout.xml
Uploading policy Products-to-JSON-2.xml
Uploading policy Products-to-JSON.xml
Uploading policy Raise-Fault-Unknown-Request.xml
Uploading policy RefreshAccessToken.xml
Uploading policy Send-Public-Key.xml
Uploading policy Set-JWT-Variables.xml
Uploading policy Set-Response.xml
Uploading policy Verify-API-Key.xml
Uploading target TargetEndpoint-1
Uploading proxy default
Deploying revision 2 of edgemicro-auth to test
Deployment on test successful
edgemicro-auth proxy upgraded

키 순환

edgemicro rotatekey 명령어를 사용하여 공개 키/비공개 키 쌍을 순환합니다. Edge Microgateway에서 OAuth 보안에 사용되는 JWT 토큰을 생성하는 데 사용되었습니다.

자세한 내용은 페이지를 참조하세요. JWT 키 순환을 참조하세요.

사용 정보

edgemicro rotatekey -o [organization] -e [environment] -u [username] -k [kid]

매개변수

매개변수	설명
`-o, --org`	(필수사항) Edge Microgateway를 구성한 Apigee 조직입니다.
`-e, --env`	(필수) Edge Microgateway를 구성한 환경입니다.
-u, --사용자 이름	(필수사항) Apigee 사용자 이름입니다. 지정된 계정의 조직 관리자여야 합니다. 되었습니다.
`-p, --password`	(선택사항) 비밀번호 이 매개변수를 제공하지 않으면 살펴보겠습니다
`-k, --kid`	(필수) 특정 키를 일치시키는 데 사용되는 ID입니다. Edge Microgateway는 이 값을 사용하여 키 순환 중에 키 세트 중에서 선택할 수 있습니다. 자세한 내용은 JSON 웹 키 사양입니다
`-b, --baseuri`	(선택사항) Apigee Edge에서 조직의 기본 URI입니다. 기본값은 Apigee 클라우드 배포의 URI는 api.enterprise.apigee.com입니다. 온프레미스 배포의 경우 기본 URL은 다를 수 있습니다.

예

edgemicro rotatekey -o jdoe -e test -u jdoe@google.com -k 2

출력 (성공)

성공하면 명령어는 다음과 비슷한 출력을 반환합니다.

current nodejs version is v12.5.0
current edgemicro version is 3.0.2
password:
Checking if private key exists in the KVM...
Checking for certificate...
Found Certificate
Generating New key/cert pair...
Extract new public key
Key Rotation successfully completed!

순환 후 Edge UI에서 새 키가 Microgateway에 추가되었음을 확인할 수 있습니다. KVM

지속적인 모니터링

edgemicro forever 명령어를 사용하여 Forever 이 도구는 앱이 다운되거나 오류가 발생할 경우 Node.js 앱을 자동으로 다시 시작하는 Node.js 도구입니다. 도 참조하세요. 지속적인 모니터링.

사용 정보

edgemicro forever 명령어를 실행하기 전에 다음 환경 변수를 설정해야 합니다.

EDGEMICRO_ORG - Edge Microgateway를 구성한 Apigee 조직입니다.
EDGEMICRO_ENV - Edge Microgateway를 구성한 환경입니다.
EDGEMICRO_KEY - 'edgemicro configuration'을 실행할 때 반환된 키 값입니다. 명령어와 함께 사용하면 됩니다
EDGEMICRO_SECRET - 'edgemicro configuration'을 실행할 때 반환된 보안 비밀 값입니다. 명령어와 함께 사용하면 됩니다

edgemicro forever -f [forever_file] -a [start|stop]

매개변수

매개변수	설명
`-f, --file`	`forever.json` 파일의 위치를 지정합니다.
`-a, --action`	`start` 또는 `stop`. 기본값은 start입니다.

예:

영원히 시작하려면 다음 단계를 따르세요.

edgemicro forever -f ~/mydir/forever.json -a start

영원히 중지하려면 다음 단계를 따르세요.

edgemicro forever -a stop

키 취소

edgemicro revokekeys 명령어를 사용하여 Edge Microgateway 구성

사용 정보

edgemicro revokekeys -o [organization] -e [environment] -u [username]
-k [key] -s [secret]

매개변수

매개변수	설명
`-o, --org`	(필수사항) Edge Microgateway를 구성한 Apigee 조직입니다.
`-e, --env`	(필수) Edge Microgateway를 구성한 환경입니다.
`-u, --username`	(필수사항) Apigee 사용자 이름입니다. 지정된 계정의 조직 관리자여야 합니다. 되었습니다.
`-p, --password`	(선택사항) 비밀번호 이 매개변수를 제공하지 않으면 살펴보겠습니다
`-k, --key`	(필수) 취소할 키입니다.
`-s, --secret`	(필수) 취소할 보안 비밀입니다.

예시

edgemicro revokekeys -o myorg -e test -u jdoe@apigee.com
-k 2c0064f5bd85f5573dcaffe21566fa7a2d49885cdbf8899370c8a4479285f -s 4b5d6355b874f7c46838893823e8d929dcb2e42fb9aebcb535089c9b98513

성공하면 다음 메시지가 표시됩니다.

key 2c0064f5bd85f5573dcaffe21566fa7a2d49885cdbf8899370c8a4479285f revoked successfully