Gestion des utilisateurs SCIM via le client SCIM ASP.NET avec WordPress
Marché
Le client SCIM pour ASP.NET permet la gestion et la synchronisation automatisées des utilisateurs entre WordPress et votre application ASP.NET. SCIM (System for Cross-domain Identity Management) est une norme ouverte permettant de gérer en toute sécurité les identités des utilisateurs sur différents systèmes. Grâce à cette intégration, les opérations utilisateur telles que la création, la mise à jour et la suppression de comptes sont gérées efficacement. Suivez le guide pas à pas ci-dessous pour configurer la gestion des utilisateurs SCIM à l'aide du client SCIM pour ASP.NET.
Pré-requis : Téléchargement Et Installation
- Connectez-vous à http://portal.miniorange.com/ et naviguer vers le Télécharger onglet. À partir de là, repérez votre plugin acheté et cliquez sur Télécharger le plugin pour télécharger le fichier zip du plugin.
- Extrayez le fichier zip téléchargé sur votre machine et placez le fichier de package NuGet (.nupkg) dans un dossier tel que « C:\miniOrangePackages ».
- Exécutez la commande suivante dans votre terminal VS pour l'ajouter comme source de paquet :
dotnet nuget add source C:\miniOrangePackages--name miniOrangePackage
- Ouvrez votre projet dans le terminal :
cd C:\Path\To\YourProject
- Installez le package dans votre projet à l'aide de la commande ci-dessous :
dotnet add package miniOrange.SCIM.Client --source miniOrangePackage
OR
- Après avoir placé le package NuGet (fichier .nupkg) dans un dossier local, au lieu d'utiliser le terminal, vous pouvez également l'installer à l'aide de Visual Studio en suivant les étapes ci-dessous :
- Ouvrez votre application .NET dans Visual Studio, cliquez sur Outils dans la barre de navigation supérieure, puis accédez à Gestionnaire de packages NuGet → Gérer les packages NuGet pour la solution.
- Une nouvelle fenêtre s'ouvrira ; cliquez sur le icône engrenage à côté du menu déroulant Source du package.
- Une fenêtre contextuelle s'ouvrira ; sélectionnez Sources des paquets Dans le panneau de navigation de gauche, cliquez sur le plus (+) icône, entrez un Le nom Pour la source du package, indiquez le chemin d'accès au dossier où vous avez placé le package NuGet. Matériau champ, puis cliquez sur Mises à jour et enfin cliquez OK pour enregistrer les modifications, comme indiqué sur l'image.
- Après avoir fermé la fenêtre contextuelle, sélectionnez la source du package nouvellement ajoutée dans le Source du paquet menu déroulant.
- Maintenant, cliquez sur le Explorer onglet, recherchez miniOrange.SCIM.ClientSélectionnez le package dans les résultats, puis cliquez sur Installer.
- À noter: Pour intégrer le client SCIM ASP.NET miniOrange à votre application, vous devrez ajouter les espaces de noms, services et configurations HTTP ci-dessous à votre projet. Vous trouverez ci-dessous un exemple d'implémentation à titre de référence.
Incluez uniquement la section surlignée ci-dessous dans le programme.cs dossier de votre candidature.
using miniOrange.SCIM.Client.DependencyInjection;
using miniOrange.SCIM.Client.Middleware;
var builder=WebApplication.CreateBuilder(args);
builder.Services.AddRazorPages();
builder.Services.AddControllersWithViews();
builder.Services.AddSCIMClientServices();
var app = builder.Build();
if(!app.Environment.IsDevelopment())
{
app.UseExceptionHandler("/Error");
app.UseHsts();
}
app.UseHttpsRedirection();
app.UseRouting();
app.UseAuthorization();
app.MapRazorPages();
app.UseCookiePolicy();
app.UseAuthentication();
#if NET9_0_OR_GREATER
app.MapStaticAssets();
#else
app.UseStaticFiles();
#endif
app.UseSCIMClientMiddleware();();
app.Run();
Étapes de configuration
Guide étape par étape pour la configuration d'un client SCIM ASP.NET utilisant WordPress comme source de provisionnement.
1. Accédez au tableau de bord du client .NET SCIM
- Après l'intégration, ouvrez votre navigateur et accédez au tableau de bord du client SCIM à l'aide de l'URL ci-dessous :
https://your-app.com/?scimaction=config
- Si la page de configuration s'ouvre, cela indique que le client SCIM miniOrange a été intégré avec succès à votre application.
- Sur la page de configuration de la base de données du client SCIM, vous trouverez deux méthodes de configuration pour configurer votre connexion à la base de données. Vous pouvez choisir parmi les options suivantes : chaînes de connexion existantes or configurer la connexion manuellement en fonction de la configuration de votre application.
Sélectionnez parmi les chaînes de connexion disponibles
- Sélectionnez votre Fournisseur de base de données dans la liste déroulante (par exemple, SQL Server, MySQL, PostgreSQL, SQLite) en fonction de la configuration de votre application.
- Choisissez un Chaîne de connexion disponible à partir de la liste déroulante (par exemple, DefaultConnection) déjà configurée dans votre application.
- Cliquez sur Enregistrer la configuration et alors Test de connexion pour vérifier la connectivité à la base de données. Une fois la connexion établie, cliquez sur Suivant aller plus loin.
OR
Configurer manuellement
- Sélectionnez votre Fournisseur de base de données Saisissez ensuite les informations requises concernant la base de données, telles que le serveur, le port (facultatif), le nom de la base de données, le nom d'utilisateur et le mot de passe. Vous pouvez également activer l'option « Utiliser ». Sécurité intégrée (authentification Windows) le cas échéant.
- Activez la « J'ai une chaîne de connexion » Activez cette option si vous souhaitez fournir directement la chaîne de connexion complète au lieu de saisir les champs individuellement.
- Cliquez sur Enregistrer la configuration et alors Test de connexion pour vérifier la connectivité à la base de données. Une fois la connexion établie, cliquez sur Suivant aller plus loin.
- Après avoir cliqué sur Suivant, vous serez redirigé vers la page de connexion. Connectez-vous avec votre compte miniOrange sous licence pour poursuivre la configuration du client SCIM.
- Après vous être connecté, le Activation de la licence Le tableau de bord s'ouvrira. Saisissez la clé de licence pour activer l'extension ; vous la recevrez après vous être connecté(e). portail.miniorange.com et naviguer vers Gérer les licences → Clés de licence.
- Ensuite, cochez la case « J'ai lu les conditions ci-dessus et je souhaite activer le plugin. », Et cliquez sur le Activer la licence .
- Une fois la licence activée avec succès, le tableau de bord de configuration SCIM s'ouvrira.
- Ouvrez votre navigateur et accédez à votre page de connexion d'administration WordPress.
https://your-wordpress-site.com/wp-admin
- Saisissez votre Nom d'utilisateur ou adresse e-mail et Mot de passe, puis cliquez sur le Se connecter bouton permettant d'accéder au tableau de bord d'administration WordPress.
- Après vous être connecté, vous serez redirigé vers le tableau de bord d'administration WordPress. Dans la barre latérale gauche, cliquez sur Provisionnement des utilisateurs SCIM pour ouvrir le plugin.
- Une fois dans le plugin, faites défiler vers le bas jusqu'à Informations d'identification de l'API SCIM section. Copiez le URL de base SCIM et Jeton au porteur SCIM et gardez-les à portée de main, car vous en aurez besoin à l'étape suivante.
- Maintenant, revenez à votre Client SCIM .NET tableau de bord et accédez au Configuration SCIM onglet. Collez le texte copié. URL de base SCIM into the URL du point de terminaison SCIM champ et le Jeton au porteur SCIM into the Jeton porteur champ.
- Une fois terminé, cliquez sur Enregistrer la configuration et alors Test de connexion pour vérifier la configuration.
- Une fois la connexion établie avec succès, une fenêtre contextuelle de confirmation apparaîtra affichant : Connexion réussie. Cliquez sur OK procéder.
3. Cartographie des attributs
- Accédez à la Mappages d'attributs Onglet dans la barre latérale gauche. Sélectionnez la table de base de données (par exemple, Utilisateurs) dans le menu déroulant et cliquez Enregistrer.
- Cartographier chaque Attribut source (Utilisateur) à son correspondant Attribut cible (SCIM) en sélectionnant la colonne de base de données appropriée dans la Rechercher ou sélectionner une colonne menu déroulant pour chaque ligne.
- NoteL'attribut cible fait référence au champ de schéma SCIM standard auquel la valeur de votre colonne de base de données sera attribuée.
- Pour ajouter un mappage d'attributs personnalisé (par exemple, Numéro de téléphone), clique le + Ajouter un mappage Cliquez sur le bouton et configurez les attributs source et cible selon vos besoins.
- Une fois tous les mappages configurés, cliquez Enregistrer toutes les cartographies enregistrer vos modifications
Mappages de groupes
Si votre fournisseur d'identité prend en charge le provisionnement de groupes, vous pouvez configurer des mappages de groupes pour synchroniser les groupes de votre application avec WordPress.
- Accédez à la Mappages de groupes Onglet dans la barre latérale gauche. Sous Table de groupe, sélectionnez la table de base de données contenant les informations de votre groupe et cliquez Enregistrer.
- De même, sous Colonne d'identification du groupe, sélectionnez la colonne qui sert d'identifiant du nom du groupe et cliquez sur Enregistrer.
- En vertu des Normes sur l’information et les communications, les organismes doivent rendre leurs sites et applications Web accessibles. Ils y parviennent en conformant leurs sites Web au niveau AA des Web Content Accessibility Guidelines (WCAG). Mappages d'attributs de groupe section, cartographier chaque Attribut source (Groupe) à son correspondant Attribut cible (SCIM), qui fait référence au champ de schéma SCIM standard auquel la valeur de votre colonne de groupe sera attribuée.
- Pour ajouter un mappage d'attribut personnalisé, cliquez sur + Ajouter un mappage bouton. Une fois terminé, cliquez sur Enregistrer les mappages enregistrer vos modifications
- Faites défiler jusqu'à la Correspondances des noms de rôles section. Si les noms de groupe dans votre application diffèrent de ceux sur le serveur, désactivez la section. Groupes identiques au serveur basculez et associez vos noms de groupes locaux aux noms de groupes externes correspondants sous le Correspondances des noms de groupes .
- Entrer le Nom du groupe local et le correspondant Nom du groupe externe dans les champs prévus à cet effet. Pour ajouter d'autres correspondances, cliquez sur le bouton. + Ajouter un mappage bouton, puis une fois terminé, cliquez Enregistrer enregistrer vos modifications
- Si la Groupes identiques au serveur Si l'option est activée, les noms de groupes locaux seront utilisés tels quels et aucun mappage de noms n'est requis.
4. Options de synchronisation
- Accédez à la Options de synchronisation onglet de la barre latérale gauche.
- Sous Paramètres de synchronisation des utilisateurs, met le Taille du lot définir le nombre d'enregistrements utilisateur à regrouper par opération groupée.
- Vous pouvez également activer le Synchronisation des utilisateurs par lots (Utilisation de l'API SCIM Bulk) bascule, qui traite plusieurs objets dans une seule requête API pour une synchronisation plus rapide.
- Une fois configuré, cliquez sur Enregistrer la configuration.
- À noter: La taille du lot n'est applicable que lors de l'utilisation de Synchronisation unique or Planifier la synchronisation.
- Synchronisation en temps réel : Allume le Activer la synchronisation en temps réel Activez cette option pour permettre la synchronisation en temps réel des modifications utilisateur (création, mise à jour et suppression) avec le serveur SCIM dès leur occurrence. Si elle est désactivée, les opérations de synchronisation en temps réel seront refusées. Cliquez Enregistrer la configuration appliquer les changements.
- Synchronisation unique : Pour effectuer une synchronisation unique et immédiate de tous les utilisateurs de votre Application .NET Pour accéder au serveur SCIM, cliquez sur Effectuer une synchronisation unique .
- Synchronisation du calendrier : Allume le Activer la synchronisation des horaires Activez la synchronisation automatique des utilisateurs depuis votre Application .NET au serveur SCIM à intervalles configurés.
- Une fois activé, configurez le Date et heure de début pour spécifier quand la synchronisation planifiée doit commencer.
- Sélectionnez ensuite la synchronisation Fréquence
Selon vos besoins — Quotidiennement, hebdomadairement, mensuellement ou sur mesure.
- Si vous sélectionnez Encadrement Sur Mesure, entrez un Valeur personnalisée et sélectionnez le Unité (par exemple, en jours) pour définir votre propre intervalle de synchronisation.
- Cliquez à nouveau Enregistrer la configuration appliquer les changements.
Options de synchronisation de groupe
- Accédez à la Options de synchronisation de groupe onglet de la barre latérale gauche.
- Notez que la synchronisation des groupes nécessite que les mappages de groupes soient configurés sous le Mappages de groupes tabuler à l'avance.
- Sous Paramètres de synchronisation de groupe, met le Taille du lot définir le nombre d'enregistrements de groupe à regrouper par opération groupée.
- Vous pouvez également activer le Synchronisation des groupes par lots (Utiliser l'API SCIM Bulk) bascule, qui traite plusieurs objets de groupe dans une seule requête API pour une synchronisation plus rapide.
- Cliquez à nouveau Enregistrer la configuration appliquer les changements.
- Sous Synchronisation de groupe en temps réel, allume le Activer la synchronisation en temps réel Activez cette option pour permettre la synchronisation en temps réel des modifications de groupe, telles que les opérations de création, de mise à jour et de suppression, avec le serveur SCIM au fur et à mesure qu'elles se produisent.
- Lorsque cette fonction est désactivée, les opérations de synchronisation en temps réel seront refusées. Cliquez Enregistrer la configuration appliquer les changements.
Articles Relatifs
