tyntec 2FA（預覽版）
Tyntec Authentication 是一種用於使用簡訊和語音進行使用者友善的雙重認證 （2FA） 的工具。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | Tyntec 支持 |
| URL | https://www.tyntec.com/get-help-support |
| support@tyntec.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 廷泰克有限公司 |
| 網站 | https://www.tyntec.com |
| 隱私策略 | https://www.tyntec.com/data-privacy-statement |
| 類別 | 安全;商 |
2FA 是用戶友好且功能豐富的 API ，可通過適當的渠道（短信或語音）將密碼發送到您的用戶手機。 提供多語言和客製化支援。
Pre-requisites
您將需要以下內容才能繼續：
- 具有自訂連接器功能的 Microsoft Power Apps 或 Power Automate 方案
- tyntec API 金鑰
如何取得API Key？
已知限制
- 如果驗證不成功 （代碼無效），傳回的回應為 401，這會停止您的流程
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| APIKEY | securestring | 您的 tyntec 身份驗證 （2FA） apikey | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 刪除 One-Time 密碼 |
刪除指定的一次性密碼 |
| 取得 One-Time 密碼狀態 |
取得給定 One-Time 密碼的狀態報告 |
| 發送 One-Time 密碼 |
向目標號碼發送 OTP（一次性密碼）。 |
| 重新傳送 One-Time 密碼 |
將給定的OTP（一次性密碼）重新傳送到目標號碼。 |
| 驗證 One-Time 密碼 |
驗證給定的OTP代碼。 |
刪除 One-Time 密碼
刪除指定的一次性密碼
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
一次性密碼 ID
|
otpID | True | string |
您的一次性密碼 ID |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
otpId
|
otpId | string |
otpId |
|
accountId
|
accountId | string |
accountId |
|
應用程式ID
|
applicationId | string |
應用程式ID |
|
數字
|
number | string |
數字 |
|
嘗試計數
|
attemptCount | integer |
嘗試計數 |
|
otp狀態
|
otpStatus | string |
otp狀態 |
|
斷氣
|
expire | integer |
斷氣 |
|
創建
|
created | integer |
創建 |
|
參考標識符
|
referenceId | string |
參考標識符 |
|
時間戳記已建立
|
timestampCreated | string |
時間戳記已建立 |
|
timestampExpire
|
timestampExpire | string |
timestampExpire |
取得 One-Time 密碼狀態
取得給定 One-Time 密碼的狀態報告
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
一次性密碼 ID
|
otpID | True | string |
您的一次性密碼 ID |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
otpId
|
otpId | string |
otpId |
|
accountId
|
accountId | string |
accountId |
|
應用程式ID
|
applicationId | string |
應用程式ID |
|
數字
|
number | string |
數字 |
|
嘗試計數
|
attemptCount | integer |
嘗試計數 |
|
otp狀態
|
otpStatus | string |
otp狀態 |
|
斷氣
|
expire | integer |
斷氣 |
|
創建
|
created | integer |
創建 |
|
參考標識符
|
referenceId | string |
參考標識符 |
|
時間戳記已建立
|
timestampCreated | string |
時間戳記已建立 |
|
timestampExpire
|
timestampExpire | string |
timestampExpire |
發送 One-Time 密碼
向目標號碼發送 OTP（一次性密碼）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
電話號碼
|
number | True | string |
收件人的電話號碼 |
|
文字
|
text | string |
如果您想覆蓋應用程序模板 |
|
|
針長
|
pinLength | integer |
自動產生的 PIN 碼長度 |
|
|
交付管道
|
via | string |
傳遞管道 |
|
|
應用程式識別碼
|
applicationId | integer |
您要使用的應用程式的 applicationId。 如果未指定，則使用預設值。 |
|
|
語言
|
language | string |
指定 ISO 639-1 中的當地語言 |
|
|
國家
|
country | string |
目的地號碼的 ISO 3166-1 alpha-2 代碼。 |
|
|
一次性密碼
|
otpCode | string |
要傳遞的 OTP 代碼，而不是自動生成的代碼。 |
|
|
寄件者
|
Sender | string |
透過簡訊傳送OTP的寄件者名稱（如果您想要覆寫應用程式範本） |
|
|
呼叫者
|
Caller | string |
透過語音傳送 OTP 的來電顯示 （如果您想覆寫應用程式範本） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
otpId
|
otpId | string |
otpId |
|
accountId
|
accountId | string |
accountId |
|
應用程式ID
|
applicationId | string |
應用程式ID |
|
數字
|
number | string |
數字 |
|
嘗試計數
|
attemptCount | integer |
嘗試計數 |
|
otp狀態
|
otpStatus | string |
otp狀態 |
|
斷氣
|
expire | integer |
斷氣 |
|
創建
|
created | integer |
創建 |
|
參考標識符
|
referenceId | string |
參考標識符 |
|
時間戳記已建立
|
timestampCreated | string |
時間戳記已建立 |
|
timestampExpire
|
timestampExpire | string |
timestampExpire |
重新傳送 One-Time 密碼
將給定的OTP（一次性密碼）重新傳送到目標號碼。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
一次性密碼 ID
|
otpID | True | string |
您的一次性密碼 ID |
|
交付管道
|
via | string |
傳遞管道 |
|
|
寄件者
|
Sender | string |
透過簡訊傳送OTP的寄件者名稱（如果您想要覆寫應用程式範本） |
|
|
呼叫者
|
Caller | string |
透過語音傳送 OTP 的來電顯示 （如果您想覆寫應用程式範本） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
otpId
|
otpId | string |
otpId |
|
accountId
|
accountId | string |
accountId |
|
應用程式ID
|
applicationId | string |
應用程式ID |
|
數字
|
number | string |
數字 |
|
嘗試計數
|
attemptCount | integer |
嘗試計數 |
|
otp狀態
|
otpStatus | string |
otp狀態 |
|
斷氣
|
expire | integer |
斷氣 |
|
創建
|
created | integer |
創建 |
|
參考標識符
|
referenceId | string |
參考標識符 |
|
時間戳記已建立
|
timestampCreated | string |
時間戳記已建立 |
|
timestampExpire
|
timestampExpire | string |
timestampExpire |
驗證 One-Time 密碼
驗證給定的OTP代碼。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
一次性密碼 ID
|
otpID | True | string |
您的一次性密碼 ID |
|
One-Time 密碼
|
otpCode | integer |
輸入您要驗證的一次性密碼代碼 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
otpId
|
otpId | string |
otpId |
|
accountId
|
accountId | string |
accountId |
|
應用程式ID
|
applicationId | string |
應用程式ID |
|
數字
|
number | string |
數字 |
|
嘗試計數
|
attemptCount | integer |
嘗試計數 |
|
otp狀態
|
otpStatus | string |
otp狀態 |
|
斷氣
|
expire | integer |
斷氣 |
|
創建
|
created | integer |
創建 |
|
參考標識符
|
referenceId | string |
參考標識符 |
|
時間戳記已建立
|
timestampCreated | string |
時間戳記已建立 |
|
timestampExpire
|
timestampExpire | string |
timestampExpire |