Изменения документа API-токены
Редактировал(а) admin 2026/09/17 16:09
Сводка
-
Свойства страницы (1 изменено, 0 добавлено, 0 удалено)
-
Вложения (0 изменено, 0 добавлено, 2 удалено)
Подробности
- Свойства страницы
-
- Содержимое
-
... ... @@ -5,7 +5,9 @@ 5 5 6 6 Доступ к HTTP API Платформы НЕЙРОСС для внешних систем и интеграций выполняется по учётной записи пользователя или по API-токену. API-токен создается для конкретной учётной записи и наследует её права: внешняя система получает доступ только к тем функциям, которые разрешены выбранному пользователю. 7 7 8 -|=Способ авторизации|=Описание 8 +Авторизация 9 + 10 +|=Способ|=Описание 9 9 |((( 10 10 Учётная запись 11 11 )))|((( ... ... @@ -17,7 +17,7 @@ 17 17 Альтернативный способ для программного доступа без передачи пароля 18 18 ))) 19 19 20 -Для одного пользователя можно настроить один или несколько API-токенов. По умолчанию токены не создаются — их нужно с оздать22 +Для одного пользователя можно настроить один или несколько API-токенов. По умолчанию токены не создаются — их нужно выпустить вручную в приложении Пользователи, роли и права. 21 21 22 22 API-токен авторизует запрос только при одновременном выполнении условий: 23 23 ... ... @@ -24,8 +24,9 @@ 24 24 * лицензия Платформы активна; 25 25 * срок действия токена не истёк (для токенов с ограниченным сроком). 26 26 27 -Сервер считывает значение API-токена из HTTP-заголовка с фиксированным именем. Имя заголовка и описание запросов предоставляются при приобретении лицензии с поддержкой API ~[[[Лицензионная политика>>doc:||anchor="licence-policy"]]].29 +Сервер считывает значение API-токена из HTTP-заголовка с фиксированным именем. Имя заголовка и описание запросов предоставляются при приобретении лицензии с поддержкой API. 28 28 31 +[[image:api-token-wnd.png||height="297" width="900"]] 29 29 30 30 == {{id name="Настройкафункцииуправленияграфикамиработы-Лицензионнаяполитика"/}}Лицензионная политика == 31 31 ... ... @@ -46,27 +46,6 @@ 46 46 Доступ к разделу создания API-токенов в приложении [[Пользователи, роли и права>>doc:ui.ui-users-roles.WebHome]]. 47 47 ))) 48 48 49 - 50 - 51 -== Рекомендации по безопасности == 52 - 53 -Для обмена по HTTP рекомендуется протокол HTTPS. 54 - 55 -В составе Платформы НЕЙРОСС есть встроенный HTTPS-сервер. При каждой установке автоматически создаются: 56 - 57 -* уникальный сертификат удостоверяющего центра (CA); 58 -* серверный сертификат, подписанный этим CA. 59 - 60 -Сертификат CA в формате .crt можно скачать через веб-сервер Платформы НЕЙРОСС и установить на клиенте, чтобы доверять HTTPS-соединению без предупреждений браузера. 61 - 62 -HTTPS можно настроить иначе — в том числе с использованием общедоступных CA (например, Let's Encrypt). В таких случаях порядок установления HTTPS-подключения уточняйте для конкретной инсталляции в документации по развёртыванию. 63 - 64 -== Окно раздела == 65 - 66 -[[image:api-token-wnd.png||height="297" width="900"]] 67 - 68 -Окно раздела содержит список токенов с указанием пользователя — «владельца» токена, его названия, времени создания и срока действия. Для бессрочных токенов срок действия не ограничен. Если был хотя бы один авторизованный запрос с использованием токена, указывается время последнего запроса. Инструменты раздела позволяют удалить токен или изменить его название и срок действия. Поддерживается групповое продление токенов. 69 - 70 70 == (% style="font-family:inherit; font-size:20px" %)Создание токена(%%) == 71 71 72 72 Нажмите на кнопку **Создать токен**. ... ... @@ -105,26 +105,6 @@ 105 105 Обязательно скопируйте токен в буфер обмена! Токен отображается **ТОЛЬКО ОДИН РАЗ**. Восстановление токена невозможно. Потребуется удалить и создать новый токен. 106 106 ))) 107 107 108 -== {{id name="edit"/}}Редактирование токена == 109 - 110 -Вы можете изменить название и/или срок действия токена. Для этого в строке токена нажмите на кнопку [[image:ui.node.WebHome@btn_prp.png]] и в отобразившемся меню выберите **Изменить**. 111 - 112 -В отобразившемся окне введите новое название и/или срок действия. Сохраните изменения. 113 - 114 -[[image:api-token-edit.png]] 115 - 116 116 == Продление токена == 117 117 118 -Платформа НЕЙРОСС обеспечивает возможность одинарного и группового продления срока действия токенов. Продление срока действия одного токена осуществляется через процедуру [[редактирования>>doc:||anchor="edit"]]. 119 - 120 -Для группового продления: 121 - 122 -1. Выберите требуемые токены. 123 -1. Нажмите на кнопку Изменить. 124 -1. В отобразившемся окне введите новый срок действия, сохраните изменения. 125 - 126 -[[image:api-token-renew.png]] 127 - 128 -Удаление токена 129 - 130 -Возможно одиночное и групповое удаление токена. Для удал 92 +Платформа НЕЙРОСС обеспечивает возможность группового продления срока действия токенов.
- api-token-edit.png
-
- Автор
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.admin - Размер
-
... ... @@ -1,1 +1,0 @@ 1 -4.1 KB - Содержимое
- api-token-renew.png
-
- Автор
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.admin - Размер
-
... ... @@ -1,1 +1,0 @@ 1 -2.8 KB - Содержимое