> ## Documentation Index
> Fetch the complete documentation index at: https://syteca.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the Data Connector

> Install the Syteca API Data Connector on a Windows host — system requirements (IIS, .NET 8.0, Syteca Application Server 7.14+), MSI installation with version compatibility matrix, and the three-step IIS self-signed certificate setup.

The Data Connector is a standalone IIS application — installed via MSI on a Windows host that has access to the Syteca Application Server. Four steps in order: confirm prerequisites, install the MSI, set up an HTTPS certificate, then [register the Data Connector in the Management Tool](/docs/api/data-connector/manage).

<Warning>
  **NOT AVAILABLE IN SAAS.** This procedure applies to **on-premises** deployments only.
</Warning>

## 1. System requirements

| Requirement                   | Supported / required                                                                                                                                                                           |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Operating system**          | Windows Server 2022 or 2019 **(recommended)**, Windows Server 2019 Core, 2016, 2012, or Windows 10. Both x86 and x64 supported.                                                                |
| **IIS**                       | 7.5 or higher                                                                                                                                                                                  |
| **.NET runtime**              | [ASP.NET Core 8.0 Runtime (v8.0.4) — Windows Hosting Bundle](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-8.0.4-windows-hosting-bundle-installer) or higher |
| **Syteca Application Server** | Version **7.14 or higher**                                                                                                                                                                     |

For turning on IIS and configuring its features, see [Management Tool installation prerequisites](/docs/administration/deployment/management-tool-prerequisites) — the IIS configuration is identical.

## 2. Install the Data Connector

The Data Connector ships as an **MSI installer**. Pick the version matching your Application Server:

<Note>
  **Use the version compatibility matrix below.** Mismatched versions can fail to register or return unexpected data. The Data Connector version must match the Application Server build range exactly.
</Note>

