Deskradar Documentation

Appearance

Single Sign-On with Okta ​

This guide demonstrates how to configure single sign-on with Okta.

Okta configuration ​

Log in to your organization’s control panel on Okta.

Create app integration ​

Okta Admin Console, Applications page with the Create App integration button

  1. In the main navigation panel, expand the Applications section, then click Applications.
  2. On the Applications page, click Create App integration.

Create SAML Integration wizard, General Settings step

  1. Enter Deskradar in the App name field

  2. Upload the Deskradar logo

    Deskradar logo

  3. Click Next

Create SAML Integration wizard, Configure SAML step with the SAML Settings form

In the following values, replace YOURDOMAIN with your Deskradar instance domain.

  1. In the Single sign-on URL field, enter https://YOURDOMAIN.deskradar.cloud/auth/sso/saml/consume
  2. In the Audience URI (SP Entity ID) field, enter https://YOURDOMAIN.deskradar.cloud
  3. In the Application username dropdown, select Email.
  4. Click Next.

Create SAML Integration wizard, Feedback step

Click Finish.

Identity provider settings ​

Okta application Sign On tab with the SAML signing certificate details

After creating the app integration, you are taken to the application details page.

Now save the information you need for Deskradar configuration.

  1. Click Show details to expand the details section.
  2. Copy Sign on URL.
  3. Copy Issuer.
  4. Download Signing Certificate as a file.

Configure attributes mapping ​

Okta application SAML settings with the Attributes section

Scroll down to the Attributes section.

Click Add expression.

Add expression dialog with Name FirstName and expression user.profile.firstName

Add expression dialog with Name LastName and expression user.profile.lastName

Add expression dialog with Name Email and expression user.profile.email

Attribute statements section listing the three saved expressions

The three attribute mapping expressions to configure:

NameExpression
Emailuser.profile.email
FirstNameuser.profile.firstName
LastNameuser.profile.lastName

Set up user assignments ​

Okta application Assignments tab with the Assign dropdown open

  1. In the top navigation panel, click Assignments.
  2. Click Assign to open the dropdown.
  3. Click Assign to Groups.

Assign to Groups dialog with the Everyone group

Click Assign on the Everyone row to allow all users in your organization to sign in to Deskradar with their Okta accounts. Select a different group to restrict access to that group only.

Click Done.

Deskradar configuration ​

Log in to your Deskradar workspace with an administrator account using your email and password.

Deskradar sign-in view

  1. Open the Team page by clicking the icon in the Sidebar.
  2. Switch to the Single Sign-On tab.
  3. Enable the SAML 2.0 authentication method.

Deskradar Team page, Single Sign-On tab with SAML 2.0 settings

  1. In the SAML SSO URL field, enter the value you obtained from Sign on URL in the Okta user interface. The value starts with https://<your-org-id>.okta.com/...
  2. In the Identity Provider Issuer field, enter the value you obtained from Issuer in the Okta user interface. The value starts with https://www.okta.com/...
  3. Open the Certificate file you downloaded from Okta in a text editor, then copy and paste its contents into Public Certificate. The value starts with -----BEGIN CERTIFICATE-----
  4. Click Save settings.

Sign in to Deskradar with SSO ​

After configuration is complete, users can sign in to Deskradar using their Okta account.

Sign in from Deskradar ​

Launch your Deskradar instance by opening this URL in your browser: https://YOURDOMAIN.deskradar.cloud (replace YOURDOMAIN with your Deskradar instance domain). Click Enterprise Single Sign-On.

Enterprise Single Sign-On button on the Deskradar login view

  • You will be signed in to Deskradar directly if you’re already signed in on Okta.
  • You will be redirected to the Okta sign-in form if you’re not signed in yet. Enter your work account credentials there to sign in.
  • Upon successful sign-in with your work account credentials, you will be taken back to Deskradar and signed in.

Launch Deskradar from the Okta apps dashboard ​

You can access Deskradar from the Okta My Apps dashboard.

Deskradar tile on the Okta My Apps dashboard