Safeguard Docs
Credentials VaultProviders

Azure Key Vault and AWS Secrets Manager

Read scan credentials from Azure Key Vault or AWS Secrets Manager with the runner's own cloud identity.

Azure Key Vault and AWS Secrets Manager

Azure Key Vault

Reference

pam://azure-key-vault/<vault-name>/<secret-name>[/<version>]

The runner reads GET https://<vault-name>.vault.azure.net/secrets/<secret-name>[/<version>]?api-version=7.4 with a Microsoft Entra ID token for https://vault.azure.net. Without a version it reads the current one.

Identity

authHow the runner gets a tokenSettings
client-credentials (default when client_id and client_secret are set)An app registration's client secrettenant_id, client_id, client_secret (env:// or file://), authority_host for other clouds
managed-identityThe Azure VM's managed identity (instance metadata service)client_id for a user-assigned identity, imds_url to override

Give the identity the Key Vault Secrets User role (or a get access policy) on the scan secrets only.

providers:
  - type: azure-key-vault
    auth: client-credentials
    tenant_id: 00000000-0000-0000-0000-000000000000
    client_id: 11111111-1111-1111-1111-111111111111
    client_secret: file:///etc/safeguard/azure-client-secret
    # url: https://scan-kv.privatelink.vaultcore.azure.net   # private endpoint

When url is set it replaces the vault address, and the vault name in the reference is informational.

AWS Secrets Manager

Reference

pam://aws-secrets-manager/<secret-id>[#json-key]

<secret-id> is the secret's name or ARN (an ARN sets the region). With #json-key, the secret string is read as a JSON object and that key returned, for example pam://aws-secrets-manager/scanning/dast-login#password.

Identity

The runner signs GetSecretValue with the default AWS credential chain: environment variables, the shared profile (profile), SSO, web identity, or the instance or container role. Grant secretsmanager:GetSecretValue on the scan secrets only (and kms:Decrypt on their key when it is a customer-managed key).

providers:
  - type: aws-secrets-manager
    region: ap-south-1
    # profile: safeguard-scan
    # endpoint: https://vpce-0123.secretsmanager.ap-south-1.vpce.amazonaws.com

On this page