The CLI requires authentication to scan your code and sync results with your Vidoc project.
Get Your Token
- Go to app.vidocsecurity.com
- Select your project
- Navigate to Settings → API Keys
- Click “Create API Key”
- Copy the token
Store your token securely. Don’t commit it to version control.
Login
Interactive Login
You’ll be prompted to enter your token.
Direct Login
Provide the token as an argument:
Single-Tenant Installations
For self-hosted Vidoc instances, specify the API URL:
vidoc login --url https://your-vidoc-instance.com <your-token>
Profiles
Profiles let you manage multiple Vidoc configurations (e.g., different projects or environments).
Create a Named Profile
vidoc login --profile work <your-token>
vidoc login --profile personal <other-token>
List Profiles
vidoc config list-profiles
Switch Profile
vidoc config set-profile work
Create Empty Profile
vidoc config create-profile staging
Delete Profile
vidoc config delete-profile old-project
View Current Configuration
See your current authentication status and settings:
CI/CD Authentication
For CI/CD pipelines, pass the token directly:
vidoc ci --token $VIDOC_TOKEN
--token flag with scan:
vidoc scan --token $VIDOC_TOKEN
Troubleshooting
”Invalid token”
- Verify the token was copied correctly
- Check for extra whitespace
- Ensure the token hasn’t been revoked in the dashboard
”Unauthorized”
The token may be associated with a deleted project. Create a new token in an active project.
Related Pages
