This integration configures OpenID Connect as the authentication mechanism with Okta as the identity provider (IdP) and kPow as the relying party.
Login to your Okta account.
Navigate to Admin > Applications > Create App Integration
In Create a New Application Integration popup set these values and click Create:
Sign on method: OIDC - OpenID Connect
Application type: Web Application
In Create OpenID Connect Integration set these values and click Save:
App integration name: The name of your kPow instance, e.g. 'kPow Staging'.
Sign-in redirect URIs: The absolute kPow callback URI, e.g.
Sign-out redirect URIs: The absolute URI of where kPow is hosted, e.g.
Click Save and next you will be redirected to the applications settings page.
Navigate to General Settings > Edit, and configure:
Initiate login URI: The absolute kPow login URI, e.g:
Optionally, if you would like Okta to appear in your organization's list of Okta apps:
Login initiated by: "Either Okta or App" selected.
"Display application icon to users" selected.
"Display application icon in the Okta Mobile app" selected.
Allowed grant types:
"Implicit (Hybrid)" selected.
"Allow ID Token with implicit grant type" selected.
"Allow Access Token with implicit grant type" selected.
Make note of the Client Credentials section that appears below.
Click Assignments and assign users to kPow.
Set the following environment variables and start kPow:
OKTA_ORGANISATION= the name of your Okta organization, e.g. mycorp
OPENID_CLIENT_ID= the Client ID found in Client Credentials.
OPENID_CLIENT_SECRET= the Client Secret found in Client Credentials.
OPENID_LANDING_URI= The absolute kPow URI, e.g:
kPow will now authenticate users with Okta (OpenID).
See the guide to Role Based Access Control for full configuration details.
When RBAC is enabled kPow will request
groups scope to view the groups associated with an authenticated user. kPow considers Okta groups as roles in your RBAC configuration.
You will need to configure a relevant group claim filter for the kPow OpenID integration: