authenticate

Delegates the authentication of the user to the Orange mobile data network used to send the underlying request to the Webcom back end. This operation is asynchronous and calls the given callback with the authentication result once performed.

This operation fails if the user isn't an Orange customer or doesn't connect to the Webcom back end through the Orange mobile data network (e.g. using a Wi-Fi connection instead of the mobile data).

Depending on whether the Webcom Authentication Service already knows the authenticated identity (which is managed externally), this operation either:

• creates a new Webcom account bound to the authenticated identity when it is not known yet,
• or retrieves the Webcom account bound to the authenticated identity when it is already known.

In order to perform a multi-factor authentication, context must be set to Context.Current and the user to authenticate must already be authenticated with an other method (or factor).