Phone

Auth v0

TerraCore v0

Login your user with phone number

Installation

Android

implement("vn.teko.android.auth:terra-auth:$version")

iOS

pod 'Janus', '~> [version]'

Flutter

flutter pub add auth_flutter

Enable phone login method in Terra Console

Please contact us we will setup it for you

Usage

You will need to implement an phone + otp login form yourself, then pass input data to TerraAuth for logging in.

Firstly, initialize phone login with OTP request. A successful call means an OTP is sent to your user, you can show the OTP form for user to enter.

You can also use this function for resending OTP.

Android

// request OTP

val terraAuth = TerraAuth.getInstance(terraApp)

PhoneProvider.requestPhoneOtp(phoneNumber, terraAuth) { result: Result<Unit, Throwable> ->

when (result) {

is Result.Success -> // request successfully, show OTP form for user

is Result.Failure -> // handle failure OTP request

}

}

iOS

PhoneAuthProvider.provider(app: terraApp)?.requestOTP(phone: phone, completion: { [weak self] (isSuccess, error) in

if (isSuccess) {

// request successfully, show OTP form for user

} else {

// handle failure OTP request

}

})

Flutter

final _terraAuth = await TerraAuth.getInstance(_appName);

final result = await _terraAuth.requestOtp(phoneNumber);

showToast("Login Result: ${result.isSuccess}");

After user enters the OTP, you can now create the credential to login

Android

// create the credential

val credential = PhoneProvider.getLoginCredential(phoneNumber, otp)

// login

TerraAuth.getInstance(terraApp).loginWithCredential(credential) { result: Result<Unit, Throwable> ->

when (result) {

is Result.Success -> // handle successful login

is Result.Failure -> // handle failed login

}

}

iOS

if let credential = PhoneAuthProvider.provider(app: terraApp)?.credential(pin: otp) {

do {

try TerraAuth.getInstance(by: app)?.login(credential: credential, delegate: self)

} catch {

}

}

with

extension MyUIViewController: LoginManagerDelegate {

func loginManagerDidLoginSuccess(authInfo: IAuthInfo) {

// handle successful login

}

func loginManagerDidLoginFail(error: AuthError?) {

// handle failed login

}

}

Flutter

final _terraAuth = await TerraAuth.getInstance(_appName);

final credential = PhoneOtpProvider.createCredential(phone, otp);

final result = await _terraAuth.loginWithCredential(credential);

showToast("Login Result: ${result.isSuccess}");

After logging in success, you now have the access_token. Please continue to Access Token Usage for usage guide.