tyntec 2FA (プレビュー)
Tyntec 認証は、SMS と音声を使用したユーザー フレンドリな 2 要素認証 (2FA) のツールです。
このコネクタは、次の製品および地域で利用可能です。
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | tyntec のサポート |
| [URL] | https://www.tyntec.com/get-help-support |
| メール | support@tyntec.com |
| Connector Metadata | |
|---|---|
| 発行者 | tyntec GmbH |
| Web サイト | https://www.tyntec.com |
| プライバシー ポリシー | https://www.tyntec.com/data-privacy-statement |
| カテゴリ | セキュリティ; コマース |
2FA は、ユーザー フレンドリで機能豊富な API で、適切なチャネル (SMS または音声) を使用してユーザーの電話にパスコードを送信します。 多言語およびカスタマイズ サポートを完備しています。
前提条件
続行するには、次のものが必要です:
- カスタム コネクタ機能を備えた Microsoft Power Apps または Power Automate プラン
- tyntec API キー
API キーを取得する方法は?
- サインアップ/ログイン を tyntec アカウントに登録します
- API 設定 をクリックする
- API 設定で、新しい API キー をクリックします
- 新しく割り当てられた API キーをコピーします
既知の制限事項
- 検証に失敗した場合 (コードが無効)、返される応答は 401 となり、フローが停止されます
接続の作成
コネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | 内容 | 必要 |
|---|---|---|---|
| apikey | securestring | tyntec 認証 (2FA) apikey | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| ワン タイム パスワードの状態を取得する |
指定されたワン タイム パスワードの状態レポートを取得します |
| ワン タイム パスワードを再送信する |
指定されたOTP (ワン タイム パスワード) を宛先番号に再送信します。 |
| ワン タイム パスワードを削除する |
指定されたワン タイム パスワードを削除します |
| ワン タイム パスワードを検証する |
指定された OTP コードを検証します。 |
| ワン タイム パスワードを送信する |
OTP (ワン タイム パスワード) を宛先番号に送信します。 |
ワン タイム パスワードの状態を取得する
指定されたワン タイム パスワードの状態レポートを取得します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ワン タイム パスワード ID
|
otpID | True | string |
OTP の ID |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
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 |
ワン タイム パスワードを再送信する
指定されたOTP (ワン タイム パスワード) を宛先番号に再送信します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ワン タイム パスワード ID
|
otpID | True | string |
OTP の ID |
|
配信チャネル
|
via | string |
配信チャネル |
|
|
センダー
|
Sender | string |
SMS を使用した OTP 配信のセンダー名 (アプリケーション テンプレート 1 を上書きする場合) |
|
|
呼び出し元
|
Caller | string |
音声を使用した OTP 配信の呼び出し元 ID (アプリケーション テンプレート 1 を上書きする場合) |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
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 |
ワン タイム パスワードを削除する
指定されたワン タイム パスワードを削除します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ワン タイム パスワード ID
|
otpID | True | string |
OTP の ID |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
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 |
ワン タイム パスワードを検証する
指定された OTP コードを検証します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ワン タイム パスワード ID
|
otpID | True | string |
OTP の ID |
|
ワン タイム パスワード コード
|
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 |
ワン タイム パスワードを送信する
OTP (ワン タイム パスワード) を宛先番号に送信します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
電話番号
|
number | True | string |
受信者の電話番号 |
|
テキスト
|
text | string |
アプリケーション テンプレートを上書きする場合 |
|
|
暗証番号の長さ
|
pinLength | integer |
自動生成された暗証番号の長さ |
|
|
配信チャネル
|
via | string |
配信チャネル |
|
|
アプリケーション ID
|
applicationId | integer |
使用するアプリケーションのアプリケーション ID。 指定しない場合は、既定のものを使用します。 |
|
|
言語
|
language | string |
ISO639-1 でローカル言語を指定します |
|
|
国
|
country | string |
宛先番号の ISO 3166-1 alpha-2 コード。 |
|
|
OTP コード
|
otpCode | string |
自動生成されたものの代わりに配信される OTP コード。 |
|
|
センダー
|
Sender | string |
SMS を使用した OTP 配信のセンダー名 (アプリケーション テンプレート 1 を上書きする場合) |
|
|
呼び出し元
|
Caller | string |
音声を使用した OTP 配信の呼び出し元 ID (アプリケーション テンプレート 1 を上書きする場合) |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
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 |