Skip to main content
C1 provides identity governance for xMatters. Integrate your xMatters instance with C1 for unified visibility and governance over user access.

​
Capabilities

​
Gather xMatters credentials

The connector signs in to the xMatters REST API with a user name and password (HTTP Basic authentication). The account needs the REST Web Service User role, or equivalent permissions, and access to the people and groups it should read.
1
In xMatters, create or choose a user account for the connector and make sure it has the REST Web Service User role.
2
To authenticate with an xMatters API key instead of a password, open the user’s profile, create an API key, and copy both the key ID and the key secret. The key ID is entered as the user name prefixed with x-api-key- (for example x-api-key-2249a8e8-...), and the key secret is entered as the password.
3
Copy your xMatters API base URL: the host you see in your browser when signed in to xMatters, followed by /api/xm/1 — for example https://yourcompany.xmatters.com/api/xm/1. Some instances include a deployment segment in the hostname, such as https://yourcompany.cs1.xmatters.com/api/xm/1; copy the host exactly as it appears.

​
Configuration fields

​
Synced resource types

  • Users: people from /people, including their active or inactive status.
  • Groups: groups from /groups, with one member entitlement per group.
  • Group memberships: person members of each group from /groups/{id}/members. Nested groups and device members are listed by xMatters but are not synced as access grants.

​
Special notes

  • Provisioning is not supported in the current build.
  • The connector is read-only and never modifies xMatters data.
  • Device contact information is not synced; xMatters keeps contact details on device records, which are out of scope for this connector.
  • Membership of nested groups is not expanded: a group inside another group is skipped rather than resolved to its individual members.

​
Configure the xMatters connector

Follow these instructions to use a built-in, no-code connector hosted by C1.
1
In C1, navigate to Apps > Connectors and click Add connector.
2
Search for xMatters and click Add.
3
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.
4
Set the connector’s Name and, optionally, a Description.
5
Click the pencil icon next to Owners to choose who can configure and manage this connector.
6
Click Add. The connector is created and its configuration page opens.
7
Find the Settings area of the page and click Edit.
8
Enter the xMatters credentials:
  • xMatters API base URL: The full API base URL, for example https://yourcompany.xmatters.com/api/xm/1.
  • Username: The connector account’s user name, or an API key ID prefixed with x-api-key-.
  • Password: The account’s password, or the API key’s secret.
9
Click Save.
10
The connector’s label changes to Syncing, followed by Connected. You can view the logs to ensure that information is syncing.
Done. Your xMatters connector is now pulling access data into C1.