Conjur Cloud Integration
GGScout supports integration with Conjur Cloud to collect and monitor your secrets. This guide will help you set up and configure the integration.
Supported Features
- Multiple secret versions collection
- CyberArk authentication
- Tenant-specific configuration
- Subdomain support
Configuration
To configure GGScout to work with Conjur Cloud, add the following configuration to your ggscout.toml
file:
[sources.conjur]
type = "conjurcloud"
auth_mode = "cyberark"
conjur_url = "${CONJUR_URL}"
client_id = "${CYBERARK_CLIENT_ID}"
client_secret = "${CYBERARK_CLIENT_SECRET}"
tenant_id = "${CYBERARK_TENANT_ID}"
subdomain = "my-company"
fetch_all_versions = true
Configuration Parameters
Parameter | Description | Required |
---|---|---|
type | Must be set to "conjurcloud" | Yes |
auth_mode | Authentication mode (e.g., "cyberark") | Yes |
conjur_url | The Conjur Cloud URL | Yes |
client_id | The client ID for authentication | Yes |
client_secret | The client secret for authentication | Yes |
tenant_id | The tenant ID | Yes |
subdomain | Your company's subdomain | Yes |
fetch_all_versions | Whether to collect all versions of secrets | No |
Authentication
GGScout supports authentication with Conjur Cloud through:
- CyberArk Integration: Using client ID and secret
- Environment Variables: Using standard Conjur environment variables
Environment Variables
CONJUR_URL
: The Conjur Cloud URLCYBERARK_CLIENT_ID
: Your CyberArk client IDCYBERARK_CLIENT_SECRET
: Your CyberArk client secretCYBERARK_TENANT_ID
: Your CyberArk tenant ID
Best Practices
- Use environment variables for sensitive credentials
- Follow the principle of least privilege for access policies
- Enable
fetch_all_versions
to track changes in your secrets over time - Regularly rotate client secrets
- Use separate subdomains for different environments
- Implement proper secret rotation policies