Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Licensing

Rockfish uses Ed25519-signed licenses with tier-based feature restrictions.

License Tiers

TierFeatures
CommunityBasic schema (48 fields), local storage only
Basic+ nDPI labels, custom observation name
Professional+ GeoIP, nDPI fingerprints (60 fields)
Enterprise+ ML models, anomaly detection

License File

Licenses are JSON files with an Ed25519 signature:

{
  "id": "lic_abc123",
  "tier": "professional",
  "customer_email": "[email protected]",
  "company": "Example Corp",
  "observation": "sensor-01",
  "issued_at": "2025-01-01T00:00:00Z",
  "expires_at": "2026-01-01T00:00:00Z",
  "signature": "base64-encoded-signature"
}

Configuration

Specify the license file in your config:

license:
  path: /opt/rockfish/etc/license.json

Or via environment variable:

export ROCKFISH_LICENSE_PATH=/opt/rockfish/etc/license.json
rockfish_probe -c config.yaml

Feature Matrix

FeatureCommunityBasicProfessionalEnterprise
Schema v1 (Simple)YesYesYesYes
Schema v2 (Extended)NoNoYesYes
GeoIP FieldsNoNoYesYes
nDPI FingerprintsNoNoYesYes
nDPI LabelingNoYesYesYes
Custom Observation DomainNoYesYesYes
Anomaly DetectionNoNoNoYes

Parquet Metadata

Licensed files include metadata for validation:

KeyDescription
rockfish.license_idLicense identifier
rockfish.tierLicense tier
rockfish.companyCompany name
rockfish.customer_emailCustomer email
rockfish.issued_atLicense issue date
rockfish.observationObservation domain name

MCP License Validation

Rockfish MCP can validate that Parquet files were generated by a licensed probe:

sources:
  licensed_flows:
    path: s3://data/flows/
    description: Licensed network flow data
    require_license: true

  enterprise_flows:
    path: s3://data/enterprise/
    description: Enterprise flow data
    require_license: true
    allowed_license_ids:
      - "lic_abc123"
      - "lic_def456"

Obtaining a License

Contact [email protected] for license inquiries.