Setting up a Custom Domain

Introduction

Custom domains allow you to replace Trinsic’s default domain URLs (api.trinsic.id) with your own custom domain (e.g. verify.yourcompany.com). This gives your users a fully branded, native experience and enhances brand trust while still leveraging Trinsic’s powerful identity infrastructure. You can register both your own and your customer's domains.

Trinsic supports domain customization through a Reverse Proxy, where your servers will terminate the TLS traffic (HTTPS) and forward the requests to Trinsic's servers.

Setup

Setup a Reverse Proxy

Setup a reverse proxy that terminates the SSL connection and points to api.trinsic.id.

It's important to make sure the proxy adds the X-Forwarded-Host header as part of its configuration.

You can confirm the domain forwarding works correctly by visiting the url: https://[YOUR CUSTOM DOMAIN]/api/check-domain. You should see your domain name in the response as requestHost.

Configure the domain in the Dashboard

In the Trinsic Dashboard, add your domain - it will be added with a status of Requested.

The Trinsic team will be notified of this and will ensure all required details are setup correctly. Once confirmed, it will be marked with a status of Connected and the team will communicate to you it's ready to be used.

Apply the domain to a Verification Profile

Once your domain is in the Connected state, you can configure the domain in the settings of a Verification Profile. For new sessions, we will use the new domain. We recommend starting with a new Verification Profile for your domain, as there will be provider specific configuration required to actually enable the use of the domain, and this could break existing flows.

Adjust your SDK usage

Frontend

If you are using Trinsic's Web UI SDK to launch verifications via a popup, you may want to specify the initialUrl and initialWindowTitle parameters when calling createPopup() or createPopupAndWaitForResults().

Due to browser restrictions regarding popups, the Web UI SDK opens a popup to a predetermined loading page before you call your backend to create a Session; finally, the SDK redirects the popup to the Session's launch URL. In the time between the popup being opened and being redirected, it displays a loading page which is hosted on Trinsic's domain name. The initialUrl and initialWindowTitle parameters allow you to change this behavior.

Backend

There are no adjustments required to make custom domains work with Trinsic's backend SDKs.

Test

Once Trinsic confirms your domain and changes the status to Connected, launch a flow using one of Trinsic's built-in test providers. These support custom domains automatically.

Provider-specific configuration

Once the Trinsic team gets a confirmation the domain works as expected we will assist you applying this domain to your configurations.

ℹ️

Need Help?

Please reach out to our team and we're happy to get connected to your technical team to ensure the domain setup is successful.