Skip to main content

Reconnect a secret a service stopped accepting

Do this when tasks that use a service start failing because the service no longer accepts Jaah's sign-in. Some secrets hold no key you pasted: Jaah signed in to the service for you, and keeps that sign-in. When the service refuses it, the secret is marked Needs reconnect. Sign in again on the same secret rather than adding a new one, so the projects it is attached to and the tasks that name it keep working.

Who can do this: anyone who can edit the secret. A secret you can only view opens read-only, with Back in place of Cancel, and offers no Reconnect.

  1. In the sidebar, select Directory, then the Secrets tab.
  2. To see which services have a secret in trouble, select Add secret. In the gallery, each service you have connected shows the worst state of its secrets on its card: Connected, Untested, Test failed or Needs reconnect, with a count when you have more than one, such as Needs reconnect · 2. Don't select the card: it adds another secret. Go back to the list.
  3. In Type, pick that service's type. The list shows only its secrets.
  4. Select a secret's name. It opens on Details, with its state beside the name. A line above the fields gives the last check: the service's own message, or The vendor refused the stored grant., and how long ago it happened.
  5. Select Reconnect at the end of that line. Jaah saves the secret, then opens the service's sign-in page.
  6. Sign in to the service and allow access. The service sends you back to the secret, which shows Connected. above the button you signed in with.
  7. Start one of the tasks that failed again, and check it gets past the step that used the service.

If it doesn't connect​

The secret's page says why, and nothing changes on the secret:

  • The authorization was not completed, so nothing was stored. You declined or closed the service's page. Select Reconnect again and allow access.
  • The connect attempt timed out. Connect again. You took too long on the service's page. Start again.
  • That connect attempt belongs to a different signed-in user. Connect again. Another person's sign-in finished in your browser. Start again while you are signed in to Jaah as yourself.
  • Reconnect is greyed out: hover it for the reason. Act as … names the organization to switch to first. Where Jaah can't sign in to the service yet, Reconnect isn't shown.

When such a secret has no Reconnect, it holds a key or token you pasted. Type the new one into its field on Details and select Save, as in Replace or delete a secret.