# 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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.