Skip to content

The react-native-ts-identity-orchestration is a React Native module for Orchestration. It allows your mobile application to communicate with Mosaic, run journeys, and submit client input. It wraps the native iOS and Android Orchestration SDKs and exposes them through a unified React Native module.

Capabilities

  • Start and manage journeys from the client side
  • Handle journey steps and submit client responses
  • Maintain state between server responses and client input
  • Support for mobile approve flows
  • Callback-based response handling for journey steps

Requirements

  • React Native 0.60+
  • iOS 13.0+
  • Android 5+ (API level 21+)

Installation

Install the React Native module:

npm install react-native-ts-identity-orchestration

For iOS, install native dependencies:

cd YOUR_PROJECT_PATH/ios
pod install

For Android, add the Mosaic Maven repository to your build.gradle:

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

Initialization

Create a TransmitSecurity.plist file in your Xcode project:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>credentials</key>
    <dict>
        <key>baseUrl</key>
        <string>[BASE_URL]</string>
        <key>clientId</key>
        <string>[CLIENT_ID]</string>
    </dict>
</dict>
</plist>

Initialize the SDK from the React Native layer:

import RNTSIdentityOrchestration from 'react-native-ts-identity-orchestration';

if (Platform.OS === 'ios') {
  RNTSIdentityOrchestration.initializeSDK();
}

Configure the base server URL based on your region:

RegionBase URL
UShttps://api.transmitsecurity.io/
EUhttps://api.eu.transmitsecurity.io/
Canadahttps://api.ca.transmitsecurity.io/
Australiahttps://api.au.transmitsecurity.io/
Japanhttps://api.gasne1-ts01.transmitsecurity.io/
Sandboxhttps://api.sbx.transmitsecurity.io/
Custom domainhttps://<your-domain>.com/ (see Custom domains)

Next steps