Configuration requise
- iOS 9+
- Xcode 11.4+ / 12.x
- Swift 4.x / 5.x
Installation
Cocoapods
Si vous utilisez Cocoapods, ajoutez cette ligne à votrePodfile :
pod 'Lock', '~> 2.0'
Ensuite, exécutez pod install.
Pour en savoir plus sur Cocoapods, consultez la documentation officielle.
Carthage
Si vous utilisez Carthage, ajoutez la ligne suivante à votreCartfile :
github "auth0/Lock.swift" ~> 2.0
Exécutez ensuite carthage bootstrap.
Pour plus d’information sur l’utilisation de Carthage, consultez la documentation officielle.
SPM
Si vous utilisez Swift Package Manager, ouvrez l’élément de menu suivant dans Xcode : File > Swift Packages > Add Package Dependency… Dans la fenêtre Choose Package Repository, ajoutez cette URL :https://github.com/auth0/Lock.swift.git
Ensuite, cliquez sur Next et suivez les étapes restantes.
Pour en savoir plus sur SPM, consultez la documentation officielle.
Configuration
Intégrer votre application
Lock doit être informé lorsqu’on demande à l’application d’ouvrir une URL. Vous pouvez le faire dans le fichierAppDelegate.
Importation de Lock
Importez Lock partout où vous en avez besoinimport lock
Identifiants Auth0
Pour utiliser Lock, vous devez fournir votre Auth0 et votre Domaine, que vous trouverez dans l’Auth0 Dashboard, dans les paramètres de votre application. Dans le bundle de votre application, vous pouvez ajouter un fichierplist nommé Auth0.plist contenant vos identifiants, selon le format suivant.
Mise en œuvre de Lock Classic
Lock Classic gère l’authentification au moyen de connexions Database, Social et Enterprise.Mode conforme à OIDC
Il est fortement recommandé d’utiliser ce SDK en mode conforme à OIDC. Lorsque ce mode est activé, il oblige le SDK à utiliser le pipeline d’authentification actuel d’Auth0 et l’empêche d’accéder à des points de terminaison hérités. Par défaut, cette valeur estfalse
Utiliser la bibliothèque Auth0.Swift pour accéder au profil utilisateur
Pour accéder aux renseignements du profil utilisateur, vous devrez utiliser la bibliothèqueAuth0.Swift :
Spécifier les connexions
Lock chargera automatiquement les connexions configurées pour votre application. Si vous souhaitez modifier le comportement par défaut, vous pouvez préciser manuellement quelles connexions il doit présenter aux utilisateurs comme options d’authentification. Pour ce faire, appelez la méthode et fournissez une fonction de fermeture permettant de préciser la ou les connexions. Ajouter une connexion de base de données :Style et personnalisation
Lock offre de nombreuses options de personnalisation visuelle pour vous aider à appliquer votre propre image de marque à Lock avecwithStyle. Par exemple, vous pouvez modifier la couleur principale et le texte d’en-tête de votre widget Lock :
Personnalisez le titre, le logo et la couleur principale
Options de configuration
Il existe de nombreuses options pour configurer le comportement de Lock. Voici un exemple de Lock configuré de façon à pouvoir être fermé, à être limité aux seuls noms d’utilisateur (et non aux adresses courriel), et à n’afficher que les écrans Connexion et Réinitialiser le mot de passe.Prise en charge du gestionnaire de mots de passe
Par défaut, la prise en charge de 1Password est activée pour les connexions de base de données. Pour que l’option s’affiche dans les écrans de connexion et d’inscription, l’utilisateur doit tout de même avoir installé l’application 1Password. Vous pouvez désactiver la prise en charge de 1Password à l’aide de la propriété enabled de passwordManager.appIdentifier correspondra au Bundle Identifier de l’application et displayName à son nom d’affichage. Vous pouvez les personnaliser comme suit :
info.plist de votre application :