VeriBits Python SDK

Official Python SDK for the VeriBits security API.

Installation

pip install veribits

Quick Start

from veribits import VeriBits

# Initialize client
client = VeriBits(api_key="your_api_key")

# Threat intelligence lookup
result = client.threat_intel.lookup("d41d8cd98f00b204e9800998ecf8427e")
print(f"Threat score: {result['threat_score']}")

# Submit file to sandbox
scan = client.sandbox.submit("/path/to/suspicious/file.exe")
print(f"Task ID: {scan['task_id']}")

# Generate SBOM for your project
sbom = client.cicd.generate_sbom(format="cyclonedx")

Features

Threat Intelligence

# Lookup hash
result = client.threat_intel.lookup("sha256_hash")

# Batch lookup
results = client.threat_intel.batch_lookup(["hash1", "hash2", "hash3"])

# Search threats
threats = client.threat_intel.search(query="ransomware", limit=10)

Malware Sandbox

# Submit file for analysis
submission = client.sandbox.submit("/path/to/file", analysis_type="full")

# Check status
status = client.sandbox.status(submission['task_id'])

# Get results
results = client.sandbox.result(submission['task_id'])

CI/CD Integration

# Generate SBOM
sbom = client.cicd.generate_sbom(format="cyclonedx")

# Scan dependencies for vulnerabilities
vulns = client.cicd.scan_dependencies("requirements.txt")

# Scan for hardcoded secrets
secrets = client.cicd.scan_secrets("./src")

Cryptographic Services

# Publish a public key
key_info = client.crypto.publish_key(pgp_key, key_type="pgp")

# Lookup a key
key = client.crypto.lookup_key("user@example.com")

# Verify signature
result = client.crypto.verify_signature(data, signature)

# Validate certificate
validation = client.crypto.validate_certificate(cert_pem)

Error Handling

from veribits import VeriBits, APIError, AuthenticationError, RateLimitError

client = VeriBits(api_key="your_api_key")

try:
    result = client.threat_intel.lookup("hash")
except AuthenticationError:
    print("Invalid API key")
except RateLimitError as e:
    print(f"Rate limited. Retry after {e.retry_after} seconds")
except APIError as e:
    print(f"API error: {e.status_code} - {e}")

Configuration

# Custom API endpoint
client = VeriBits(
    api_key="your_api_key",
    api_url="https://custom.veribits.com"
)

Requirements

• Python 3.8+
• requests >= 2.28.0

License

MIT License - see LICENSE for details.

Links

• VeriBits Platform
• API Documentation
• GitHub