---
title: Central Config API Authentication
slug: neurons-for-itsm/on-premises-help/enu/2022/central-config-api-authentication
createdAt: 2026-07-30T04:08:22.489Z
---

APIs in the Central Config can be accessed only by known users by authenticating the API call. The API Header will pass the API Key which will be authenticated and passed by the Central Config server. This prevents un-authorised users from accessing the APIs.

## Install/upgrade Ivanti Service Manager System Configuration Wizard

On installing or upgrading the Service Manager System Configuration Wizard, the API Key is auto-generated in the Central Config DB. This key is used to to authenticate the API calls to the Central Config Server. However, the following should be monitored while installing/upgrading.

::::ExpandableHeading
## Verify the webconfig file

Once the installation/upgradation is complete, verify the webconfig file has the following:

- In the config section:

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

- In the new protected section:

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

:::ExpandableHeading
## Update for Teams Bot Service

If you have installed Teams Bot Service, update the **CentralConfigApiKey** value in **appsetting** file. from C:\inetpub\TeamBotService/appsettings.json. Get the **CentralConfigApiKey** from th&#x65;**&#x20;Central Config DB table (Frs\_data\_api\_key)**.
:::

:::ExpandableHeading
## Updates if Service Manager System Configuration Wizard and Service Manager Reporting Wizard are installed on different machines

If the Service Manager System Configuration Wizard and Service Manager Reporting Wizard are installed on different machines, update the Centralconfig api key when installing the Reporting Wizard as shown in the below image. Get the **CentralConfigApiKey** from the **Central Config DB table (Frs\_data\_api\_key)**.

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

::::ExpandableHeading
## Updating the CentralConfigAPIKey

In case you wish to update/change the **CentralConfigAPIKey**, do so by following the below steps:

1.Stop all services that are referencing the centralconfig.

2\. Log in to Service Manager with Admin credentials and open the Configuration console.

3.Select **Security Controls** > **CentralCofigAPIKeyGroup** and note down the description .

4.Delete the existing **CentralConfigAPIKey** and recreate a new key inside the **CentralConfigAPiKeyGroup** as shown in the below image.

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

5.Once the Key is created in the CentralConfig tenants, re-run the System Configuration Wizard to update the **webconfig** and **appconfig** files.

6.Restart your machine.

:::hint{type="info"}
The CentralConfigAPIKey should be unique, duplicate/multiple keys will break the feature.
:::
::::

## Disabling the Centralconfig API Key Feature

1.Log in to the application with Admin credentials and open the Configuration console.

2.Select **Security Controls** > **API Key** and delete the **CentralConfigAPIKey**.

:::hint{type="info"}
Ensure you **Delete** and not **De-activate** to disable.
:::

## Impacted webconfig file list:

| AppDomains         | Configiration Files                                                                                  |
| ------------------ | ---------------------------------------------------------------------------------------------------- |
| AppServer          | Web.config                                                                                           |
| WorkFlow           | WorkflowService.exe.config                                                                           |
| Excalation         | EscalationService.exe.config                                                                         |
| email              | EmailWindowsServiceapp.exe.config                                                                    |
| bulkupload         | KMBulkUploadTool.exe.config                                                                          |
| integrationserver  | IntegrationServiceHost.exe.config                                                                    |
| systemconfigwizard | ServerConfigurationWizard.exe.config                                                                 |
| release tool       | ReleaseTool.exe.config                                                                               |
| Frsloggingservice  | FRSLoggingService.exe.config                                                                         |
| metric             | HEAT.MetricsServer.exe.config                                                                        |
| message queue      | MessageQueueServiceHost.exe.config                                                                   |
| License service    | LicenseServerWindowsService.exe.config                                                               |
| report provinising | reportserver\ReportProvisioning.exe.config                                                           |
| Neurons            | appsettings                                                                                          |
| Teams Bot Service  | appsettings                                                                                          |
| DynamicWebServices | web.config                                                                                           |
| OpsConsole         | web.config                                                                                           |
| FrsSurvey          | web.config                                                                                           |
| FrsSurveyProxy     | web.config                                                                                           |
| IM                 | IMServer\IMServices\AssetProcessor\Web.config                                                        |
| IM                 | IMServer\IMServices\DiscoProcessor\Web.config                                                        |
| IM                 | IMServer\IMServices\DiscoUtils\Web.config                                                            |
| IM                 | IMServer\IMServices\IMReadOnlyDataService\Web.config                                                 |
| IM                 | IMServer\IMServices\TaskProcessor\Web.config                                                         |
| IM                 | IMServer\WebServices\ClientTransportProcessor\Web.config                                             |
| reports            | C:\Program Files\Microsoft SQL Server\MSRS12.MSSQLSERVER\Reporting Services \ReportServer\Web.config |

## Custom Installation of SCW

When customers try to install the Configuration Server in one machine and other components in another machine, user has to copy the Central Config API Key from Configuration Server and update the key in the **Central Configuration Settings** page as show in the following image.

*Sample image of Custom Installation of SCW*

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

