Ajouter la connexion à votre application .NET Android et iOS

Utiliser l’IA pour intégrer Auth0

Si vous utilisez un assistant de codage par IA comme Claude Code, Cursor ou GitHub Copilot, vous pouvez ajouter automatiquement l’authentification Auth0 en quelques minutes à l’aide des agent skills.Installation :

npx skills add auth0/agent-skills --skill auth0-quickstart --skill auth0-net-android --skill auth0-net-ios

Demandez ensuite à votre assistant IA :

Add Auth0 authentication to my .NET Android & iOS app

Votre assistant IA créera automatiquement votre application Auth0, récupérera les informations d’identification, installera le SDK Auth0 OidcClient, configurera les paramètres propres à la plateforme et mettra en place les flux de connexion et de déconnexion. Documentation complète sur les agent skills →

Premiers pas

Créer un projet .NET

Créez un nouveau projet .NET MAUI ou .NET Android/iOS pour ce guide de démarrage rapide.

.NET MAUI
.NET Android
.NET iOS

Dans Visual Studio 2022 ou une version ultérieure :

Fichier → Nouveau → Projet
Sélectionnez le modèle .NET MAUI App
Configurez votre projet :
- Nom du projet : Auth0MauiSample
- Emplacement : Choisissez l’emplacement souhaité
- Framework : .NET 8.0 ou version ultérieure
Cliquez sur Créer

Dans Visual Studio 2022 ou une version ultérieure :

Fichier → Nouveau → Projet
Sélectionnez le modèle Android App (.NET)
Configurez votre projet :
- Nom du projet : Auth0AndroidSample
- Framework : .NET 8.0 ou version ultérieure
Cliquez sur Créer

Dans Visual Studio 2022 (Mac) ou Visual Studio for Mac :

Fichier → Nouveau → Projet
Sélectionnez le modèle iOS App (.NET)
Configurez votre projet :
- Nom du projet : Auth0iOSSample
- Framework : .NET 8.0 ou version ultérieure
Cliquez sur Créer

Ce guide de démarrage rapide met l’accent sur .NET Android et iOS, qui constituent la nouvelle génération de Xamarin.Android et Xamarin.iOS. Si vous utilisez encore Xamarin, vous pouvez suivre ce guide, car l’intégration est identique et les SDK sont compatibles.

Installer le SDK d’Auth0

Ajoutez le SDK client OIDC Auth0 à votre projet.

Console du gestionnaire de packages
Visual Studio pour Mac
.NET CLI

Ouvrez la console du gestionnaire de packages (View → Other Windows → Package Manager Console) et installez le package approprié :Pour .NET Android :

Package Manager Console

Install-Package Auth0.OidcClient.AndroidX

Pour .NET iOS :

Package Manager Console

Install-Package Auth0.OidcClient.iOS

Pour .NET MAUI (les deux plateformes) :

Package Manager Console

Install-Package Auth0.OidcClient.MAUI

Dans le Solution Pad, faites Ctrl+clic (ou clic droit) sur le dossier Packages
Sélectionnez Add Packages…
Recherchez :
- Auth0.OidcClient.AndroidX pour Android
- Auth0.OidcClient.iOS pour iOS
- Auth0.OidcClient.MAUI pour les projets MAUI
Sélectionnez le package, puis cliquez sur Add Package

Exécutez la commande suivante dans le répertoire de votre projet :Pour .NET Android :

Terminal

dotnet add package Auth0.OidcClient.AndroidX

Pour .NET iOS :

Terminal

dotnet add package Auth0.OidcClient.iOS

Pour .NET MAUI :

Terminal

dotnet add package Auth0.OidcClient.MAUI

Le SDK client OIDC Auth0 gère tous les détails des protocoles OAuth 2.0 et OIDC et fournit une API simple pour l’authentification.

Configurez votre application Auth0

Créez une nouvelle application dans votre locataire Auth0 et configurez-la pour le mobile.

Accédez au Auth0 Dashboard
Cliquez sur Applications → Applications → Create Application
Saisissez un nom pour votre application, sélectionnez Native comme type d’application, puis cliquez sur Create
Ouvrez l’onglet Settings sur la page des détails de l’application
Prenez note de votre Domaine et de votre ID client : vous en aurez besoin à l’étape suivante

Configurer les URL de rappel :Dans l’onglet Settings, ajoutez les URL suivantes :Allowed Callback URLs:

