> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-docs-entitlement-lifecycle-sparse-acl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up a Matomo connector

> C1 provides identity governance for Matomo. Integrate your Matomo instance with C1 for unified visibility and governance over user access.

C1 provides identity governance for Matomo. Integrate your Matomo
instance with C1 for unified visibility and governance over which users
hold which level of access to each of your Matomo sites.

## Capabilities

| Resource | Sync                                                          | Provision |
| -------- | ------------------------------------------------------------- | --------- |
| Users    | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |
| Sites    | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |

The connector syncs Matomo **users** and **sites**, and the per-site
**access** each user holds (`view`, `write`, or `admin`). Super Users are
modeled as administrators of every site.

## Gather Matomo credentials

<Warning>
  The Matomo connector requires an API authentication token that belongs to a
  **Super User**. A non–Super User token returns a filtered, email-less view of
  your users and cannot read every site's access list, which produces an
  incomplete access graph.
</Warning>

<Steps>
  <Step>
    Sign in to your Matomo instance as a user with **Super User** access.
  </Step>

  <Step>
    Go to **Administration** (the gear icon) > **Personal** > **Security**.
  </Step>

  <Step>
    Under **Auth tokens**, click **Create new token**, enter your password if
    prompted, give the token a description (for example, `ConductorOne`), and
    create it.
  </Step>

  <Step>
    Copy the generated token. You will also need your Matomo base URL (for
    example, `https://analytics.example.com` or `https://demo.matomo.org`).
  </Step>
</Steps>

## Configure the Matomo connector

<Tabs>
  <Tab title="Cloud-hosted">
    Follow these instructions to use a built-in, no-code connector hosted by C1.

    <Steps>
      <Step>
        In C1, navigate to **Apps** > **Connectors** and click **Add connector**.
      </Step>

      <Step>
        Search for **Matomo** and click **Add**.
      </Step>

      <Step>
        Choose where to add the connector: **Create a new app**, or **Add to an existing app** (then select the app).

        If you're creating a new app, choose whether to link it to an application discovered from your identity provider: select **Yes** and pick the IdP application, or **No** to continue with just the connector.
      </Step>

      <Step>
        Set the connector's **Name** and, optionally, a **Description**.
      </Step>

      <Step>
        Click the pencil icon next to **Owners** to choose who can configure and manage this connector.
      </Step>

      <Step>
        Click **Add**. The connector is created and its configuration page opens.
      </Step>

      <Step>
        Find the **Settings** area of the page and click **Edit**.
      </Step>

      <Step>
        Enter the Matomo credentials:

        * **Matomo base URL**: The base URL of your Matomo instance, e.g. `https://analytics.example.com` (do not include `/index.php`).
        * **Matomo API token**: The Super User auth token you created above.
      </Step>

      <Step>
        Click **Save**.
      </Step>

      <Step>
        The connector's label changes to **Syncing**, followed by **Connected**. You can view the logs to ensure that information is syncing.
      </Step>
    </Steps>

    **Done.** Your Matomo connector is now pulling access data into C1.
  </Tab>

  <Tab title="Self-hosted">
    Follow these instructions to run the Matomo connector in your own
    environment.

    <Steps>
      <Step>
        Create secrets for the Matomo credentials.
      </Step>

      <Step>
        Configure the connector with:

        * **Matomo base URL**: The base URL of your Matomo instance, e.g. `https://analytics.example.com`.
        * **Matomo API token**: The Super User auth token you created above.
      </Step>

      <Step>
        Deploy the connector using your standard self-hosted connector process.
      </Step>
    </Steps>

    **Done.** Your Matomo connector is now pulling access data into C1.
  </Tab>
</Tabs>