| Data Connector version | Compatible Application Server build | Download                                                                                                |
| ---------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------- |
| 1.10                   | 7.22.221                            | [Syteca-DataConnector\_v.1.10.zip](https://download.syteca.com/Syteca-DataConnector_v.1.10.zip)         |
| 1.9                    | 7.18.235 – 7.21.1019                | [Syteca-DataConnector\_v.1.9.zip](https://download.syteca.com/Syteca-DataConnector_v.1.9.zip)           |
| 1.8                    | 7.14.36 – 7.17.685                  | [EkranSystem-DataConnector\_v.1.8.zip](https://download.syteca.com/EkranSystem-DataConnector_v.1.8.zip) |
| 1.7                    | 7.14.36 – 7.17.685                  | [EkranSystem-DataConnector\_v.1.7.zip](https://download.syteca.com/EkranSystem-DataConnector_v.1.7.zip) |
| 1.6                    | 7.9.58 – 7.13.39                    | [EkranSystem-DataConnector\_v.1.6.zip](https://download.syteca.com/EkranSystem-DataConnector_v.1.6.zip) |
| 1.5                    | 7.4.68 – 7.8.236                    | [EkranSystem-DataConnector\_v.1.5.zip](https://download.syteca.com/EkranSystem-DataConnector_v.1.5.zip) |
| 1.4                    | 7.1.1143 – 7.3.35                   | [EkranSystem-DataConnector\_v.1.4.zip](https://download.syteca.com/EkranSystem-DataConnector_v.1.4.zip) |
| 1.3                    | 7.0.45 – 7.0.51                     | [EkranSystem-DataConnector\_v.1.3.zip](https://download.syteca.com/EkranSystem-DataConnector_v.1.3.zip) |
| 1.2 (1.0.107)          | 6.63.1 – 7.0.40                     | [EkranSystem-DataConnector\_v.1.2.zip](https://download.syteca.com/EkranSystem-DataConnector_v.1.2.zip) |
| 1.1 (1.0.93)           | 6.58.1 – 6.62.5                     | [EkranSystem-DataConnector\_v.1.1.zip](https://download.syteca.com/EkranSystem-DataConnector_v.1.1.zip) |

<Note>
  Versions **1.9 and higher** use current Syteca branding (`Syteca-DataConnector_v.1.X.zip`). Versions **1.8 and earlier** retain the legacy filename `EkranSystem-DataConnector_v.1.X.zip` — preserve these exactly when scripting installation across mixed environments.
</Note>

<Steps>
  <Step title="Download the MSI">
    Click the appropriate download link in the table above for your Application Server version. Extract the `.zip` file to get the `.msi` installer.
  </Step>

  <Step title="Run the installer">
    Double-click the `.msi` file to open the installation wizard. Follow the wizard prompts — defaults are appropriate for most deployments.
  </Step>

  <Step title="Verify installation">
    After installation completes, the Data Connector is installed as an IIS application. Continue to certificate setup before sending API requests.
  </Step>
</Steps>

## 3. Set up an HTTPS certificate

The Data Connector serves the API over **HTTPS**. Before you can call the API, IIS needs a certificate — production deployments should use a certificate from your organizational PKI, but for development or testing, IIS can generate a self-signed certificate. The three-step setup: generate the certificate in IIS Manager, export it as a `.pfx` file, import it into the Trusted Root Certification Authorities on every machine that will call the API.

<Tabs>
  <Tab title="A. Generate a self-signed certificate">
    <Steps>
      <Step title="Open IIS Manager">
        Open **Internet Information Services (IIS) Manager**.
      </Step>

      <Step title="Open Server Certificates">
        In the **Connections** tree-view, select the main node. Double-click the **Server Certificates** icon in the **IIS** section.
      </Step>

      <Step title="Click Create Self-Signed Certificate">
        In the **Actions** pane on the right, click **Create Self-Signed Certificate**.
      </Step>

      <Step title="Name the certificate">
        In the **Create Self-Signed Certificate** window:

        * Enter a name in the **Specify a friendly name for the certificate** field.
        * Select **Personal** in the **Select a certificate store for the new certificate** drop-down.

        Click **OK**.
      </Step>
    </Steps>
  </Tab>

  <Tab title="B. Export the certificate">
    <Steps>
      <Step title="Select the certificate">
        In IIS Manager, on the **Server Certificates** pane, select the certificate you just generated.
      </Step>

      <Step title="Click Export">
        Click **Export** in the **Actions** pane (or right-click the certificate and select **Export** from the context menu).
      </Step>

      <Step title="Save the .pfx file">
        In the **Export Certificate** window, define a location and password for the certificate, then click **OK**.

        <Warning>
          Save the password somewhere safe — you'll need it during the import step on every machine that will call the API.
        </Warning>
      </Step>
    </Steps>
  </Tab>

  <Tab title="C. Add to Trusted Root Authorities">
    Repeat these steps **on every machine that will call the Data Connector API** — including the Data Connector host itself if you'll test from there.

    <Steps>
      <Step title="Open MMC">
        Press **Windows + R**, enter `mmc`, and click **Enter**. Click **Yes** in the User Account Control prompt.
      </Step>

      <Step title="Add the Certificates snap-in">
        In the **Console** window: **File → Add/Remove Snap-in → Certificates → Add → Computer account → Next → Local computer → Finish → OK**.
      </Step>

      <Step title="Find Trusted Root Certification Authorities">
        Expand **Certificates (Local Computer)** in the tree-view. Find the **Trusted Root Certification Authorities** node.
      </Step>

      <Step title="Import the certificate">
        Right-click **Trusted Root Certification Authorities**, then select **All Tasks → Import** from the context menu. The **Certificate Import Wizard** opens.

        On the **File to Import** page, click **Browse** to find the `.pfx` certificate. Click **Next**.
      </Step>

      <Step title="Enter the password">
        On the **Private key protection** page, enter the certificate password (the one you set during export). Click **Next**.
      </Step>

      <Step title="Pick the certificate store">
        On the **Certificate Store** page, click **Next** (the default store is correct).
      </Step>

      <Step title="Finish">
        On the **Completing the Certificate Import Wizard** page, click **Finish**, then click **OK** in the confirmation.
      </Step>
    </Steps>

    <Warning>
      **The Issued To field contains the computer name where the Management Tool is installed.** Use the same name in the URL when calling the API from your tool — for example, `https://<hostname>/ekranapi/sessions` where `<hostname>` matches the Issued To value.
    </Warning>
  </Tab>
</Tabs>

## 4. Register and verify

Once installed, [register the Data Connector in the Management Tool](/docs/api/data-connector/manage) — the Configuration page's Applications tab is where the new Data Connector appears after installation. Once registered, generate an API key from your user's Manage Account page and start calling the [API endpoints](/docs/api/data-connector/api-reference#endpoints).

## Related

<CardGroup cols={2}>
  <Card title="Manage the Data Connector" icon="settings" href="/docs/api/data-connector/manage">
    The Applications tab — register, view, and deactivate the Data Connector.
  </Card>

  <Card title="API reference" icon="square-code" href="/docs/api/data-connector/api-reference">
    Authentication, base URL, all 9 endpoints, status codes.
  </Card>

  <Card title="Management Tool prerequisites" icon="list-checks" href="/docs/administration/deployment/management-tool-prerequisites">
    IIS setup details — shared with the Data Connector prerequisites.
  </Card>

  <Card title="Power BI example" icon="bar-chart" href="/docs/api/data-connector/power-bi-example">
    End-to-end use case after install completes.
  </Card>
</CardGroup>