Android
iOS

YOUR_ANDROID_PACKAGE_NAME://{yourDomain}/android/YOUR_ANDROID_PACKAGE_NAME/callback

Remplacez :

YOUR_ANDROID_PACKAGE_NAME par le nom du package de votre application (p. ex., com.mycompany.myapp)
{yourDomain} par votre domaine Auth0 (p. ex., dev-abc123.us.auth0.com)

Exemple : com.mycompany.myapp://dev-abc123.us.auth0.com/android/com.mycompany.myapp/callback

YOUR_BUNDLE_IDENTIFIER://{yourDomain}/ios/YOUR_BUNDLE_IDENTIFIER/callback

Remplacez :

YOUR_BUNDLE_IDENTIFIER par l’identifiant du bundle de votre application (p. ex., com.mycompany.myapp)
{yourDomain} par votre domaine Auth0 (p. ex., dev-abc123.us.auth0.com)

Exemple : com.mycompany.myapp://dev-abc123.us.auth0.com/ios/com.mycompany.myapp/callback

Allowed Logout URLs:Utilisez les mêmes URL que pour vos URL de rappel.

Assurez-vous que les URL de rappel et de déconnexion sont en minuscules. Si les URL ne correspondent pas, l’authentification échouera.

Les Allowed Callback URLs sont essentielles à la sécurité : elles garantissent que les utilisateurs sont redirigés de façon sécuritaire vers votre application après l’authentification. Sans URL correspondante, le processus de connexion échouera.Les Allowed Logout URLs offrent une expérience fluide lorsque les utilisateurs se déconnectent, en les redirigeant vers votre application au lieu de les laisser sur une page Auth0.

Initialiser l’application Auth0

Créez une instance d’Auth0Client pour communiquer avec Auth0.

Android - MainActivity
iOS - AppDelegate

MainActivity.cs

using Auth0.OidcClient;
using Android.App;
using Android.Content;

[Activity(Label = "Auth0Sample", MainLauncher = true, Icon = "@drawable/icon",
    LaunchMode = LaunchMode.SingleTask)]
[IntentFilter(
    new[] { Intent.ActionView },
    Categories = new[] { Intent.CategoryDefault, Intent.CategoryBrowsable },
    DataScheme = "YOUR_ANDROID_PACKAGE_NAME",
    DataHost = "{yourDomain}",
    DataPathPrefix = "/android/YOUR_ANDROID_PACKAGE_NAME/callback")]
public class MainActivity : Activity
{
    private Auth0Client auth0Client;

    protected override void OnCreate(Bundle savedInstanceState)
    {
        base.OnCreate(savedInstanceState);

        // Initialiser le client Auth0
        auth0Client = new Auth0Client(new Auth0ClientOptions
        {
            Domain = "{yourDomain}",
            ClientId = "{yourClientId}"
        }, this);
    }

    protected override async void OnNewIntent(Intent intent)
    {
        base.OnNewIntent(intent);
        Auth0.OidcClient.ActivityMediator.Instance.Send(intent.DataString);
    }
}

Remplacez YOUR_ANDROID_PACKAGE_NAME, {yourDomain} et {yourClientId} par vos valeurs. Assurez-vous que tout le texte dans DataScheme, DataHost et DataPathPrefix est en minuscules.

IntentFilter enregistre votre application pour traiter l’URL de rappel. LaunchMode.SingleTask garantit qu’Android ne crée pas une nouvelle instance d’activité lorsque l’URL de rappel est appelée.

Commencez par enregistrer le schéma d’URL dans votre Info.plist :

Info.plist

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>None</string>
        <key>CFBundleURLName</key>
        <string>Auth0</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>YOUR_BUNDLE_IDENTIFIER</string>
        </array>
    </dict>
</array>

Ensuite, configurez votre AppDelegate.cs :

AppDelegate.cs

using Auth0.OidcClient;
using Foundation;
using UIKit;

[Register("AppDelegate")]
public class AppDelegate : UIApplicationDelegate
{
    private Auth0Client auth0Client;

    public override bool FinishedLaunching(UIApplication application, NSDictionary launchOptions)
    {
        // Initialiser le client Auth0
        auth0Client = new Auth0Client(new Auth0ClientOptions
        {
            Domain = "{yourDomain}",
            ClientId = "{yourClientId}"
        });

        return true;
    }

