SSO Integration Guide
This guide walks you through integrating your partner authentication server with Archisketch via SSO (Single Sign-On).
Last updated
Was this helpful?
This guide walks you through integrating your partner authentication server with Archisketch via SSO (Single Sign-On).
By using Archisketch SSO (Single Sign-On), users can log in to the dashboard using the partner's own authentication system. In this method, the partner server issues a verification token, and Archisketch verifies it with the partner server.
After signing a contract with Archisketch, please log in to the Archisketch Enterprise Service. Go to Settings > Enterprise Settings > Developer Settings, and click the 'View/Update' button.

Field
Description
Required
Example
Verification URL
The verification URL of the partner authentication server (Only GET method is supported)
Y
https://your-service.com/oauth2/user
Email Key
The email field name in the verification API response (maps to Archisketch email)
Y
email
Name Key
The name field name in the verification API response (maps to Archisketch name)
Y
name
UID Key
The unique user ID field name in the verification API response (maps to Archisketch uid)
N
id
Avatar Key
The avatar image URL field name in the verification API response (maps to Archisketch avatarImage)
N
profileImageUrl
Use GET with Bearer Token
Verification token delivery method. true: Authorization header Bearer, false: Query Parameter (Default)
N
false
Request Param Key
The Query Parameter name to use when Use GET with Bearer Token is false
N
token
Depending on the configuration, Archisketch delivers the token in one of two ways when calling the partner's verification server:
Query Parameter Method (Default): GET {verificationUrl}?{paramKey}={verifyToken}
Bearer Token Method: GET {verificationUrl} with header Authorization: Bearer {verifyToken}

The user logs in to the partner's service.
The partner server generates a verifyToken and calls the Archisketch Login API.
Archisketch passes the verifyToken to the registered Verification URL to verify user information.
Upon successful verification, Archisketch creates (new) or updates (existing) the user and returns tokens.
You can authenticate into the dashboard using the issued tokens.
If you have any questions or feedback regarding the SSO integration, please reach out via our Integration/Development Inquiry.
Last updated
Was this helpful?
Was this helpful?

