---
title: 中央構成API認証
slug: neurons-for-itsm/on-premises-help/jpn/2025/api
createdAt: 2026-07-29T17:06:42.135Z
---

Central Config 内の API には、API 呼び出しを認証することで既知のユーザーのみがアクセスできます。 API ヘッダーは、Central Config サーバーによって認証され渡される API キーを渡します。 これにより、権限のないユーザーが API にアクセスできなくなります。

## Ivanti Service Manager システム構成ウィザードのインストール/アップグレード

Service Manager システム構成ウィザードをインストールまたはアップグレードすると、API キーが Central Config DB に自動生成されます。 このキーは、中央構成サーバーへの API 呼び出しを認証するために使用されます。 ただし、インストール/アップグレード中は次の点に注意する必要があります。

::::ExpandableHeading
## webconfigファイルを確認する

インストール/アップグレードが完了したら、webconfig ファイルに次の内容が含まれていることを確認します。

- 構成セクションでは:

:::Paragraph{indent="1"}
\<section name="CentralConfigApiKey" type="System.Configuration.NameValueSectionHandler" />
:::

- 新しい保護されたセクションでは、次のようになります。

:::Paragraph{indent="1"}
\<CentralConfigApiKey> \<add key="CentralConfigApiKey" value="" /> \</CentralConfigApiKey>
:::
::::

:::ExpandableHeading
## appsettings.jsonファイルを確認する

インストール/アップグレードが完了したら、appsettings.json ファイルに次の内容が含まれていることを確認します。

"central-config-api-key": "CAEFXXXX8C847D5XXXX698D8XXXXXX"
:::

:::ExpandableHeading
## Teams ボット サービスの更新

Teams Bot Service をインストールしている場合は、 **appsetting** ファイル内の CentralConfigApiKey 値を更新します。 C:\\\inetpub\\\TeamBotService/appsettings.json から。 Central Config DB テーブル (Frsdataapikey) から CentralConfigApiKeyを取得します。
:::

:::ExpandableHeading
## Service Manager システム構成ウィザードと Service Manager レポート ウィザードが異なるマシンにインストールされている場合の更新

Service Manager システム構成ウィザードと Service Manager レポート ウィザードが異なるマシンにインストールされている場合は、次の図に示すように、レポート ウィザードをインストールするときに Centralconfig API キーを更新します。 Central Config DB テーブル (Frsdataapikey) から CentralConfigApiKeyを取得します。

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/dGGWHYxpjMJHbWdSBZ4QG_scwandreportingupdate.png" position="flex-start" size="45" width="451" height="205" initialPath="Config_Images/SCWAndReportingUpdate.png" githubPath="ITSM-On-Prem-Help/Content/ConfigDB_Guide/Config_Images/SCWAndReportingUpdate.png" showCaption="false"}
:::

::::ExpandableHeading
## CentralConfigAPIKeyの更新

CentralConfigAPIKeyを更新/変更する場合は、以下の手順に従ってください。

1. centralconfig を参照しているすべてのサービスを停止します。
2. 管理者の資格情報を使用して Service Manager にログインし、構成コンソールを開きます。
3. セキュリティ コントロール > CentralCofigAPIKeyGroup を選択し、説明を書き留めます。
4. 既存の CentralConfigAPIKey を削除し、下の画像に示すように、 CentralConfigAPiKeyGroup 内に新しいキーを再作成します。

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/gh-QQPTi11-uJnUpbgDOM_createnewapikey.png" position="flex-start" size="57" width="571" height="228" initialPath="Config_Images/CreateNewAPIKey.png" githubPath="ITSM-On-Prem-Help/Content/ConfigDB_Guide/Config_Images/CreateNewAPIKey.png" showCaption="false" indent="1"}

5. CentralConfig テナントにキーが作成されたら、システム構成ウィザードを再実行して、 webconfig ファイルと appconfig ファイルを更新します。
6. マシンを再起動します。

:::hint{type="info"}
CentralConfigAPIKey は一意である必要があります。重複したキーや複数のキーがあると機能が動作しなくなります。
:::
::::

## Centralconfig API キー機能を無効にする

インストール/アップグレードが完了したら、centralConfig appsettings.json ファイルに次のプロパティがあることを確認します: “DisableApiKeyValidation”:”false” これを “True” に変更して、“DisableApiKeyValidation”:”true” とする必要があります。

