Skip to main content

​
Authentication Errors

​
User Not Found

Error Message:
Cause: The user account is not registered with SafeDep Cloud. Solution:
1

Register Account

Follow the quickstart guide to register with SafeDep Cloud
2

Verify Registration

Ensure you’ve completed the full onboarding process including tenant creation
3

Check Email Verification

Verify your email address if required during registration

​
Tenant Not Found

Error Message:
Cause: The tenant is not properly configured in Vet, or the tenant domain is incorrect. Solution:

​
API and Connectivity Issues

​
Rate Limiting

Error Message:
Solution:
  • Back off briefly and retry. SafeDep enforces per-second rate limits, so a short pause clears the error (see the API reference for the current limits)
  • Reduce the frequency of API calls and use batch operations where possible
  • Contact support for increased rate limits if needed

​
Network Connectivity

Error Message:
Solution:
  • Check internet connectivity
  • Verify DNS resolution for api.safedep.io
  • Check firewall settings and proxy configuration
  • Ensure HTTPS traffic on port 443 is allowed

​
SSL/TLS Issues

Error Message:
Solution:
  • Update your system’s CA certificates
  • Check system clock accuracy
  • Verify no proxy is interfering with SSL
  • Try updating Vet to the latest version

​
Configuration Issues

​
Invalid API Key

Error Message:
Solution:
1

Generate New Key

Create a new API key in your SafeDep Cloud tenant settings
2

Update Configuration

3

Verify Permissions

Ensure the API key has the necessary permissions for your operations

​
Expired Tokens

Error Message:
Solution:

​
Configuration File Issues

Error Message:
Solution:
  • Check file permissions on Vet configuration directory
  • Ensure user has write access to ~/.config/vet/
  • Try running with appropriate permissions
  • Clear and recreate configuration if corrupted

​
Data Sync Issues

​
Sync Failures

Error Message:
Solution:
  • Verify project name and version are correctly specified
  • Check that tenant has permissions for data sync
  • Ensure API key includes sync permissions
  • Retry with proper project identification

​
Missing Data

Issue: Scanned data doesn’t appear in SafeDep Cloud Solution:
1

Check Sync Flags

Ensure --report-sync is included in your scan command
2

Verify Project Info

3

Check Authentication

​
Query Failures

Error Message:
Solution:
  • Verify SQL syntax is correct
  • Check table and column names in schema
  • Use safedep query schema list to view available tables
  • Ensure proper quoting for identifiers with special characters

​
GitHub Actions Issues

​
Secret Configuration

Issue: GitHub Action fails with authentication errors Solution:
1

Check Secrets

Verify these secrets are set in your repository:
  • SAFEDEP_CLOUD_API_KEY
  • SAFEDEP_CLOUD_TENANT_DOMAIN
2

Update Workflow

​
Action Version Issues

Issue: Action fails with “unknown parameter” errors Solution:
  • Update to the latest version of vet-action
  • Check the action documentation for parameter changes
  • Verify you’re using supported parameters for your action version

​
Performance Issues

​
Slow Scans

Issue: Scans take too long to complete Solution:
  • Use path exclusions to skip irrelevant directories
  • Scan specific manifest files instead of entire directories
  • Adjust timeout settings for malware analysis
  • Use JSON dump workflow for repeated analysis

​
Memory Issues

Issue: Vet runs out of memory during scans Solution:
  • Scan smaller directory trees
  • Use exclusions to skip large dependency directories
  • Increase available memory in CI/CD environments
  • Process large monorepos in batches

​
Getting Additional Help

GitHub Issues

Report bugs and request features

Documentation

Setup guides

Community Support

Join our Discord community for help

Contact Support

Direct support

​
Common Debugging Commands

​
Check Authentication Status

​
Verify API Configuration

​
Test Cloud Connectivity

​
Clear Configuration

​
Re-authenticate

​
View Detailed Logs