---
title: REST APIキーの使用
slug: neurons-for-itsm/admin-user-help/jpn/latest/rest-api
createdAt: 2026-10-29T01:28:25.045Z
---

テナント用に作成された REST API キーは、REST API エンドポイントの承認に使用されます。 これらのキーは静的であり、セッション ID とは異なり、変更されたり期限切れになったりすることはありません。

## REST API キーグループの作成

:::hint{type="info"}
この機能を初めて使用する場合、REST API のグループを作成する必要があります。 すでに存在する場合は、この手順をスキップして、 [REST API キー](docId:8ETXcKtaJjOL4N5meDNli)の作成に進むことができます。
:::

1. 構成コンソールから、\[ **構成** ] > \[ **セキュリティ コントロール** ] > \[ **API キー**] を選択します。
2. キ**ーグループの追加を**クリックします。 アプリケーションは、「 **新しい API グループ** 」ページを表示します。
3. 名**前&#x20;**&#x304A;よび 説**明&#x20;**&#x30D5;ィールドに、グループのコンテキスト名と説明を入力します。
4. キ**ー グループの保存を**クリックします。 REST API グループが作成されます。
5. 「 **戻る** 」をクリックして、「 **API キー** 」ページに戻ります。

## REST API キーの作成

1. 構成コンソールから、\[ **構成** ] > \[ **セキュリティ コントロール** ] > \[ **API キー**] を選択します。
2. キ**ー グループ&#x20;**&#x30BB;クションから、REST API 用に作成された関連グループを選択します。

:::Paragraph{indent="1"}
*REST API グループ*
:::

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/eD4IjOvwsSoiDRTI413_i_selectingrestapikeygroup.png" position="flex-start" size="100" width="785" height="448" initialPath="../../Resources/Images/RESTAPI/SelectingRESTAPIKeyGroup.png" githubPath="Admin-User-Jpn/Content/Resources/Images/RESTAPI/SelectingRESTAPIKeyGroup.png" showCaption="false" indent="1"}

3. A**PI キーの追加を**クリックします。 アプリケーションは、「 **新しい API キー** 」ページを表示します。
4. フィールドに情報を入力します:
   - **参照 ID** - このフィールドは自動生成されます。 この ID は、エンドポイント認証に使用する必要がある REST API キーです。
   - **アクティブ化** - キーをアクティブ化または非アクティブ化するには、チェックボックスを選択または選択解除します。
   - **説明** - キーの説明を入力します。
   - **代理** - キーを作成するユーザーの名前を選択します。
   - **ロール** - キーを作成するユーザーのロールを選択します。
5. デフォルトでは、作成された REST API キーはログインしたテナントに適用されます。 ただし、このキーに追加の IP を追加できます。 これを行うには、「 **新しい IP の追加**」をクリックし、IP アドレスを入力して、「 **OK**」をクリックします。
6. キ**ーを保存を**クリックします。 生成された REST API キーは、入力した詳細とともに保存されます。
7. 「 **戻る** 」をクリックして、「 **API キー** 」ページに戻ります。

## REST API キーの編集

1. 構成コンソールから、\[ **構成** ] > \[ **セキュリティ コントロール** ] > \[ **API キー**] を選択します。
2. キ**ー グループ&#x20;**&#x30BB;クションから REST API の関連グループを選択します。 アプリケーションは使用可能なキーのリストを表示します。
3. キーを見つけて、\[ **編集**] をクリックします。
4. 必要に応じて詳細を変更し、「 **キーを保存**」をクリックします。

## REST API キーの削除

1. 構成コンソールから、\[ **構成** ] > \[ **セキュリティ コントロール** ] > \[ **API キー**] を選択します。
2. キ**ー グループ&#x20;**&#x30BB;クションから REST API の関連グループを選択します。 アプリケーションは使用可能なキーのリストを表示します。
3. キーを見つけて、\[ **削除**] をクリックします。

## REST APIキーの使用

エンドポイントを実行するときに REST API キーを認証として使用するには:

1. P**ostman&#x20;**&#x30A2;プリケーションで新しいリクエストを作成します。
2. ヘ**ッダー&#x20;**&#x30BF;ブに次の情報を入力します。
   - 認**証&#x20;**&#x30C1;ェックボックスをオンにします。
   - テナントに対して生成された参照 ID (REST API キー) を、 **値** 列に、 `restapikey={参照 ID}`の形式で入力します。
3. 同じエンドポイント要求ウィンドウで、エンドポイント要求ペイロードの詳細を入力し、「 **送信** 」ボタンをクリックするか、ENTER キーを押します。

:::hint{type="info"}
テナントから REST API を実行する場合、同じテナントに対して生成された REST API キーのみ使用でき、他のテナントの REST API キーは使用できません。 たとえば、テナント用に生成されたREST APIキー
:::

## REST API キーのトラブルシューティング

REST API エンドポイントを実行すると、権限がないというエラーが発生します。

### 理由：

エンドポイントを承認するために使用される REST API キーは、このテナント/IP に属していません。

### 解決：

このテナント/IP の新しい REST API キーを作成します。 R[EST API キーの作成を](docId:8ETXcKtaJjOL4N5meDNli)参照してください。
