# API keys

Tab **API Keys** enables the generation and management of secret keys used to integrate the system with other applications. Each key operates based on assigned permission groups, which means it has access only to those resources and functions allowed by the selected configuration. This enables secure and controlled use of the system API.

<figure><img src="https://3262380731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdzip3GyvGq5q5J3qckWN%2Fuploads%2FuXs0PfstvzBqEIXwObtr%2Fimage.png?alt=media&#x26;token=0614dffe-bff8-42d5-8231-e50a92e5b177" alt="" width="375"><figcaption></figcaption></figure>

### Operation description

To generate a new key, select the **+ Add key** button located above the table. A window will open in which you must (required fields):

* enter the key name,
* assign permission groups using the **Add groups**.

option. After selecting this option, a list of available groups in the system will be displayed. These are permission groups corresponding to administrator permissions. The selection window works similarly to other parts of the system and allows multiple groups to be assigned at once.

<figure><img src="https://3262380731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdzip3GyvGq5q5J3qckWN%2Fuploads%2F3U7pF0EYMVnk4EYxU3Ff%2Fimage.png?alt=media&#x26;token=a0fcb9f2-f6bc-4d5f-92d8-9064e49ce521" alt="" width="375"><figcaption></figcaption></figure>

After completing the data correctly, you can select:

* **Add key** - to create the key,
* **Cancel** - to abort the operation.

After the key is created, the system will display its value only once.

{% hint style="danger" %}
**Note:**\
The key must be stored in a secure location. It will not be possible to display it again.\
Anyone who possesses the key can perform operations in the system within the assigned permissions.\
If the key is lost, a new one must be generated and updated in the integrations.
{% endhint %}

<figure><img src="https://3262380731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdzip3GyvGq5q5J3qckWN%2Fuploads%2FeVQyHZfR6kX5ZxOxvy12%2Fimage.png?alt=media&#x26;token=11a378df-fb55-4377-bc64-6a2b83ff3d55" alt="" width="375"><figcaption></figcaption></figure>

The **Copy to clipboard**button is available, which allows you to quickly save the key.

### API Keys table

This tab contains a table with all created keys. It includes the following information:

* **Name** - the name assigned by the administrator,
* **Status (active / inactive)** - specifies whether the key can be used; a deactivated key does not process requests,
* **Key** - only an abbreviated version is visible (beginning and end); the full value is available only during generation,
* **Creation date** - the moment the key was generated,
* **Last used date** - information on when the key was last used,
* **Created by** - the administrator who created the key,
* **Groups** - assigned permission groups defining the key's access scope (the API will not obtain greater privileges than those assigned).

More information about managing [permissions and groups is available in a separate section of the documentation](https://eaclouddoc.eauditor.eu/eacloud-docs-en/features/account-management/organization).

### Managing keys

The following operations are available for each key:

* activation and deactivation,
* editing the name,
* changing the assigned permission groups,
* deleting the key (requires confirmation).

<figure><img src="https://3262380731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdzip3GyvGq5q5J3qckWN%2Fuploads%2FZRPqYGIMufXnCM0yMUq1%2Fimage.png?alt=media&#x26;token=99dda980-32a5-4909-83f3-d791e6b66105" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}
If the key is lost, it cannot be recovered - a new one must be generated and replaced in the integrations in use.
{% endhint %}