The Journyx SaaS application can be configured to use to provide SAML-based single sign-on authentication. Journyx is considered a Service Provider (SP) in SAML terminology. Your portal script functions as the Identity Provider (IdP).


The Journyx setup process is generally described below.

  1. Journyx gives you a few key bits of information discussed below; mainly the SSO endpoint URL and Audience value, and tells you the Attributes to send, mainly 'login' and 'email'.
    1. a. Your endpoint will be:
      https://<your_journyx_site_name>.apps.journyx.com/Journyx.sso/SAML2/POST
    2. b. Your audience URI will be:
      https://<your_journyx_site_name>.apps.journyx.com/Journyx.sso

      In the above examples, "<your_journyx_site_name>" would be replaced with the actual name of your Journyx SaaS site.
  2. Your identity management software (e.g. Okta, Azure, PingOne) accepts these values at a configuration screen and produces an XML file called the Identity Provider (IdP) SSO Metadata. Your signing certificate is embedded in this file.
  3. You send the IdP SSO Metadata XML file to us at Journyx, and we install it on our server. This describes you (the Identity Provider) to our server so we know how to validate incoming assertions.
  4. Once we have this file and install the necessary SSO tools and configuration to your Journyx site, the SSO connection will be active.


Please note that the creation of the application within your SSO portal and the creation of the metadata file is controlled by you, the customer, and not by Journyx. Each identity provider procedure will vary. If you are unfamiliar with registering an application and creating the associated metadata, please contact your IT staff or your identity provider support.


The following example instructions are for setting up a SAML Single Sign-On (SSO) connection between an Okta identity provider and a Journyx SaaS site. These steps must be performed by your identity provider administrator. Again, other idP software configuration should be similar, but Journyx cannot advise on specific idP interfaces for generating the metadata file.


Before you begin, please note that the 'login' value must exactly match the corresponding 'User Login' field in Journyx; this is case-sensitive and must uniquely identify each user. This can be different from what the user actually types to sign in on your side, as long as you can extract/obtain the correct value to match the information in Journyx.


Okta: Setting up a SAML Application in Okta

Azure: Configuring single sign-on to applications that are not in the Azure Active Directory application gallery

PingOne: Export Metadata for Service Provider Configuration

Okta


  1. Sign in to the Okta admin dashboard and go to the Applications section.
  2. Click Add Application.
  3. From the directory screen, click Create New App.
  4. Set "Sign on method" to SAML 2.0
  5. General settings:
    1. These settings are up to you, you can put any values you want. You have to at least assign a name here. We suggest <your_journyx_site_name>.apps.journyx.com.
    2. Logo is optional; it's up to you. This will only appear on the Okta side.
  6. SAML Settings - see screenshot below.
    1. SAML Endpoint:
      https://<your_journyx_site_name>.apps.journyx.com/Journyx.sso/SAML2/POST
    2. Audience URI:
      https://<your_journyx_site_name>.apps.journyx.com/Journyx.sso
    3. Default RelayState: leave blank
    4. Name ID Format: use "Unspecified"
    5. Application Username: depends, but possibly Okta username prefix
      • This pertains to the requirement that the username that Okta sends over must exactly match the Journyx username.
      • This is somewhat configurable by setting and/or use Okta's custom rule feature.
    6. Open the "Advanced Settings", and change only this:
    7. Request Compression: Yes
    8. Under "Attribute Statements", at minimum you need these two:
      • login - user.login
      • email - user.email
      • See screenshot below. These are based on my Okta test site.
    9. Click "Next" to save and move to the next screen.
  7. Answer the next questions with "I'm an Okta customer..."
    1. You can then leave the remaining questions blank, or check "it's an internal app"
  8. You should now be at the application dashboard page for your new app, <your_journyx_site_name>.apps.journyx.com.
    1. Click the link "Identity Provider Metadata". This will prompt you to save a file to disk.
    2. Attach the file to an email support@journyx.com with a subject that is something like: "<Your company name> single sign on metadata"
  9. We will then handle the setup process on our end and notify you when it's complete. Depending on when we receive the file, and if we run into any issues on our end, it could be up to a day before it becomes active, but most likely less. We will notify you if there's any delays or other issues.
  10. If you need to access the Journyx web app directly without SSO, you can use this URL:
    • https://<your_journyx_site_name>.apps.journyx.com/jtcgi/wte.pyc?nosso=1
      The important part is the “?nosso=1” at the end of the URL.
      This checks the password against the Journyx password database.
    • Access to this SSO bypass is controlled by a User field named "SSO Authentication". Each user can be set to "SSO Only", "Journyx Only", or "Both".
    • Accountlink, Reportlink and other tools don't need to use the special URL above, but they DO need to use the Journyx password, not whatever's in Okta/ActiveDirectory, though they could be the same.