Tray Platform / Using Connectors / Auth collector

Auth collector

You must be in a shared workspace to use this feature.

auth collector : hero image

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:

auth collector : new auth workflow visible

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 {
id
name
customFields
service {
id
name
icon
title
version
}
serviceEnvironment {
id
title
}
}
}
pageInfo{
hasNextPage
hasPreviousPage
}
}
}
}

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
}
}
}