Licensing

ProAuth includes built-in license validation to ensure compliance with your software license agreement. The license system validates your deployment at runtime and provides clear feedback about your license status.

Overview

When ProAuth starts, it validates the installed license file against several criteria:

• License validity: Ensures the license file is valid and properly signed
• Version compatibility: Verifies your ProAuth version is covered by the license
• Expiration status: Checks subscription and software upgrade expiration dates
• Feature entitlements: Validates access to licensed features and modules

License Types

ProAuth supports different license types, each with specific characteristics:

License Type	Description
Subscription	Time-limited license that expires on a specific date
Perpetual	License for a specific ProAuth version that never expires
Perpetual with Upgrades	Perpetual license with time-limited upgrade rights

Subscription Licenses

Subscription licenses are valid until the specified expiration date. ProAuth will continue to function as long as the subscription is active. When a subscription expires, ProAuth will log warnings and eventually restrict functionality.

Perpetual Licenses

Perpetual licenses are tied to a specific ProAuth version and never expire. You can continue using the licensed version indefinitely.

Perpetual with Upgrade Rights

This license type combines perpetual usage rights with time-limited upgrade eligibility. After the software upgrade period expires, you can continue using the last version released within that period indefinitely.

License Validation

ProAuth performs license validation:

• At startup: Initial validation when ProAuth starts
• Periodically: Background validation at configurable intervals (default: every 4 hours)

Validation Behavior

The license validation runs as a background job and checks the current license status. If issues are detected, ProAuth logs appropriate warnings or errors:

License status: Valid subscription license, expires on 2026-12-31

Or in case of issues:

License validation warning: License expires in 30 days

Monitoring License Status

API Endpoint

License and product information can be retrieved via the Management API:

GET /api/v1/productinformation

This endpoint returns:

• Product version information
• License status and expiration dates
• Licensed features and modules
• Allowed host configurations

Logs

License-related events are logged with the following categories:

• ProAuth.Common.Licensing.ProAuthLicenseManager - License validation events
• ProAuth.JobQueue - Background license check job execution

Configure your log aggregation to monitor these categories for license-related warnings.

Recommended Alerts

Consider setting up alerts for the following log patterns:

Pattern	Severity	Action
License expires in	Warning	Plan license renewal
License has expired	Error	Renew license immediately
License validation failed	Error	Check license file installation
No valid license found	Critical	Install valid license

Troubleshooting

Common Issues

License file not found

Ensure the license file is properly mounted in the container at the configured path. Check your Helm values or Docker configuration.

Version mismatch

If you see version compatibility warnings, verify that your license covers the installed ProAuth version. You may need to upgrade your license for newer versions.

Expired license

Contact your ProAuth representative to renew your license. ProAuth will continue to operate with reduced functionality during a grace period.

Verifying License Installation

Use the ProAuth CLI to verify your license installation:

proauth license verify --license-file <path-to-license>

This command displays detailed information about the license including:

• License holder information
• Valid versions
• Expiration dates
• Licensed features

See Also

• Prerequisites - Resource access and license credentials
• Monitoring - Setting up observability for license events
• Software License Agreement - License terms and conditions