Skip to main content

Basic Auth

Use this credential type for upstream APIs that require username:password over HTTP auth.

Configure​

  1. Open Credentials -> New Credential.
  2. Select type basic.
  3. Enter:
    • username
    • password (or env-backed password field)
  4. Save and attach to your proxy/workflow HTTP call.

Verify​

curl -i "https://gateway.example.com/basic-auth-test" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Client-ID: app-prod" \
  -H "X-Profile-ID: prod-default"

Expected: upstream returns success (200-299) when credential is valid.

Common issues​

  • 401 from upstream: invalid username/password.
  • Runtime secret error: env variable configured but not present at runtime.