tyntec 2FA (предварительная версия)
Tyntec Authentication — это средство для удобной двухфакторной проверки подлинности (2FA) с помощью SMS и голосовой связи.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Поддержка tyntec |
| URL | https://www.tyntec.com/get-help-support |
| Адрес электронной почты | support@tyntec.com |
| Метаданные соединителя | |
|---|---|
| Publisher | tyntec GmbH |
| Веб-сайт | https://www.tyntec.com |
| Политика конфиденциальности | https://www.tyntec.com/data-privacy-statement |
| Категории | Безопасность; Торговля |
2FA — это удобный и функциональный API , который отправляет секретный код пользователям по телефону с помощью соответствующего канала (SMS или голосовой связи). Поддержка нескольких языков и настроек.
Pre-requisites
Для продолжения вам потребуется следующее:
- План Microsoft Power Apps или Power Automate с пользовательским компонентом соединителя
- Ключ API tyntec
Как получить ключ API?
- Регистрация/Вход в учетную запись tyntec
- Щелкните параметры API
- В параметрах API щелкните новый ключ API
- Скопируйте только что назначенный ключ API
Известное ограничение
- В случае неуправляемой проверки (код недопустим), возвращенный ответ равен 401, который останавливает поток.
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| apikey | securestring | Apikey tyntec Authentication (2FA) | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Отправка пароля One-Time |
Отправляет OTP (одноразовый пароль) в номер назначения. |
| Повторное One-Time пароль |
Повторно отправляет указанный OTP (одноразовый пароль) на целевой номер. |
| Получение состояния пароля One-Time |
Возвращает отчет о состоянии для заданного пароля One-Time |
| Проверка пароля One-Time |
Проверяет указанный код OTP. |
| Удаление пароля One-Time |
Удаляет заданный одноразовый пароль |
Отправка пароля One-Time
Отправляет OTP (одноразовый пароль) в номер назначения.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Номер телефона
|
number | True | string |
Номер телефона получателя |
|
Текст
|
text | string |
Если вы хотите перезаписать шаблон приложения |
|
|
Закрепление Lenght
|
pinLength | integer |
Длина автогенерированного ПИН-кода |
|
|
Канал доставки
|
via | string |
Канал доставки |
|
|
Идентификатор приложения
|
applicationId | integer |
ApplicationId приложения, которое вы хотите использовать. Если не указано, используется значение по умолчанию. |
|
|
Language
|
language | string |
Указывает локальный язык в ISO 639-1 |
|
|
Страна
|
country | string |
Код ISO 3166-1 alpha-2 целевого номера. |
|
|
Код OTP
|
otpCode | string |
Код OTP, который будет доставлен вместо автоматического создания. |
|
|
Отправитель
|
Sender | string |
Имя отправителя для доставки OTP через SMS (если вы хотите переопределить шаблон приложения) |
|
|
Звонящий
|
Caller | string |
Идентификатор вызывающего объекта для доставки OTP через голосовую связь (если вы хотите переопределить шаблон приложения) |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
otpId
|
otpId | string |
otpId |
|
accountId
|
accountId | string |
accountId |
|
applicationId
|
applicationId | string |
applicationId |
|
число/номер
|
number | string |
число/номер |
|
attemptCount
|
attemptCount | integer |
attemptCount |
|
otpStatus
|
otpStatus | string |
otpStatus |
|
истекать
|
expire | integer |
истекать |
|
создано
|
created | integer |
создано |
|
referenceId
|
referenceId | string |
referenceId |
|
timestampCreated
|
timestampCreated | string |
timestampCreated |
|
timestampExpire
|
timestampExpire | string |
timestampExpire |
Повторное One-Time пароль
Повторно отправляет указанный OTP (одноразовый пароль) на целевой номер.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Одноразовый идентификатор пароля
|
otpID | True | string |
Идентификатор OTP |
|
Канал доставки
|
via | string |
Канал доставки |
|
|
Отправитель
|
Sender | string |
Имя отправителя для доставки OTP через SMS (если вы хотите переопределить шаблон приложения) |
|
|
Звонящий
|
Caller | string |
Идентификатор вызывающего объекта для доставки OTP через голосовую связь (если вы хотите переопределить шаблон приложения) |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
otpId
|
otpId | string |
otpId |
|
accountId
|
accountId | string |
accountId |
|
applicationId
|
applicationId | string |
applicationId |
|
число/номер
|
number | string |
число/номер |
|
attemptCount
|
attemptCount | integer |
attemptCount |
|
otpStatus
|
otpStatus | string |
otpStatus |
|
истекать
|
expire | integer |
истекать |
|
создано
|
created | integer |
создано |
|
referenceId
|
referenceId | string |
referenceId |
|
timestampCreated
|
timestampCreated | string |
timestampCreated |
|
timestampExpire
|
timestampExpire | string |
timestampExpire |
Получение состояния пароля One-Time
Возвращает отчет о состоянии для заданного пароля One-Time
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Одноразовый идентификатор пароля
|
otpID | True | string |
Идентификатор OTP |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
otpId
|
otpId | string |
otpId |
|
accountId
|
accountId | string |
accountId |
|
applicationId
|
applicationId | string |
applicationId |
|
число/номер
|
number | string |
число/номер |
|
attemptCount
|
attemptCount | integer |
attemptCount |
|
otpStatus
|
otpStatus | string |
otpStatus |
|
истекать
|
expire | integer |
истекать |
|
создано
|
created | integer |
создано |
|
referenceId
|
referenceId | string |
referenceId |
|
timestampCreated
|
timestampCreated | string |
timestampCreated |
|
timestampExpire
|
timestampExpire | string |
timestampExpire |
Проверка пароля One-Time
Проверяет указанный код OTP.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Одноразовый идентификатор пароля
|
otpID | True | string |
Идентификатор OTP |
|
код пароля One-Time
|
otpCode | integer |
Входной код одноразового пароля, который требуется проверить |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
otpId
|
otpId | string |
otpId |
|
accountId
|
accountId | string |
accountId |
|
applicationId
|
applicationId | string |
applicationId |
|
число/номер
|
number | string |
число/номер |
|
attemptCount
|
attemptCount | integer |
attemptCount |
|
otpStatus
|
otpStatus | string |
otpStatus |
|
истекать
|
expire | integer |
истекать |
|
создано
|
created | integer |
создано |
|
referenceId
|
referenceId | string |
referenceId |
|
timestampCreated
|
timestampCreated | string |
timestampCreated |
|
timestampExpire
|
timestampExpire | string |
timestampExpire |
Удаление пароля One-Time
Удаляет заданный одноразовый пароль
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Одноразовый идентификатор пароля
|
otpID | True | string |
Идентификатор OTP |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
otpId
|
otpId | string |
otpId |
|
accountId
|
accountId | string |
accountId |
|
applicationId
|
applicationId | string |
applicationId |
|
число/номер
|
number | string |
число/номер |
|
attemptCount
|
attemptCount | integer |
attemptCount |
|
otpStatus
|
otpStatus | string |
otpStatus |
|
истекать
|
expire | integer |
истекать |
|
создано
|
created | integer |
создано |
|
referenceId
|
referenceId | string |
referenceId |
|
timestampCreated
|
timestampCreated | string |
timestampCreated |
|
timestampExpire
|
timestampExpire | string |
timestampExpire |