Single Sign-On (SSO)
      Back to home
      1. Help Docs
      2. Administration
      3. Single Sign-On (SSO)

      Configuring Prendio With Okta SSO Authentication

      This document details the configuration of Okta Single Sign-On (SSO) Authentication for Prendio and enabling SSO authentication for a Prendio User.

      Prerequisites:
      • This configuration requires that a SSO service, such as Okta, is available to your company. The company IT Department normally sets this up and provides the technical details
      • A Prendio user with the Admin role is required to complete this process
      • If the SSO radio button is not available for an Admin to select, then the feature must be requested for the Company account. Contact Prendio Technical Support at support@prendio.com

       

      An admin for Okta will need to create a SAML application that will be used for the authentication. That application will need the following fields and values:

       Single sign on URL https://procure.prendio.com/sso/Okta/auth
       Use this URL for Recipient URL and Destination URL (Checked)
       Audience URI (SP Entity ID) https://procure.prendio.com
       
      After the Okta configuration is complete, the Company Admin should first test the configuration by selecting SSO for a different Prendio User. This way in the event of a mistake, the Admin is not locked out and the test user can be configured for Prendio Authentication while the issue is resolved.
       
      Note: The SAML Metadata URL might not be displayed in Okta, depending on which of their user interfaces you use. This is generally the format of the URL:
      https://<Company>.okta.com/app/<IdP_EntityID>/sso/saml/metadata
       
      Enabling SSO Integration for Your Prendio Company
       

      1. Go to [Admin > General] and click the User Authentication section

      2. Select the Single Sign-On radio button, select "SAML 2.0" in the the Single sign-on authentication field, and select "Okta" in the Identity Provider field

      3. The Company IT and Prendio Admin then need to input the SAML Metadata URL in that field and click the Load URL button. After clicking that button, the Identity Provider Login Url, Identity Provider entity ID, and the Identity Provider Certificate fields will automatically populate.

      4. "Email Address" is the Default User Mapping used with Prendio SSO.

      5. Click the Save button.
       
      Whenever the Save button is clicked on this page, a prompt appears asking how to proceed with the initial user configuration:
       
       
      You can apply SSO authentication to all users or configure each user manually. See the next section for information on manually configuring authentication for each user.
       

      Enabling SSO Authentication for a User

      6. Edit an account under [Admin > Users] and click the Authentication section

      7. Select "SSO" in the Auth Metod field

      8. Enter the user's email address in the IdP Username field. Note that the email address for this field is case sensitive depending on how Okta is configured
      9. Click the Save button