    public override bool OpenUrl(UIApplication application, NSUrl url,
        string sourceApplication, NSObject annotation)
    {
        ActivityMediator.Instance.Send(url.AbsoluteString);
        return true;
    }
}

Remplacez YOUR_BUNDLE_IDENTIFIER, {yourDomain} et {yourClientId} par vos valeurs.

Stockez votre domaine Auth0 et votre ID client dans un fichier de configuration ou dans les paramètres de l’application au lieu de les coder en dur, afin de faciliter la maintenance.

Mettre en œuvre la connexion et la déconnexion

Ajoutez des méthodes pour gérer l’authentification de l’utilisateur.Implémentez la connexion :

Authentication.cs

public async Task LoginAsync()
{
    var loginResult = await auth0Client.LoginAsync();

    if (!loginResult.IsError)
    {
        // Authentification réussie
        var accessToken = loginResult.AccessToken;
        var idToken = loginResult.IdentityToken;
        var user = loginResult.User;

        // Enregistrer les informations d'identification et mettre à jour l'interface
        Console.WriteLine($"Logged in as: {user.FindFirst("name")?.Value}");
    }
    else
    {
        // Gérer l'erreur d'authentification
        Console.WriteLine($"Login error: {loginResult.Error}");
    }
}

Implémentez la déconnexion :

Authentication.cs

public async Task LogoutAsync()
{
    var logoutResult = await auth0Client.LogoutAsync();

    if (logoutResult == BrowserResultType.Success)
    {
        // Effacer les informations d'identification stockées
        // Mettre à jour l'interface pour l'état déconnecté
        Console.WriteLine("Logged out successfully");
    }
}

La méthode LoginAsync() lance le navigateur du système (ou Chrome Custom Tabs sur Android) pour afficher la page Universal Login d’Auth0. Après l’authentification, l’utilisateur est redirigé vers votre application au moyen de l’URL de rappel.

Ajoutez ces méthodes à votre MainActivity (Android) ou à un ViewController (iOS), puis appelez-les lorsque les utilisateurs appuient sur les boutons de connexion/déconnexion.

Lancez votre application

Compilez et exécutez votre application.

Visual Studio (Windows)
Visual Studio pour Mac
.NET CLI

Pour Android :

Sélectionnez un émulateur Android ou un appareil connecté dans la liste déroulante des appareils
Appuyez sur F5 ou cliquez sur le bouton Run
L’application sera compilée, déployée et lancée

Pour iOS (nécessite un hôte de compilation Mac) :

Connectez-vous à votre hôte de compilation Mac
Sélectionnez un simulateur ou un appareil iOS dans la liste déroulante des appareils
Appuyez sur F5 ou cliquez sur le bouton Run

Pour Android :

Terminal

dotnet build -f net8.0-android
dotnet run -f net8.0-android

Pour iOS :

Terminal

dotnet build -f net8.0-ios
dotnet run -f net8.0-ios

Flux attendu :

L’application s’ouvre avec un bouton Login
Touchez Log In → Le navigateur ou un onglet personnalisé Chrome s’ouvre → Terminez l’authentification
Redirection automatique vers votre application
L’utilisateur est authentifié avec succès

Au premier lancement, iOS peut vous demander de confirmer l’ouverture du navigateur pour l’authentification. Il s’agit d’un comportement normal.

Point de contrôleVous disposez maintenant d’une expérience de connexion Auth0 entièrement fonctionnelle dans votre application .NET pour Android ou iOS. L’application utilise le navigateur système pour une authentification sécurisée et gère automatiquement le flux de redirection.

Accéder aux informations de l’utilisateur

Après une authentification réussie, vous pouvez accéder aux informations de l’utilisateur dans le résultat de connexion.

Résultat de l’authentification

La méthode LoginAsync() renvoie un objet LoginResult contenant :

UserInfo.cs

var loginResult = await auth0Client.LoginAsync();

if (!loginResult.IsError)
{
    // Jetons d'accès
    var accessToken = loginResult.AccessToken;
    var idToken = loginResult.IdentityToken;
    var refreshToken = loginResult.RefreshToken;

    // Accéder aux revendications de l'utilisateur
    var user = loginResult.User;
    var name = user.FindFirst("name")?.Value;
    var email = user.FindFirst("email")?.Value;
    var picture = user.FindFirst("picture")?.Value;

    Console.WriteLine($"Name: {name}");
    Console.WriteLine($"Email: {email}");
}

