Usage
vg dsn create --workspace <id> [--region <region>] [--ingest <url>] [--write <path>]
What It Does
vg dsn create generates an HMAC-signed Data Source Name (DSN) token that authenticates uploads to the Vibgrate Cloud API.
Flags
| Flag | Default | Description |
|---|---|---|
--workspace | required | Your workspace ID |
--region | us | Data residency region (us, eu) |
--ingest | — | Custom ingest API URL (overrides --region) |
--write | — | Write DSN to a file |
Examples
Create a US DSN
vg dsn create --workspace ws-abc123
Create an EU DSN
vg dsn create --workspace ws-abc123 --region eu
Write to file
vg dsn create --workspace ws-abc123 --write .vibgrate/.dsn
Important: Add the DSN file to
.gitignore— it contains your authentication secret.
Custom ingest endpoint
vg dsn create --workspace ws-abc123 --ingest https://custom.ingest.example.com
DSN Format
The generated DSN follows this structure:
vibgrate+https://<key_id>:<secret>@<ingest_host>/<workspace_id>
Security Best Practices
- Never commit DSN tokens to source control
- Store DSNs as CI/CD secrets (e.g. GitHub Secrets, Azure DevOps variables, GitLab CI variables)
- Rotate DSN tokens periodically
- Use separate DSNs for different environments (dev, staging, production) if needed