Configuring Okta Single Sign On (SSO)

Our step by step guide on how to ensure Okta is integrated correctly

Introduction

This guide explains how to integrate Okta Account with Safeter. This could be for a number of different reasons, including:

  1. You plan to integrate Okta with Safeter, to onboard employees added in Okta.
  2. All employees of the organization will be able to login to Safeter using the Okta option on the login page.
  3. As new users join or leave the organization, their login in for Safeter will be automatically disabled by Okta.

Prerequisite

In order to get started, your organization will need an Okta account with a list of employees added.

You will also need to make sure that you have a Safeter account with Single Sign On enabled. If you are unsure, please contact our support team.

Getting Started

1. Admin Registration on Safeter.

  1. Sign in to your Safeter account
  2. Visit Company Settings and make sure that you have an Office location created

2. Create Safeter App in Organization's Okta Admin Account.

  1. Login to Organization's Okta an go to Applications, and then press Add Application

  2. Select Create New App
  3. Select the Sign In Method as: OpenID Connect

  4. Set the application type as Web Application


  5. Specify an Application name  (Example: Safeter)
  6. Under Grant types, please enable Authorization Code, Refresh Token and Implicit (Hybrid)



  7. Set Sign-in redirect URL's as:

     https://app.safeter.work/extras/static/oktaredirect.html
  8. For Sign-Out URL please set as:

    https://app.safeter.work/extras/static/oktaredirect.html
  9. Select which method you would like for the Login to be Initiated by. We recommend Either Okta or App

    123
  10. For Initiate Login URL, please set as:
    https://app.safeter.work/extras/static/oktaredirect.html
  11. Press Save and then the new application should be created
  12. Should you wish, you can upload the Safeter logo
  13. Finally, Go to Applications and Assign Users to your newly created application

3. Integrate Okta in Safeter

  1. Login to Safeter with an Admin Account
  2. Go to Company Settings and then Integrations
  3. Enable Okta Integration
  4. Enter your Okta URL which can be found from your Okta Dashboard by clicking your profile icon




  5. Copy the Client ID and Client Secret from Okta Application, created in the previous step
  6. Set your Organization Code for your organization and then press Update

    Note: The Organization Code allows for your employees to sign in directly from the Safeter login screen, instead of the Okta Dashboard. We typically recommend this be a shortened version of your company name such as "Safeter" but note that it is case-sensitive.



  7. That's it, you're all set! The Safeter app should now show on your Okta dashboard, and your team can access Safeter directly from Okta dashboard.

Okta integration for Mobile App

In order to integrate with our Safeter Mobile app, you will need to create a separate application. Please complete the following steps to get started:

1. Admin Registration on Safeter.

  1. Sign in to your Safeter account
  2. Visit Company Settings and make sure that you have an Office location created

2. Create Safeter App in Organization's Okta Admin Account.

  1. Login to Organization's Okta an go to Applications, and then press Add Application

  2. Select Create New App
  3. Select the Sign In Method as: OpenID Connect

  4. Select Native Application under Application Type
  5. Specify an Application name  (Example: Safeter)
  6. Under Grant types, please enable Authorization Code, Refresh Token and Implicit (Hybrid)
  7. Where it asks for Callback URL's for the mobile application, for the Sign-In Redirect URL and Sign-Out Redirect URL, please enter:
    com.app.safeter:/



  8. Once complete, press Save
  9. Once the application is saved, a new Client ID will be generated for the mobile application. Please copy this for the next steps

3. Integrate Okta in Safeter

  1. Login to Safeter with an Admin Account
  2. Go to Company Settings and then Integrations
  3. Enable Okta Integration
  4. Enter your Okta URL which can be found from your Okta Dashboard by clicking your profile icon




  5. Paste the Client ID into the Okta Mobile Client ID field, and then press Update

  6. That's it, you're all set! The Safeter app should now show on your Okta dashboard, and your team can access Safeter directly from Okta dashboard.

Having Issues or Need Support?

Not a problem, please reach out to our customer support team who will be more than happy to help resolve your issues.