A secret request asks a specific person to supply a value through a single-use link. The secret is created empty with the status Awaiting value, and the person types the value into a page that sends it straight to the store. The person who asked, and any AI agent working for them, never sees it. Use a request whenever someone else holds the credential, or whenever an agent needs a credential in your tenant: an agent should ask with a request rather than take a value into its own hands.

Make a request

  1. Open Secrets and choose Request from someone.
  2. Enter a Name, a Kind, and What it will be used by (for example “the billing sync app”).
  3. Optionally enter a Recipient such as user:…. You can also fulfil it yourself. Leave it blank and only you can fulfil the request.
  4. Choose Create request link and copy the link.
The link is shown once, when the request is made. Only a hash of it is stored, so it cannot be shown again. If you lose it, revoke the request and make a new one. The Open requests list on the Secrets page shows each request’s secret, what it is for, the recipient, who asked, and when it expires. Send the link over a channel only the recipient reads. The part of the link after # is what authorises a submission, and the page it opens is not cached. The recipient needs Secret read to open the request and Secret update to submit a value. The built-in data_engineer, data_admin and account_admin roles include both; a custom role can grant them too. viewer and analyst do not have these rights. If the recipient cannot open the request with their current access, ask a tenant admin for a role that can read and update secrets, or ask the requester to create a new request naming someone who can, or to supply the value themselves. Forwarding the same link does not change who may fulfil it.

What the recipient sees

A recipient with the required access opens the link, signs in, and sees who asked, which secret it is, its kind, what it will be used by and when it expires. They enter the value and choose Submit, or choose Report this request if they were not expecting it.

After the value arrives

The secret becomes Active with its first version, created by the request. From there it behaves like any other secret: bind it, grant access to colleagues, or rotate it.

Limits

  • Up to 20 requests can be open at a time.
  • A link works once and for 24 hours.
  • A request, its revocation and its fulfilment appear in the secret’s Activity tab. The value does not.