Skip to main content

Device: Users

Device > Users manages account credentials, HTTP API authentication, and bearer API tokens across two tabs: Access and API.

Access​

The Access tab controls administrator and guest login credentials as well as HTTP CGI authentication.

Access Settings with the admin password, guest password, and HTTP authentication controls

Admin and Guest Passwords​

Passwords accept letters, numbers, and !@#$^*()-_. up to 64 characters. Password fields include an eye button to show or hide characters.

SettingControlBehavior
Admin PasswordChange buttonOpens the Change Admin Password dialog (Current Password, New Password, Confirm New Password, with Cancel and Change Password buttons).
Enable Guest UserCreate Guest Password buttonOpens the Create Guest Password dialog (New Password, Confirm New Password, with Cancel and Create Password buttons) to enable guest access.

The Change Admin Password dialog with three empty password fields

The Create Guest Password dialog with two empty password fields

HTTP Authentication​

SettingControlOptions
AuthenticationSwitchOn, Off (requires credentials on HTTP API requests when On; see HTTP API Getting Started)

API Tokens​

The API tab lets you issue and revoke named API tokens for integrations and control software.

What you need

Enable Time Sync under Device > Network > NTP before using API tokens. As noted on the API tab, API tokens work as expected only when NTP is enabled; see Device: Network.

The API Tokens page with a Create token button and an empty token table

Create an API Token​

Copy the token before closing the dialog

Horizon displays the generated token value only once in the Save your API token dialog. Copy and store it securely before selecting Done.

  1. Open Device > Users > API and select Create token.
  2. In Create API token, enter a Name using letters, numbers, hyphens (-), and underscores (_), up to 32 characters (placeholder Example: camera_admin-01).
  3. Select an Expiry period from the dropdown: 7 days, 30 days, 90 days, 6 months, 1 year, or Never expires.
  4. Select Create.
  5. In the Save your API token dialog, select the copy button to copy the token, store it in your integration or secret manager, and select Done.

The Create API token dialog with the Name field and the Expiry dropdown set to 30 days

The Create API token dialog with the Expiry dropdown open

The Save your API token dialog, with the token value hidden

Refresh or Delete an API Token​

Created tokens appear in the table with Name, Expires (YYYY-MM-DD), and an Action menu (three-dot icon):

ActionBehavior
Refresh expiryExtends the token's expiration date from the current time.
DeleteOpens the Delete token? confirmation dialog ("[token name] will be permanently removed."). Select Confirm to revoke and delete the token immediately.

The token list with one token and its actions menu open

The Delete token confirmation dialog with Cancel and Confirm buttons

Ask PTZOptics AI

Ask a question about PTZOptics products or documentation.