External Access Signing Helper CLI 사용

Classic/VPC 환경에서 이용 가능합니다.

External Access에서 제공하는 External Access Signing Helper CLI 사용 방법을 설명합니다.

1. Signing Helper CLI 다운로드 및 압축 해제

1.1. CLI 다운로드

사용하는 운영 체제에 맞는 Signing Helper CLI 파일을 다운로드해 주십시오.

• Linux
• macOS
• Windows

1.2. 압축 해제

Windows

# Windows
$ unzip ncp_signing_helper-gov-{version}.windows.arm64.zip
ex) unzip ncp_signing_helper-gov-v1.0.1.windows.arm64.zip
$ chmod +x ./ncp_signing_helper.exe

Linux및 macOS

# Linux
$ tar -xzvf ncp_signing_helper-gov-{version}.linux.arm64.tar.gz
ex) tar -xzvf ncp_signing_helper-gov-v1.0.1.linux.arm64.tar.gz
$ chmod +x ./ncp_signing_helper
 
# macOS
$ tar -xzvf ncp_signing_helper-gov-{version}.darwin.arm64.tar.gz
ex) tar -xzvf ncp_signing_helper-gov-v1.0.1.darwin.arm64.tar.gz
$ chmod +x ./ncp_signing_helper

2. CLI 실행

2.2. 사용 가능한 명령어

version 명령어
version 명령어를 실행하면 Signing Helper CLI가 올바르게 설치되었는지 버전을 확인할 수 있습니다.

./ncp_signing_helper version

help 명령어
help 명령어를 실행하면 Signing Helper의 사용 가능한 명령어와 설명을 확인할 수 있습니다.

./ncp_signing_helper help

credential-process 명령어
credential-process 명령어를 실행해 IAM External Access 에 요청을 보내 임시 자격 증명을 받아올 수 있습니다.

• credential-process --help 실행
  credential-process 명령어 설명과 flag 설명을 확인할 수 있습니다.

  ./ncp_signing_helper credential-process --help
  

  Plain text

  Copy

• credential-process의 flags
  credential-process 명령어에서 사용할 수 있는 flags입니다.

  Flag	기본값	타입	설명	필수 여부
  --role-nrn	""	string	사용할 role의 nrn	Y
  --profile-nrn	""	string	정책을 로드할 profile의 nrn	Y
  --trust-anchor-nrn	""	string	인증에 사용할 트러스트 앵커의 nrn	Y
  --certificate	""	string	인증서 파일의 경로	Y
  --intermediates	""	string	중간 인증서 파일의 경로	N
  --private-key	""	string	개인 키 파일의 경로	Y
  --session-duration	3600	int	세션 유지 시간 (초)	N
  --debug	false	bool	디버그 출력 활성 여부	N
  --with-proxy	false	bool	CreateSession 요청에 프록시 사용 여부	N
  --endpoint	"https://externalaccess.apigw.gov-ntruss.com/auth/v1"	string	CreateSession 요청에 사용되는 엔드포인트	N
  --format	"ncp"	string	자격 증명 출력 형식 지정 ("ncp", "aws" 사용 가능)	N

• credential-process 명령어 실행 및 임시 자격 증명 획득
  credential-process 명령어를 실행해 인증서와 개인키 파일로 IAM External Access에 요청을 보내 임시 자격 증명을 받아옵니다.

  ./ncp_signing_helper credential-process \
  --certificate {certificate file path} \
  --private-key {private key file path} \
  --trust-anchor-nrn {trust anchor nrn} \
  --profile-nrn {profile nrn} \
  --role-nrn {role nrn}
  

  Plain text

  Copy

    "accessKey": "ncp_iam_BPSRK...WoqKhg3",
    "keySecret": "ncp_iam_BPTR...ypJklM3QbK",
    "createTime": "2024-09-30T08:31:07Z",
    "expireTime": "2024-09-30T09:31:07Z"
  }
  

  Plain text

  Copy