;
};
export const sections = [{
id: "configure-auth0",
title: "Configurer Auth0"
}, {
id: "install-the-auth0-sdk",
title: "Installer le SDK Auth0"
}, {
id: "instantiate-the-auth0client",
title: "Instancier Auth0Client"
}, {
id: "configure-android",
title: "Configurer Android"
}, {
id: "configure-ios",
title: "Configurer iOS"
}, {
id: "add-login-to-your-application",
title: "Ajouter la connexion à votre application"
}, {
id: "add-logout-to-your-application",
title: "Ajouter la déconnexion à votre application"
}, {
id: "show-user-profile-information",
title: "Afficher les renseignements du profil utilisateur"
}];
Auth0 vous permet d'ajouter l'authentification à presque n'importe quel type d'application rapidement. Ce guide explique comment
intégrer Auth0, ajouter l'authentification et afficher les renseignements du 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 rapide porte sur .NET Android et iOS, puisqu’ils représentent la nouvelle génération de
`Xamarin.Android` et `Xamarin.iOS`. Si vous utilisez encore
`Xamarin.Android` et `Xamarin.iOS`, vous pouvez suivre ce guide, car l’intégration est
identique et les SDKs sont compatibles.
Pour utiliser ce guide de démarrage rapide, vous aurez besoin de :
Pour utiliser les services Auth0, vous devez avoir une application configurée dans l’Auth0 Dashboard. L’application Auth0 est
l’endroit où vous configurerez le fonctionnement de l’authentification pour votre projet.
### Configurer une application
Utilisez le sélecteur interactif pour créer une nouvelle "Application native", ou sélectionnez une application existante qui
représente le projet que vous souhaitez intégrer. Chaque application dans Auth0 se voit attribuer un client ID alphanumérique unique
que le code de votre application utilisera pour effectuer des requêtes aux API Auth0 par l’entremise du SDK.
Tous les paramètres que vous configurez à l’aide de ce Quickstart seront automatiquement mis à jour pour votre application dans le [Dashboard](https://manage.auth0.com/#/), où vous
pourrez gérer vos applications plus tard.
Si vous préférez consulter une configuration complète, vous pouvez plutôt voir un exemple d’application.
### Configurer les URL de rappel
Une URL de rappel est une URL de 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 projet d’exemple, définissez-la sur 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`
**Android** : `YOUR_PACKAGE_NAME://{yourDomain}/android/YOUR_PACKAGE_NAME/callback`
**iOS** : `YOUR_BUNDLE_ID://{yourDomain}/ios/YOUR_BUNDLE_ID/callback`
### Configurer les URL de déconnexion
Une URL de déconnexion est une URL de 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 une erreur.
Si vous suivez notre projet d’exemple, définissez-la sur 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`
**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** de votre application est défini sur **Native** dans les [Settings de l’application](https://manage.auth0.com/#/applications/).
Auth0 offre des SDK [Android](https://www.nuget.org/packages/Auth0.OidcClient.AndroidX/) et [iOS](https://www.nuget.org/packages/Auth0.OidcClient.iOS) pour simplifier l’implémentation de l’authentification Auth0
dans les applications Android et iOS en .NET.
Utilisez le Gestionnaire de package NuGet (Outils -> Gestionnaire de package de bibliothèque -> Console du Gestionnaire de package) pour installer le
package `Auth0.OidcClient.AndroidX` ou `Auth0.OidcClient.iOS`, selon que vous
développez une application Android ou iOS.
Vous pouvez aussi utiliser la console du Gestionnaire de package NuGet (`Install-Package`) ou la
CLI `dotnet` (`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 à votre application, créez une instance de la classe `Auth0Client`, en lui passant
une instance de `Auth0ClientOptions` qui contient votre domaine Auth0 et votre Client ID.
```csharp theme={null}
using Auth0.OidcClient;
var client = new Auth0Client(new Auth0ClientOptions {
Domain = "{yourDomain}",
ClientId = "{yourClientId}"
}, this);
```
Par défaut, le SDK utilisera Chrome Custom Tabs sur Android et ASWebAuthenticationSession sur iOS.
##### Point de contrôle
Votre `Auth0Client` devrait maintenant être correctement instancié. Exécutez votre application pour vérifier que :
* L’`Auth0Client` est correctement instancié dans l’`Activity` (Android) ou le
`UIViewController` (iOS).
* Votre application ne génère aucune erreur liée à Auth0.
Une fois l’utilisateur authentifié avec succès, il sera redirigé vers l’URL de rappel que vous avez configurée plus tôt dans ce
Quickstart.
Pour gérer le rappel sur les appareils Android, vous devez enregistrer un intent qui prend en charge cette URL de rappel. Une façon simple
de le faire consiste à enregistrer l’intent 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 véritable Package Name de votre
application, par exemple `com.mycompany.myapplication`, et assurez-vous que tout le texte de
`DataScheme`, `DataHost` et `DataPathPrefix` est en minuscules. Définissez également
`LaunchMode = LaunchMode.SingleTask` pour l’Activity ; sinon, le système créera une nouvelle instance
de l’activité chaque fois que l’URL de rappel sera appelée.
De plus, vous devez gérer l’intent dans l’événement `OnNewIntent` de votre classe `Activity`.
Vous devez indiquer au Auth0 OIDC Client de terminer le flux d’authentification en appelant la méthode `Send`
du singleton `ActivityMediator`, en lui transmettant l’URL reçue.
```charp theme={null}
protected override void OnNewIntent(Intent intent)
{
base.OnNewIntent(intent);
ActivityMediator.Instance.Send(intent.DataString);
}
```
Après s’être authentifié avec succès, l’utilisateur sera redirigé vers l’URL de rappel que vous avez configurée plus tôt dans ce
Quickstart.
Pour traiter l’URL de rappel sur les appareils iOS :
1. Ouvrez le fichier `Info.plist` de votre application dans Visual Studio, puis accédez à l’onglet \*\*Advanced \*\*.
2. Sous **Types d’URL**, cliquez sur le bouton \*\*Ajouter un type d’URL \*\*.
3. Définissez l’\*\*identifiant \*\* sur Auth0, les \*\*schémas d’URL \*\* comme le `Bundle Identifier` de votre application,
et le \*\*rôle \*\* sur `None`.
Voici un exemple de la représentation XML de votre fichier `info.plist` après avoir ajouté le
type d’URL :
```xml theme={null}
CFBundleURLTypesCFBundleTypeRoleNoneCFBundleURLNameAuth0CFBundleURLSchemesYOUR_BUNDLE_IDENTIFIER
```
De plus, vous devez gérer l’URL de rappel dans l’événement `OpenUrl` de votre
classe `AppDelegate`. Vous devez indiquer à Auth0 OIDC Client de terminer le flux d’authentification en
appelant la méthode `Send` du singleton `ActivityMediator`, en lui transmettant l’URL
reçue.
Maintenant que vous avez configuré votre application Auth0 et le SDK Auth0, vous devez mettre en place la connexion pour votre projet.
Pour ce faire, vous utiliserez la méthode `LoginAsync()` du SDK afin de créer un bouton de connexion qui redirige les utilisateurs
vers la page Universal Login d’Auth0.
```csharp 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 devriez maintenant être en mesure de vous connecter ou de vous inscrire à l’aide d’un nom d’utilisateur et d’un mot de passe.
Cliquez sur le bouton de connexion et vérifiez que :
* Votre application Android ou iOS vous redirige vers la page Universal Login d’Auth0.
* Vous pouvez vous connecter ou vous inscrire.
* Auth0 vous redirige vers votre application.
Les utilisateurs qui se connectent à votre projet auront aussi besoin d’un moyen de se déconnecter. Créez un bouton de déconnexion à l’aide de la méthode `LogoutAsync()` du SDK.
Lorsque les utilisateurs se déconnectent, ils sont redirigés vers votre endpoint de logout Auth0,
qui les redirige ensuite immédiatement vers l’URL de logout que vous avez configurée plus tôt dans ce Quickstart.
```csharp theme={null}
await client.LogoutAsync();
```
##### Point de contrôle
Lancez votre application et cliquez sur le bouton de déconnexion. Vérifiez que :
* Votre application Android ou iOS vous redirige vers l’adresse que vous avez indiquée parmi les URL de déconnexion autorisées dans les Paramètres de l’application.
* Vous n’êtes plus connecté à l’application.
Maintenant que vos utilisateurs peuvent 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 pourriez vouloir afficher le nom ou la photo de profil d’un utilisateur connecté dans votre projet.
Le SDK Auth0 pour Android et iOS fournit des informations sur l’utilisateur par l’intermédiaire de la propriété `LoginResult.User`.
```csharp theme={null}
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
}
```
## Prochaines étapes
Excellent travail ! Si vous avez suivi toutes les étapes jusqu'ici, vous devriez maintenant avoir la connexion, la déconnexion et les renseignements du profil utilisateur fonctionnels dans votre application.
Ceci conclut notre tutoriel de démarrage rapide, mais il reste encore beaucoup à explorer. Pour en savoir plus sur ce que vous pouvez faire avec Auth0, consultez :
* [Auth0 Dashboard](https://manage.auth0.com/dashboard/us/dev-gja8kxz4ndtex3rq) - Apprenez à configurer et à gérer votre tenant Auth0 et vos applications
* [auth0-oidc-client-net SDK](https://github.com/auth0/auth0-oidc-client-net) - Explorez plus en détail le SDK utilisé dans ce tutoriel
* [Auth0 Marketplace](https://marketplace.auth0.com/) - Découvrez les 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();
}
}
```
Créez un{" "}
compte Auth0
{" "}
ou{" "}
console.log("log in")}>
connectez-vous
{" "}
à votre compte existant pour vous intégrer directement à votre propre tenant.