Implémentation d’un fournisseur de stockage ASP.NET Identity MySQL personnalisé

Article
07/13/2023

par Raquel Soares De Almeida, Suhas Joshi, Tom FitzMacken

ASP.NET Identity est un système extensible qui vous permet de créer votre propre fournisseur de stockage et de le connecter à votre application sans re-travailler l’application. Cette rubrique explique comment créer un fournisseur de stockage MySQL pour ASP.NET Identity. Pour obtenir une vue d’ensemble de la création de fournisseurs de stockage personnalisés, consultez Vue d’ensemble des fournisseurs de stockage personnalisés pour ASP.NET Identity.

Pour suivre ce tutoriel, vous devez avoir Visual Studio 2013 avec Update 2.

Ce tutoriel va :

Montrez comment créer une base de données MySQL instance sur Azure.

Montrez comment utiliser un outil client MySQL (MySQL Workbench) pour créer des tables et gérer votre base de données distante sur Azure.

Montrez comment remplacer l’implémentation de stockage ASP.NET Identity par défaut par notre implémentation personnalisée sur un projet d’application MVC.

Ce tutoriel a été écrit à l’origine par Raquel Soares De Almeida et Rick Anderson ( @RickAndMSFT ). L’exemple de projet a été mis à jour pour Identity 2.0 par Suhas Joshi. La rubrique a été mise à jour pour Identity 2.0 par Tom FitzMacken.

Télécharger le projet terminé

À la fin de ce tutoriel, vous aurez un projet d’application MVC avec ASP.NET Identity travaillant avec une base de données MySQL hébergée sur Azure.

Vous pouvez télécharger le fournisseur de stockage MySQL terminé à l’adresse AspNet.Identity.MySQL (GitHub).

Les étapes que vous allez effectuer

Ce didacticiel vous apprendra à effectuer les opérations suivantes :

Créer une base de données MySQL sur Azure
Créer les tables d’identité ASP.NET dans MySQL
Créer une application MVC et la configurer pour utiliser le fournisseur MySQL
Exécuter l’application

Cette rubrique ne couvre pas l’architecture de ASP.NET Identity et les décisions que vous devez prendre lors de l’implémentation d’un fournisseur de stockage client. Pour obtenir ces informations, consultez Vue d’ensemble des fournisseurs de stockage personnalisés pour ASP.NET Identity.

Passer en revue les classes de fournisseur de stockage MySQL

Avant de passer à la procédure de création du fournisseur de stockage MySQL, examinons les classes qui composent le fournisseur de stockage. Vous aurez besoin de classes qui gèrent les opérations de base de données et les classes appelées à partir de l’application pour gérer les utilisateurs et les rôles.

Classes de stockage

IdentityUser : contient des propriétés pour l’utilisateur.
UserStore : contient des opérations d’ajout, de mise à jour ou de récupération d’utilisateurs.
IdentityRole : contient des propriétés pour les rôles.
RoleStore : contient des opérations d’ajout, de suppression, de mise à jour et de récupération de rôles.

Classes de couche d’accès aux données

Pour cet exemple, les classes de couche d’accès aux données contiennent des instructions SQL permettant d’utiliser les tables ; Toutefois, dans votre code, vous pouvez utiliser le mappage objet-relationnel (ORM), tel qu’Entity Framework ou NHibernate. En particulier, votre application peut rencontrer des performances médiocres sans orm qui inclut le chargement paresseux et la mise en cache des objets.

MySQLDatabase : contient la connexion à la base de données MySQL et les méthodes permettant d’effectuer des opérations de base de données. UserStore et RoleStore sont tous deux instanciés avec un instance de cette classe.
RoleTable : contient des opérations de base de données pour la table qui stocke les rôles.
UserClaimsTable : contient les opérations de base de données pour la table qui stocke les revendications utilisateur.
UserLoginsTable : contient des opérations de base de données pour la table qui stocke les informations de connexion utilisateur.
UserRoleTable : contient des opérations de base de données pour la table qui stocke les utilisateurs auxquels sont attribués les rôles.
UserTable : contient les opérations de base de données pour la table qui stocke les utilisateurs.

Créer une base de données MySQL instance sur Azure

Connectez-vous au portail Azure.
Cliquez sur +NOUVEAU en bas de la page, puis sélectionnez STORE.
Dans l’Assistant Choisir et ajouter , sélectionnez ClearDB MySQL Database et cliquez sur la flèche suivante en bas à droite de la boîte de dialogue.
Conservez le plan Gratuit par défaut et remplacez le Nom par IdentityMySQLDatabase. Sélectionnez la région la plus proche de vous, puis cliquez sur la flèche suivante.
Cliquez sur la coche pour terminer la création de la base de données.
Une fois la base de données créée, vous pouvez la gérer à partir de l’onglet ADD-ONS du portail de gestion.
Vous pouvez obtenir les informations de connexion à la base de données en cliquant sur INFORMATIONS DE CONNEXION en bas de la page.
Copiez la chaîne de connexion en cliquant sur le bouton copier et enregistrez-la afin de pouvoir l’utiliser ultérieurement dans votre application MVC.

Créer les tables d’identité ASP.NET dans une base de données MySQL

