Skip to main content

Integrate with Personio

Support level: Community

What is Personio?​

Personio is an HR software platform for managing core HR processes such as recruiting, onboarding, payroll, time tracking, and performance management.

-- https://www.personio.com/

Preparation​

The following placeholders are used in this guide:

  • authentik.company is the FQDN of the authentik installation.
Personio requirements

To set up SSO, you need either an Administrator role in Personio or an employee role with edit permissions for Account configuration > Authentication. Personio does not create or sync employees through this OIDC connection, so each employee must already have an invited and activated Personio profile.

info

This documentation lists only the settings that you need to change from their default values. Be aware that any changes other than those explicitly mentioned in this guide could cause issues accessing your application.

Before you configure authentik, copy the Personio callback URL:

  1. Log in to Personio as an administrator.
  2. Navigate to Settings > Security & integrations > Security & authentication.
  3. From the list of login methods, go to Open ID Connect (OIDC) and click Configure.
  4. Under Provider settings, copy the Callback URLs/Redirect URIs value.

authentik configuration​

Redirect URI changes in authentik 2026.5

In authentik versions earlier than 2026.5, all Redirect URIs are automatically treated as Authorization type. If you are using one of these older authentik versions, add only the Authorization URL to your Redirect URIs and do not configure a Post Logout URI.

To support the integration of Personio with authentik, you need to create an application/provider pair in authentik.

  1. Log in to authentik as an administrator and open the authentik Admin interface.

  2. Navigate to Applications > Applications and click New Application to open the application wizard.

    • Application: set Application Name, Slug, an optional group, the policy engine mode, and optional UI settings. Take note of the Slug as it will be required later.
    • Choose a Provider: select OAuth2/OpenID Connect on the Choose a Provider Type page.
    • Configure OAuth2 Provider: provide a name (or accept the auto-provided name), select the authorization flow to use for this provider, and set the following values.
      • Note the Client ID and Client Secret values because they will be required later.
      • Set the Client type to Confidential.
      • Add two Redirect URIs of type Strict Authorization:
        • The Callback URLs/Redirect URIs value from Personio.
        • https://login.personio.com/login/callback
      • Select any available signing key.
    • Configure Bindings (optional): you can create a binding (policy, group, or user) to manage the listing and access to applications on a user's Application Dashboard page.

  3. Click Create Application to save the new application and provider.

Personio configuration​

  1. Log in to Personio as an administrator.
  2. Navigate to Settings > Security & integrations > Security & authentication.
  3. From the list of login methods, go to Open ID Connect (OIDC) and click Configure.
  4. Under Configuration, enter the following values:
    • Button Display Text: Continue with authentik
    • Issuer: https://authentik.company/application/o/<application_slug>/
    • Authorization URI: https://authentik.company/application/o/authorize/
    • Token URI: https://authentik.company/application/o/token/
    • Userinfo URI: https://authentik.company/application/o/userinfo/
    • JSON Web Key Set URI: https://authentik.company/application/o/<application_slug>/jwks/
    • Scopes: openid,email
    • Client ID: the Client ID from the authentik provider.
    • Client Secret: the Client Secret from the authentik provider.
    • Secret expiry date: the date when you plan to rotate the authentik client secret.
    • Claim Field: email
  5. Submit the changes and enable the connection.
User matching

Personio matches incoming users by the value of the configured Claim Field. Make sure each employee has an active Personio profile and that the email address returned by authentik matches the email address of the corresponding Personio employee, otherwise the SSO login will fail.

Configuration verification​

To confirm that authentik is properly configured with Personio, open Personio and click Continue with authentik. You should be redirected to authentik to log in, then redirected back to Personio.

You can also use Perform a configuration test on the Personio OIDC configuration screen to validate the connection without logging out.

Resources​