Skip to main content

Anonymous Enrollment

Before proceeding with the enrollment, users must trigger the anonymous enrollment flow, which will allow them to enroll without providing any personal or password-based credentials. This process relies on the Shift Lite backend and MCSDK events.

When a StartResultEvent with ACTIVATION_REQUIRED as sdkState is received, users should initiate the Anonymous Enrollment flow.

This involves triggering the AnonymousEnrollment event, which requires tenantId and clientId to the backend to perform the enrollment. The flow must follow the correct sequence for a seamless and successful enrollment process.

Shift Lite Anonymous Enrollment Flow​

The event flow diagram illustrates the sequence of events during the Anonymous Enrollment process for KOBIL Shift Lite.

Swift/iOS​

The AnonymousEnrollment function is a bridge between the user interface and the Shift Lite backend. It sends the necessary request (tenantId and clientId) to trigger the anonymous enrollment event. Once the enrollment is processed, the result is handled accordingly.

Here’s an example for triggering the AnonymousEnrollment flow in Swift/iOS:

func performAnonymousEnrollment(
    tenantId: String,
    clientId: String) {

    self.shiftLiteWrapper.enrollAnonymousUser(tenantId: tenantId, 
                                              clientId: clientId) { resultObject, _ in
        handleResult(resultObject: resultObject)
    }
}

Android/Kotlin​

In Kotlin, the AnonymousEnrollment flow utilizes a similar approach, where the enrollment event is triggered with the tenantId and clientId. The result is handled via the onResultReceived callback.

Here’s an example for triggering the AnonymousEnrollment flow in Kotlin:

fun performAnonymousEnrollment(
    tenantId: String,
    clientId: String,
    onResultReceived: ((result: ResultObject) -> Unit)? = onResultReceivedCallback
) {
    launchIO {
        ShiftLite.getInstance()?.enrollAnonymousUser(tenantId, clientId, onResultReceived)?.then {
            // handle result
        }
    }
}

Request Parameters​

Below are the request parameters used in the Anonymous Enrollment flow:

tenantId: This value is provided by the backend services.
clientId: The unique client identifier for your application.

Notes on Authentication Modes​

In Shift Lite, you can configure various authentication modes during the Anonymous Enrollment process. For more details, refer to the section on authentication modes.

For more details on event handling, you can also refer to the AnonymousEnrollEvent and AnonymousEnrollResultEvent events.

Conclusion​

With these steps, users can enroll anonymously without needing passwords. The provided code examples for both iOS/Swift and Android/Kotlin offer easy integration paths for mobile apps to leverage Shift Lite's anonymous enrollment capabilities.