---
canonical: https://docs.ideco.ru/v22/ru/ngfw/api/admin-ad-api
---

# Администраторы Active Directory/Samba DC

::: page-constructor
blocks:
  - type: content-layout-block
    textContent:
      buttons:
        - text: Классический VCE
          theme: action
          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 "Получение списка AD правил авторизации" %}

```
GET /web/admins/ad?format_type=JSON|CSV&columns=["id","enabled",...]
```

**Параметры запроса:**

* `format_type` - поддерживается `CSV` и `JSON`, по умолчанию `JSON`;
* `columns` - список столбцов, которые попадут в `CSV` отчет, по умолчанию пустой список.

Список `columns` состоит из столбцов (значения столбцов описаны ниже):

* `id`;
* `enabled`;
* `role`;
* `group_alias`;
* `comment`.

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

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

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

{% endcut %}

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

```
POST /web/admins/ad
```

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

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

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

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

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

{% endcut %}

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

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

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

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

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

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

**При успехе веб-сессии удаляются.**

{% endcut %}

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

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

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

{% endcut %}
