Flow.Documentation

Your own key vault (Azure, AWS or Google Cloud)

10 steps± 7 minVideoVerified 28 Oct 2026
  1. Step 1 · Open the secrets of Development
  2. Step 2 · Test Flow's own vault
  3. Step 3 · Propose AWS Secrets Manager
  4. Step 4 · Set up AWS with the portal's steps
  5. Step 5 · Test the new vault
  6. Step 6 · Approve the switch
  7. Step 7 · Check the vault
  8. Step 8 · Choose Google Cloud for Production
  9. Step 9 · Set up Google Cloud and test
  10. Step 10 · Approve: Production reads from Google Cloud

Passwords and keys Flow uses are kept encrypted in Flow's own vault by default. If you want to keep them in your own cloud, in Azure Key Vault, AWS Secrets Manager or Google Cloud Secret Manager, you choose that per environment in the portal. Workflows refer to a secret by its name; which vault looks that name up is up to the environment. So Test reads Test's vault and Production reads Production's, with the same workflow. Another vault is an access change: an owner approves it, and Flow never copies values — you put them in the new vault yourself.

Watch the whole guide as a video10 steps in one film
Step 1 / 10

Open the secrets of Development

Under Environments, click Development and choose Secrets and keys: there you see where this environment's secrets live and whether the vault works. A new environment uses Flow's own vault: encrypted in its own database.

  1. Click Development
Open the secrets of Development · Click Development
  1. Click Secrets and keys Vault · no AI key yet · own key
Open the secrets of Development · Click Secrets and keys Vault · no AI key yet · own key
Open the secrets of Development · Flow's own vault, not checked yet.
Step 2 / 10

Test Flow's own vault

Check now checks that this environment's vault answers: that it can open its key and read the names Flow uses. For Flow's own vault there is nothing to set up — no rights, no test secret. If a name a workflow or connection uses is missing, you see that here too.

  1. Click Check now
Test Flow's own vault · Click Check now
Test Flow's own vault · ‘Flow's own vault · Works’ — nothing needs to be set up.
Step 3 / 10

Propose AWS Secrets Manager

Choose another vault and fill in where the secrets will live: the region, the role Flow assumes and the prefix under which this environment may read — every environment a prefix of its own, so Development can never reach Production's secrets. A developer may propose this too; only an owner approves it.

  1. Click Choose another vault
Propose AWS Secrets Manager · Click Choose another vault
  1. Click AWS Secrets Manager
Propose AWS Secrets Manager · Click AWS Secrets Manager
  1. In Region, type eu-west-1
  2. In Role (ARN), type arn:aws:iam::123456789012:role/flow-vault-accountants-dev
  3. In Allowed prefix (ARN), type arn:aws:secretsmanager:eu-west-1:123456789012:secret:flow/vault-accountants/dev/
  4. In Why, type The auditor wants every key in our own cloud
Propose AWS Secrets Manager · In Region, type eu-west-1; In Role (ARN), type arn:aws:iam::123456789012:role/flow-vault-accountants-dev; In Allowed prefix (ARN), type arn:aws:secretsmanager:eu-west-1:123456789012:secret:flow/vault-accountants/dev/; In Why, type The auditor wants every key in our own cloud
  1. Click Propose the change
Propose AWS Secrets Manager · Click Propose the change
Propose AWS Secrets Manager · The proposal, with the four steps of the move.
Step 4 / 10

Set up AWS with the portal's steps

The portal writes out exactly what you set up in AWS, with this environment's values already filled in: the portal as identity provider, a role that trusts only this environment, and read access under the prefix. No access key is needed. Then put the values in Secrets Manager under their workspace's name — /; Flow shows that name with every secret — plus the test secret flow-canary right under the prefix.

  1. Click Show the steps for Amazon Web Services (AWS)
Set up AWS with the portal's steps · Click Show the steps for Amazon Web Services (AWS)
Set up AWS with the portal's steps · The read policy, only for this prefix.
Step 5 / 10