Installer l’outil MySQL Workbench pour connecter et gérer la base de données MySQL

Installer l’outil MySQL Workbench à partir de la page de téléchargements MySQL
Lancez l’application et cliquez sur le bouton MySQLConnections + pour ajouter une nouvelle connexion. Utilisez les données de chaîne de connexion que vous avez copiées à partir de la base de données Azure MySQL que vous avez créée précédemment dans ce didacticiel.
Après avoir établi la connexion, ouvrez un nouvel onglet Requête ; collez les commandes de MySQLIdentity.sql dans la requête et exécutez-la afin de créer les tables de base de données.
Vous disposez maintenant de toutes les tables ASP.NET Identity nécessaires créées sur une base de données MySQL hébergée sur Azure, comme indiqué ci-dessous.

Créer un projet d’application MVC à partir d’un modèle et le configurer pour utiliser le fournisseur MySQL

Si nécessaire, installez Visual Studio Express 2013 pour web ou Visual Studio 2013 avec Update 2.

Téléchargez le ASP.NET. Projet Identity.MySQL à partir de GitHub

Accédez à l’URL du dépôt à l’adresse AspNet.Identity.MySQL (GitHub).
Téléchargez le code source.
Extrayez le fichier .zip dans un dossier local.
Ouvrez la solution AspNet.Identity.MySQL et générez-la.

Créer un projet d’application MVC à partir d’un modèle

Cliquez avec le bouton droit sur la solution AspNet.Identity.MySQL et Ajouter, Nouveau projet
Dans la boîte de dialogue Ajouter un nouveau projet , sélectionnez Visual C# sur la gauche, puis Web , puis ASP.NET application web. Nommez votre projet IdentityMySQLDemo ; puis cliquez sur OK.
Dans la boîte de dialogue Nouveau projet ASP.NET , sélectionnez le modèle MVC avec les options par défaut (qui inclut les comptes d’utilisateur individuels en tant que méthode d’authentification), puis cliquez sur OK.
Dans Explorateur de solutions, cliquez avec le bouton droit sur votre projet IdentityMySQLDemo et sélectionnez Gérer les packages NuGet. Dans la boîte de dialogue de recherche, tapez Identity.EntityFramework. Sélectionnez ce package dans la liste des résultats, puis cliquez sur Désinstaller. Vous serez invité à désinstaller le package de dépendances EntityFramework. Cliquez sur Oui, car nous n’aurons plus ce package sur cette application.
Cliquez avec le bouton droit sur le projet IdentityMySQLDemo, sélectionnez Ajouter, Référence, Solution, Projets ; sélectionnez le projet AspNet.Identity.MySQL, puis cliquez sur OK.
Dans le projet IdentityMySQLDemo, remplacez toutes les références à
using Microsoft.AspNet.Identity.EntityFramework;
par
using AspNet.Identity.MySQL;

Dans IdentityModels.cs, définissez ApplicationDbContext pour qu’il dérive de MySqlDatabase et incluez un constructeur qui prend un seul paramètre avec le nom de connexion.

public class ApplicationDbContext : MySQLDatabase
{
    public ApplicationDbContext(string connectionName)
        : base(connectionName)
    {
    }

    public static ApplicationDbContext Create()
    {
        return new ApplicationDbContext("DefaultConnection");
    }
}

Ouvrez le fichier IdentityConfig.cs. Dans la méthode ApplicationUserManager.Create , remplacez l’instanciation de UserManager par le code suivant :
```
var manager = new ApplicationUserManager(
    new UserStore<ApplicationUser>(
    context.Get<ApplicationDbContext>() as MySQLDatabase));
```
Ouvrez le fichier web.config et remplacez la chaîne DefaultConnection par cette entrée en remplaçant les valeurs en surbrillance par la chaîne de connexion de la base de données MySQL que vous avez créée lors des étapes précédentes :
```
<add name="DefaultConnection" connectionString="Database=IdentityMySQLDatabase;
Data Source=<DataSource>;User Id=<UserID>;Password=<Password>"
providerName="MySql.Data.MySqlClient" />
```

Exécutez l’application et connectez-vous à la base de données MySQL

Cliquez avec le bouton droit sur le projet IdentityMySQLDemo et sélectionnez Définir comme projet de démarrage
Appuyez sur Ctrl + F5 pour générer et exécuter l’application.
Cliquez sur l’onglet Inscrire en haut de la page.
Entrez un nouveau nom d’utilisateur et un nouveau mot de passe, puis cliquez sur Inscrire.
Le nouvel utilisateur est maintenant inscrit et connecté.
Retour à l’outil MySQL Workbench et inspectez le contenu de la table IdentityMySQLDatabase. Inspectez la table des utilisateurs pour les entrées lorsque vous inscrivez de nouveaux utilisateurs.

Étapes suivantes

Pour plus d’informations sur l’activation d’autres méthodes d’authentification sur cette application, consultez Créer une application MVC 5 ASP.NET avec Facebook et Google OAuth2 et OpenID Sign-on.

Pour savoir comment intégrer votre base de données à OAuth et configurer des rôles afin de limiter l’accès des utilisateurs à votre application, consultez Déployer une application sécurisée ASP.NET MVC 5 avec appartenance, OAuth et SQL Database dans Azure.