Auth collector

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