---
title: "CLI 인증"
slug: "cli-auth"
updated: 2026-04-23T08:56:49Z
published: 2026-04-23T08:58:50Z
canonical: "cli.ncloud-docs.com/cli-auth"
---

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

# CLI 인증

<p class="platform-info type-classic-vpc">Classic/VPC 환경에서 이용 가능합니다.</p>

API 인증키를 설정하는 방법을 설명합니다.
    
## API 인증키 설정<a name="API인증키설정"></a>
CLI를 사용하려면 먼저 API 인증키를 설정해야 합니다.

:::(Info) (참고)
API 인증키에 대한 자세한 설명은 [API 가이드](https://api.ncloud-docs.com/docs/common-ncpapi){target="_blank"}를 참조해 주십시오.
:::

`ncloud configure` 명령어를 입력하면 **Access Key**, **Secret Key**를 입력받을 수 있습니다.

```
./ncloud configure
set [DEFAULT]'s configuration.
Ncloud Access Key ID []: <access-key>
Ncloud Secret Access Key []: <secret-key>
Ncloud API URL (default:https://ncloud.apigw.ntruss.com) []: 
```

각 API 인증키는 사용자 환경 홈 디렉터리의 `.ncloud` 폴더에 Configure 파일 형태로 저장됩니다. API 인증키를 제대로 입력한 경우, 정상적으로 명령어가 수행됩니다. 만약 입력한 API 인증키가 유효하지 않은 경우, 다음과 같은 메시지가 출력됩니다.

```
./ncloud server getRegionList
Invalid consumerKey
```

인증키가 유효한 경우, Zone 리스트 출력 실행 시 다음과 같은 결과가 출력됩니다.

```
./ncloud server getZoneList --regionNo 1
```

```json
{
  "getZoneListResponse": {
    "zoneList": [
      {
        "zoneNo": "3",
        "zoneName": "KR-2",
        "zoneCode": "KR-2",
        "zoneDescription": "평촌 zone",
        "regionNo": "1"
      },
      {
        "zoneNo": "2",
        "zoneName": "KR-1",
        "zoneCode": "KR-1",
        "zoneDescription": "가산 zone",
        "regionNo": "1"
      }
    ],
    "requestId": "07a42c32-d1f9-430d-b658-1078f2f3bb81",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```

### 프로필 설정<a name="프로필설정"></a>
여러 계정의 인증 정보를 관리하려면 프로필을 사용합니다. `--profile` 옵션을 지정하지 않으면 기본(`DEFAULT`) 인증 정보가 사용됩니다.

프로필을 추가하려면 `ncloud configure` 명령어에 `--profile` 옵션을 지정합니다.
```
./ncloud configure --profile <profile-name>
set [<profile-name>]'s configuration.
Ncloud Access Key ID []: <access-key>
Ncloud Secret Access Key []: <secret-key>
Ncloud API URL (default:https://ncloud.apigw.ntruss.com) []: 
```

명령어 실행 시 `--profile` 옵션으로 사용할 프로필을 지정합니다.
```
./ncloud server getZoneList --regionNo 1 --profile <profile-name>
```