React Native - Transmit Security Account Protection SDK

#### Detect risk in customer interactions on digital channels, and enable informed identity and trust decisions across the consumer experience.

About Account Protection SDK

The React Native Detection and Response SDK Wrapper is a versatile tool designed to seamlessly integrate the powerful capabilities of the Detection and Response services into your React Native applications. By encapsulating the APIs of the native SDKs for both iOS and Android platforms, this wrapper empowers enterprises to confidently enhance security measures while maintaining a smooth user experience.

Using this module, you can easily integrate our Account Protection SDK into your React Native app.

Learn more on our website.

Understand the flows

We recommended that you read more about the native Account Protection SDKs as described in our iOS documentation and Android documentation

Configure your app

To integrate this module, you'll need to configure an application in our portal.

Example project setup

1. In your project, navigate to example/src/config.ts and configure the clientId and secret using the configuration obtained from the Transmit portal.
2. Ensure you have all the necessary dependencies by running yarn in both the module's root folder and the example root folder.
3. Run the example app on a real device using Xcode or Android Studio. Alternatively, execute yarn example ios or yarn example android.



> Important Security Note: Never store your secret in a front-end application.
>
> The example app utilizes a mock server to manage communication with the authentication platform. This mock server employs the secret you have specified in example/src/config.ts exclusively for demonstration purposes. It is paramount that you safeguard your secret in a secure and confidential location.

Installation

``sh
npm install react-native-ts-accountprotection
`
#### iOS Setup
You might need to execute pod install in your project's /ios folder.

#### Android Setup

Add to app/build.gradle under repositories

`gradle
repositories {
google()
maven {
url('https://transmit.jfrog.io/artifactory/transmit-security-gradle-release-local/')
}
}

dependencies {
implementation("com.ts.sdk:accountprotection:2.1.+")
}
`

Module Setup

$3


First, update your strings.xml by adding
`xml


"CLIENT_ID"
https://api.transmitsecurity.io/

`

Next open your MainApplication.kt file in your React Native android project, and add:

`kt
class Application : Application() {
override fun onCreate() {
super.onCreate()
TSAccountProtection.initializeSDK(this.applicationContext) // initialize the SDK
...
}
}
`

$3


First, Create a filed named TransmitSecurity.plist in your native iOS Xcode project:
`xml




credentials

baseUrl
https://api.transmitsecurity.io/
clientId
[CLIENT_ID]



`

Next initialize the SDK when your app component is ready
`js
import TSAccountProtectionSDKModule, { TSAccountProtectionSDK } from 'react-native-ts-accountprotection';

componentDidMount(): void {
// Setup the module as soon your component is ready
await TSAccountProtectionSDKModule.initializeSDKIOS();
}
`

Module API

#### Set UserID after authentication
`js
await TSAccountProtectionSDKModule.setUserId(username);
`

#### Trigger Action
`js
private handleTriggerActionLoginExample = async () => {
const triggerActionResponse = await TSAccountProtectionSDKModule.triggerAction(
TSAccountProtectionSDK.TSAction.login,
{
correlationId: "CORRELATION_ID",
claimUserId: "CLAIM_USER_ID",
referenceUserId: "REFERENCE_USER_ID",
transactionData: undefined
}
)
const actionToken = triggerActionResponse.actionToken;
console.log("Action Token: ", actionToken); // Use the action token to invoke the recommendation API.
}
`

#### Clear User ID
`js
await TSAccountProtectionSDKModule.clearUser();
`

#### Set Log Level (Optional)
Enable or disable SDK debug logging:
`js
await TSAccountProtectionSDKModule.setLogLevel(true); // Enable debug logging
await TSAccountProtectionSDKModule.setLogLevel(false); // Disable debug logging
``

Important

Please take note that the example application uses a client-side mock server. In a production environment, a real server is required. Additionally, it is crucial to emphasize that storing the client secret in your front-end application is strictly discouraged for security reasons.

Support

Email us for support

Author

Transmit Security, https://github.com/TransmitSecurity

License

This project is licensed under the MIT license. See the LICENSE file for more info.