Authentication

Pyvorin uses the Pyvorin Portal to authenticate devices and licence keys. The CLI supports web-based device activation and licence-key activation.

Device activation flow

1. Run pyvorin auth login.
2. The CLI displays a device code and a URL such as https://crm.pyvorin.com/device.
3. Open the URL, sign in to your Pyvorin account, and enter the code.
4. The CLI polls until you approve the request.
5. Once approved, the CLI stores a device token locally.

Licence-key activation

1. Run pyvorin auth activate --key PYV-XXXX-XXXX-XXXX.
2. The CLI sends your device token and licence key to the Portal.
3. The server returns a long-lived licence device token if the key is valid and within its device limit.

Token expiry and refresh

Device authorization codes expire after 10 minutes. Licence device tokens can be refreshed with pyvorin auth refresh. If a token expires or is revoked, the CLI requests re-authentication.

Revocation

You can revoke a device from the Licences page in the Portal. Once revoked, the device token is invalid and the CLI must re-authenticate. Revocation takes effect immediately for new requests.