> For the complete documentation index, see [llms.txt](https://docs.adaptiva.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adaptiva.com/platform-guide/client-management/client-authorization.md).

# Client Authorization

{% hint style="info" %}
Client Authorization is only used for the on-premises version of the OneSite Platform. For more information on Client Tokens for SaaS, please visit our [Client Install](https://docs.adaptiva.com/platform-install/client-install-and-uninstall/client-install/client-install-saas) page.
{% endhint %}

Client Authorization can be used to additionally protect Adaptiva client installations that are completed over the internet. This is important when the client cannot communicate with the Adaptiva Server, but can communicate with the Adaptiva Cloud Relay Services at `http://services.adaptiva.cloud`.

When an Authorization Secret is created, a new client installation must include that Authorization Secret. A secret is entered during the Adaptiva Client installation that ensures only clients with valid secrets can be registered with the Adaptiva Server.

Multiple secrets can be created, and either secret can be entered when prompted. For instance, you may want to give one Admin group a particular secret that differs from another group based on location. Both secrets will grant Client Authorization regardless of which secret is entered.

Authorization Secrets can be created and removed at any time. When removed, be sure to update any command lines that included the secret.

{% hint style="info" %}
Authorization secrets are essentially passwords and are recommended to follow the same guidelines: minimum 10 characters in length, contains 1 or more digits, an uppercase letter, and a lowercase letter.
{% endhint %}

## Setting up client authorization

1. Select **Settings** > **Client Authorization** from the Admin Portal settings gear (![](/files/3TIyhkfCAp2B83XW32xP)).
2. Select from the following radio buttons to choose which client installations will require a password:

   * **No Authorization** - Does not require a password.
   * **Enable Internet Clients** - Only Internet Clients will require a password.
   * **Enable All Clients** - All Clients will require a password.

   ![](/files/fS2bUZFRnjlppHUeesGQ)
3. Click **+Add Secret**
4. Enter an **Auth Secret**.

   ![](/files/yRnlQgtmvY6nLfYoiMCd)
5. Click **OK**.
6. Click **Save**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.adaptiva.com/platform-guide/client-management/client-authorization.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.