---
title: "External Access Signing Helper CLI 사용"
slug: "external-access-signing-helper-cli"
updated: 2026-08-20T09:03:36Z
published: 2026-08-20T09:03:36Z
canonical: "guide-gov.ncloud-docs.com/external-access-signing-helper-cli"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide-gov.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/ncp_signing_helper-gov-v1.0.1.linux.arm64.tar.gz)
- [macOS](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/ncp_signing_helper-gov-v1.0.1.darwin.arm64.tar.gz)
- [Windows](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/ncp_signing_helper-gov-v1.0.1.windows.arm64.zip)

### 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 | Signing Helper의 버전 |
| help | Signing Helper의 사용법 및 옵션 |
| credential-process | IAM External Access에 요청을 보내 임시 자격 증명을 받아옴 |

**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
```
- 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}
```

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