External providers

This article contains instruction to implement third parties approaches to authenticating a customer in a mobile application.

Facebook Login

For those Applications that rely on Facebook Login as authentication, Synerise has a separate method that provides you with a Synerise JWT token based on Facebook login. Currently, there are no dedicated settings related to Facebook authentication on the user interface in the Synerise platform. You just have to implement RESTful API or SDK methods to authenticate through Facebook.

To authenticate a customer using Facebook, implement the following methods:

Additionally, in the Synerise platform (app.synerise.com) you can define the following settings:

• Assignment of loyalty card
• JWT longevity
• Custom ID overwriting
• External ID overwriting

Sign in with Apple

For integrating with the Apple platform, Synerise has a separate method that returns a Synerise JWT token based on Sign in with Apple credentials. You can read more about the configuration of the Sign in with Apple option in the Synerise platform here.

In this case, the authentication process works in the following way:

1. A customer authenticates by Sign in with Apple.
2. Apple provides authentication credentials.
3. Your app uses these credentials and creates ClientAppleSignInAuthenticationContext.
4. The context is passed to Synerise by using:

   OS	Method
   iOS	- Client.authenticate(token:clientIdentityProvider:authID:context:success:failure:) - Client.authenticateConditionally(token:clientIdentityProvider:authID:context:success:failure:)
   React Native	- Synerise.Client.authenticate(token, clientIdentityProvider, authID, context, onSuccess, onError) - Synerise.Client.authenticateConditionally(token, clientIdentityProvider, authID context, onSuccess, onError)
   Flutter	- Synerise.client.authenticate(clientAuthContext, clientIdentityProvider, token))

5. If the authentication was successful, Synerise provides your application with our JWT access token for the customer.

Additionally, in the Synerise platform (app.synerise.com) you can define the following settings:

• Assignment of loyalty card
• JWT longevity
• Custom ID overwriting
• External ID overwriting

The list of methods

Check if a customer is signed in

This method checks if a customer is signed in through oAuth, Facebook, Sign in with Apple, or RaaS.

Customer sign out

This method signs out the customer. The method terminates the JWT token and ends the customer session.

What’s next

When the customer’s is signed in, you can implement profile management methods and session management methods.