SCIM-användarprovisionering med ASP.NET SCIM-klient med WordPress
Översikt
Ocuco-landskapet ASP.NET SCIM-klient möjliggör automatiserad användarprovisionering och synkronisering mellan hood.discount och din ASP.NET-applikation. SCIM (System for Cross-domain Identity Management) är en öppen standard som används för att säkert hantera användaridentiteter över olika system. Med hjälp av den här integrationen kan användaråtgärder som att skapa, uppdatera och ta bort hanteras effektivt. Följ steg-för-steg-guiden nedan för att konfigurera SCIM-användarprovisionering med ASP.NET SCIM-klienten.
Förutsättningar: Ladda ner och installation
- Logga in till http://portal.miniorange.com/ och navigera till Nedladdningar fliken. Därifrån letar du upp ditt köpta plugin och klickar på Hämta Plugin för att ladda ner zip-filen för plugin-programmet.
- Extrahera den nedladdade zip-filen till din dator och placera nuget-paketfilen (.nupkg-filen) i en mapp som "C:\miniOrangePackages"
- Kör följande kommando i din VS-terminal för att lägga till den som en paketkälla:
dotnet nuget add source C:\miniOrangePackages--name miniOrangePackage
- Öppna ditt projekt i terminalen:
cd C:\Path\To\YourProject
- Installera paketet i ditt projekt med hjälp av kommandot nedan:
dotnet add package miniOrange.SCIM.Client --source miniOrangePackage
OR
- Efter att du har placerat NuGet-paketet (.nupkg-filen) i en lokal mapp kan du istället för att använda terminalen även installera det med Visual Studio genom att följa stegen nedan:
- Öppna din .NET-applikation i Visual Studio, klicka på Verktyg i det övre navigeringsfältet och navigera till NuGet-pakethanterare → Hantera NuGet-paket för lösningen.
- Ett nytt fönster öppnas; klicka på kugghjulsikonen bredvid rullgardinsmenyn Paketkälla.
- Ett popup-fönster öppnas; välj Paketkällor från den vänstra navigeringspanelen klickar du på plustecknet (+) ikon, ange en namn För paketkällan, ange sökvägen till mappen där du placerade NuGet-paketet i Källa fältet och klicka sedan på Uppdatering och äntligen klicka OK för att spara ändringarna, som visas på bilden.
- Efter att du stängt popup-fönstret, välj den nyligen tillagda paketkällan från Paketkälla falla ner.
- Klicka nu på Bläddra fliken, sök efter miniOrange.SCIM.Client, välj paketet från resultaten och klicka på Installera.
- Obs: För att integrera miniOrange ASP.NET SCIM-klienten i din applikation måste du lägga till nedanstående namnrymder, tjänster och HTTP-konfigurationer i ditt projekt. Nedan följer ett exempel på en implementering som referens.
Inkludera endast det markerade avsnittet nedan i Program.cs filen för din ansökan.
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();
Konfigurationssteg
Steg-för-steg-guide för installation av ASP.NET SCIM-klient med WordPress som provisioneringskälla.
1. Åtkomst till .NET SCIM-klientens instrumentpanel
- Efter integrationen öppnar du webbläsaren och öppnar SCIM-klientens instrumentpanel med hjälp av URL:en nedan:
https://your-app.com/?scimaction=config
- Om konfigurationssidan öppnas indikerar det att miniOrange SCIM-klienten har integrerats i din applikation.
- På konfigurationssidan för SCIM-klientdatabasen hittar du två konfigurationsmetoder för att konfigurera din databasanslutning. Du kan antingen välja mellan befintliga anslutningssträngar or konfigurera anslutningen manuellt baserat på din applikationskonfiguration.
Välj bland tillgängliga anslutningssträngar
- Välj din Databasleverantör från rullgardinsmenyn (t.ex. SQL Server, MySQL, PostgreSQL, SQLite) baserat på din applikationskonfiguration.
- Välj en Tillgänglig anslutningssträng från rullgardinsmenyn (t.ex. Standardanslutning) som redan är konfigurerad i din applikation.
- Klicka på Spara konfiguration och då Testa anslutning för att verifiera databasanslutningen. När anslutningen är lyckad klickar du på Nästa att fortsätta vidare.
OR
Konfigurera manuellt
- Välj din Databasleverantör och ange nödvändiga databasuppgifter, såsom Server, Port (valfritt), Databasnamn, Användarnamn och Lösenord. Du kan också aktivera Använd Integrerad säkerhet (Windows-autentisering) om tillämpligt.
- aktivera "Jag har en anslutningssträng" växla om du vill ange hela anslutningssträngen direkt istället för att ange enskilda fält.
- Klicka på Spara konfiguration och då Testa anslutning för att verifiera databasanslutningen. När anslutningen är lyckad klickar du på Nästa att fortsätta vidare.
- När du klickat på Nästa kommer du att omdirigeras till inloggningssidan. Logga in med ditt licensierade miniOrange-konto för att fortsätta konfigurera SCIM-klienten.
- Efter inloggning, den Licensaktivering instrumentpanelen öppnas. Ange licensnyckeln för att aktivera plugin-programmet, som du får efter att du loggat in på portal.miniorange.com och navigerar till Hantera licens → Licensnycklar.
- Markera sedan rutan "Jag har läst ovanstående villkor och vill aktivera pluginet", och klicka på Aktivera licens knapp.
- När licensen har aktiverats öppnas SCIM-konfigurationsinstrumentpanelen.
- Öppna din webbläsare och navigera till din WordPress-administratörsinloggningssida.
https://your-wordpress-site.com/wp-admin
- Ange din Användarnamn eller e-mailadress och Lösenord, klicka sedan på Logga in knappen för att komma åt WordPress administratörspanel.
- Efter inloggning kommer du att omdirigeras till WordPress admin-instrumentpanel. Klicka på i vänster sidofält. SCIM användaradministration för att öppna plugin-programmet.
- När du är inne i plugin-programmet, scrolla ner till SCIM API-uppgifter sektion. Kopiera SCIM Bas URL och SCIM Bearer Token och ha dem till hands, eftersom du kommer att behöva dem i nästa steg.
- Växla nu tillbaka till din .NET SCIM-klient instrumentpanelen och navigera till SCIM-konfiguration flik. Klistra in det kopierade SCIM Bas URL i SCIM-slutpunkts-URL fält och SCIM Bearer Token i Bärartoken fält.
- När du är klar klickar du på Spara konfiguration och då Testa anslutning för att verifiera installationen.
- När anslutningen har upprättats visas ett popup-fönster med bekräftelsemeddelanden Anslutningen lyckades. Klicka OK att fortsätta.
3. Attributmappning
- Navigera till Attributmappningar fliken i vänster sidofält. Välj databastabellen (t.ex. användare) från rullgardinsmenyn och klicka på Spara.
- Kartlägg varje Källattribut (användare) till dess motsvarande Målattribut (SCIM) genom att välja lämplig databascolumn från Sök eller välj kolumn rullgardinsmeny för varje rad.
- AnmärkningarMålattributet refererar till det standard SCIM-schemafält som ditt databascolumnvärde kommer att tillhandahållas till.
- För att lägga till en anpassad attributmappning (t.ex. Telefonnummer), klicka på + Lägg till mappning knappen och konfigurera käll- och målattributen efter behov.
- När alla mappningar är konfigurerade klickar du på Spara alla mappningar för att spara dina ändringar.
Gruppmappningar
Om din identitetsleverantör stöder gruppprovisionering kan du konfigurera gruppmappningar för att synkronisera grupper från din applikation till WordPress.
- Navigera till Gruppmappningar fliken i vänster sidofält. Under Grupptabell, markera databastabellen som innehåller din gruppinformation och klicka på Spara.
- På samma sätt, under Gruppidentifierarkolumn, markera kolumnen som fungerar som gruppnamnsidentifierare och klicka på Spara.
- Enligt Gruppattributmappningar sektion, karta varje Källattribut (grupp) till dess motsvarande Målattribut (SCIM), vilket refererar till standard SCIM-schemafältet som ditt gruppkolumnvärde kommer att etableras till.
- För att lägga till en anpassad attributmappning, klicka på + Lägg till mappning knappen. När du är klar klickar du på Spara mappningar för att spara dina ändringar.
- Bläddra ner till Mappningar av rollnamn Om gruppnamnen i ditt program skiljer sig från de på servern, inaktivera Grupper samma som servern växla och mappa dina lokala gruppnamn till motsvarande externa gruppnamn under Gruppnamnsmappningar sektion.
- Ange Lokalt gruppnamn och motsvarande Extern gruppnamn i de angivna fälten. För att lägga till fler mappningar, klicka på + Lägg till mappning knappen, och när du är klar klickar du på Spara för att spara dina ändringar.
- Om Grupper samma som servern Om växlingsknappen är aktiverad kommer lokala gruppnamn att användas som de är och ingen namnmappning krävs.
4. Synkroniseringsalternativ
- Navigera till Alternativ för synkronisering fliken från vänster sidofält.
- Enligt Inställningar för användarsynkronisering, ställ in Satsstorlek för att definiera antalet användarposter som ska grupperas per bulkåtgärd.
- Du kan också aktivera Synkronisera användare i batchar (använd SCIM Bulk API) växla, som bearbetar flera objekt i en enda API-begäran för snabbare synkronisering.
- När du har konfigurerat klickar du på Spara konfiguration.
- Obs: Batchstorlek gäller endast när man använder Engångssynkronisering or Schemalägg synkronisering.
- Realtidssynkronisering: Slå på Aktivera realtidssynkronisering Växla för att tillåta realtidssynkronisering av användarändringar, till exempel skapande, uppdatering och borttagning, till SCIM-servern allt eftersom de sker. När den är inaktiverad kommer realtidssynkroniseringsåtgärder att avvisas. Klicka på Spara konfiguration att tillämpa ändringarna.
- Engångssynkronisering: För att utföra en omedelbar engångssynkronisering av alla användare från din .NET-applikation till SCIM-servern, klicka på Utför engångssynkronisering knapp.
- Schemalägg synkronisering: Slå på Aktivera schemasynkronisering växla för att automatiskt synkronisera användare från din .NET-applikation till SCIM-servern med konfigurerade intervall.
- När den är aktiverad, ställ in Startdatum och tid för att ange när den schemalagda synkroniseringen ska börja.
- Välj sedan synkroniseringen Frekvens enligt dina krav — dagligen, veckovis, månadsvis eller anpassad.
- Om du väljer Custom, ange en Anpassat värde och välj Enhet (t.ex. dagar) för att definiera ditt eget synkroniseringsintervall.
- Klicka Spara konfiguration att tillämpa ändringarna.
Alternativ för gruppsynkronisering
- Navigera till Alternativ för gruppsynkronisering fliken från vänster sidofält.
- Observera att gruppsynkronisering kräver att gruppmappningar konfigureras under Gruppmappningar fliken i förväg.
- Enligt Inställningar för gruppsynkronisering, ställ in Satsstorlek för att definiera antalet gruppposter som ska grupperas per bulkåtgärd.
- Du kan också aktivera Synkronisera grupper i batchar (använd SCIM Bulk API) växla, som bearbetar flera gruppobjekt i en enda API-begäran för snabbare synkronisering.
- Klicka Spara konfiguration att tillämpa ändringarna.
- Enligt Gruppsynkronisering i realtid, slå på Aktivera realtidssynkronisering Växla för att tillåta realtidssynkronisering av gruppändringar, till exempel skapande, uppdatering och borttagning, till SCIM-servern allt eftersom de inträffar.
- När den är inaktiverad kommer synkroniseringsåtgärder i realtid att avvisas. Klicka på Spara konfiguration att tillämpa ändringarna.
Relaterade artiklar
