From 0ffd0278af759afb2eb5c5f410370d287da975c1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9=20Gon=C3=A7alves?= Date: Thu, 24 Oct 2024 11:30:31 +0100 Subject: [PATCH] Add mobile docs --- docs/mobile.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 docs/mobile.md diff --git a/docs/mobile.md b/docs/mobile.md new file mode 100644 index 0000000..beb99a8 --- /dev/null +++ b/docs/mobile.md @@ -0,0 +1,21 @@ +--- +sidebar_position: 13 +--- + +# Mobile + +When integrating Topper on a mobile app, or either you open Topper on a **user's browser**, where no extra configuration is required, or embed it in a **WebView**. + +When embedding on a **WebView**, please ensure the following: + +- set the correct parameters referenced on [Single Sign-On](./single-sign-on.md#mobile-app) and [Digital Wallets](./digital-wallets.md#mobile-app). +- configure the **WebView** to support **Cloudflare Turnstile**. +- configure camera and audio app permissions to support **Veriff**. + +## Cloudflare Turnstile + +We use **Clouflare Turnstile** to confirm users are real and to block unwanted bots without slowing down the experience, so please be sure to follow this [Webview configurations](https://developers.cloudflare.com/turnstile/get-started/mobile-implementation/#webview-configurations) and [update the allowed origins](https://developers.cloudflare.com/turnstile/get-started/mobile-implementation/#update-allowed-origins) to account for `challenges.cloudflare.com, about:blank, about:srcdoc` and enable `https` and `http` connections. + +If you use `react-native-webview` package update your **WebView** `originWhitelist` as `originWhitelist={['https://*', 'http://*', 'about:blank', 'about:srcdoc']}`. + +If you use Flutter, Turnstile is [compatible and tested](https://developers.cloudflare.com/turnstile/get-started/mobile-implementation/#use-flutter-with-turnstile) with Flutter’s **WebView** implementation.