---
title: "Applicationの作成"
slug: "post-application"
tags: ["Ncloud Single Sign-On"]
updated: 2026-09-17T09:58:00Z
published: 2026-09-17T09:58:00Z
canonical: "api.ncloud-docs.com/post-application"
---

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

# Applicationの作成

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

Applicationを作成します。

## リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

| メソッド | URI |
| --- | --- |
| POST | /api/v1/applications |

### リクエストヘッダ

Ncloud Single Sign-On APIで共通して使用されるヘッダの詳細は、[Ncloud Single Sign-Onのリクエストヘッダ](/docs/ja/single-sign-on-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

### リクエストボディ

リクエストボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `name` | String | Required | Application名 - 英数字、記号の「.」、「-」、「_」を組み合わせて2~100文字以内で入力 - 先頭文字は英字のみ使用 |
| `description` | String | Optional | Applicationの説明 - 0~500文字 |
| `applicationUrl` | String | Optional | Application URL |
| `applicationType` | String | Optional | Applicationタイプ - `web` (デフォルト) \| `app` - `web`: ウェブ - `app`: アプリ |
| `mbrLoginAllow` | String | Required | メインアカウントでログインできるかどうか - `ALLOW` \| `DENY` - `ALLOW`: 許可 - `DENY`: 拒否 |
| `redirectUris` | Array | Required | Applicationリダイレクト URIリスト - 1~50個以内で入力 - OAuth 2.0 |
| `postLogoutRedirectUris` | Array | Optional | Single Logout(SLO)リクエストの完了後、ユーザーが移動する URIリスト - 最大50個入力可能 - https URIのみ許可 (localhostなどの loopbackは httpを許可) - OAuth 2.0 |
| `clientAuthMethod` | String | Required | Applicationの認証方法 - `client_secret_basic` \| `client_secret_post` \| `none` - `client_secret_basic`: Client認証情報を HTTP Basic認証ヘッダで渡す - `client_secret_post`: Client IDと Secretを POSTリクエスト本文に含める - `none`: 認証しない - `accessType`が`confidential`の場合、`client_secret_basic`または`client_secret_post`を入力可能 - `accessType`が`public`の場合、`none`のみ入力可能 - OAuth 2.0 |
| `accessType` | String | Required | Applicationアクセス方法 - `confidential` \| `public` - `confidential`: Client IDと Secretで認証してアクセス - `public`: Client IDで認証してアクセス - OAuth 2.0 |
| `grantTypes` | Array | Required | 権限付与方法 - `authorization_code` \| `refresh_token` \| `implicit` - `authorization_code`: 独自作成した Authorization codeで Access Tokenを発行 - `refresh_token`: Access Tokenの期限切れ後、再ログインせずに Access Tokenを新規発行 - `implicit`: Authorization Codeなしで直接 Access Tokenを発行。認証情報を安全に保存するのが困難な Client環境に最適化 - `authorization_code`、`implicit`のうち、いずれか1つは必ず含める - OAuth 2.0 |
| `scopes` | Array | Required | Applicationのアクセス可能な情報の範囲 - `profile` \| `openid` \| `groups` \| `email` - `profile`: アカウント区分、ログイン ID、会員の固有 ID、ユーザー名 - `openid`: アカウント区分、ログイン ID、会員の固有 ID、ユーザー名 - `groups`: アカウント区分、ログイン ID、会員の固有 ID、ユーザー名、グループ - `email`: アカウント区分、ログイン ID、会員の固有 ID、ユーザー名、メール - `profile`、`openid`のうち、いずれか1つは必ず含める - OAuth 2.0 |
| `accessTokenValidity` | Number | Optional | Access Tokenの有効期間(秒) - 43200 (デフォルト) - OAuth 2.0 |
| `refreshTokenValidity` | Number | Optional | Refresh Tokenの有効期間(秒) - 2592000 (デフォルト) - OAuth 2.0 |
| `consentPage` | Object | Required | 個人情報提供同意ページ情報 |
| `consentPage.applicationName` | Object | Required | 提供を受ける者情報 |
| `consentPage.applicationName.ko` | String | Required | 提供を受ける者(韓国語) |
| `consentPage.applicationName.en` | String | Required | 提供を受ける者(英語) |
| `consentPage.applicationName.ja` | String | Required | 提供を受ける者(日本語) |
| `consentPage.useLanguages` | Array | Required | 使用言語 - `ko` \| `en` \| `ja` - `ko`: 韓国語 - `en`: 英語 - `ja`: 日本語 |
| `consentPage.defaultLanguage` | String | Required | デフォルト言語 - `ko` \| `en` \| `ja` - `ko`: 韓国語 - `en`: 英語 - `ja`: 日本語 |
| `consentPage.usePurposeDesc` | Object | Required | 利用目的情報 |
| `consentPage.usePurposeDesc.ko` | String | Required | 利用目的(韓国語) |
| `consentPage.usePurposeDesc.en` | String | Required | 利用目的(英語) |
| `consentPage.usePurposeDesc.ja` | String | Required | 利用目的(日本語) |
| `consentPage.usePeriodDesc` | Object | Required | 保有・利用期間情報 |
| `consentPage.usePeriodDesc.ko` | String | Required | 保有・利用期間(韓国語) |
| `consentPage.usePeriodDesc.en` | String | Required | 保有・利用期間(英語) |
| `consentPage.usePeriodDesc.ja` | String | Required | 保有・利用期間(日本語) |
| `consentPage.dataTransferAbroad` | Boolean | Required | 個人情報の海外移転 - `true` \| `false` - `true`: 移転 - `false`: 移転しない |
| `consentPage.dataTransferCountry` | Object | Conditional | 移転先の国情報 - `dataTransferAbroad`が`true`の場合、必ず入力 |
| `consentPage.dataTransferCountry.ko` | String | Conditional | 移転先の国(韓国語) |
| `consentPage.dataTransferCountry.en` | String | Conditional | 移転先の国(英語) |
| `consentPage.dataTransferCountry.ja` | String | Conditional | 移転先の国(日本語) |
| `consentPage.dataRecipients` | Object | Conditional | 移転を受ける者情報 - `dataTransferAbroad`が`true`の場合、必ず入力 |
| `consentPage.dataRecipients.ko` | String | Conditional | 移転を受ける法人名(韓国語) |
| `consentPage.dataRecipients.en` | String | Conditional | 移転を受ける法人名(英語) |
| `consentPage.dataRecipients.ja` | String | Conditional | 移転を受ける法人名(日本語) |
| `consentPage.dataRecipientsContact` | Object | Conditional | 移転を受ける者の連絡先情報 - `dataTransferAbroad`が`true`の場合、必ず入力 |
| `consentPage.dataRecipientsContact.ko` | String | Conditional | 移転を受ける法人の個人情報管理者の連絡先(韓国語) |
| `consentPage.dataRecipientsContact.en` | String | Conditional | 移転を受ける法人の個人情報管理者の連絡先(英語) |
| `consentPage.dataRecipientsContact.ja` | String | Conditional | 移転を受ける法人の個人情報管理者の連絡先(日本語) |
| `protocol` | String | Required | Applicationプロトコル - `OAUTH2`: OAuth 2.0 (有効値) |
| `tags` | Object | Optional | ポリシーのタグ - リソースごとに最大20個 - `{tagKey}:{tagValue}`形式で入力 - tagKey: 英数字、記号の「*」、「.」、「/」、「=」、「+」、「-」、「@」を組み合わせて128文字以内で入力* - tagValue: 英数字、記号の「」、「.」、「/」、「=」、「+」、「-」、「@」を組み合わせて256文字以内で入力 |

### リクエスト例

リクエストのサンプルコードは次の通りです。

```
curl --location --request POST 'https://sso.apigw.ntruss.com/api/v1/groups/12cfbd94-****-****-****-2ff725201395' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--data '{
    "name" : "application000",
    "description" : "aplication000 description",
    "applicationUrl" : "http://****.com",
    "applicationType" : "web",
    "mbrLoginAllow" : "ALLOW",
    "redirectUris" : [
        "http://****.com"
    ],
    "postLogoutRedirectUris" : [
        "https://****.com"
    ],
    "clientAuthMethod" : "client_secret_basic",
    "accessType" : "confidential",
    "grantTypes" : [
        "authorization_code",
        "refresh_token"
    ],
    "scopes" : [
        "profile"
    ],
    "accessTokenValidity" : 43200,
    "refreshTokenValidity" : 2592000,
    "consentPage" : {
        "applicationName" : {
            "ko" : "네이버 클라우드 플랫폼"
        },
        "useLanguages" : [
            "ko"
        ],
        "defaultLanguage" : "ko",
        "usePurposeDesc" : {
            "ko" : "로그인"
        },
        "usePeriodDesc" : {
            "ko" : "365일"
        },
        "dataTransferAbroad" : true,
        "dataTransferCountry" : {
            "ko" : "국가 이름"
        },
        "dataRecipients" : {
            "ko" : "네이버 클라우드 플랫폼"
        },
        "dataRecipientsContact" : {
            "ko" : "******@ncloud.com"
        }
    },
    "protocol" : "OAUTH2",
    "tags": {
        "tagKey1": "tagValue1",
        "team": "a"
    }
}'
```

## レスポンス

レスポンス形式を説明します。

### レスポンスボディ

レスポンスボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `applicationId` | String | - | Application ID |
| `oauth2` | Object | - | OAuth 2.0情報 |
| `oauth2.clientId` | String | - | 作成された OAuth Client ID |
| `oauth2.secret` | String | - | 作成された OAuth Client Secret |
| `protocol` | String | - | Applicationプロトコル - `OAUTH2`: OAuth 2.0 |

### レスポンスステータスコード

Ncloud Single Sign-On APIで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud Single Sign-Onのレスポンスステータスコード](/docs/ja/single-sign-on-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

### レスポンス例

レスポンスのサンプルコードは次の通りです。

```
{
    "applicationId": "b1bbb54f-****-****-****-6dfdf7fb94a6",
    "oauth2": {
        "clientId": "b1bbb54f-****-****-****-6dfdf7fb94a6",
        "clientSecret": "d1517905-****-****-****-3b3010784920"
    },
    "protocol": "OAUTH2"
}
```