1. 管理者の資格情報を使用してアプリケーションにログインし、構成コンソールを開きます。
2. **セキュリティ コントロール&#x20;**> **API キー**を選択し、 **CentralConfigAPIKey**を削除します。

:::hint{type="info"}
無効にするには、 **「** 削除」し、「 **「非アクティブ化」」しないことを確認し**てください。
:::

:::ExpandableHeading
## 影響を受ける webconfig ファイルのリスト:

| アプリドメイン           | 設定ファイル                                                                                                          |
| ----------------- | --------------------------------------------------------------------------------------------------------------- |
| アプリケーションサーバー      | ウェブ.config                                                                                                      |
| ワークフロー            | ワークフローサービス.exe.config                                                                                           |
| エスカレーション          | EscalationService.exe.config                                                                                    |
| メール               | EmailWindowsServiceapp.exe.config                                                                               |
| 一括アップロード          | KMBulkUploadTool.exe.config                                                                                     |
| 統合サーバー            | 統合サービスホスト.exe.config                                                                                            |
| システム構成ウィザード       | ServerConfigurationWizard.exe.config                                                                            |
| リリースツール           | リリースツール.exe.config                                                                                              |
| Frsloggingservice | FRSLoggingService.exe.config                                                                                    |
| メトリック             | HEAT.MetricsServer.exe.config                                                                                   |
| メッセージキュー          | メッセージキューサービスホスト.exe.config                                                                                      |
| ライセンスサービス         | LicenseServerWindowsService.exe.config                                                                          |
| レポートのプロビジョニング     | レポートサーバー\\\ReportProvisioning.exe.config                                                                        |
| Neurons           | アプリ設定                                                                                                           |
| Teams ボット サービス    | アプリ設定                                                                                                           |
| ダイナミックWebサービス     | ウェブ構成                                                                                                           |
| オペレーションコンソール      | ウェブ構成                                                                                                           |
| FrsSurvey         | ウェブ構成                                                                                                           |
| FrsSurveyProxy    | ウェブ構成                                                                                                           |
| 私は                | IMServer\\\IMServices\\\AssetProcessor\\\Web.config                                                             |
| 私は                | IMServer\\\IMServices\\\DiscoProcessor\\\Web.config                                                             |
| 私は                | IMServer\\\IMServices\\\DiscoUtils\\\Web.config                                                                 |
| 私は                | IMServer\\\IMServices\\\IMReadOnlyDataService\\\Web.config                                                      |
| 私は                | IMServer\\\IMServices\\\TaskProcessor\\\Web.config                                                              |
| 私は                | IMServer\\\WebServices\\\ClientTransportProcessor\\\Web.config                                                  |
| レポート              | C:\\\Program Files\\\Microsoft SQL Server\\\MSRS12.MSSQLSERVER\\\Reporting Services\\\ReportServer\\\Web.config |
:::

:::ExpandableHeading
## appdomain の影響を受ける appsettings.json ファイル

| アプリケーションドメイン          |
| --------------------- |
| CCF                   |
| アプリケーションサーバー          |
| メールサービス               |
| EscalationService     |
| FRSSurvey             |
| FRSSurveyProxy        |
| 受信Webサービス             |
| 統合サーバー                |
| KMインポートツール            |
| ライセンスマネージャ            |
| ロギングサービス              |
| メッセージキュー              |
| メトリクスサーバー             |
| オペレーションコンソール          |
| リリースツール               |
| システム構成ウィザード           |
| ワークフローサービス            |
| レポートサーバー              |
| IMサーバー - IMサービス       |
| アセットプロセッサ             |
| ディスコプロセッサ             |
| ディスコユーティリティ           |
| IM読み取り専用データサービス       |
| Ivantiクラウドデータプロセッサ    |
| TaskProcessor         |
| Web サービス - AgentTaskW |
:::

## SCWのカスタムインストール

顧客が 1 台のマシンに構成サーバーをインストールし、別のマシンに他のコンポーネントをインストールしようとする場合、ユーザーは構成サーバーから Central Config API キーをコピーし、次の図に示すように、 **Central Configuration Settings** ページでキーを更新する必要があります。

*SCWのカスタムインストールのサンプル画像*

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/OtKyN1GcJMCRCEuT4IPpW_custominstallationofscw.png" position="flex-start" size="62" width="624" height="435" initialPath="Config_Images/CustomInstallationOfSCW.png" githubPath="ITSM-On-Prem-Help/Content/ConfigDB_Guide/Config_Images/CustomInstallationOfSCW.png" showCaption="false"}
