authentik SCIM Provisioningauthentik ​S​C​I​M ​Provisioning

Available on: Enterprise EditionCloud>= 0.18.0

Sync Users and Groups from authentik to Kestra using SCIM.

Prerequisites

  • authentik Account: An account with administrative privileges to configure SCIM provisioning.
  • Enable multi-tenancy in Kestra: Tenants must be enabled in Kestra to support SCIM provisioning. You can enable tenants by setting the kestra.ee.tenants.enabled configuration property to true:
yaml
kestra:
  ee:
    tenants:
      enabled: true

Kestra SCIM Setup: Create a New Provisioning Integration

  1. In the Kestra UI, navigate to the AdministrationIAMProvisioning page.
  2. Click on the Create button in the top right corner of the page.
  3. Fill in the following fields:
    • Name: Enter a name for the provisioning integration.
    • Description: Provide a brief description of the integration.
    • Provisioning Type: Currently, only SCIM 2.0 is supported — leave the default selection and click Save.

scim1

The above steps will generate a SCIM endpoint URL and a Secret Token that you will use to authenticate authentik with the SCIM integration in Kestra. Save those details, as they will be needed in the next steps.

scim2

The endpoint should look as follows:

text
https://your_kestra_host/api/v1/your_tenant/integrations/integration_id/scim/v2

The Secret Token will be a long string (approximately 200 characters) used to authenticate requests from authentik to Kestra.

Enable or Disable SCIM Integration

Note that you can disable or completely remove the SCIM Integration at any time. When an integration is disabled, all incoming requests to that integration endpoint will be rejected.

scim3

IAM Role and Service Account

When creating a new Provisioning Integration, Kestra will automatically create two additional objects:

  1. Role SCIMProvisioner with the following permissions:
    • GROUPS: CREATE, READ UPDATE, DELETE
    • USERS: CREATE, READ, UPDATE
    • BINDINGS: CREATE, READ, UPDATE, DELETEscim4
  2. Service Account with an API Token which was previously displayed as a Secret Token for the integration: scim5

authentik SCIM 2.0 Setup

Configuring SCIM 2.0 follows a process similar to SSO — you'll need to create a new Application. Then, in the second step, select SCIM as the Provider Type.

scim-for-authentik-7

In the Protocol settings section, enter the URL and Secret Token obtained from Kestra.

scim-for-authentik-8

Test both SSO and SCIM by adding users and groups

First, create Users and Groups in the Directory settings.

scim-for-authentik-9

Then assign your user(s) to an existing group.

scim-for-authentik-10

You can set a password for each authentik user to allow them to log in directly to Kestra with their username/email and password.

scim-for-authentik-11

Once groups and users are created, they should be visible in the Kestra UI under the IAMUsers and Groups sections. It’s best to log in as the default admin user and attach the desired Role to each group to ensure that the users have the necessary permissions.

scim-for-authentik-12

Then, to verify access, log in as one of those new authentik users in a separate browser or incognito mode and verify that the user has the permissions you expect.


Additional Resources

Was this page helpful?