# Klucze API

Zakładka **Klucze API** umożliwia generowanie i zarządzanie tajnymi kluczami wykorzystywanymi do integracji systemu z innymi aplikacjami. Każdy klucz działa w oparciu o przypisane grupy uprawnień, co oznacza, że ma dostęp tylko do tych zasobów i funkcji, na które pozwala wybrana konfiguracja. Dzięki temu możliwe jest bezpieczne i kontrolowane korzystanie z API systemu.

<figure><img src="/files/rf3OGLZ3TxHF46snnVmS" alt="" width="375"><figcaption></figcaption></figure>

### Opis działania

Aby wygenerować nowy klucz, wybierz przycisk **+ Dodaj klucz** znajdujący się nad tabelą. Otworzy się okno, w którym należy (pola obowiązkowe):

* wprowadzić nazwę klucza,
* przypisać grupy uprawnień poprzez opcję **Dodaj grupy**.

Po wybraniu tej opcji wyświetli się lista dostępnych grup w systemie. Są to grupy uprawnień odpowiadające uprawnieniom administratorów. Okno wyboru działa analogicznie jak w innych częściach systemu i umożliwia przypisanie wielu grup jednocześnie.

<figure><img src="/files/uNZF1Jw7BuWyyVGwAkyP" alt="" width="375"><figcaption></figcaption></figure>

Po poprawnym uzupełnieniu danych można wybrać:

* **Dodaj klucz** - aby utworzyć klucz,
* **Anuluj** - aby przerwać operację.

Po utworzeniu klucza system wyświetli jego wartość tylko raz.

{% hint style="danger" %}
**Uwaga:**\
Klucz należy zapisać w bezpiecznym miejscu. Nie będzie możliwości jego ponownego wyświetlenia.\
Każda osoba posiadająca klucz może wykonywać operacje w systemie w ramach przypisanych uprawnień.\
W przypadku utraty klucza konieczne jest wygenerowanie nowego i zaktualizowanie go w integracjach.
{% endhint %}

<figure><img src="/files/eIbvYuzcr9bpf1MszWlN" alt="" width="375"><figcaption></figcaption></figure>

Dostępny jest przycisk **Kopiuj do schowka**, który umożliwia szybkie zapisanie klucza.

### Tabela kluczy API

W zakładce dostępna jest tabela zawierająca wszystkie utworzone klucze. Zawiera ona następujące informacje:

* **Nazwa** - nazwa nadana przez administratora,
* **Status (aktywny / nieaktywny)** - określa, czy klucz może być używany; dezaktywowany klucz nie obsługuje zapytań,
* **Klucz** - widoczny jest jedynie skrót (początek i koniec); pełna wartość dostępna jest tylko podczas generowania,
* **Data utworzenia** - moment wygenerowania klucza,
* **Data ostatniego użycia** - informacja, kiedy klucz był ostatnio wykorzystany,
* **Utworzony przez** - administrator, który utworzył klucz,
* **Grupy** - przypisane grupy uprawnień określające zakres dostępu klucza (API nie uzyska większych uprawnień niż te przypisane).

Więcej informacji o zarządzaniu [uprawnieniami i grupami znajduje się w osobnej sekcji dokumentacji](/funkcje/zarzadzanie-kontem/organizacja.md).

### Zarządzanie kluczami

Dla każdego klucza dostępne są następujące operacje:

* aktywacja i dezaktywacja,
* edycja nazwy,
* zmiana przypisanych grup uprawnień,
* usunięcie klucza (wymaga potwierdzenia).

<figure><img src="/files/Bp23xuUzstArH6kDDu4l" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}
W przypadku utraty klucza nie ma możliwości jego odzyskania - należy wygenerować nowy i podmienić go w używanych integracjach.
{% endhint %}


---

# 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://eaclouddoc.eauditor.eu/funkcje/narzedzia/konfiguracja/klucze-api.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.
