SCIM-Benutzerbereitstellung mit dem ASP.NET SCIM-Client und WordPress
Übersicht
Das ASP.NET SCIM-Client ermöglicht die automatisierte Benutzerbereitstellung und Synchronisierung zwischen WordPress und Ihre ASP.NET-Anwendung. SCIM (System für domänenübergreifendes Identitätsmanagement) ist ein offener Standard, der zur sicheren Verwaltung von Benutzeridentitäten über verschiedene Systeme hinweg verwendet wird. Durch diese Integration lassen sich Benutzervorgänge wie Erstellen, Aktualisieren und Löschen effizient abwickeln. Folgen Sie der unten stehenden Schritt-für-Schritt-Anleitung, um die SCIM-Benutzerbereitstellung mit dem ASP.NET SCIM-Client zu konfigurieren.
Voraussetzungen: Download und Installation
- Einloggen um http://portal.miniorange.com/ und navigiere zu Downloads Dort finden Sie das von Ihnen erworbene Plugin und klicken darauf. Download Plugin um die Plugin-ZIP-Datei herunterzuladen.
- Entpacken Sie die heruntergeladene ZIP-Datei auf Ihrem Rechner und legen Sie die NuGet-Paketdatei (.nupkg-Datei) in einen Ordner wie z. B. "C:\miniOrangePackages" ab.
- Führen Sie folgenden Befehl in Ihrem VS-Terminal aus, um es als Paketquelle hinzuzufügen:
dotnet nuget add source C:\miniOrangePackages--name miniOrangePackage
- Öffnen Sie Ihr Projekt im Terminal:
cd C:\Path\To\YourProject
- Installieren Sie das Paket in Ihrem Projekt mit dem folgenden Befehl:
dotnet add package miniOrange.SCIM.Client --source miniOrangePackage
OR
- Nachdem Sie das NuGet-Paket (die .nupkg-Datei) in einem lokalen Ordner abgelegt haben, können Sie es anstelle der Verwendung des Terminals auch mit Visual Studio installieren, indem Sie die folgenden Schritte befolgen:
- Öffnen Sie Ihre .NET-Anwendung in Visual Studio und klicken Sie auf Zubehör in der oberen Navigationsleiste und navigieren Sie zu NuGet-Paket-Manager → NuGet-Pakete für Projektmappe verwalten.
- Es öffnet sich ein neues Fenster; klicken Sie auf die Zahnrad-Symbol neben dem Dropdown-Menü „Paketquelle“.
- Ein Popup-Fenster öffnet sich; wählen Sie Paketquellen Klicken Sie im linken Navigationsbereich auf das Pluszeichen. (+) Symbol, geben Sie ein Name Geben Sie für die Paketquelle den Pfad des Ordners an, in dem Sie das NuGet-Paket abgelegt haben. Quelle Feld, dann klicken Sie auf Update und schließlich klick OK Um die Änderungen zu speichern, wie im Bild gezeigt.
- Nachdem Sie das Popup-Fenster geschlossen haben, wählen Sie die neu hinzugefügte Paketquelle aus der Liste aus. Paketquelle Dropdown-Liste.
- Klicken Sie nun auf die Jetzt entdecken Registerkarte, suchen nach miniOrange.SCIM.ClientWählen Sie das gewünschte Paket aus den Ergebnissen aus und klicken Sie auf Installieren.
- Hinweis: Um den miniOrange ASP.NET SCIM-Client in Ihre Anwendung zu integrieren, müssen Sie die folgenden Namespaces, Dienste und HTTP-Konfigurationen in Ihr Projekt einfügen. Nachfolgend finden Sie eine Beispielimplementierung als Referenz.
Fügen Sie nur den unten hervorgehobenen Abschnitt in die folgende ein: Programm.cs Datei Ihrer Bewerbung.
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();
Konfigurationsschritte
Schritt-für-Schritt-Anleitung zur Einrichtung des ASP.NET SCIM-Clients mit WordPress als Bereitstellungsquelle.
1. Zugriff auf das .NET SCIM Client Dashboard
- Nach der Integration öffnen Sie Ihren Browser und greifen Sie über die unten stehende URL auf das SCIM-Client-Dashboard zu:
https://your-app.com/?scimaction=config
- Wenn sich die Konfigurationsseite öffnet, bedeutet dies, dass der miniOrange SCIM Client erfolgreich in Ihre Anwendung integriert wurde.
- Auf der Konfigurationsseite der SCIM-Clientdatenbank finden Sie Folgendes: zwei Konfigurationsmethoden Um Ihre Datenbankverbindung einzurichten, können Sie entweder Folgendes auswählen: bestehende Verbindungszeichenfolgen or Konfigurieren Sie die Verbindung manuell basierend auf Ihrer Anwendungskonfiguration.
Wählen Sie aus den verfügbaren Verbindungszeichenfolgen aus.
- Wählen Sie Ihre Datenbankanbieter aus der Dropdown-Liste (z. B. SQL Server, MySQL, PostgreSQL, SQLite) basierend auf Ihrer Anwendungskonfiguration.
- Wähle ein Verfügbare Verbindungszeichenfolge aus der Dropdown-Liste (z. B. DefaultConnection), die bereits in Ihrer Anwendung konfiguriert ist.
- Klicken Sie auf Konfiguration speichern und dann Verbindung testen Um die Datenbankverbindung zu überprüfen. Sobald die Verbindung erfolgreich hergestellt wurde, klicken Sie auf Weiter um weiter zu gehen.
OR
Manuell konfigurieren
- Wählen Sie Ihre Datenbankanbieter Geben Sie die erforderlichen Datenbankdetails wie Server, Port (optional), Datenbankname, Benutzername und Passwort ein. Sie können die Verwendung auch aktivieren. Integrierte Sicherheit (Windows-Authentifizierung) wenn anwendbar.
- Aktivieren Sie die „Ich habe eine Verbindungszeichenfolge.“ Aktivieren Sie diese Option, wenn Sie die vollständige Verbindungszeichenfolge direkt angeben möchten, anstatt einzelne Felder einzugeben.
- Klicken Sie auf Konfiguration speichern und dann Verbindung testen Um die Datenbankverbindung zu überprüfen, klicken Sie auf Weiter um weiter zu gehen.
- Nach dem Klicken auf „Weiter“ werden Sie zur Anmeldeseite weitergeleitet. Melden Sie sich mit Ihrem lizenzierten miniOrange-Konto an, um die Konfiguration des SCIM-Clients fortzusetzen.
- Nach dem Einloggen wird der Lizenzaktivierung Das Dashboard wird geöffnet. Geben Sie den Lizenzschlüssel ein, um das Plugin zu aktivieren. Diesen erhalten Sie nach dem Einloggen. portal.miniorange.com und navigieren Sie zu Lizenz verwalten → Lizenzschlüssel.
- Setzen Sie dann ein Häkchen in das Kästchen. „Ich habe die oben genannten Bedingungen gelesen und möchte das Plugin aktivieren.“, und klicken Sie auf Lizenz aktivieren .
- Sobald die Lizenz erfolgreich aktiviert wurde, öffnet sich das SCIM-Konfigurations-Dashboard.
- Öffnen Sie Ihren Browser und rufen Sie die WordPress-Admin-Anmeldeseite auf.
https://your-wordpress-site.com/wp-admin
- Geben Sie Ihre Benutzername oder E-mail Adresse und Passwort, dann klicken Sie auf Anmelden Schaltfläche zum Aufrufen des WordPress-Admin-Dashboards.
- Nach dem Einloggen werden Sie zum WordPress-Admin-Dashboard weitergeleitet. Klicken Sie in der linken Seitenleiste auf SCIM-Benutzerbereitstellung Das Plugin öffnen.
- Sobald Sie sich im Plugin befinden, scrollen Sie nach unten zu SCIM-API-Anmeldeinformationen Abschnitt. Kopiere das SCIM-Basis-URL und SCIM-Inhaber-Token Halten Sie sie griffbereit, da Sie sie im nächsten Schritt benötigen werden.
- Wechseln Sie nun zurück zu Ihrem .NET SCIM-Client Dashboard und navigieren Sie zu SCIM-Konfiguration Tab. Fügen Sie den kopierten Text ein. SCIM-Basis-URL in die SCIM-Endpunkt-URL Feld und die SCIM-Inhaber-Token in die Inhaber-Token Feld.
- Wenn Sie fertig sind, klicken Sie auf Konfiguration speichern und dann Verbindung testen um die Einrichtung zu überprüfen.
- Sobald die Verbindung erfolgreich hergestellt wurde, erscheint ein Bestätigungs-Pop-up mit folgender Anzeige: Verbindung erfolgreich. Klicken Sie OK fortfahren.
3. Attributzuordnung
- Navigieren Sie zu der Attributzuordnungen Klicken Sie in der linken Seitenleiste auf den entsprechenden Tab. Wählen Sie die Datenbanktabelle aus (z. B. Nutzer) aus dem Dropdown-Menü auswählen und klicken Gespeichert.
- Karte jedes Quellattribut (Benutzer) zu seinem entsprechenden Zielattribut (SCIM) durch Auswahl der entsprechenden Datenbankspalte aus der Spalte durchsuchen oder auswählen Dropdown-Menü für jede Zeile.
- HinweisDas Zielattribut bezieht sich auf das Standard-SCIM-Schemafeld, dem der Wert Ihrer Datenbankspalte zugewiesen wird.
- Um eine benutzerdefinierte Attributzuordnung hinzuzufügen (z. B. Telefonnummer), drücke den + Zuordnung hinzufügen Klicken Sie auf die Schaltfläche und konfigurieren Sie die Quell- und Zielattribute nach Bedarf.
- Sobald alle Zuordnungen konfiguriert sind, klicken Sie Alle Zuordnungen speichern um Ihre Änderungen zu speichern.
Gruppenzuordnungen
Wenn Ihr Identitätsanbieter die Bereitstellung von Gruppen unterstützt, können Sie Gruppenzuordnungen konfigurieren, um Gruppen von Ihrer Anwendung mit WordPress zu synchronisieren.
- Navigieren Sie zu der Gruppenzuordnungen Registerkarte aus der linken Seitenleiste. Unter GruppentabelleWählen Sie die Datenbanktabelle aus, die Ihre Gruppeninformationen enthält, und klicken Sie auf Gespeichert.
- Ebenso unter Spalte für GruppenkennungWählen Sie die Spalte aus, die als Gruppennamensbezeichner dient, und klicken Sie auf Gespeichert.
- Unter dem Gruppenattributzuordnungen Abschnitt, Karte jedes Quellattribut (Gruppe) zu seinem entsprechenden Zielattribut (SCIM), was sich auf das Standard-SCIM-Schemafeld bezieht, dem der Wert Ihrer Gruppenspalte zugewiesen wird.
- Um eine benutzerdefinierte Attributzuordnung hinzuzufügen, klicken Sie auf die Schaltfläche + Zuordnung hinzufügen Klicken Sie anschließend auf die Schaltfläche. Zuordnungen speichern um Ihre Änderungen zu speichern.
- Scrollen Sie nach unten zum Rollennamenszuordnungen Abschnitt. Falls die Gruppennamen in Ihrer Anwendung von denen auf dem Server abweichen, deaktivieren Sie die Option. Gruppen entsprechen denen des Servers Schalten Sie um und ordnen Sie Ihre lokalen Gruppennamen den entsprechenden externen Gruppennamen unter der Option zu. Gruppennamenszuordnungen .
- Geben Sie die Name der lokalen Gruppe und die entsprechenden Name der externen Gruppe in den dafür vorgesehenen Feldern. Um weitere Zuordnungen hinzuzufügen, klicken Sie auf die Schaltfläche. + Zuordnung hinzufügen Klicken Sie anschließend auf die Schaltfläche. Gespeichert um Ihre Änderungen zu speichern.
- Besitzt das Gruppen entsprechen denen des Servers Wenn die Option aktiviert ist, werden lokale Gruppennamen unverändert verwendet und es ist keine Namenszuordnung erforderlich.
4. Synchronisierungsoptionen
- Navigieren Sie zu der Sync-Optionen Tab von der linken Seitenleiste.
- Der BenutzersynchronisierungseinstellungenStellen Sie die Batch-Größe um die Anzahl der Benutzerdatensätze festzulegen, die pro Massenoperation gruppiert werden sollen.
- Sie können auch die Benutzer in Batches synchronisieren (SCIM Bulk API verwenden) Toggle, das mehrere Objekte in einer einzigen API-Anfrage verarbeitet, um eine schnellere Synchronisierung zu ermöglichen.
- Klicken Sie nach der Konfiguration auf Konfiguration speichern.
- Hinweis: Die Chargengröße ist nur anwendbar, wenn Einmalige Synchronisierung or Synchronisierung planen.
- Echtzeit-Synchronisierung: Mach das ... an Aktivieren Sie die Echtzeitsynchronisierung Aktivieren Sie diese Option, um die Echtzeit-Synchronisierung von Benutzeränderungen wie Erstellungs-, Aktualisierungs- und Löschvorgängen mit dem SCIM-Server zu ermöglichen. Wenn diese Option deaktiviert ist, werden Echtzeit-Synchronisierungsvorgänge abgelehnt. Klicken Sie hier. Konfiguration speichern um die Änderungen zu übernehmen.
- Einmalige Synchronisierung: Um eine sofortige, einmalige Synchronisierung aller Benutzer von Ihrem .NET-Anwendung Um zum SCIM-Server zu gelangen, klicken Sie auf die Führen Sie eine einmalige Synchronisierung durch. .
- Synchronisierung planen: Mach das ... an Zeitplansynchronisierung aktivieren Aktivieren Sie diese Option, um Benutzer automatisch von Ihrem System zu synchronisieren. .NET-Anwendung in konfigurierten Intervallen an den SCIM-Server.
- Nach der Aktivierung stellen Sie die Startdatum und -zeit um festzulegen, wann die geplante Synchronisierung beginnen soll.
- Wählen Sie anschließend die Synchronisierung aus. Frequenz Ganz nach Ihren Wünschen – täglich, wöchentlich, monatlich oder individuell.
- Wenn Sie auswählen Maßgeschneidert, Geben Sie ein Benutzerdefinierten Wert und wählen Sie die Einheit (z. B. Tage), um Ihr eigenes Synchronisierungsintervall festzulegen.
- Klicken Sie auf Konfiguration speichern um die Änderungen zu übernehmen.
Gruppensynchronisierungsoptionen
- Navigieren Sie zu der Gruppensynchronisierungsoptionen Tab von der linken Seitenleiste.
- Beachten Sie, dass für die Gruppensynchronisierung die Konfiguration von Gruppenzuordnungen unter dem Menüpunkt erforderlich ist. Gruppenzuordnungen vorher abziehen.
- Der GruppensynchronisierungseinstellungenStellen Sie die Batch-Größe um die Anzahl der Gruppendatensätze festzulegen, die pro Massenoperation gruppiert werden sollen.
- Sie können auch die Gruppen in Batches synchronisieren (SCIM Bulk API verwenden) Toggle, das mehrere Gruppenobjekte in einer einzigen API-Anfrage verarbeitet, um eine schnellere Synchronisierung zu ermöglichen.
- Klicken Sie auf Konfiguration speichern um die Änderungen zu übernehmen.
- Der Gruppen-Echtzeitsynchronisierung, mach das ... an Aktivieren Sie die Echtzeitsynchronisierung Aktivieren Sie diese Option, um die Echtzeit-Synchronisierung von Gruppenänderungen wie Erstellungs-, Aktualisierungs- und Löschvorgängen mit dem SCIM-Server zu ermöglichen, sobald diese erfolgen.
- Wenn diese Option deaktiviert ist, werden Echtzeit-Synchronisierungsvorgänge abgelehnt. Klicken Sie hier. Konfiguration speichern um die Änderungen zu übernehmen.
Ähnliche Artikel
