It is possible to allow your users to complete the authentication step using an auth-only dialog, instead of the Configuration Wizard.
This is useful for integrations that do not require End Users to carry out any personalization beyond authenticating with services.
You can see an example of this being put to use in our demo app with
onCreateAuth at https://github.com/trayio/embedded-edition-sample-app/blob/master/src/components/Instance.js
Note on whitelabellingCopy
Whitelabelling the urlCopy
Note that you can use an iFrame to present this if you wish to 'whitelabel' and hide the
https://embedded.tray.io url. If you wish to do this your domain will need to be added to our whitelist. Please contact us at email@example.com to arrange this.
You can also whitelabel the url using a custom domain as explained in our page on whitelabelling public urls
Whitelabelling the dialog CSSCopy
Please see our guide to whitelabelling auth-only dialog CSS for instructions.
Using auth-only dialogCopy
In order to use an auth-only dialog you will need to:
When editing your Solution, pick up the External ID for the authentication from the Configuration section:
2. Use the Create Solution Instance mutation to generate a solutionInstanceId for the End User (this requires an access token for your End User as per Create User Token)
3. When the End User clicks the relevant button in your app UI, the auth-only dialog is then initiated with a url which contains the externalAuthId and solutionInstanceId obtained in steps 1 and 2:
Please note the auth dialog URL could be different for you if you are in a different region.
If you are in the EU region, the auth dialog URL for you would be:
If you are in the APAC region, the auth dialog URL for you would be:
Remember that embeddedId is set in the Profile section of the dashboard, as explained here.
authorizationCode is the one-time use code that must be generated as per Create Config Wizard Authorization Code
An example url would then be:
The End User will then be presented with an authentication dialog for the service being authenticated with.
You can remove the Tray.io domain and whitelabel the Config Wizard url. If you have done so then
embedded.tray.io will be replaced with e.g.
4. Final step is to use the Update Solution Instance mutation to update the solutionInstanceId with authValues for the End User (this requires an access token for your End User as per Create User Token)