Изменения документа API-токены

Сводка

• Свойства страницы (1 изменено, 0 добавлено, 0 удалено)

Подробности

Свойства страницы

Содержимое

...	...	@@ -2,8 +2,31 @@
2	2
3	3	== Общие сведения ==
4	4
5		-[[image:api-token-wnd.png||height="297" width="900"]]
6	6
	6	+Доступ к HTTP API Платформы НЕЙРОСС для внешних систем и интеграций выполняется по учётной записи пользователя или по API-токену. API-токен создается для конкретной учётной записи и наследует её права: внешняя система получает доступ только к тем функциям, которые разрешены выбранному пользователю.
	7	+
	8	+|=Способ авторизации|=Описание
	9	+|(((
	10	+Учётная запись
	11	+)))|(((
	12	+Стандартная авторизация пользователя (логин и пароль)
	13	+)))
	14	+|(((
	15	+API-токен
	16	+)))|(((
	17	+Альтернативный способ для программного доступа без передачи пароля
	18	+)))
	19	+
	20	+Для одного пользователя можно настроить один или несколько API-токенов. По умолчанию токены не создаются — их нужно создать вручную.
	21	+
	22	+API-токен авторизует запрос только при одновременном выполнении условий:
	23	+
	24	+* лицензия Платформы активна;
	25	+* срок действия токена не истёк (для токенов с ограниченным сроком).
	26	+
	27	+Сервер считывает значение API-токена из HTTP-заголовка с фиксированным именем. Имя заголовка и описание запросов предоставляются при приобретении лицензии с поддержкой API ~[[[Лицензионная политика>>doc:||anchor="licence-policy"]]].
	28	+
	29	+
7	7	== {{id name="Настройкафункцииуправленияграфикамиработы-Лицензионнаяполитика"/}}Лицензионная политика ==
8	8
9	9	Для обеспечения функции авторизации по API-токену проверьте наличие требуемых лицензий в параметрах лицензии ~[[[Просмотр параметров и обновление лицензии>>doc:ui.node.basic.license-update.WebHome]]]. В противном случае требуется приобрести лицензии ~[[[Лицензирование Платформы НЕЙРОСС>>doc:neyross.licensing.WebHome]]].
...	...	@@ -23,6 +23,27 @@
23	23	Доступ к разделу создания API-токенов в приложении [[Пользователи, роли и права>>doc:ui.ui-users-roles.WebHome]].
24	24	)))
25	25
	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	+
26	26	== (% style="font-family:inherit; font-size:20px" %)Создание токена(%%) ==
27	27
28	28	Нажмите на кнопку **Создать токен**.