Integration Guide
Session Launch Modes
There are three possible session modes to select from, depending on how much of Trinsic's Hosted UI you want to use in your solution.
Our full hosted UI solution. The Trinsic-hosted widget manages the entire user experience, including guiding the user through method selection, handover to mobile device, etc. Capture results via the resultsAccessKey sent back to you via redirect url or the Trinsic Web SDK.
The middle ground between a Widget Session and an Advanced Provider Session. Your application guides the user through method selection, invoking Trinsic's hosted UI to handle complex integrations if necessary, and capturing results through the resultsAccessKey sent back to you via the redirect url.
Our "full white-label mode". Your application owns the entire user experience, falling back to Trinsic's hosted UI only if your application cannot support required functionality for a given provider.
Comparison
| Widget Session | Hosted Provider Session | Advanced Provider Session | |
|---|---|---|---|
| Trinsic Provider Selector | ✅ | ❌ | ❌ |
| Launch individual provider | ❌ | ✅ Only option | ✅ Only option |
| Trinsic UI | ✅ Only option | ✅ Only for providers that require additional user interaction | 🔵 You can own the UI 100%; let Trinsic handle it; or any blend of the two. |
| Block Trinsic UI | ❌ | ❌ | 🔵 Optionally enforce we never show our UI |
| Result collection | Redirect back returns resultsAccessKey, or iFrame/popup send message. | Redirect back returns resultsAccessKey | Redirect back returns resultsAccessKeyor polling after session creation. |
Test Providers
Easily test your integration, or try out a digital identity flow for yourself, with test mode.
In test mode, you'll have access to two kinds of providers:
- Trinsic Test Providers
- These are simple Trinsic-hosted web apps which are designed for rapid testing during development. We offer a number of test providers, covering all use cases and flows.
- Test-Enabled Providers
- Many of the Identity Providers within Trinsic's network offer their own test mode, which we make available through our platform.
SDKs
You can find all our SDKs, including samples, on our Github. We've included working samples for all SDKs that require only your auth token to run. If your specific tech stack isn't covered, please let us know; we're happy to help you get started. Click each link to find a detailed readme on the SDK's specific usage.
Updated 2 days ago