torus_direct
Torus CustomAuth SDK for Flutter applications.
Get started
Checkout example/
.
Usage
Add torus_direct
package to your pubspec and import the package:
import 'package:torus_direct/torus_direct.dart';
Decide which OAuth provider you'll being using. See Torus CustomAuth supported OAuth providers.
Go to Torus Developer and create your verifier for your OAuth provider of choice with corresponding configuration.
Initialize the package:
await TorusDirect.init(
network: TorusNetwork.testnet,
browserRedirectUri:
Uri.parse('https://scripts.toruswallet.io/redirect.html'),
redirectUri: Uri.parse(
'torusapp://org.torusresearch.torusdirectandroid/redirect')); // Replace with your app URL
browserRedirectUri
is where you host your callback/redirect URL from OAuth provider (Google, Facebook, Twitter, etc),
some of these providers do not accept custom scheme (only accept https), in these cases, you'll need a browser URL the proxy the OAuth result to your app custom scheme.
If you don't supply browserRedirectUri
, it will be default to redirectUri
.
Trigger login while your user is interacting with your application:
await TorusDirect.triggerLogin(
typeOfLogin: TorusLogin.google,
verifier: 'google-lrc',
clientId:
'221898609709-obfn3p63741l5333093430j3qeiinaa8.apps.googleusercontent.com');
Or get Torus key directly if you're using JWT verifier:
await TorusDirect.getTorusKey(
verifier: 'acme-jwt',
verifierId: idToken.sub,
idToken: idToken.jwt);
Android-specific configuration
Add custom URL schemes to your app by adding the following to your app android/app/build.gradle
:
manifestPlaceholders = [
'torusRedirectScheme': 'torusapp',
'torusRedirectHost': 'org.torusresearch.torusdirectandroid',
'torusRedirectPathPrefix': '/redirect'
]
iOS-specific configuration
Open the project in XCode (open ios/Runner.xcworkspace
) and add a custom URL types.
Add the following to ios/Runner/AppDelegate.swift
to handle redirect URL:
import UIKit
import Flutter
import TorusSwiftDirectSDK
@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
override func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
GeneratedPluginRegistrant.register(with: self)
return super.application(application, didFinishLaunchingWithOptions: launchOptions)
}
// Handle redirect URL and send to Torus Direct instance
override func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
TorusSwiftDirectSDK.handle(url: url)
return true
}
}