Domain White Labelling

Introduction

Domain White Labelling allows you to replace Trinsic’s default domain URLs (api.trinsic.id) with your own custom domains (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 customers domains.

Trinsic supports domain white labelling 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 it's configuration.

You can confirm the domain forwarding works correctly by visiting the url: <https://verify.example.com/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 an app

Once Connected you can configure the domain in the Settings of an app. For new sessions we will use the new domain. We recommend starting with a new app 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

When using a popup to launch a verification flow, include your custom domain as a parameter. Some browsers (such as Safari) restrict when a popup can be initiated—usually they must be opened immediately after user interaction (such as a button click). To handle this, our Web UI Library provides a launchPopup method that accepts an asynchronous function for you to call your API to create a session and return the appropriate URL. During the wait, we display a loading page hosted on your domain to maintain a smooth user experience.

Backend

There are no adjustments required to make domain white labelling work in the 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 domain white labelling 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.

ℹ️

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.