Set up an Outline connector

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

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

Capabilities

Resource	Sync	Provision
Users
Groups

The connector syncs Outline workspace users, groups, and group memberships. Each group exposes a member entitlement, and each group membership becomes a grant of that entitlement to the member.

Gather Outline credentials

The connector authenticates with an Outline API key. Use an unscoped key created by a workspace admin, or a key scoped to users.list, groups.list, and groups.memberships.

1. In Outline, open Settings > API & Apps and create a new API key.

2. If you scope the key, include the users.list, groups.list, and groups.memberships scopes so the connector can list workspace users, groups, and group memberships.

3. Copy the key value, and note your Outline URL. For Outline’s hosted service this is https://app.getoutline.com; for a self-hosted Outline server, use the URL the server is reachable at, with no trailing slash and no path.

Configuration fields

Field	Required	Description
base-url	Yes	The URL of your Outline installation, with no trailing slash and no path (for example https://app.getoutline.com).
api-key	Yes	An Outline API key, sent as a bearer token. It must be able to list users and groups.

Synced resource types

• Users: Outline workspace users, including suspended and invited users. Suspended or deleted users sync as disabled.
• Groups: Outline groups, each with a member entitlement.
• Group memberships (as grants): each group’s members, granted the group’s member entitlement.

Special notes

• Provisioning is not supported in the current build; the connector is read-only.
• Collections and documents are not synced; the connector covers workspace identity and group membership.
• The connector requests users of every status. If your Outline server excludes suspended or invited users from those listings, those users will not appear in C1 until they are active.

Configure the Outline connector

Cloud-hosted

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 Outline 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 Outline credentials:

   • Outline URL: The URL of your Outline installation.
   • API key: The API key created in Settings > API & Apps.
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 Outline connector is now pulling access data into C1.

Self-hosted

Follow these instructions to run the Outline connector in your own environment.

1. Create secrets for the Outline credentials.

2. Configure the connector environment variables:

   • BATON_BASE_URL: The URL of your Outline installation.
   • BATON_API_KEY: The API key created in Settings > API & Apps.
3. Deploy the connector using your standard self-hosted connector process.

Done. Your Outline connector is now pulling access data into C1.