Sign up for an{" "}
Auth0 account
{" "}
or{" "}
console.log("log in")}>
log in
{" "}
to your existing account to integrate directly with your own tenant.
;
};
export const sections = [{
id: "configuration-d-auth0",
title: "Configuration d’Auth0"
}, {
id: "installer-la-trousse-sdk-auth0",
title: "Installer la trousse SDK Auth0"
}, {
id: "instancier-auth0client",
title: "Instancier Auth0Client"
}, {
id: "configurer-android",
title: "Configurer Android"
}, {
id: "configurer-ios",
title: "Configurer iOS"
}, {
id: "ajouter-une-fonctionnalité-de-connexion-à-votre-application",
title: "Ajouter une fonctionnalité de connexion à votre application"
}, {
id: "ajouter-une-fonctionnalité-de-déconnexion-à-votre-application",
title: "Ajouter une fonctionnalité de déconnexion à votre application"
}, {
id: "afficher-les-informations-du-profil-utilisateur",
title: "Afficher les informations du profil utilisateur"
}];
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 .NET Android et iOS à l’aide des SDK Auth0 pour [Android](https://www.nuget.org/packages/Auth0.OidcClient.AndroidX/) et [iOS](https://www.nuget.org/packages/Auth0.OidcClient.iOS).
Ce guide de démarrage couvre .NET Android et iOS, les futures générations de `Xamarin.Android` et de `Xamarin.iOS`. Si vous utilisez encore `Xamarin.Android` et `Xamarin.iOS`, vous pouvez suivre ce guide, car l’intégration est identique et les SDK sont compatibles.
Pour utiliser ce guide rapide, vous devez :
* Vous inscrire à un compte Auth0 gratuit ou vous connecter à Auth0.
* Avoir un projet Android ou iOS fonctionnel utilisant .NET 6 (ou une version ultérieure) 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.
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 votre projet.
### Configurer une application
Utilisez le sélecteur interactif pour créer une nouvelle application « Application native », ou sélectionnez une application existante qui représente le projet avec lequel vous souhaitez vous intégrer. Dans Auth0, il est attribué à chaque application 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 démarrage rapide seront automatiquement mis à jour pour votre application dans le [Dashboard](https://manage.auth0.com/#/), 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 l’une des URL suivantes selon votre plateforme :
* **Android** : `YOUR\_PACKAGE\_NAME://{yourDomain}/android/YOUR\_PACKAGE\_NAME/callback`
* **iOS** : `YOUR\_BUNDLE\_ID://{yourDomain}/ios/YOUR\_BUNDLE\_ID/callback`
### 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 l’une des URL suivantes selon votre plateforme :
* **Android** : `YOUR\_PACKAGE\_NAME://{yourDomain}/android/YOUR\_PACKAGE\_NAME/callback`
* **iOS** : `YOUR\_BUNDLE\_ID://{yourDomain}/ios/YOUR\_BUNDLE\_ID/callback`
Enfin, assurez-vous que le **type d’application** pour votre application est défini sur **Native** dans les [Application Settings (Paramètres d’application)](https://manage.auth0.com/#/applications/).
Auth0 propose une trousse SDK [Android](https://www.nuget.org/packages/Auth0.OidcClient.AndroidX/) et [iOS](https://www.nuget.org/packages/Auth0.OidcClient.iOS) pour simplifier le processus d’implémentation de l’authentification Auth0 dans les applications .NET Android et iOS.
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.AndroidX` ou `Auth0.OidcClient.iOS`, pour développer une application Android ou iOS.
Sinon, vous pouvez utiliser la Console du gestionnaire de packages NuGet (`Install-Package`) ou le `dotnet` CLI (`dotnet add`).
```
Install-Package Auth0.OidcClient.AndroidX
Install-Package Auth0.OidcClient.iOS
```
```
dotnet add Auth0.OidcClient.AndroidX
dotnet add Auth0.OidcClient.iOS
```
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 identificateur client.
```
using Auth0.OidcClient;
var client = new Auth0Client(new Auth0ClientOptions {
Domain = "{yourDomain}",
ClientId = "{yourClientId}"
}, this);
```
Par défaut, la trousse SDK utilisera les onglets personnalisés Chrome pour Android et ASWebAuthenticationSession pour iOS.
##### Point de contrôle
Votre `Auth0Client` devrait maintenant être correctement instancié. Exécutez votre application pour vérifier que :
l’`Auth0Client` est instancié correctement dans `Activity` (Android) ou `UIViewController` (iOS) ;
votre application ne génère aucune erreur liée à 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 guide rapide.
Pour gérer la fonction Callback sur les appareils Android, vous devez enregistrer une intention qui gère cette URL de rappel. Une façon simple de le faire est d’enregistrer l’intention sur la même activité à partir de laquelle vous avez appelé la méthode LoginAsync pour instancier le flux d’authentification.
Assurez-vous de remplacer `YOUR_ANDROID_PACKAGE_NAME` dans l’exemple de code par le nom réel du package de votre application, comme `com.mycompany.myapplication`, et de vous assurer que tout le texte des champs `DataScheme`, `DataHostet` et `DataPathPrefix` est en majuscules. De plus, définissez `LaunchMode = LaunchMode.SingleTask` pour l’activité; sinon, le système créera une nouvelle instance de l’activité chaque fois que l’URL de rappel est appelée.
De plus, vous devez gérer l’intention dans l’événement `OnNewIntent` dans votre classe `Activity`. Vous devez notifier le client OIDC Auth0 pour terminer le flux d’authentification en appelant la méthode `Send` du singleton `ActivityMediator`, en transmettant l’URL qui a été envoyée.
```
protected override void OnNewIntent(Intent intent)
{
base.OnNewIntent(intent);
ActivityMediator.Instance.Send(intent.DataString);
}
```
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 guide rapide.
Pour gérer la callback sur les appareils iOS :
1. Ouvrez le fichier `Info.plist` de votre application dans Visual Studio, puis accédez à l’onglet **Advanced (Avancé)**.
2. Sous **URL Types (Types d’URL)**, cliquez sur le bouton **Add URL Type (Ajouter le type d’URL)**.
3. Définissez **Identifier (Identificateur)** sur Auth0, les **URL Schemes (Schémas d’URL)** identiques à Bundle Identifier\*\*`Role (Rôle)`\*\*
Voici un exemple de la représentation XML de votre fichier `Info.plist` après avoir ajouté le type d’URL :
```html theme={null}
CFBundleURLTypesCFBundleTypeRoleNoneCFBundleURLNameAuth0CFBundleURLSchemesYOUR_BUNDLE_IDENTIFIER
```
De plus, vous devez gérer l’URL de rappel dans l’événement `OpenUrl` dans votre classe `AppDelegate`. Vous devez notifier le client OIDC Auth0 pour terminer le flux d’authentification en appelant la méthode `Send` du singleton `ActivityMediator`, en transmettant l’URL qui a été envoyée.
À 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.
```js theme={null}
var loginResult = await client.LoginAsync();
```
S’il n’y a pas d’erreur, vous pouvez accéder à `User`, `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 Android ou iOS vous redirige vers la page de connexion universelle Auth0.
Vous pouvez vous connecter ou vous inscrire.
Auth0 vous redirige vers 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.
```
await client.LogoutAsync();
```
##### Point de contrôle
Exécutez votre application et cliquez sur le bouton de déconnexion. Veuillez vérifiez que :
Votre application Android ou iOS vous redirige vers l’adresse que vous avez spécifié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.
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 pour Android et iOS fournit des informations sur l’utilisateur via la propriété `LoginResult.User`.
```
if loginResult.IsError == false {
var user = loginResult.User
var name = user.FindFirst(c => c.Type == "name")?.Value
var email = user.FindFirst(c => c.Type == "email")?.Value
var picture = user.FindFirst(c => c.Type == "picture")?.Value
}
```
## É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 :
* [Auth0 Dashboard](https://manage.auth0.com/#) : apprenez à configurer et gérer votre locataire et vos applications Auth0
* [Trousse SDK auth0-oidc-client-net](https://github.com/auth0/auth0-oidc-client-net) : explorez en détail la trousse SDK utilisée dans ce tutoriel
* [Auth0 Marketplace](https://marketplace.auth0.com/) : découvrez des intégrations que vous pouvez activer pour étendre les fonctionnalités d’Auth0
```cs MainActivity.cs highlight={2-9} lines theme={null}
// Example of a full Android Activity
[Activity(Label = "AndroidSample", 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 OnNewIntent(Intent intent)
{
base.OnNewIntent(intent);
ActivityMediator.Instance.Send(intent.DataString);
}
protected override void OnCreate(Bundle bundle)
{
base.OnCreate(bundle);
Auth0ClientOptions clientOptions = new Auth0ClientOptions
{
Domain = "{yourDomain}"
ClientId = "{yourClientId}"
};
_auth0Client = new Auth0Client(clientOptions, this);
}
private async void LoginButtonOnClick(object sender, EventArgs eventArgs)
{
var loginResult = await _auth0Client.LoginAsync();
if (loginResult.IsError == false)
{
var user = loginResult.User;
var name = user.FindFirst(c => c.Type == "name")?.Value;
var email = user.FindFirst(c => c.Type == "email")?.Value;
var picture = user.FindFirst(c => c.Type == "picture")?.Value;
}
}
private async void LogoutButtonOnClick(object sender, EventArgs e)
{
await _auth0Client.LogoutAsync();
}
}
```
```cs AppDelegate.cs highlight={6-11} lines theme={null}
using Auth0.OidcClient;
[Register("AppDelegate")]
public class AppDelegate : UIApplicationDelegate
{
public override bool OpenUrl(UIApplication application, NSUrl url, string sourceApplication, NSObject annotation)
{
ActivityMediator.Instance.Send(url.AbsoluteString);
return true;
}
}
```
```cs MyViewController.cs lines theme={null}
// Example of a full iOS UIViewController
public partial class MyViewController : UIViewController
{
private Auth0Client _auth0Client;
public MyViewController() : base("MyViewController", null)
{
}
public override void ViewDidLoad()
{
base.ViewDidLoad();
Auth0ClientOptions clientOptions = new Auth0ClientOptions
{
Domain = "{yourDomain}"
ClientId = "{yourClientId}"
};
_auth0Client = new Auth0Client(clientOptions, this);
}
private async void LoginButton_TouchUpInside(object sender, EventArgs e)
{
var loginResult = await _auth0Client.LoginAsync();
if (loginResult.IsError == false)
{
var user = loginResult.User;
var name = user.FindFirst(c => c.Type == "name")?.Value;
var email = user.FindFirst(c => c.Type == "email")?.Value;
var picture = user.FindFirst(c => c.Type == "picture")?.Value;
}
}
private async void LogoutButton_TouchUpInside(object sender, EventArgs e)
{
await _auth0Client.LogoutAsync();
}
}
```
```cs AppDelegate.cs highlight={6-11} lines theme={null}
using Auth0.OidcClient;
[Register("AppDelegate")]
public class AppDelegate : UIApplicationDelegate
{
public override bool OpenUrl(UIApplication application, NSUrl url, string sourceApplication, NSObject annotation)
{
ActivityMediator.Instance.Send(url.AbsoluteString);
return true;
}
}
```
```cs MainActivity.cs highlight={2-9} lines theme={null}
// Example of a full Android Activity
[Activity(Label = "AndroidSample", 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 OnNewIntent(Intent intent)
{
base.OnNewIntent(intent);
ActivityMediator.Instance.Send(intent.DataString);
}
protected override void OnCreate(Bundle bundle)
{
base.OnCreate(bundle);
Auth0ClientOptions clientOptions = new Auth0ClientOptions
{
Domain = "{yourDomain}"
ClientId = "{yourClientId}"
};
_auth0Client = new Auth0Client(clientOptions, this);
}
private async void LoginButtonOnClick(object sender, EventArgs eventArgs)
{
var loginResult = await _auth0Client.LoginAsync();
if (loginResult.IsError == false)
{
var user = loginResult.User;
var name = user.FindFirst(c => c.Type == "name")?.Value;
var email = user.FindFirst(c => c.Type == "email")?.Value;
var picture = user.FindFirst(c => c.Type == "picture")?.Value;
}
}
private async void LogoutButtonOnClick(object sender, EventArgs e)
{
await _auth0Client.LogoutAsync();
}
}
```
```cs MyViewController.cs lines theme={null}
// Example of a full iOS UIViewController
public partial class MyViewController : UIViewController
{
private Auth0Client _auth0Client;
public MyViewController() : base("MyViewController", null)
{
}
public override void ViewDidLoad()
{
base.ViewDidLoad();
Auth0ClientOptions clientOptions = new Auth0ClientOptions
{
Domain = "{yourDomain}"
ClientId = "{yourClientId}"
};
_auth0Client = new Auth0Client(clientOptions, this);
}
private async void LoginButton_TouchUpInside(object sender, EventArgs e)
{
var loginResult = await _auth0Client.LoginAsync();
if (loginResult.IsError == false)
{
var user = loginResult.User;
var name = user.FindFirst(c => c.Type == "name")?.Value;
var email = user.FindFirst(c => c.Type == "email")?.Value;
var picture = user.FindFirst(c => c.Type == "picture")?.Value;
}
}
private async void LogoutButton_TouchUpInside(object sender, EventArgs e)
{
await _auth0Client.LogoutAsync();
}
}
```
Sign up for an{" "}
Auth0 account
{" "}
or{" "}
console.log("log in")}>
log in
{" "}
to your existing account to integrate directly with your own tenant.