Tray Platform / Using Connectors / Auth collector
Auth collector
On this page
You must be in a shared workspace to use this feature.
The Auth Collector feature allows you to securely gather authentications from your End Users for particular services.
This is done by sending the recipient a URL that they can visit to activate the authentication for the services you have requested.
Any auths they activate will then be accessible via the usual means, i.e.:
- The auths will be visible in the Tray app UI
- The auths will be accessible via the Embedded GraphQL APIs
Creating an auth request
To create an auth request go to the 'Authentications' section of your dashboard, click 'New authentication' in the top right and choose 'From request' from the dropdown:
Using the auth
Once the authentication has been completed by the end user, you will be able to use the authentication in any workflows as usual:
Embedded customers can also retrieve the authId
for an End User's created authentications using the Get User Authentications query (with the user's access token as bearer):
query {viewer {authentications {edges {node {idnamecustomFieldsservice {idnameicontitleversion}serviceEnvironment {idtitle}}}pageInfo{hasNextPagehasPreviousPage}}}}
And the authentications can be imported when using the Create Solution Instance mutation (or when Updating or Upgrading Solution Instances):
mutation {createSolutionInstance(input: {solutionId: "0dc02586-xxx-xxx-xxxx-cb98734578ef",instanceName: "some instance name",authValues: [{ externalId: "external_sqs_authentication", authId: "aaa67786-xxx-xxx-xxx-97dedd1519b3" }]}) {solutionInstance {id}}}