> For the complete documentation index, see [llms.txt](https://doc.duaer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/external-secrets.md).

# Use external secret stores in Duaer

Use an external secrets vault with Duaer.
## Connect Duaer to your secrets store <a href="#connect-n8n-to-your-secrets-store" id="connect-n8n-to-your-secrets-store"></a>

1. Go to Settings → External Secrets.
2. Enter the connection your vault requires, then Save.

The help link on that screen points at this section. The connection is the vault’s access method, not a paste of every secret into Duaer. Until it is connected, credential fields cannot pick an external secret, and $secrets is not available.

## Use secrets in Duaer credentials <a href="#use-secrets-in-n8n-credentials" id="use-secrets-in-n8n-credentials"></a>

A secret only appears in the picker on a credential field. After you pick it, Duaer fetches it at runtime. The screen should not show the value, and the execution record should not contain the plaintext. The $secrets completion hint also hides the value, and it is only available in credential fields.

Do not write a secret into a node parameter or a [variable](/code/variables.md). Anyone who can open Variables can read a variable.

## Access for project roles <a href="#access-for-project-roles" id="access-for-project-roles"></a>

On an instance licensed for external secrets, v3 gives project editors and admins the external-secrets scopes by default and removes the old Settings toggle. If that toggle was off before the update, those roles become wider. The breaking-change check links to this section.

On an instance that is not licensed for external secrets, that check does not apply. A finer split still goes through [custom roles](/user-management/rbac/custom-roles.md).
## Questions

### Does an external secret appear on the credential screen?

No. Duaer reads it from a connected vault into credential fields only; the UI does not show plaintext. Without a vault, $secrets is unavailable.

### Who can use external secrets after v3 in Duaer?

On a licensed instance, v3 gives project editors and admins external-secrets scopes by default and removes the old Settings toggle.

