Passer au contenu principal
Auth0 vous permet d’ajouter rapidement l’authentification à presque tous les types d’application. Ce guide explique comment intégrer Auth0, ajouter l’authentification et afficher les informations de profil utilisateur dans n’importe quelle application WPF et WinForms à l’aide des SDK Auth0 de WPF et WinForms.Pour utiliser ce guide rapide, vous devez :
  • Vous inscrire à un compte Auth0 gratuit ou vous connecter à Auth0.
  • Disposer d’un projet WPF ou WinForms fonctionnel avec lequel vous souhaitez vous intégrer. Vous pouvez également consulter ou télécharger une application faisant office d’exemple lorsque vous vous connectez.
    1

    Configuration d’Auth0

    Pour utiliser les services Auth0, vous devez avoir une application installée dans Auth0 Dashboard. L’application Auth0 est l’endroit où vous allez configurer le fonctionnement de l’authentification pour le projet que vous développez.

    ​
    Configurer une application

    Utilisez le sélecteur interactif pour créer une nouvelle application Auth0 ou sélectionner une application existante qui représente le projet avec lequel vous souhaitez effectuer l’intégration. Dans Auth0, chaque application se voit attribuer un identifiant client unique alphanumérique que votre code d’application utilisera pour appeler les API Auth0 via la trousse SDK.Tous les paramètres que vous configurez à l’aide de ce guide de démarrage rapide seront automatiquement mis à jour pour votre application dans le Tableau de bord, qui est l’endroit où vous pourrez gérer vos applications à l’avenir.Si vous préférez explorer une configuration complète, consultez plutôt un exemple d’application.

    ​
    Configuration des URL de rappel

    Une URL de rappel est une URL intégrée dans votre application vers laquelle vous souhaitez qu’Auth0 redirige les utilisateurs après leur authentification. Si elle n’est pas définie, les utilisateurs ne seront pas redirigés vers votre application après s’être connectés.
    Si vous suivez notre exemple de projet, définissez cette URL comme suit : http://{yourDomain}:4200/mobile.

    ​
    Configuration des URL de déconnexion

    Une URL de déconnexion est une URL intégrée dans votre application vers laquelle vous souhaitez qu’Auth0 redirige les utilisateurs après leur déconnexion. Si elle n’est pas définie, les utilisateurs ne pourront pas se déconnecter de votre application et recevront un message d’erreur.
    Si vous suivez notre exemple de projet, définissez cette URL comme suit : http://{yourDomain}:4200/mobile.
    2

    Installer la trousse SDK Auth0

    Auth0 propose une trousse SDK WPF et WinForms pour simplifier le processus d’implémentation de l’authentification Auth0 dans les applications WPF et WinForms.Utilisez le gestionnaire de packages NuGet (Tools (Outils) -> Library Package Manager (Gestionnaire de packages de bibliothèque) -> Package Manager Console (Console du gestionnaire de packages)) pour installer le package Auth0.OidcClient.WPF ou Auth0.OidcClient.WinForms en fonction de si vous générez une application WPF ou Windows Forms.Sinon, vous pouvez utiliser la Console du gestionnaire de packages NuGet (Install-Package) ou le dotnet CLI (dotnet add).
    Install-Package Auth0.OidcClient.WPF
Install-Package Auth0.OidcClient.WinForms

    dotnet add Auth0.OidcClient.WPF
dotnet add Auth0.OidcClient.WinForms
    3

    Instancier Auth0Client.

    Pour intégrer Auth0 dans votre application, instanciez une instance de la classe Auth0Client en passant une instance de Auth0ClientOptions qui contient votre domaine Auth0 et votre identifiant client.Par défaut, la trousse SDK exploitera WebView2 pour .NET6 et les versions ultérieures, tout en s’appuyant sur l’ancien WebView pour les applications utilisant une version antérieure à .NET6.
    Point de contrôle
    Votre Auth0Client devrait maintenant être correctement instancié. Exécutez votre application pour vérifier que : le client Auth0 est instancié correctement. votre application ne génère aucune erreur liée à Auth0.
    4

    Ajouter une fonctionnalité de connexion à votre application

    À présent que vous avez configuré votre application Auth0 et la trousse SDK Auth0, vous devez configurer la connexion pour votre projet. Pour ce faire, vous utiliserez la méthode LoginAsync() de la trousse SDK pour créer un bouton de connexion qui redirige les utilisateurs vers la page de connexion universelle Auth0. Une fois un utilisateur authentifié avec succès, il est redirigé vers l’URL de rappel que vous avez configurée précédemment dans ce démarrage rapide.S’il n’y a pas d’erreur, vous pouvez accéder à User (Utilisateur), IdentityToken, AccessToken et RefreshToken dans le LoginResult renvoyé par LoginAsync().
    Point de contrôle
    Vous devez désormais pouvoir vous connecter ou vous inscrire en utilisant un nom d’utilisateur et un mot de passe. Appuyez sur le bouton de connexion et vérifiez que : Votre application WPF ou WinForms vous redirige vers la page Connexion universelle Auth0. Vous pouvez vous connecter ou vous inscrire. Auth0 vous redirige vers votre application.
    5

    Ajouter une fonctionnalité de déconnexion à votre application

    Les utilisateurs qui se connectent à votre projet auront également besoin d’un moyen de se déconnecter. Créez un bouton de déconnexion en utilisant la méthode LogoutAsync() de la trousse SDK. Lorsque les utilisateurs se déconnectent, ils seront redirigés vers votre point de terminaison de déconnexion Auth0, qui par la suite les redirigera immédiatement vers l’URL de déconnexion que vous avez configurée précédemment dans ce démarrage rapide.
    Point de contrôle
    Exécutez votre application et cliquez sur le bouton de déconnexion, vérifiez que : Votre application WPF ou WinForms vous redirige vers l’adresse que vous avez indiquée comme l’une des URL de déconnexion autorisées dans les paramètres de votre application. Vous n’êtes plus connecté à votre application.
    6

    Afficher les informations du profil utilisateur

    Vu que vos utilisateurs peuvent désormais se connecter et se déconnecter, vous voudrez probablement pouvoir récupérer les informations de profil associées aux utilisateurs authentifiés. Par exemple, vous voudrez peut-être afficher le nom ou la photo de profil d’un utilisateur connecté dans votre projet.La trousse SDK Auth0 de WPF et WinForms fournit des informations sur l’utilisateur par l’intermédiaire de la propriété LoginResult.User.
    Point de contrôle
    Vérifiez que vous pouvez afficher le nom de l’utilisateur ou une autre propriété de l’utilisateur après la connexion.

​
Étapes suivantes

Beau travail! Si vous en êtes arrivé là, vous devriez avoir la connexion, la déconnexion et les informations de profil utilisateur actives dans votre application.Cela conclut notre tutoriel de démarrage rapide, mais il y a tellement plus à explorer. Pour en savoir plus sur ce que vous pouvez faire avec Auth0, consultez :
⌘I