Test the new vault

Before anyone approves, the environment reads the test secret flow-canary from the proposed vault — with its own identity, as it will for real — and checks that every name it uses is there. You see what was found, never a value.

  1. Click Test this vault
Test the new vault · Click Test this vault
Test the new vault · ‘flow-canary · found · version 1’.
Step 6 / 10

Approve the switch

An owner approves; who asked and who decided is recorded. The environment restarts and from then on reads from AWS. The same workflows keep working: the names stayed the same.

  1. Click Approve
Approve the switch · Click Approve
  1. Click Yes, switch
Approve the switch · Click Yes, switch
Approve the switch · A message: Development restarts with the new vault.
Step 7 / 10

Check the vault

Once the environment runs again, AWS Secrets Manager is at the top, with the prefix. Check now reads the test secret from the environment's own vault; the result stays as its health, with who tested and when. An error stays visible until a later test succeeds.

  1. Click Check now
Check the vault · Click Check now
Check the vault · ‘Works’, tested by you, just now.
Step 8 / 10

Choose Google Cloud for Production

Every environment chooses its own vault. Open Production and propose Google Cloud Secret Manager: the project ID that holds the secrets, the project number, the workload identity pool and the provider in it. A service account is not needed: left empty, Flow reads with the environment's own identity, without a key file.

  1. Click Environments
Choose Google Cloud for Production · Click Environments
  1. Click Production
Choose Google Cloud for Production · Click Production
  1. Click Secrets and keys Vault · no AI key yet · own key
Choose Google Cloud for Production · Click Secrets and keys Vault · no AI key yet · own key
  1. Click Choose another vault
Choose Google Cloud for Production · Click Choose another vault
  1. Click Google Cloud Secret Manager
Choose Google Cloud for Production · Click Google Cloud Secret Manager
  1. In Project ID, type kluis-en-196c5c39
  2. In Project number, type 835172959
  3. In Workload identity pool, type flow
  4. In Provider in the pool, type flow-prod
  5. In Why, type Production in our Google Cloud project
Choose Google Cloud for Production · In Project ID, type kluis-en-196c5c39; In Project number, type 835172959; In Workload identity pool, type flow; In Provider in the pool, type flow-prod; In Why, type Production in our Google Cloud project
  1. Click Propose the change
Choose Google Cloud for Production · Click Propose the change
Choose Google Cloud for Production · The proposal: Flow's own vault → Google Cloud Secret Manager, projects/kluis-en-196c5c39.
Step 9 / 10

Set up Google Cloud and test

The steps in the portal already name your project number, pool and provider: create the pool, add the portal as OIDC provider with the condition that lets only Production in, and give that identity the role Secret Manager Secret Accessor. Put the values in Secret Manager under their workspace's name, __, plus flow-canary. Then test the vault: Production reads the test secret with its own identity.

  1. Click Show the steps for Google Cloud
Set up Google Cloud and test · Click Show the steps for Google Cloud
Set up Google Cloud and test · The OIDC provider, with the condition for exactly this environment.
  1. Click Test this vault
Set up Google Cloud and test · Click Test this vault
Set up Google Cloud and test · ‘flow-canary · found · version 1’, from Google Cloud.
Step 10 / 10

Approve: Production reads from Google Cloud

After approval Production restarts and from then on reads from Secret Manager; Development stays on AWS. The same workflow looks up the same name, each in its own vault. Check now proves it.

  1. Click Approve
Approve: Production reads from Google Cloud · Click Approve
  1. Click Yes, switch
Approve: Production reads from Google Cloud · Click Yes, switch
  1. Click Check now
Approve: Production reads from Google Cloud · Click Check now
Approve: Production reads from Google Cloud · Google Cloud Secret Manager, projects/…: ‘Works’.

This guide was carried out step by step on 28 Oct 2026 by an automated test on Flow (version 96971699).