---
title: "CLIの認証"
slug: "cli-auth"
updated: 2026-09-17T10:11:00Z
published: 2026-09-17T10:11:00Z
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の認証

Classic/VPC環境で利用できます。

API認証キーを設定する方法を説明します。

## API認証キーの設定

CLIを使用するには、まず API認証キーを設定する必要があります。

              参考

              

API認証キーの詳細は、[APIガイド](https://api.ncloud-docs.com/docs/ja/common-ncpapi)をご参照ください。

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

```
{
  "getZoneListResponse": {
    "zoneList": [
      {
        "zoneNo": "3",
        "zoneName": "KR-2",
        "zoneCode": "KR-2",
        "zoneDescription": "坪村ゾーン",
        "regionNo": "1"
      },
      {
        "zoneNo": "2",
        "zoneName": "KR-1",
        "zoneCode": "KR-1",
        "zoneDescription": "加山ゾーン",
        "regionNo": "1"
      }
    ],
    "requestId": "07a42c32-d1f9-430d-b658-1078f2f3bb81",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```

### プロファイルの設定

複数のアカウントの認証情報を管理するには、プロファイルを使用します。`--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>
```