---
title: "CLI 인증"
slug: "cli-auth"
updated: 2026-06-25T09:10:26Z
published: 2026-06-25T09:10:26Z
canonical: "cli-fin.ncloud-docs.com/cli-auth"
---

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

# CLI 인증

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

:::(Info) (참고)
API 인증키에 대한 자세한 설명은 [API 가이드](https://api-fin.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://fin-ncloud.apigw.fin-ntruss.com) []: 
```

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

```
./ncloud vserver getRegionList
Invalid consumerKey
```

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

```
./ncloud vserver getZoneList
```

```json
{
  "getZoneListResponse": {
    "totalRows": 2,
    "zoneList": [
      {
        "zoneName": "FKR-1",
        "zoneCode": "FKR-1",
        "regionCode": "FKR",
        "zoneDescription": "Korea(finance) ZONE"
      },
      {
        "zoneName": "FKR-2",
        "zoneCode": "FKR-2",
        "regionCode": "FKR",
        "zoneDescription": "Korea(finance)-2 ZONE"
      }
    ],
    "requestId": "d1acba9a-45b3-4f2c-a0d3-d59113f3239e",
    "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://fin-ncloud.apigw.fin-ntruss.com) []: 
```

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