Parcourir l’ensemble des revendications

Pour voir toutes les informations disponibles sur l’utilisateur :

UserClaims.cs

if (!loginResult.IsError)
{
    foreach (var claim in loginResult.User.Claims)
    {
        Console.WriteLine($"{claim.Type}: {claim.Value}");
    }
}

Les revendications renvoyées dépendent exactement des scopes demandés. Pour en savoir plus, consultez Utilisation des scopes dans la documentation du client OIDC Auth0.

Demander des scopes personnalisés

Pour demander des informations supplémentaires sur l’utilisateur, précisez les scopes lors de la création de l’Auth0Client :

CustomScopes.cs

var auth0Client = new Auth0Client(new Auth0ClientOptions
{
    Domain = "{yourDomain}",
    ClientId = "{yourClientId}",
    Scope = "openid profile email offline_access read:posts"
});

Dépannage et aspects avancés

Problèmes courants et solutions

Le navigateur ne redirige pas vers l’application

Solutions :

Vérifiez que les URL de rappel dans le Auth0 Dashboard correspondent exactement au nom du package ou à l’identifiant de bundle de votre application
Assurez-vous que les URL de rappel sont en minuscules
Vérifiez que DataScheme, DataHost et DataPathPrefix (Android), ou le schéma d’URL (iOS), correspondent à votre configuration
Nettoyez et recompilez votre projet

L’authentification échoue avec l’erreur “Invalid Callback URL”

Correctif :

Vérifiez de nouveau que votre URL de rappel dans le Auth0 Dashboard respecte le format suivant :
- Android : packagename://yourdomain/android/packagename/callback
- iOS : bundleidentifier://yourdomain/ios/bundleidentifier/callback
Assurez-vous que l’URL est en minuscules
Vérifiez que le Domaine dans votre code correspond au Domaine dans le Auth0 Dashboard

LoginAsync() bloque ou ne se termine jamais

Solutions :

Assurez-vous que le filtre d’intent (Android) ou le schéma d’URL (iOS) est correctement configuré
Vérifiez que OnNewIntent() (Android) ou OpenUrl() (iOS) appelle ActivityMediator
Vérifiez que votre application peut ouvrir le navigateur système
Vérifiez la connexion réseau

Erreur : “Default App must use Token Endpoint Authentication Method ‘None’”

Correctif :

Accédez aux paramètres de votre application Auth0 dans le Dashboard
Faites défiler jusqu’à Application Properties
Réglez Application Type sur Native
Réglez Token Endpoint Authentication Method sur None
Cliquez sur Save Changes

iOS : Le navigateur ne s’ouvre pas

Solutions :

Vérifiez que Info.plist contient la bonne configuration de schéma d’URL
Vérifiez que OpenUrl() est implémenté dans AppDelegate
Assurez-vous que la cible de déploiement iOS est compatible avec la version de votre SDK Auth0

Considérations pour la production

Bonnes pratiques de sécurité

Stockage sécurisé des jetons : Utilisez le stockage sécurisé propre à la plateforme (Android Keystore, iOS Keychain) pour stocker les jetons
Actualisation des jetons : Implémentez la gestion des jetons d’actualisation afin de maintenir les sessions utilisateur
Épinglage de certificats : Envisagez l’épinglage de certificats pour renforcer la sécurité de l’API
ProGuard/obfuscation du code : Ajoutez les règles appropriées si vous utilisez l’obfuscation du code sur Android

Exigences des boutiques d’applications

Politique de confidentialité : Assurez-vous que votre application dispose d’une politique de confidentialité qui décrit l’utilisation d’Auth0
Gestion des données des utilisateurs : Suivez les directives de la plateforme pour gérer les données d’authentification des utilisateurs
Liens profonds : Testez minutieusement la gestion des URL de rappel dans différents scénarios
Exigences réseau : Gérez correctement les scénarios hors ligne

Optimisation des performances

Mettre Auth0Client en cache : Créez une seule instance et réutilisez-la dans toute votre application
Chargement différé : Initialisez Auth0Client uniquement au besoin
Actualisation en arrière-plan : Implémentez l’actualisation des jetons en arrière-plan pour les sessions de longue durée

Configuration avancée

