1. Frontend
  • Overview
  • Application Guides
    • Frontend
      • Get Started - React App
      • Get Started - HTML and JS
      • Get Started - Angular JS
      • Get Started - Next JS App
    • Backend
      • Get Started - Node JS
      • Get Started - Golang
      • Get Started - ASP.NET
      • Get Started - JAVA
  • Dashboard
    • API Credentials
    • Organization
    • Social Login
    • Customize Email Template
    • Configure Custom Domain
    • IT Admin Portal
  • Authentication
    • Login Widget
    • Magic Link
    • Google Social Login
    • Multi-Factor Authentication
    • Single Sign-On Overview
    • Setup SSO Connection
  • Security
    • Overview
    • Authentication
      • Password Hashing and Storage
      • Multi-Factor Authentication Methods and Implementation
      • Session Management
    • Attack Protection
      • Bot Detection
      • Breached Password Detection
      • Brute Force Protection
      • Log Events
      • Secure JSON Web Tokens (JWT)
      • Secure OpenID Connect (OIDC)
      • Suspicious IP Throttling
    • Data Security
      • Data Encryption At Rest and In Transit
      • Secure Storage of Secrets (Keys, Credentials)
      • Sensitive Data Handling
    • Infrastructure
      • Security Considerations for Cloud Provider or Deployment Model
      • Threat Modeling
  • API References
    • Authentication
      • MagicLink
        • Email a Magic Link
        • Resend Email Magic Link
        • Verify Magic Link
        • Ping Status
      • Magic Auth Code
        • Email a Magic Auth Code
        • Resend Magic Auth Code
        • Verify Magic Auth Code
      • Phone Authentication
        • Send Magic Auth Code via SMS
        • Resend Magic Auth Code via SMS
        • Phone Magic Auth Verify
      • PassKey
        • Initiate Passkey Login
        • Passkey Registration Initialize
        • Finish Passkey Authentication
        • Complete Passkey Registration
        • Check User Passkey Authentication Status
        • List User PassKey Credentials
        • Update Passkey Name
        • Delete Associated Passkey
      • GET Auth Status
    • Token
      • Refresh Token
      • Access Token By Auth Code
    • Mutli-Factor Authentication (MFA)
      • MFA Access Token
      • List of Authenticators
      • MFA Enroll TOTP
      • Initiate MFA
      • QR Code Image API
      • Validate MFA Token
      • Get Backup Code
    • Role And Permission
      • List All Roles
      • List All Permission
      • Create New Role
      • Update Existing Role
      • Update Permission By Permission Id
      • Remove Organization Role By Role Id
      • Remove Organization Permission By Permission Id
    • User Management
      • List All Users
      • GET User By User Id
      • GET User by User Email Address
      • Create a User
      • Update User by User Id
      • Verify User Status By User Id
      • Delete User By User Id
      • Manage User Roles
      • GET Users Organizations
      • GET User Login Logs
    • Organization
      • Add New Organization
      • Get Organization
      • Get All Organization
      • Update Organization
      • Delete Organization
      • GET Configuration By Client Id
      • GET Configuration By Custom Domain
  1. Frontend

Get Started - HTML and JS

To integrate SSOJet into your HTML and JavaScript application, follow these steps. You will need specific details about your application to set up and begin the implementation.

Get Your Login Page URL#

Access the SSOJet Dashboard.
Navigate to the Branding section of your SSOJet dashboard.
Select the Widgets section.
Click on the Try Now button, which will redirect you to your Login Page. Use this URL to log your users into your application.

Configure The Redirect URL#

Configuring the redirect URL is essential for your authentication flow, ensuring users are redirected back to your application after successful authentication. Follow the steps below to configure the redirect URL for your application:

Understanding the Redirect URL#

Purpose: The redirect URL is the endpoint in your application where users are sent after they have authenticated successfully through the authentication provider.
Usage: It ensures a seamless transition back to your application, allowing you to handle the authentication response and proceed with your custom logic.
Determine the endpoint in your application that will handle the authentication response. This is typically a route dedicated to processing the authentication token or code.
Example redirect URL: /auth/callback
Setting Up the Redirect URL
Navigate to the API Settings section of your SSOJet dashboard.
Select the Domain section.
Enter your application redirect URL.
image.png
The default authentication method supported for the Login page is a magic link. Configuring and enabling any SSO connections from the SSOJet dashboard (e.g., Okta, AzureAd, etc.), will be displayed on your Login Page.

Handling Redirection#

After successfully verifying the magic link, your user will be redirected to your application's specified redirect URL, with the state parameter included in the query string. The state ID is used to get the token for a successful login. Check the example below:
Example
This example code snippet shows how to retrieve the state query parameter value and request the SSOJet magic link status API.
API Endpoint:
https://api.ssojet.com/api/v1/auth/passwordless/magic-link/status?state=<state>
This API will return an access token after successful verification and authentication status of the user.
Replace <Your workspace client Id> with your actual client ID. This example demonstrates how to handle the authentication response and display a message to the user based on the authentication status.
Modified at 2024-07-24 09:28:32
Previous
Get Started - React App
Next
Get Started - Angular JS
Built with