Quick Start

1

Install

Add the SDK to your project

2

Initialize

Configure at app startup

3

Verify

Call verify() on sensitive actions

1. Install

Web

npm install @surtai/guardian-web

React Native

npm install @surtai/guardian-rn
cd ios && pod install && cd ..

iOS

In Xcode: File → Add Package Dependencies → enter https://github.com/surtTech/surt-guardian-sdk, version 0.2.1.

Android

build.gradle.kts

dependencies {
    implementation("com.surt.guardian:securitysdk:0.2.1")
}

2. Initialize

Web

No initialization step, the web SDK exposes a single static collect() function with no API key, no provider, and no setup. Skip to step 3.

React Native

App.tsx

import { GuardianProvider } from '@surtai/guardian-rn';

export default function App() {
  return (
    <GuardianProvider apiKey="YOUR_API_KEY" environment="production">
      <Navigation />
    </GuardianProvider>
  );
}

iOS

AppDelegate.swift

import SurtGuardianSDK

GuardianSDK.initialize(
    apiKey: "YOUR_API_KEY",
    options: GuardianOptions(environment: .production)
)

Android

MyApplication.kt

import com.surt.guardian.GuardianSDK
import com.surt.guardian.core.Environment
import com.surt.guardian.core.GuardianOptions

GuardianSDK.initialize(
    context = this,
    apiKey = "YOUR_API_KEY",
    options = GuardianOptions(environment = Environment.Production)
)

3. Set Customer & Verify

Web

Web is collect-only, the SDK returns an encrypted payload your backend forwards to Surt.

SignInButton.tsx

import { collect } from '@surtai/guardian-web';

async function handleSignIn() {
  const { payload } = await collect({ collectLocation: false });

  await fetch('/api/sign-in', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ userId: 'user_123', payload }),
  });
  // Your /api/sign-in forwards `payload` to Surt's evaluate endpoint
  // and decides what to return to the client.
}

React Native

LoginScreen.tsx

import { useGuardian } from '@surtai/guardian-rn';

function LoginScreen() {
  const { verify, setCustomer } = useGuardian();

  const handleLogin = async () => {
    setCustomer('user_123', 'John Doe', 'john@example.com');

    const result = await verify('login', 'User Login');

    if (result.allowed) {
      // Proceed
    } else {
      // Blocked - check result.riskLevel
    }
  };
}

iOS

GuardianSDK.shared.setCustomer(customerId: "user_123", name: "John Doe", email: "john@example.com")

let result = try await GuardianSDK.shared.verify(transactionType: .login, transactionName: "User Login")

if result.allowed {
    // Proceed
}

Android

GuardianSDK.getInstance().setCustomer(customerId = "user_123", name = "John Doe", email = "john@example.com")

val result = GuardianSDK.getInstance().verifySuspend(
    transactionType = TransactionType.LOGIN,
    transactionName = "User Login"
)

if (result.allowed) {
    // Proceed
}

Next Steps

Choose your platform for the full integration guide:

• Web (Browser)
• React Native
• iOS (Swift)
• Android (Kotlin)