Skip to Content

Adding Users and Employees

Users in Liona represent the individuals or systems that will access your AI providers. This could include your employees, customers, or application services. Adding a user in Liona allows them to authenticate and use AI providers without ever seeing your original API keys.

Creating a User

In the Liona dashboard, click “Users” in the sidebar navigation.

Navigate to Users

Click “New User”

Click the “New User” button in the top-right corner of the page.

Enter user details:

  1. Unique ID: Enter a unique identifier for the user (e.g., email, user ID, username)
    • This must be at least 3 characters
    • This will be how you identify the user in your system
  2. Email (Optional): The user’s email address for identification
  3. Policy: Select a usage policy to apply to this user

Create the user

Click “Create User” to add the user to your project. After creation, you’ll be prompted to create an access key for the new user.

Enter user details

Copy the access key

Copy the generated access key.

Copy access key

Managing Access Keys

Access keys are how users authenticate with Liona. You can create multiple access keys for each user, with different expiration dates.

Generating Additional Access Keys

You may need to create additional keys for a user if:

  • The original key was lost
  • You need to rotate keys for security
  • Different applications need separate keys

To generate a new access key:

  1. Navigate to “Users” and select the user
  2. In the “Access Keys” section, click “Create Key”
  3. Select the expiration period (30 days, 90 days, 180 days, 1 year, or never)
  4. Click “Create Access Key”
  5. Copy the new access key

Generate additional key

Managing Existing Keys

For existing keys, you can:

  • View: See key details including last use and expiration date
  • Deactivate/Activate: Temporarily disable a key without deleting it
  • Copy: Copy the key to the clipboard

User-Specific Policies

In addition to the default policy assigned during creation, you can create user-specific policies:

  1. Navigate to the user’s detail page
  2. In the “User Policy” section, click “Create Policy”
  3. Set the policy limits
  4. Set an expiration date for the temporary policy
  5. Click “Create Policy”

User policies override project-level policies and are great for:

  • Temporarily increasing limits for high-usage periods
  • Providing special access for specific users
  • Testing different usage patterns

Blocking Users

If you need to prevent a user from accessing your AI providers:

  1. Navigate to the user’s detail page
  2. Click the “Block User” button
  3. Confirm the action

Blocking a user immediately prevents all their access keys from working. You can unblock a user at any time to restore access.

Dynamic User Creation via API

For applications that need to create users programmatically, Liona provides an API for user management. See the API Reference for more details.

Tracking User Usage

To monitor how your users are using the AI providers:

  1. Navigate to the user’s detail page
  2. View their usage statistics in the “Executions” section
  3. For more detailed tracking, see Tracking Usage

Next Steps

After adding users and generating access keys:

  1. Share the access keys with your users or integrate them into your applications
  2. Track usage to monitor spending and activity
  3. Explore connecting with SDKs to use native AI libraries
Last updated on
Creating Usage PoliciesTracking Usage