tyntec 2FA （预览版）
Tyntec 身份验证是一种使用短信和语音进行用户友好的双因素身份验证（2FA）的工具。
此连接器在以下产品和区域中可用：
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 ： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD） |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 联系人 | |
|---|---|
| Name | tyntec 支持 |
| URL | https://www.tyntec.com/get-help-support |
| support@tyntec.com |
| 连接器元数据 | |
|---|---|
| 发布者 | tyntec GmbH |
| 网站 | https://www.tyntec.com |
| 隐私策略 | https://www.tyntec.com/data-privacy-statement |
| 类别 | 安全;商业 |
2FA 是用户友好且功能丰富的 API ，可通过相应的通道（短信或语音）将密码发送到用户电话。 完成多语言和自定义支持。
先决条件
需要满足以下条件才能继续作：
- 具有自定义连接器功能的Microsoft Power Apps 或 Power Automate 计划
- tyntec API 密钥
如何获取 API 密钥？
已知限制
- 如果出现 unsuccesfull 验证（代码无效），返回的响应为 401，这会停止流
正在创建连接
连接器支持以下身份验证类型：
| 默认 | 用于创建连接的参数。 | 所有区域 | 不可共享 |
违约
适用：所有区域
用于创建连接的参数。
这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。
| Name | 类型 | Description | 必选 |
|---|---|---|---|
| apikey | securestring | tyntec 身份验证 （2FA） apikey | True |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| 删除 One-Time 密码 |
删除给定的一次性密码 |
| 发送 One-Time 密码 |
将 OTP（一次性密码）发送到目标号码。 |
| 获取 One-Time 密码状态 |
获取给定 One-Time 密码的状态报告 |
| 重新发送 One-Time 密码 |
将给定的 OTP（一次性密码）重新发送到目标编号。 |
| 验证 One-Time 密码 |
验证给定的 OTP 代码。 |
删除 One-Time 密码
删除给定的一次性密码
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
一次性密码 ID
|
otpID | True | string |
OTP 的 ID |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
otpId
|
otpId | string |
otpId |
|
帐户ID
|
accountId | string |
帐户ID |
|
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（一次性密码）发送到目标号码。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
电话号码
|
number | True | string |
接收方的电话号码 |
|
文本
|
text | string |
如果要覆盖应用程序模板 |
|
|
Pin Lenght
|
pinLength | integer |
自动生成的 PIN 的长度 |
|
|
传递渠道
|
via | string |
传递渠道 |
|
|
应用程序 ID
|
applicationId | integer |
要使用的应用程序的 applicationId。 如果未指定，请使用默认的一个。 |
|
|
语言
|
language | string |
指定 ISO 639-1 中的本地语言 |
|
|
国家
|
country | string |
目标编号的 ISO 3166-1 alpha-2 代码。 |
|
|
OTP 代码
|
otpCode | string |
要传递的 OTP 代码，而不是自动生成的代码。 |
|
|
发送方
|
Sender | string |
通过短信传递 OTP 的发件人名称（如果要替代应用程序模板 1） |
|
|
调用方
|
Caller | string |
通过语音传递 OTP 的呼叫方 ID（如果要替代应用程序模板 1） |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
otpId
|
otpId | string |
otpId |
|
帐户ID
|
accountId | string |
帐户ID |
|
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 密码的状态报告
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
一次性密码 ID
|
otpID | True | string |
OTP 的 ID |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
otpId
|
otpId | string |
otpId |
|
帐户ID
|
accountId | string |
帐户ID |
|
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（一次性密码）重新发送到目标编号。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
一次性密码 ID
|
otpID | True | string |
OTP 的 ID |
|
传递渠道
|
via | string |
传递渠道 |
|
|
发送方
|
Sender | string |
通过短信传递 OTP 的发件人名称（如果要替代应用程序模板 1） |
|
|
调用方
|
Caller | string |
通过语音传递 OTP 的呼叫方 ID（如果要替代应用程序模板 1） |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
otpId
|
otpId | string |
otpId |
|
帐户ID
|
accountId | string |
帐户ID |
|
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 代码。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
一次性密码 ID
|
otpID | True | string |
OTP 的 ID |
|
One-Time 密码代码
|
otpCode | integer |
输入要验证的一次性密码代码 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
otpId
|
otpId | string |
otpId |
|
帐户ID
|
accountId | string |
帐户ID |
|
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 |