Setting up ZEN Master Okta SSO

this section includes instructions on how to register zen master as an sso app on okta and configure the connection between zen master and okta to complete this process, you need to log in as an admin on both the okta side and the zen master side it is, therefore, recommended to have both open in parallel to setup zen master okta sso on the okta home page, click applications click add application the add application screen opens click create new app the create a new application integration window opens in the platform field, select web (default) in the sign on method field, select openid connect click create the create openid connect integration screen opens in the application name field, enter a name for the sso app this name will not be shared and is used for administration purposes only for example, "zen master" in the application logo field, you can optionally choose a logo by clicking browse files , and following the prompts in the zen master ui , go to account management > single sign on click +add the create new single sign on screen opens copy the callback url to your clipboard in okta , on the create openid connect integration screen, paste the callback url in the login redirect uris field, and click save the application is created, and the settings screen for the application opens click on the assignments tab click assign , and then select either assign to people or assign to groups (depending on how you want to assign access to this app) in the assign window that opens, select each user or group that you want to grant access to, by clicking assign each time that you assign the app to an individual user, a window opens specific to that user, enabling you to optionally modify that user’s profile information click save and go back the user is assigned to the app click done click on the general tab, and scroll down to the client credentials section the client credentials can be found on the bottom of the page you will need the client id and client secret from that section to continue the setup process in zen master click the client id copy button in zen master , paste the client id in the client id field back in okta , copy the client secret , and paste it in the client secret field in zen master in zen master , in the name field, enter a name for this sso connection, for example okta sso this is the name that will be displayed on the okta button in the zen master sign in portal in the authorization url field, enter your unique authorization url for example, https //{youroktaorg} okta com/oauth2/v1/authorize for more information about okta authorization servers, see authorization servers https //developer okta com/docs/concepts/auth servers/ in the token url field, enter your unique token url for example, https //{youroktaorg} okta com/oauth2/v1/token for more information about okta authorization servers, see authorization servers https //developer okta com/docs/concepts/auth servers/ if you want to manually register okta users to zen master (see pre registering users in zen master for okta docid\ fpkg wrutqtxg3mdvhk2x ) before granting access, select the allow pre registered users only checkbox the registration is simple and only involves entering the user's email in zen master , click save the newly created okta sso is added to the list of sso profiles the users assigned in okta will be able to connect to zen master by selecting the newly created sso option under sign in with during the first connection you may be required to provide permission to connect through okta to zen master as an administrator, you can select consent on behalf of your organization option, which will not require additional consent by the other users however, if you have selected the allow pre registered users only option you will need to manually pre register the users by following the instructions below