# Администраторы FreeIPA

::: page-constructor
blocks:
  - type: content-layout-block
    textContent:
      buttons:
        - text: Классический VCE
          theme: action
          width: 'auto'
        - text: Высокопроизводительный VCE
          theme: outlined
          url: https://docs.ideco.ru/api/vpp-v22/ru/ngfw/server-management/admins/admins-freeipa-api/
          width: 'auto'
        - text: Документация
          theme: outlined
          url: https://docs.ideco.ru/v22/ru/ngfw/settings/server-management/admins
          width: 'auto'
    resetPaddings: false
    textWidth: l
    size: m
    centered: false
:::


{% cut "Добавление правил" %}

```
POST /web/admins/freeipa
```

**Json-тело запроса:**

```json5
{
    "enabled": true | false,
    "role": "integer",
    "group_alias": "string",
    "comment": "string"
}
```

* `enabled` - статус правила: 
  * `true` - включено;
  * `false` - выключено.
* `role` - идентификатор уровня доступа администратора;
* `group_alias` - группа безопасности. Тип группы должен соответствовать типу домена;
* `comment` - комментарий, максимальная длина - 256 символов. Может быть пустым.

**Ответ на успешный запрос:**

```json5
{
    "id": "string"
}
```

* `id` - идентификатор правила авторизации.

{% endcut %}

{% cut "Изменение правил авторизации" %}

```
PATCH /web/admins/freeipa/<id правила>
```

**Json-тело запроса (все или некоторые поля):**

```json5
{
    "enabled": true | false,
    "role": "integer",
    "group_alias": "string",
    "comment": "string"
}
```

* `enabled` - статус правила: 
  * `true` - включено;
  * `false` - выключено.
* `role` - идентификатор уровня доступа администратора;
* `group_alias` - группа безопасности. Тип группы должен соответствовать типу домена;
* `comment` - комментарий, максимальная длина - 256 символов. Может быть пустым.

**Ответ на успешный запрос:** 200 OK

{% endcut %}

{% cut "Удаление правил авторизации" %}

```
DELETE /web/admins/freeipa/<id правила>
```

**Ответ на успешный запрос:** 200 OK

{% endcut %}
