››

How to Integrate Help Desk SSO With Web Application

Integrating Single Sign-On (SSO) with ProProfs Help Desk allows users to access support directly from your web application using their existing login credentials. This simplifies the login process, enhances security, and provides a seamless support experience.

Once configured, users can submit tickets, view their support history, and communicate with support agents effectively.

Benefits of Help Desk SSO Integration:

Accelerated Support Operations: Minimizes delays by streamlining access to support tools and tickets, enabling users to focus on resolving issues faster.
Improved Access Management: Centralized authentication helps enforce robust security policies and minimizes password-related risks.
Enhanced Productivity: Faster access to tickets, reports, and tools through centralized navigation and intuitive design.

Use Case: With SSO enabled, a user can log in directly to ProProfs Help Desk without manually entering credentials. Once authenticated, the user gains seamless access to all features, including replying to existing tickets, creating new ones, viewing reports, and managing support tasks efficiently. This ensures a secure and unified login experience across the platform.

Integrate Help Desk SSO With Your Web Application

Step 1: Configure SSO Settings in Help Desk

Log in to your ProProfs Help Desk account.
Navigate to Settings → Security → Single sign-on.
Add the following:
- Auth URL: The URL on your web app to validate the SSO request.
- Logout URL: The URL users are redirected to after logging out.

Step 2: Retrieve Your SSO Credentials

In the same SSO settings panel, copy the following:

SSO Token: Used to sign the JWT.
SSO Auth URL: The endpoint where users are authenticated.
Account ID: Required during the authentication request.

Step 3: Generate a JWT Token

Create a JWT token on your server containing the user’s email and issue time. This token must be signed using your SSO Token.

Required JWT Payload:

email: The user’s email address.
iat: Issued-at timestamp.
jti: A unique token ID (for security and replay protection).

Step 4: Redirect to the SSO Endpoint

After generating the token, redirect the user to the Help Desk SSO endpoint using the following parameters:

Parameter	Description
token	JWT token generated and signed with your SSO token
account_id	Your Help Desk Account ID
auth_url	The same Auth URL added in Step 1

Sample PHP Implementation

// Step 1: Setup

$key = md5("your_sso_token");

$user_email = "user@example.com";

$account_id = 123456;

$auth_url = "https://yourdomain.com/login";

$encodedAuthUrl = urlencode($auth_url);

// Step 2: Create JWT Token

date_default_timezone_set("UTC");

$now = time();

$header = json_encode(['typ' => 'JWT', 'alg' => 'HS256']);

$payload = json_encode([

"iat" => $now,

"jti" => md5($now . rand(100, 10000)),

"email" => $user_email

]);

// Step 3: Encode and Sign the Token

$base64UrlHeader = str_replace(['+', '/', '='], ['-', '_', ''], base64_encode($header));

$base64UrlPayload = str_replace(['+', '/', '='], ['-', '_', ''], base64_encode($payload));

$signature = hash_hmac('sha256', "$base64UrlHeader.$base64UrlPayload", $key, true);

$base64UrlSignature = str_replace(['+', '/', '='], ['-', '_', ''], base64_encode($signature));

$jwt = "$base64UrlHeader.$base64UrlPayload.$base64UrlSignature";

// Step 4: Redirect to SSO Endpoint

$sso_endpoint = "https://www.proprofsdesk.com/app/v2/login/ssoauth";

$return_url = "$sso_endpoint?token=$jwt&account_id=$account_id&auth_url=$encodedAuthUrl";

header("Location: $return_url");

exit;

That is all about integrating Help Desk SSO with the Web Application. Please contact our support team if you encounter any issues or questions.

Related Articles:

Was this helpful?

Thank you Your feedback helps us to continually improve our content.