---
title: "Configure a tenant with the Tenant Service"
slug: "configure-a-tenant-with-the-tenant-service"
abstract: "How to create or upgrade a tenant with the Tenant Service functionality in Sitecore Data Exchange Framework."
---
# Configure a tenant with the Tenant Service

This topic describes how you configure a tenant with the Tenant Service (TS) on a Sitecore server.

> [!note]
> To enable the TS feature on a Sitecore server, you do not have to create a new tenant. You can extend an existing tenant with TS features by following points 5-9 in the following procedure.

To create a tenant with TS:

1. In the content tree, navigate to */sitecore/system/Data Exchange*.

    ![Data Exchange in the content tree](<https://doc.sitecore.com/api/markdown-image/xp/en/developers/def/60/data-exchange-framework/images/data%20exchange%20in%20content%20tree.png>)

2. Create an **Empty Data Exchange tenant** using the **Insert** option.

    > [!note]
    > You can also extend an already created tenant with the Tenant Service feature.

3. Right-click the menu ribbon, and verify that the **Data Exchange SDK** ribbon tab is enabled.

    ![Data Exchange SDK in the menu selection ribbon](<https://doc.sitecore.com/api/markdown-image/xp/en/developers/def/60/data-exchange-framework/images/enable%20data%20exchange%20sdk%20in%20menu%20ribbon.png>)

4. Select the newly created tenant item.

    ![New tenant item in the content tree](<https://doc.sitecore.com/api/markdown-image/xp/en/developers/def/60/data-exchange-framework/images/tenant%20branch%20in%20content%20tree.jpg>)

5. On the **Data Exchange SDK** ribbon, click **Upgrade Tenant**.

    ![The Upgrade Tenant button](<https://doc.sitecore.com/api/markdown-image/xp/en/developers/def/60/data-exchange-framework/images/upgrade%20tenant%20button.png>)

6. In the **Upgrade Tenant** dialog, in the **Instruction set** drop-down menu, select **Tenant Service**.

    ![The Upgrade Tenant dialog](<https://doc.sitecore.com/api/markdown-image/xp/en/developers/def/60/data-exchange-framework/images/upgrade%20tenant%20service%20dialog.jpg>)

7. Click **Next**.
8. Click **Start Upgrade**.
9. You can confirm the tenant was upgraded by finding the **Tenant Service Endpoints** and **Tenant Service Settings** items under the upgraded tenant.

    ![Confirming that a tenant is upgraded with the Tenant Service](<https://doc.sitecore.com/api/markdown-image/xp/en/developers/def/60/data-exchange-framework/images/upgraded%20tenant%20service%20options%20in%20content%20tree.jpg>)

10. On the server, navigate to the root folder of the Sitecore installation, open the `web.config` file, and add the following `httpProtocol` to the `system.webServer` node:

    ```xml
    <system.webServer>
        ...
        <httpProtocol>
            <customHeaders>
                <add name="Access-Control-Allow-Origin" value="http://<tenant.service.hostname>"/>
                <add name="Access-Control-Allow-Headers" value="*" />
                <add name="Access-Control-Allow-Methods" value="*" />
            </customHeaders>
        </httpProtocol>
        ...
    </system.webServer>
    ```

    > [!note]
    > In the example, replace `<tenant.service.hostname>` with the actual hostname of your Tenant Service, for example, `my-sitecore.service`.