[comment]: # ({8d34cfb0-851ae152})
# 4 API токены

[comment]: # ({/8d34cfb0-851ae152})

[comment]: # ({d632cee5-7d7a0a5c})
#### Обзор

Этот раздел позволяет создавать и управлять API-токенами.

![](../../../../../assets/en/manual/web_interface/api_tokens.png){width="600"}

Вы можете фильтровать API-токены по имени, пользователям, которым назначены токены, дате истечения срока действия, пользователям, создавшим токены, или статусу (включен/выключен). Щелкните статус токена в списке, чтобы быстро включить или выключить токен. Вы также можете массово включать или выключать токены, выбрав их в списке, а затем нажав кнопки *Enable/Disable* под списком.

Чтобы создать новый токен, нажмите кнопку *Create API token* в правом верхнем углу, затем заполните обязательные поля на экране настройки токена:

![](../../../../../assets/en/manual/web_interface/frontend_sections/users/api_token_conf.png){width="600"}

|Parameter|Description|
|--|--------|
|Name|Отображаемое имя токена.|
|User|Пользователь, которому должен быть назначен токен. Чтобы быстро выбрать пользователя, начните вводить имя пользователя, имя или фамилию, затем выберите нужного пользователя из списка автодополнения. Либо нажмите кнопку *Select* и выберите пользователя из полного списка пользователей. Токен может быть назначен только одному пользователю.|
|Description|Необязательное описание токена.|
|Set expiration date and time|Снимите этот флажок, если у токена не должно быть даты истечения срока действия.|
|Expiry date|Щелкните значок календаря, чтобы выбрать дату истечения срока действия токена, или введите дату вручную в формате YYYY-MM-DD hh:mm:ss|
|Enabled|Снимите этот флажок, если нужно создать токен в отключенном состоянии.|

Нажмите *Add*, чтобы создать токен. 

![](../../../../../assets/en/manual/web_interface/frontend_sections/users/api_token.png){width="600"}

Скопируйте значение *Auth token* и сохраните его в надежном месте **до закрытия страницы**, затем нажмите *Close*.
Токен появится в списке.

::: notewarning
Значение *Auth token* нельзя будет просмотреть позже. Оно доступно только сразу после создания токена. Если вы потеряете сохраненный токен, вам придется сгенерировать его заново, и при этом будет создана новая строка авторизации.
:::

Щелкните имя токена, чтобы изменить имя, описание, настройки даты истечения срока действия или статус токена. Обратите внимание, что изменить пользователя, которому назначен токен, невозможно. Нажмите кнопку *Update*, чтобы сохранить изменения.
Если токен был утерян или скомпрометирован, вы можете нажать кнопку *Regenerate*, чтобы сгенерировать новое значение токена. Появится диалоговое окно подтверждения с просьбой подтвердить это действие, поскольку после продолжения ранее сгенерированный токен станет недействительным.

Пользователи без доступа к разделу меню *Administration* могут просматривать и изменять сведения о назначенных им токенах только в разделе *User profile → API tokens* [section](/manual/web_interface/user_profile#api-tokens), если в их правах [user role](/manual/web_interface/frontend_sections/users/user_roles) разрешено *Manage API tokens*.

[comment]: # ({/d632cee5-7d7a0a5c})