Assistant de connexion sociale (Google, Facebook & Apple)
Faites fonctionner les connexions OAuth Google, Facebook et Apple de manière fiable dans votre app WebView iOS grâce aux assistants de connexion intégrés.
Google, Facebook et d'autres fournisseurs OAuth restreignent les connexions depuis des WebViews intégrées (p. ex. l'erreur « disallowed_useragent » de Google). Le Social Login Helper intégré à WebViewGold permet à ces connexions de fonctionner de manière fiable dans votre app iOS — sans modifier le flux de connexion de votre site web.
Fonctionnement :
Vous définissez des préfixes d'URL qui apparaissent pendant le flux de connexion de votre app web. Dès que l'une de ces URL déclencheuses se charge, WebViewGold ouvre la connexion dans une fenêtre de connexion popup dédiée avec un user agent ajusté que le fournisseur OAuth accepte. Après une connexion réussie, le flux revient automatiquement à votre app web. « Sign in with Apple » (appleid.apple.com) est détecté et géré automatiquement — aucune configuration nécessaire.
Configuration :
Ouvrez Config.swift et définissez les préfixes d'URL déclencheurs de votre flux de connexion :
var google_login_helper_triggers: [String] = ["https://accounts.google.com", "https://accounts.youtube.com"] var facebook_login_helper_triggers: [String] = ["https://m.facebook.com", "https://www.facebook.com"]
google_login_helper_triggers— préfixes d'URL chargés pendant une connexion Google sur votre site web.facebook_login_helper_triggers— préfixes d'URL chargés pendant une connexion Facebook sur votre site web.
Pour trouver les bonnes URL déclencheuses, lancez le flux de connexion de votre site web dans un navigateur de bureau et notez par quelles URL passe la redirection OAuth.
Ouvrir une URL d'authentification dans le navigateur externe :
En alternative, vous pouvez transmettre explicitement une URL de connexion au navigateur système (la session vit alors dans le navigateur, pas dans l'app) :
window.location.href = "googlelogin://" + encodeURIComponent("https://accounts.google.com/o/oauth2/v2/auth?...");
WebViewGold décode l'URL après le préfixe googlelogin:// et l'ouvre en externe.
Quand utiliser le helper :
Essayez d'abord les options plus simples — elles résolvent déjà de nombreux problèmes de connexion :
- Ouvrez le domaine de connexion dans un onglet de navigateur in-app ou dans le navigateur externe via l'API URL Handling (p. ex.
specialLinkHandlingOptions,safariblacklist). - Définissez un user agent personnalisé (
useragent_iphone/useragent_ipad).
Si la connexion échoue toujours dans l'app, les déclencheurs du Social Login Helper sont la solution recommandée.
Notes d’implémentation façon SDK
Considérez cette fonctionnalité comme une capacité native exposée à votre couche web : conservez votre site web de production ou votre PWA comme source de vérité, puis utilisez les indicateurs de configuration WebViewGold documentés, les commandes URL et les appels du pont JavaScript pour activer le comportement natif iOS uniquement là où il apporte de la valeur. Cette approche garde votre base de code maintenable, car la même application web peut servir les navigateurs, WebViewGold pour iOS et les autres plateformes WebViewGold avec un minimum de logique conditionnelle.
Pour des résultats fiables, privilégiez les points de terminaison HTTPS, des noms de routes stables, des états de succès/erreur explicites dans votre interface et de petites fonctions JavaScript qui encapsulent les appels natifs. Par exemple, une application web créée avec jQuery Mobile, Lovable, Base44, Bolt, WordPress, Bubble, une pile React/Vue/Angular personnalisée ou du HTML statique peut exposer un seul bouton ou gestionnaire d’événement qui déclenche l’API native WebViewGold tout en affichant une solution de repli élégante dans le navigateur.
- Modèle d’intégration recommandé : détectez le contexte de l’application, appelez l’API WebViewGold, puis mettez à jour votre interface web après le rappel natif ou le changement de route.
- Liste de vérification des tests : validez la fonctionnalité sur un appareil réel ou une build empaquetée, vérifiez les autorisations et le texte de revue du store, et confirmez que les utilisateurs navigateur uniquement reçoivent toujours une solution de repli utile.
- Avantage SEO : gardez les pages de fonctionnalités, les titres de routes et le contenu structuré indexables sur votre site web pendant que WebViewGold fournit l’enveloppe d’application native pour les utilisateurs iOS.