Configure a tenant with the Tenant Service

Version: 8.0

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
  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
  4. Select the newly created tenant item.

    New tenant item in the content tree
  5. On the Data Exchange SDK ribbon, click Upgrade Tenant.

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

    The Upgrade Tenant dialog
  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
  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:

    RequestResponse
    <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.

Do you have some feedback for us?

If you have suggestions for improving this article,