Skip to main content

Link Okta to your Zenvoices environment

Read here how you can add Zenvoices as an application within Okta

Written by Jèsel Broekema
Updated over a week ago

The information in this article applies only to a feature in the Compleet subscription.

Consult this article about Single Sign On (SSO) for more information about this functionality. By activating Single Sign On for Okta it is possible to log in to Zenvoices both from the Okta dashboard and via the Zenvoices login screen.

Supported functions

  • Single Sign-On (OpenID Connect) from Okta: log in to Zenvoices from Okta.

  • Service Provider (SP)-Initiated Authentication Flow: log in to Zenvoices with Okta.

Installation

Add Zenvoices as an application within Okta

  1. Log in as an administrator in Okta.

  2. Go to 'Applications' in the menu and select 'Applications'.

  3. Click 'Browse App Catalog'

  4. Search for Zenvoices and add the application to your Okta organization.

  5. Complete the final step and finish adding the application.

  6. Then open the 'Sign On' tab and click 'Edit' at 'Settings'.

  7. Under 'Advanced Sign-on Settings', enter your environment name in the field 'OrganisationCode'. This is the environment name you use to log in to Zenvoices.

  8. Then click 'Save'.

Configure Okta in Zenvoices

  1. Log in as an administrator in Zenvoices.

  2. Go to Manage / Environment / Settings and open the tab 'Okta configuration'.

  3. Open the Zenvoices app integration in Okta and copy the 'Client ID' and 'Client secret'. Enter these details under the tab 'Okta configuration' in Zenvoices.

  4. Enter 'Okta domain' in the tab 'Okta configuration' in Zenvoices with the domain name you use to log in to Okta, for example "companyname.okta.com".

Please note: do you receive the error message 'No Okta configuration could be found for the organization'? This message appears when the 'Client ID', 'Client secret' and 'Okta domain' have not been copied from Okta and entered in Zenvoices.

Consult this article for more information on how to activate Okta per user after completing the steps above.

Log in with Okta

From Zenvoices

  1. Click "Okta" at "Log in with".

  2. Enter your environment name.

  3. Click "LOG IN".

From Okta

Click the Zenvoices application tile in your Okta dashboard.

Did this answer your question?