👩‍🎨Social Auth

What is Social Auth?

The Social Auth functionality enables Natively to manage third-party OAuth integrations directly within the application. To adhere to the policies of Google and Facebook, which prohibit developers from utilizing web authorization within WKWebView (iOS) and WebView (Android), Natively reroutes users to the official operating system browsers: Chrome (for Android) and Safari (for iOS). This measure is taken to circumvent potential security risks.

Currently, Natively accommodates social authorization exclusively for Google, Facebook and KakaoTalk. However, the scope for adding more options in the future remains open. Please share your suggestions for additional integrations by submitting a request here.

You're required to integrate Sign In with Apple feature if you have any other social authorization.

How to set up Social Auth?

1. Turn on the Universal Links feature.

2. Enter your app domain - a domain that will be associated with your application (We need it to redirect users back to your app after authorization). For example, app.buildnatively.com.

3. Setup Universal Links (This step is very important! Otherwise, Social Auth will not work.)

4. Make sure to enable Associated Domain for iOS.

5. Verify if Universal Links works. iOS and Android.

6. Turn on the Social Auth feature in the Natively app dashboard.

7. Rebuild your app

8. Test

IMPORTANT!

You need to make sure your redirect URL for Facebook/Google has the same domain that you're using in Universal Links (This is needed to redirect the user back with an auth token in such url so that you can handle it in the web app)

For example, in Bubble you can turn on the generic URL in Facebook or Google plugins:

and, of course, update it on Google and Facebook developer accounts (if needed).