다음을 통해 공유

tyntec 2FA (Preview)

  • Reference

Tyntec Authentication is a tool for user-friendly two-factor authentication (2FA) with SMS and voice.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name tyntec support
URL https://www.tyntec.com/get-help-support
Email support@tyntec.com
Connector Metadata
Publisher tyntec GmbH
Website https://www.tyntec.com
Privacy policy https://www.tyntec.com/data-privacy-statement
Categories Security;Commerce

2FA is user-friendly and feature-rich API that send the passcode to your users phone via the appropriate channel (SMS or voice). Complete with multi-language and customization support.

Pre-requisites

You will need the following to proceed:

  • A Microsoft Power Apps or Power Automate plan with custom connector feature
  • tyntec API Key

How to get API Key?

  1. Sign up/Login to your tyntec account
  2. Click on API settings
  3. In the API settings, click on New API KEY
  4. Copy the newly assigned API key

Known Limitation

  • In case of unsuccesfull verification (the code is not valid), the returned response is 401, which stops your Flow

Creating a connection

The connector supports the following authentication types:
Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
apikey securestring Your tyntec Authentication (2FA) apikey True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Delete One-Time Password

Deletes a given One-time Password
Get One-Time Password Status

Gets status report for given One-Time Password
Resend One-Time Password

Resends the given OTP (One-time Password) to a destination number.
Send One-Time Password

Sends an OTP (One-time Password) to a destination number.
Verify One-Time Password

Verifies the given OTP code.

Delete One-Time Password

Operation ID:
DeleteOTP

Deletes a given One-time Password

Parameters

Name Key Required Type Description
One-time Password ID
 otpID True string

ID of your OTP

Returns

Name Path Type Description
otpId
 otpId string

otpId
accountId
 accountId string

accountId
applicationId
 applicationId string

applicationId
number
 number string

number
attemptCount
 attemptCount integer

attemptCount
otpStatus
 otpStatus string

otpStatus
expire
 expire integer

expire
created
 created integer

created
referenceId
 referenceId string

referenceId
timestampCreated
 timestampCreated string

timestampCreated
timestampExpire
 timestampExpire string

timestampExpire

Get One-Time Password Status

Operation ID:
StatusOTP

Gets status report for given One-Time Password

Parameters

Name Key Required Type Description
One-time Password ID
 otpID True string

ID of your OTP

Returns

Name Path Type Description
otpId
 otpId string

otpId
accountId
 accountId string

accountId
applicationId
 applicationId string

applicationId
number
 number string

number
attemptCount
 attemptCount integer

attemptCount
otpStatus
 otpStatus string

otpStatus
expire
 expire integer

expire
created
 created integer

created
referenceId
 referenceId string

referenceId
timestampCreated
 timestampCreated string

timestampCreated
timestampExpire
 timestampExpire string

timestampExpire

Resend One-Time Password

Operation ID:
ResendOTP

Resends the given OTP (One-time Password) to a destination number.

Parameters

Name Key Required Type Description
One-time Password ID
 otpID True string

ID of your OTP
Delivery Channel
 via string

The delivery channel
Sender
 Sender string

Sender name for OTP delivery via SMS (if you want to override the application template one)
Caller
 Caller string

Caller id for OTP delivery via Voice (if you want to override the application template one)

Returns

Name Path Type Description
otpId
 otpId string

otpId
accountId
 accountId string

accountId
applicationId
 applicationId string

applicationId
number
 number string

number
attemptCount
 attemptCount integer

attemptCount
otpStatus
 otpStatus string

otpStatus
expire
 expire integer

expire
created
 created integer

created
referenceId
 referenceId string

referenceId
timestampCreated
 timestampCreated string

timestampCreated
timestampExpire
 timestampExpire string

timestampExpire

Send One-Time Password

Operation ID:
SendOTP

Sends an OTP (One-time Password) to a destination number.

Parameters

Name Key Required Type Description
Phone Number
 number True string

Receiver's Phone Number
Text
 text string

In case you want to overwrite the application template
Pin Lenght
 pinLength integer

Length of the auto generated PIN
Delivery Channel
 via string

The delivery channel
Application ID
 applicationId integer

The applicationId of the application you would like to use. If not specified, uses default one.
Language
 language string

Specifies the local language in ISO 639-1
Country
 country string

The ISO 3166-1 alpha-2 code of the destination number.
OTP Code
 otpCode string

The OTP code to be delivered instead of auto generated one.
Sender
 Sender string

Sender name for OTP delivery via SMS (if you want to override the application template one)
Caller
 Caller string

Caller id for OTP delivery via Voice (if you want to override the application template one)

Returns

Name Path Type Description
otpId
 otpId string

otpId
accountId
 accountId string

accountId
applicationId
 applicationId string

applicationId
number
 number string

number
attemptCount
 attemptCount integer

attemptCount
otpStatus
 otpStatus string

otpStatus
expire
 expire integer

expire
created
 created integer

created
referenceId
 referenceId string

referenceId
timestampCreated
 timestampCreated string

timestampCreated
timestampExpire
 timestampExpire string

timestampExpire

Verify One-Time Password

Operation ID:
VerifyOTP

Verifies the given OTP code.

Parameters

Name Key Required Type Description
One-time Password ID
 otpID True string

ID of your OTP
One-Time Password Code
 otpCode integer

Input One-time password code that you want to verify

Returns

Name Path Type Description
otpId
 otpId string

otpId
accountId
 accountId string

accountId
applicationId
 applicationId string

applicationId
number
 number string

number
attemptCount
 attemptCount integer

attemptCount
otpStatus
 otpStatus string

otpStatus
expire
 expire integer

expire
created
 created integer

created
referenceId
 referenceId string

referenceId
timestampCreated
 timestampCreated string

timestampCreated
timestampExpire
 timestampExpire string

timestampExpire