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
auth | How the runner gets a token | Settings |
|---|---|---|
client-credentials (default when client_id and client_secret are set) | An app registration's client secret | tenant_id, client_id, client_secret (env:// or file://), authority_host for other clouds |
managed-identity | The 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 endpointWhen 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.comDelinea Secret Server
Read scan credentials from Delinea Secret Server with an OAuth2 sign-in and the secret field endpoint, using the delinea provider type in the runner's provider file.
REST connector
Read scan credentials from any PAM or secret store with an HTTP API by describing its sign-in and fetch requests in the provider file, with an example for ManageEngine PAM360 and a note on Delinea Secret Server.