Skip to main content
Read a secret from a secret store while your automation runs. Intuned resolves the reference with your Project’s credentials for the store. Your code gets the secret’s value but never sees the credentials.

Supported stores

The reference’s scheme picks the store.

Available helpers

Function reference

resolve_secret

Resolves a secret reference and returns its value. Each call reads from the store again.
Call it inside without_tracing. On a traced Run, calling it outside an async with without_tracing(): block raises, so the secret can’t be captured by the browser trace, a screenshot, or an automation log. On a Run that isn’t traced, the block isn’t required.
Parameters
str
required
The secret reference. For 1Password, a secret reference: op://<vault>/<item>/<field>, or op://<vault>/<item>/<section>/<field>, optionally followed by a query such as ?attribute=otp.Python type checkers can’t check a string’s format, so the format is checked when the function runs. SecretReference is exported to document intent in your own signatures.
Returns Returns the secret’s value as a str. Raises
  • ValueError if reference isn’t a supported secret reference.
  • SecretResolveError if the Run is traced and no without_tracing block is open.
  • SecretResolveError if the secret can’t be read. This happens when the store’s integration isn’t enabled, its credentials are missing or can’t read the item, or the machine running the Run doesn’t answer in time. The message names the reference, never the secret.
For 1Password, every call counts toward your service account’s rate limits. Resolve a secret once per Run and reuse it rather than calling it in a loop.

is_secret_reference

Returns True if value is a supported secret reference.