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: "configuration-propre-à-la-plateforme",
title: "Configuration propre à la plateforme"
}, {
id: "instancier-auth0client-",
title: "Instancier Auth0Client."
}, {
id: "ajouter-une-fonctionnalité-de-connexion-à-votre-application",
title: "Ajouter une fonctionnalité de connexion à votre application"
}, {
id: "ajoutez-une-fonctionnalité-de-déconnexion-à-votre-application",
title: "Ajoutez 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 MAUI à l’aide des SDK Auth0 de [MAUI](https://www.nuget.org/packages/Auth0.OidcClient.MAUI/).
La trousse SDK MAUI prend en charge Android, iOS, macOS et Windows. Poursuivez la lecture pour en savoir plus sur la configuration propre à chaque plateforme.
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](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, définissez cette URL comme suit : `myapp://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, définissez cette URL comme suit : `myapp://callback`.
Auth0 propose une trousse SDK [MAUI](https://www.nuget.org/packages/Auth0.OidcClient.MAUI/) pour simplifier le processus de mise en œuvre de l’authentification Auth0 dans les applications MAUI.
Utilisez le gestionnaire de paquet NuGet (Outils -> Gestionnaire de paquets de la bibliothèque -> Console du gestionnaire de paquets) pour installer le paquet `Auth0.OidcClient.MAUI`.
Vous pouvez aussi utiliser la Console du gestionnaire de paquets NuGet (`Install-Package`) ou le `dotnet` interface de ligne de commande (CLI) (`dotnet add`).
```
Install-Package Auth0.OidcClient.MAUI
```
```
dotnet add package Auth0.OidcClient.MAUI
```
Une configuration propre à la plateforme est nécessaire pour utiliser la trousse SDK avec Android et Windows.
### Android
Créez une nouvelle activité qui étend `WebAuthenticatorCallbackActivity` :
```
[Activity(NoHistory = true, LaunchMode = LaunchMode.SingleTop, Exported = true)]
[IntentFilter(new[] { Intent.ActionView },
Categories = new[] { Intent.CategoryDefault, Intent.CategoryBrowsable },
DataScheme = CALLBACK_SCHEME)]
public class WebAuthenticatorActivity : Microsoft.Maui.Authentication.WebAuthenticatorCallbackActivity
{
const string CALLBACK_SCHEME = "myapp";
}
```
L’activité ci-dessus garantira que l’application peut gérer l’URL `myapp://callback` lorsque Auth0 redirige de nouveau vers l’application Android après la connexion.
### Windows
Pour garantir la réactivation correcte de votre application après la redirection vers Auth0, vous devez faire deux choses :
* Ajouter le protocole correspondant au `Package.appxmanifest`. Dans ce cas, il est défini sur `myapp`, mais vous pouvez le changer à votre guise (veillez également à mettre à jour toutes les URL Auth0 correspondantes).
```html theme={null}
```
* Appelez `Activator.Default.CheckRedirectionActivation()` dans le fichier propre à `App.xaml.cs`.
```
public App()
{
if (Auth0.OidcClient.Platforms.Windows.Activator.Default.CheckRedirectionActivation())
return;
this.InitializeComponent();
}
```
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, votre identifiant client et les permissions requises. De plus, vous devez également configurer `RedirectUri` et `PostLogoutRedirectUri` pour garantir qu’Auth0 peut rediriger vers l’application en utilisant les URL configurées.
```
using Auth0.OidcClient;
var client = new Auth0Client(new Auth0ClientOptions {
Domain = "{yourDomain}",
ClientId = "{yourClientId}",
RedirectUri = "myapp://callback",
PostLogoutRedirectUri = "myapp://callback",
Scope = "openid profile email"
});
```
En règle générale, la trousse SDK emploiera les onglets personnalisés de Chrome pour Android, ASWebAuthenticationSession pour iOS et macOS, et le navigateur par défaut de votre système sur Windows.
##### 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 la `MainPage`,
votre application ne génère aucune erreur liée à Auth0.
À 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 vous redirige vers la page 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, vérifiez que :
Votre application vous redirige vers l’adresse que vous avez précisé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.
Maintenant que vos utilisateurs peuvent se connecter et se déconnecter, vous voudrez probablement pouvoir récupérer les [profile information (informations de profil)](https://auth0.com/docs/users/concepts/overview-user-profile) associées aux utilisateurs authentifiés. Par exemple, vous voudrez peut-être pouvoir afficher le nom ou la photo de profil d’un utilisateur connecté dans votre projet.
La trousse SDK Auth0 de MAUI fournit des informations sur l’utilisateur par l’intermédiaire de la propriété `LoginResult.User`.
## É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 MainPage.xaml.cs lines highlight={3-10} theme={null}
public partial class MainPage : ContentPage
{
Auth0Client client = new Auth0Client(new Auth0ClientOptions
{
Domain = "{yourDomain}"
ClientId = "{yourClientId}",
RedirectUri = "myapp://callback",
PostLogoutRedirectUri = "myapp://callback",
Scope = "openid profile email"
});
public MainPage()
{
InitializeComponent();
}
private async void OnLoginClicked(object sender, EventArgs e)
{
var extraParameters = new Dictionary();
var audience = ""; // FILL WITH AUDIENCE AS NEEDED
if (!string.IsNullOrEmpty(audience))
extraParameters.Add("audience", audience);
var result = await client.LoginAsync(extraParameters);
DisplayResult(result);
}
private async void OnLogoutClicked(object sender, EventArgs e)
{
BrowserResultType browserResult = await client.LogoutAsync();
if (browserResult != BrowserResultType.Success)
{
ErrorLabel.Text = browserResult.ToString();
return;
}
LogoutBtn.IsVisible = false;
LoginBtn.IsVisible = true;
HelloLabel.Text = $"Hello, World!";
ErrorLabel.Text = "";
}
private void DisplayResult(LoginResult loginResult)
{
if (loginResult.IsError)
{
ErrorLabel.Text = loginResult.Error;
return;
}
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;
LogoutBtn.IsVisible = true;
LoginBtn.IsVisible = false;
HelloLabel.Text = $"Hello, {loginResult.User.Identity.Name}";
ErrorLabel.Text = "";
}
}
```
```cs MainPage.xaml.cs lines highlight={25} theme={null}
public partial class MainPage : ContentPage
{
Auth0Client client = new Auth0Client(new Auth0ClientOptions
{
Domain = "{yourDomain}"
ClientId = "{yourClientId}",
RedirectUri = "myapp://callback",
PostLogoutRedirectUri = "myapp://callback",
Scope = "openid profile email"
});
public MainPage()
{
InitializeComponent();
}
private async void OnLoginClicked(object sender, EventArgs e)
{
var extraParameters = new Dictionary();
var audience = ""; // FILL WITH AUDIENCE AS NEEDED
if (!string.IsNullOrEmpty(audience))
extraParameters.Add("audience", audience);
var result = await client.LoginAsync(extraParameters);
DisplayResult(result);
}
private async void OnLogoutClicked(object sender, EventArgs e)
{
BrowserResultType browserResult = await client.LogoutAsync();
if (browserResult != BrowserResultType.Success)
{
ErrorLabel.Text = browserResult.ToString();
return;
}
LogoutBtn.IsVisible = false;
LoginBtn.IsVisible = true;
HelloLabel.Text = $"Hello, World!";
ErrorLabel.Text = "";
}
private void DisplayResult(LoginResult loginResult)
{
if (loginResult.IsError)
{
ErrorLabel.Text = loginResult.Error;
return;
}
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;
LogoutBtn.IsVisible = true;
LoginBtn.IsVisible = false;
HelloLabel.Text = $"Hello, {loginResult.User.Identity.Name}";
ErrorLabel.Text = "";
}
}
```
```cs MainPage.xaml.cs lines highlight={32} theme={null}
public partial class MainPage : ContentPage
{
Auth0Client client = new Auth0Client(new Auth0ClientOptions
{
Domain = "{yourDomain}"
ClientId = "{yourClientId}",
RedirectUri = "myapp://callback",
PostLogoutRedirectUri = "myapp://callback",
Scope = "openid profile email"
});
public MainPage()
{
InitializeComponent();
}
private async void OnLoginClicked(object sender, EventArgs e)
{
var extraParameters = new Dictionary();
var audience = ""; // FILL WITH AUDIENCE AS NEEDED
if (!string.IsNullOrEmpty(audience))
extraParameters.Add("audience", audience);
var result = await client.LoginAsync(extraParameters);
DisplayResult(result);
}
private async void OnLogoutClicked(object sender, EventArgs e)
{
BrowserResultType browserResult = await client.LogoutAsync();
if (browserResult != BrowserResultType.Success)
{
ErrorLabel.Text = browserResult.ToString();
return;
}
LogoutBtn.IsVisible = false;
LoginBtn.IsVisible = true;
HelloLabel.Text = $"Hello, World!";
ErrorLabel.Text = "";
}
private void DisplayResult(LoginResult loginResult)
{
if (loginResult.IsError)
{
ErrorLabel.Text = loginResult.Error;
return;
}
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;
LogoutBtn.IsVisible = true;
LoginBtn.IsVisible = false;
HelloLabel.Text = $"Hello, {loginResult.User.Identity.Name}";
ErrorLabel.Text = "";
}
}
```
```cs MainPage.xaml.cs lines highlight={55-58} theme={null}
public partial class MainPage : ContentPage
{
Auth0Client client = new Auth0Client(new Auth0ClientOptions
{
Domain = "{yourDomain}"
ClientId = "{yourClientId}",
RedirectUri = "myapp://callback",
PostLogoutRedirectUri = "myapp://callback",
Scope = "openid profile email"
});
public MainPage()
{
InitializeComponent();
}
private async void OnLoginClicked(object sender, EventArgs e)
{
var extraParameters = new Dictionary();
var audience = ""; // FILL WITH AUDIENCE AS NEEDED
if (!string.IsNullOrEmpty(audience))
extraParameters.Add("audience", audience);
var result = await client.LoginAsync(extraParameters);
DisplayResult(result);
}
private async void OnLogoutClicked(object sender, EventArgs e)
{
BrowserResultType browserResult = await client.LogoutAsync();
if (browserResult != BrowserResultType.Success)
{
ErrorLabel.Text = browserResult.ToString();
return;
}
LogoutBtn.IsVisible = false;
LoginBtn.IsVisible = true;
HelloLabel.Text = $"Hello, World!";
ErrorLabel.Text = "";
}
private void DisplayResult(LoginResult loginResult)
{
if (loginResult.IsError)
{
ErrorLabel.Text = loginResult.Error;
return;
}
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;
LogoutBtn.IsVisible = true;
LoginBtn.IsVisible = false;
HelloLabel.Text = $"Hello, {loginResult.User.Identity.Name}";
ErrorLabel.Text = "";
}
}
```
Sign up for an{" "}
Auth0 account
{" "}
or{" "}
console.log("log in")}>
log in
{" "}
to your existing account to integrate directly with your own tenant.