> This page is for version V3 - Beta (default).
> For other versions, use one of these documentation indexes:
> - V3 - Beta (default): https://docs.authlyx.dev/v3/llms.txt
> - V2 - Legacy: https://docs.authlyx.dev/v2/llms.txt
> - V1 - End of support: https://docs.authlyx.dev/v1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.authlyx.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.authlyx.dev/_mcp/server.

# AppKeys and management keys

> AppKeys and management keys in AuthlyX, with examples and troubleshooting.

## Which key belongs in your app?

MyApp needs an AppKey so AuthlyX knows which application is connecting. That key can be included in distributed customer software. It identifies the app; it does not give everyone permission to manage the developer account.

An Elite Key or Bot Key is different. Those credentials authorize management operations according to their permissions. Keep them on a server or in the authorized bot service, never in a desktop binary, browser bundle or public repository.

```mermaid
flowchart LR
    A[MyApp customer software] -->|AppKey and login proof| B[Client API]
    C[Developer's private server] -->|Scoped management key| D[Management API]
    B --> E[Check customer access]
    D --> F[Manage permitted records]
```

## An AppKey is not an unbreakable app secret

Someone who can inspect the customer's software can read embedded values. AppKeys therefore cannot prove that an HTTP request came from an unmodified program. AuthlyX uses authenticated identities, installation proof and server-side authorization to decide access.

Use the AppKey and version from the same application as your test license. Initialize first, then log in. Never paste a management key into the AppKey field to fix a failed login.

## Rotating credentials

Rotate management keys when a server or bot credential may have leaked. Give each integration a descriptive name, only the permissions it needs and an expiry when appropriate. Revoke old keys after updating the service.

AppKey rotation also needs a release plan: existing software may still contain the previous key. Test the transition before changing a live app. Verification public keys are a third category: they let the SDK verify server signatures and do not grant management access. Keep trusted verification keys in step with the API's signing-key rotation.

## Check your release

Search the compiled frontend configuration and repository for management credentials. Confirm that customer software can authenticate but cannot create arbitrary licenses or inspect another account. The warning in API Reference applies to both Elite Keys and Bot Keys.