Scopes personnalisés et audience

Demandez des scopes précis et définissez une audience pour votre API :

AdvancedAuth.cs

var auth0Client = new Auth0Client(new Auth0ClientOptions
{
    Domain = "{yourDomain}",
    ClientId = "{yourClientId}",
    Scope = "openid profile email offline_access read:posts write:posts",
    Audience = "https://myapi.example.com"
});

var loginResult = await auth0Client.LoginAsync();

Paramètres supplémentaires

Ajoutez des paramètres supplémentaires à la requête d’autorisation :

ExtraParams.cs

var extraParameters = new Dictionary<string, string>
{
    { "prompt", "login" },
    { "ui_locales", "es" },
    { "custom_param", "value" }
};

var loginResult = await auth0Client.LoginAsync(extraParameters);

Jetons d’actualisation

Utilisez des jetons d’actualisation pour obtenir de nouveaux jetons d’accès sans intervention de l’utilisateur :

RefreshToken.cs

var refreshResult = await auth0Client.RefreshTokenAsync(loginResult.RefreshToken);

if (!refreshResult.IsError)
{
    var newAccessToken = refreshResult.AccessToken;
    var newIdToken = refreshResult.IdentityToken;
    // Stockez les nouveaux jetons
}

Pour recevoir un jeton d’actualisation, incluez le scope offline_access dans votre requête d’authentification.

Configuration du navigateur selon la plateforme

Android - Utiliser Chrome Custom Tabs avec des couleurs personnalisées :

AndroidBrowser.cs

var auth0Client = new Auth0Client(new Auth0ClientOptions
{
    Domain = "{yourDomain}",
    ClientId = "{yourClientId}",
    Browser = new AndroidBrowser
    {
        ToolbarColor = Android.Graphics.Color.ParseColor("#FF6B35")
    }
}, this);

iOS - Utiliser SFSafariViewController avec une présentation personnalisée :

iOSBrowser.cs

var auth0Client = new Auth0Client(new Auth0ClientOptions
{
    Domain = "{yourDomain}",
    ClientId = "{yourClientId}",
    Browser = new ASWebAuthenticationSessionBrowser
    {
        PrefersEphemeralWebBrowserSession = false
    }
});

Prochaines étapes

Configurer des fournisseurs d’identité

Ajoutez des fournisseurs de connexion sociale comme Google, Facebook et GitHub

Activer l’authentification multifacteur

Ajoutez une couche de sécurité supplémentaire avec MFA

Protection contre les attaques

Découvrez comment vous protéger contre les attaques par force brute et les bots

Personnaliser l’expérience de connexion

Personnalisez la page Universal Login pour qu’elle reflète votre image de marque

​Premiers pas

​Accéder aux informations de l’utilisateur

​Résultat de l’authentification

​Parcourir l’ensemble des revendications

​Demander des scopes personnalisés

​Dépannage et aspects avancés

​Le navigateur ne redirige pas vers l’application

​L’authentification échoue avec l’erreur “Invalid Callback URL”

​LoginAsync() bloque ou ne se termine jamais

​Erreur : “Default App must use Token Endpoint Authentication Method ‘None’”

​iOS : Le navigateur ne s’ouvre pas

​Bonnes pratiques de sécurité

​Exigences des boutiques d’applications

​Optimisation des performances

​Scopes personnalisés et audience

​Paramètres supplémentaires

​Jetons d’actualisation

​Configuration du navigateur selon la plateforme

​Prochaines étapes

Configurer des fournisseurs d’identité

Activer l’authentification multifacteur

Protection contre les attaques

Personnaliser l’expérience de connexion

Premiers pas

Accéder aux informations de l’utilisateur

Résultat de l’authentification

Parcourir l’ensemble des revendications

Demander des scopes personnalisés

Dépannage et aspects avancés

Le navigateur ne redirige pas vers l’application

L’authentification échoue avec l’erreur “Invalid Callback URL”

LoginAsync() bloque ou ne se termine jamais

Erreur : “Default App must use Token Endpoint Authentication Method ‘None’”

iOS : Le navigateur ne s’ouvre pas

Bonnes pratiques de sécurité

Exigences des boutiques d’applications

Optimisation des performances

Scopes personnalisés et audience

Paramètres supplémentaires

Jetons d’actualisation

Configuration du navigateur selon la plateforme

Prochaines étapes