10.0.0

10.0.0/модуль-decort_jwt.md

@@ -0,0 +1,48 @@
+# Модуль decort_jwt
+## Обзор модуля
+Модуль **decort_jwt** предназначен для получения авторизационного токена JWT (JSON Web Token). Данный модуль может быть полезен при массовом создании ресурсов (например, виртуальных машин), так как позволяет оптимизировать количество API вызовов для получения токена.
+
+По сути, данный модуль является провайдером информации и не управляет облачными ресурсами (всегда возвращает `changed: False`).
+
+## Параметры модуля decort_jwt
+Список параметров для модуля **decort_jwt** почти полностью совпадает с [общими параметрами модулей для авторизации](./введение.md#общие-параметры-модулей-для-авторизации).
+
+Отличия от общих параметров:
+- Параметр `controller_url` не используется.
+- Параметр `jwt` не используется.
+- В параметре `authenticator` не используется значение `jwt`.
+
+## Возвращаемые значения модуля decort_jwt
+| Ключ | Тип данных | Описание |
+|---| ------ | ------ |
+| jwt | str | JWT токен. |
+
+## Примеры использования
+### Пример получения JWT токена с помощью DECS3O
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Obtain JWT from DECS3O
+      decort_jwt:
+        app_id: "{{ app_id }}"
+        app_secret: "{{ app_secret }}"
+        authenticator: decs3o
+        oauth2_url: https://sso-dynamix.local
+```
+
+### Пример получения JWT токена с помощью BVS
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Obtain JWT from BVS
+      decort_jwt:
+        app_id: "{{ app_id }}"
+        app_secret: "{{ app_secret }}"
+        authenticator: bvs
+        oauth2_url: https://bvs.local
+        domain: dynamix
+        username: "{{ username }}"
+        password: "{{ password }}"
+```