Integrate with Plane
Support level: Community
What is Plane?
Plane is a project and knowledge management platform that brings projects, documentation, and workflows into a single workspace.
Preparation
The following placeholders are used in this guide:
plane.companyis the FQDN of the self-hosted Plane installation. This placeholder is not used for Plane Cloud.authentik.companyis the FQDN of the authentik installation.
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.
OIDC SSO requires a Plane Cloud Business plan or a self-hosted Plane Pro or Business plan. Plane Cloud also requires a verified email domain before you configure SSO. Domain verification is outside the scope of this guide.
Choose your Plane deployment below.
- Plane Cloud
- Self-hosted Plane
authentik configuration
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 Plane Cloud with authentik, you need to create an application/provider pair in authentik.
Create an application and provider
- Log in to authentik as an administrator and open the authentik Admin interface.
- Navigate to Applications > Applications and click New Application to create an application and provider pair.
- Application: provide a descriptive name, an optional group for the type of application, the policy engine mode, and optional UI settings. Note the Slug value because it is required later.
- Choose a Provider type: select OAuth2/OpenID Connect as the provider type.
- Configure the Provider: provide a name (or accept the auto-provided name), select the authorization flow to use for this provider, and configure the following settings:
- Note the Client ID and Client Secret values because they are required later.
- Add a
StrictAuthorizationredirect URI with the temporary valuehttps://temp.temp. - 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.
- Click Submit to save the application and provider.
Plane configuration
Get the Plane connection details
- Log in to Plane Cloud as a workspace administrator.
- Navigate to Workspace Settings > Identity.
- Click Configure next to Enable OIDC, and then click Get setup details.
- Copy the Redirect URL and Logout URL. You need these values to update the authentik provider.
Update the authentik provider
- In a separate browser tab, log in to authentik as an administrator and open the authentik Admin interface.
- Navigate to Applications > Providers and open the provider that you created for Plane.
- Replace the temporary Redirect URI with the Redirect URL that you copied from Plane. Keep the URI type set to
StrictAuthorization. - Add the Logout URL from Plane as a
StrictPost Logoutredirect URI. - Click Update to save the provider.
Configure OIDC
- Return to the Plane Cloud OIDC configuration page.
- Configure the following settings:
- Client ID: enter the Client ID from authentik.
- Client secret: enter the Client Secret from authentik.
- Authorize URL:
https://authentik.company/application/o/authorize/ - Token URL:
https://authentik.company/application/o/token/ - Users' info URL:
https://authentik.company/application/o/userinfo/ - Logout URL:
https://authentik.company/application/o/<application_slug>/end-session/
- Click Save changes to enable OIDC authentication.
Configuration verification
To confirm that authentik is properly configured with Plane Cloud, log out, open Plane, and click Sign in with Single Sign-On. You should be redirected to authentik and then returned to Plane after authentication.
authentik configuration
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 self-hosted Plane with authentik, you need to create an application/provider pair in authentik.
Create an application and provider
- Log in to authentik as an administrator and open the authentik Admin interface.
- Navigate to Applications > Applications and click New Application to create an application and provider pair.
- Application: provide a descriptive name, an optional group for the type of application, the policy engine mode, and optional UI settings. Note the Slug value because it is required later.
- Choose a Provider type: select OAuth2/OpenID Connect as the provider type.
- Configure the Provider: provide a name (or accept the auto-provided name), select the authorization flow to use for this provider, and configure the following settings:
- Note the Client ID and Client Secret values because they are required later.
- Add the following redirect URIs:
StrictAuthorization:https://plane.company/auth/oidc/callback/StrictPost Logout:https://plane.company/auth/oidc/logout/StrictAuthorization:https://plane.company/auth/mobile/oidc/callback/StrictPost Logout:https://plane.company/auth/mobile/oidc/logout/
- 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.
- Click Submit to save the application and provider.
Plane configuration
- Log in to Plane as an instance administrator and open God Mode.
- Navigate to Authentication > OIDC.
- Configure the following settings:
- Client ID: enter the Client ID from authentik.
- Client secret: enter the Client Secret from authentik.
- Authorize URL:
https://authentik.company/application/o/authorize/ - Token URL:
https://authentik.company/application/o/token/ - Users' info URL:
https://authentik.company/application/o/userinfo/ - Logout URL:
https://authentik.company/application/o/<application_slug>/end-session/ - IdP's name:
authentik
- Click Save changes, and then enable OIDC using the toggle at the top of the page.
Configuration verification
To confirm that authentik is properly configured with self-hosted Plane, log out, open Plane, and click Continue with authentik. You should be redirected to authentik and then returned to Plane after authentication.