¶ Automatically detect login on mobile

¶ Principle introduction

Automatically detect the login status of associated applications on the same device, which essentially establishes a session connection between a deviceId (device ID) and the GenAuth server.

When a user logs in to an application, the GenAuth interface is called to create a session between the deviceId and the GenAuth server, so that when the user logs in to other applications on the same device, the existence of this session can be detected, thereby skipping the login step and achieving automatic login.

Suppose you have three apps: App 1, App2 and App3. As long as one of the apps has established a session relationship with the GenAuth server, the session can be detected.

¶ Start access

¶ Get device ID

¶ iOS

The device ID of an iOS device can be obtained through identifierForVendor (opens new window). The device ID obtained by apps from the same vendor is the same.

If your apps do not belong to the same vendor, it is recommended to use ASIdentifierManager (opens new window).

Swift 5 code example:

let deviceId = UIDevice.current.identifierForVendor!.uuidString

OC code example:

UIDevice *currentDevice = [UIDevice currentDevice];
NSString *deviceId = [[currentDevice identifierForVendor] UUIDString];

¶ Android

Android devices can be obtained through ANDROID_ID (opens new window):

Java code example:

import android.provider.Settings.Secure;
private String android_id = Secure.getString(getContext().getContentResolver(),
                                                        Secure.ANDROID_ID);

Kotlin code example:

val deviceID = Settings.Secure.getString(contentResolver,
Settings.Secure.ANDROID_ID)

{
    code: 200,
    message: "Session created successfully!",
    data: {
        sessionId: "xxxxxx", // session ID
    }
}

Swift code example:

func createSession(userPoolId: String, token: String){
    // Mobile SSO: createSession
    struct MobileSSO: Encodable {
        let userPoolId: String
        let deviceId: String
    }
    let body = MobileSSO(
        userPoolId: UserPoolId,
        deviceId: UIDevice.current.identifierForVendor!.uuidString,
    )
    let headers: HTTPHeaders = [
        "Authorization": token ,
        "Accept": "application/json"
    ]
    let api = "https://core.genauth.ai/oauth/sso/mobile/createSession"
    AF.request(api, method: .post, parameters: body, encoder: JSONParameterEncoder.default, headers: headers).response { response in
         debugPrint(response)
    }
}

// Return user information directly
{
    code: 200,
    message: 'Successfully obtained session user information',
    data: {
      "_id":"5e05bbf2d51b3761d5c71070",
      "email":"983132@qq.com",
      "emailVerified":false,
      "oauth":"",
      "registerMethod":"default:username-password",
      "username":"983132@qq.com",
      "nickname":"",
      "company":"",
      "photo":"https://usercontents.authing.co/authing-avatar.png",
      "token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7ImVtYWlsIjoiOTgzMTMyQHFxLmNvbSIsImlxxxxxxxxx",
      "phone":"",
      "tokenExpiredAt":"2020-01-11T08:08:18.000Z",
      "loginsCount":1,
      "lastIP":"::1",
      "signedUp":"2019-12-27T08:08:18.115Z",
      "blocked":false,
      "isDeleted":false
    }
}

// Return ticket
{
    code: 200,
    message: 'Successfully obtained session user information',
    data: {
      ticket: "xxxxdjdkxxxxx",
      nickname: "xxxx",
      photo: "https://usercontents.authing.co/authing-avatar.png"
    }
}

If the session is queried, GenAuth trackSession will return the user's nickname and avatar (for display purposes) and the ticket used to exchange for user information:

You can display the user's nickname and avatar on the front end, as shown below:

{
   "code":200,
   "message":"Successfully exchanged user information",
   "data":{
      "_id":"5e05bbf2d51b3761d5c71070",
      "email":"983132@qq.com",
      "emailVerified":false,
      "oauth":"",
      "registerMethod":"default:username-password",
      "username":"983132@qq.com",
      "nickname":"",
      "company":"",
      "photo":"https://usercontents.authing.co/authing-avatar.png",
      "token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7ImVtYWlsIjoiOTgzMTMyQHFxLmNvbSIsImlxxxxxxxxx",
      "phone":"",
      "tokenExpiredAt":"2020-01-11T08:08:18.000Z",
      "loginsCount":1,
      "lastIP":"::1",
      "signedUp":"2019-12-27T08:08:18.115Z",
      "blocked":false,
      "isDeleted":false
   }

 {
    code: 200,
    message: "Destroying session successfully!"
}