Integrera SharePoint med DNN med miniOrange DNN SharePoint Connector
Översikt
Den här installationsguiden visar hur du sömlöst ansluter din SharePoint- miljö till din DNN- webbplats, så att du kan bädda in SharePoint-dokument och andra resurser direkt på DNN-sidor. Du kan också tillämpa behörigheter på SharePoint-nivå och konfigurera detaljerade åtkomstkontroller för att säkerställa att användare bara ser det innehåll de är behöriga att visa – vilket ger en säker och integrerad innehållsupplevelse i din DNN-portal.
Förutsättningar: Ladda ner och installation
Steg 1: Ladda ner plugin
Obs ! Ladda ner DNN SharePoint Connector baserat på ditt abonnemang – provversion från DNN Store eller Enterprise från miniOrange-portalen ( fliken Nedladdningar → Ladda ner plugin ).
Företagsplaner — Se skärmdumpen nedan för att ladda ner plugin-programmet från miniOrange-portalen.
Steg 2: Installera plugin-programmet i DNN
- Ladda upp installationspaketet dnn-sharepoint-connector_xxx_Install genom att gå in Inställningar > Tillägg > Installera tillägg.
- Öppna någon av sidorna på din DNN-webbplats (redigeringsläge) och klicka på Lägg till modul.
- Sök efter sharepoint och klicka på miniOrange SharePoint-anslutningDra och släpp modulen på sidan där du vill ha den.
- När du har installerat modulen på din DNN-webbplats klickar du på kugghjulsikonen av modulen och välj Inställningar från rullgardinsmenyn.
- Navigera till miniOrange SharePoint Connector-inställningar fliken för att konfigurera modulen.
Konfigurationssteg
Steg för steg guide för DNN Sharepoint Integration.
1. Aktivera SharePoint-pluginet med licensnyckeln
- När du klickar miniOrange SharePoint Connector-inställningar fliken kommer du att omdirigeras till licensaktiveringssidan och du kommer att få en testlicensnyckel till din registrerade e-postadress.
- För att aktivera plugin-programmet kan du antingen:
- Ange licensnyckeln som du mottagit via e-post i det angivna inmatningsfältet.
OR
- Ladda upp licensfilen med hjälp av Välj FIL knapp.
- Markera sedan rutan "Jag har läst ovanstående villkor och jag vill aktivera modulen", och klicka Aktivera licens knapp.
- När du klickar miniOrange SharePoint Connector-inställningar fliken kommer du att omdirigeras till DNN SharePoint-inloggningssidan.
- Logga in på DNN Sharepoint-pluginet för att komma åt administratörspanelen med ditt miniOrange-konto som licensen köptes under.
- Ange licensnyckeln i Licensnyckel fält och klicka på Aktivera licens knapp.
2. Skapa autentiseringsapplikation i Entra ID
- Du kommer att representeras med startskärmen för Azure Active Directory. Leta efter "App-registreringar" tjänster i Azure Active Directory.
- Klicka nu på Ny registrering alternativ.
- Skriv app Namn i namnfältet och välj kontotyp. Som standard väljs kontotyp som Konto endast i denna organisationskatalog.
- Omdirigera URI är valfritt, du kan hålla detta fält tomt.
- När du har angett ovanstående data kan du klicka på knappen Registrera.
- Efter registreringen av en applikation tilldelar Azure AD ett unikt applikations-ID till din applikation.
- Navigera till Översikt fliken i den vänstra rutan.
- kopiera ansöknings-ID och Katalog-ID, eftersom detta kommer att användas som ditt kund-ID och Hyresgäst ID för att konfigurera SharePoint Connector.
- Därför kan du ha den till hands någonstans som anteckningsblock för att senare använda den.
- Från den vänstra navigeringsrutan, navigera till Certifikat och hemligheter fliken.
- Klicka på Ny klient hemlighet för att ange beskrivningen och utgångstiden, klicka sedan på Lägg till alternativ.
- kopiera Hemligt värde som visas i skärmdumpen nedan. När du navigerar till någon annan sida kommer detta värde att döljas så kopiera och klistra in det någonstans praktiskt.
- Notera: Se till att du har kopierat värdet på klienthemligheten och inte det hemliga ID:t som visas i bilden nedan.
Bevilja API-behörigheter till din Entra ID-applikation:
- Gå till API-behörigheter från den vänstra navigeringsrutan och klicka på Lägg till ett behörighetsalternativ.
- Välja Microsoft Graph från listan.
- Autentiserat användarläge
- Gästanvändarläge
-
NOTERA : Grant Applikationsbehörigheter till din Entra ID-applikation om du vill ge "autentiserad" användare åtkomst till din katalog eller annars bevilja Ansökan behörighet att tillåta åtkomst till specifika Entra ID-användare.
-
NOTERA : Du kan välja mellan två olika behörigheter Sites.Read.All och Sites.ReadWrite.All under alternativet webbplatser för att passa dina åtkomstbehov.
-
Välj för att tillåta användaren att endast läsa webbplatsens data Sites.Read.All behörighet och klicka på knappen Lägg till behörigheter.
-
Kopiera återuppringnings-/omdirigerings-URL:en från Konfigurera autentisering fliken på Connector-instrumentpanelen.
-
Konfigurera CallBack/Redirect URL i din Entra ID-applikation >> Fliken Autentisering >> Redirect URL.
-
NOTERA : Grant Delegera behörigheter till din Entra ID-applikation om du vill tillåta "Gäst"-användare åtkomst till din katalog eller ge applikationsbehörighet att tillåta åtkomst till specifika Entra ID-användare.
-
NOTERA : Du kan välja mellan två olika behörigheter Sites.Read.All och Sites.ReadWrite.All under alternativet webbplatser för att passa dina åtkomstbehov.
-
Välj för att tillåta användaren att endast läsa webbplatsens data Sites.Read.All behörighet och klicka på knappen Lägg till behörigheter.
- Autentiserat användarläge
- Gästanvändarläge
-
NOTERA : Grant Applikationsbehörigheter till din Entra ID-applikation om du vill ge "autentiserad" användare åtkomst till din katalog eller annars bevilja Ansökan behörighet att tillåta åtkomst till specifika Entra ID-användare.
-
NOTERA : Du kan välja mellan två olika behörigheter Sites.Read.All och Sites.ReadWrite.All under alternativet webbplatser för att passa dina åtkomstbehov.
-
Välj för att tillåta användaren att endast läsa webbplatsens data Sites.Read.All behörighet och klicka på knappen Lägg till behörigheter.
-
Kopiera återuppringnings-/omdirigerings-URL:en från Konfigurera autentisering fliken på Connector-instrumentpanelen.
-
Konfigurera CallBack/Redirect URL i din Entra ID-applikation >> Fliken Autentisering >> Redirect URL.
-
NOTERA : Grant Delegera behörigheter till din Entra ID-applikation om du vill tillåta "Gäst"-användare åtkomst till din katalog eller ge applikationsbehörighet att tillåta åtkomst till specifika Entra ID-användare.
-
NOTERA : Du kan välja mellan två olika behörigheter Sites.Read.All och Sites.ReadWrite.All under alternativet webbplatser för att passa dina åtkomstbehov.
-
Välj för att tillåta användaren att endast läsa webbplatsens data Sites.Read.All behörighet och klicka på knappen Lägg till behörigheter.
3. Konfigurera Entra ID-autentisering i DNN
- Navigera till DNN SharePoint Integrator Modul.
- Enligt "Ställ in autentisering" fliken, ange nödvändig information från Entra ID-appen och klicka på knappen Spara.
- När du har sparat konfigurationen, klicka på "Testa anslutning" för att testa din anslutning till Entra ID.
- Du kommer att se ett framgångsmeddelande i ett annat popup-fönster för att bekräfta autentiseringsinställningarna.
- Navigera till miniOrange SharePoint-anslutning Modul.
- Enligt "Ställ in autentisering" fliken, ange den information som krävs från Entra ID-appen och klicka på Spara knapp.
- När du har sparat konfigurationen, klicka på "Testa anslutning" för att testa din anslutning till Entra ID.
Gästanvändare
- Om du har valt Gästanvändare visningsläge, klicka på Testa anslutning knappen visar ett meddelande om lyckades i ett annat popup-fönster för att bekräfta autentiseringsinställningarna.
Autentiserad användare
- Om du har valt Autentiserad användare visningsläge, klicka på Testa anslutning knappen öppnar ett popup-fönster för Microsoft-inloggning. Logga in med dina Entra-ID-uppgifter för att verifiera anslutningen till Entra-ID.
4. Konfigurera ShortCodes i DNN
- Enligt "Shortcodes List" Klicka på knappen "Lägg till kortkod" för att skapa en ny kortkod som visas i bilden nedan.
- Klicka på din specifika webbplats och välj sedan den mapp vars innehåll du vill visa på DNN-sidorna och klicka sedan på "Spara kortkod" knapp.
- Ange ett ShortCode-namn och aktivera Tillåt CRUD för slutanvändare om du vill att slutanvändarna på din DNN-webbplats ska prestera Skapa, läs, uppdatera och ta bort (CRUD) åtgärder på SharePoint-filer och -mappar direkt från DNN-webbplatsen.
- Du kan Visa/Redigera alla dina kortkoder från "Shortcodes List" fliken i DNN Sharepoint Connector.
- Kopiera din kortkod med hjälp av "Urklipp" ikonen mot din kortkod.
- Enligt "Shortcodes List" fliken, klicka på "Lägg till kortkod" knappen för att skapa en ny shortcode som visas på bilden nedan.
- Klicka på din specifika webbplats och välj sedan den mapp vars innehåll du vill visa på DNN-sidorna och klicka sedan på "Spara kortkod" knapp.
- Ange ett ShortCode-namn och aktivera de behörigheter och funktioner du vill tillåta för slutanvändarna på din DNN-webbplats.
- Tillåt skapande för slutanvändare — Gör det möjligt för slutanvändare att skapa nya filer och mappar i SharePoint direkt från DNN-webbplatsen.
- Tillåt borttagning för slutanvändare — Gör det möjligt för slutanvändare att ta bort SharePoint-filer och -mappar från DNN-webbplatsen.
- Tillåt nedladdning för slutanvändare — Gör det möjligt för slutanvändare att ladda ner SharePoint-filer från DNN-webbplatsen.
- Tillåt uppdatering för slutanvändare — Gör det möjligt för slutanvändare att uppdatera eller ändra befintliga SharePoint-filer från DNN-webbplatsen.
- Aktivera filsökning — Lägger till en sökfält i den inbäddade kortkoden så att slutanvändare snabbt kan söka efter specifika filer i den anslutna SharePoint-mappen.
- Du kan Visa/Redigera alla dina kortkoder från "Shortcodes List" fliken i DNN Sharepoint Connector.
- Kopiera din kortkod med hjälp av "Urklipp" ikonen mot din kortkod.
Hantera åtkomst
- Enligt Hantera SharePoint fliken, klicka på ikonen med tre punkter i Handling kolumnen bredvid en fil eller mapp och välj Hantera åtkomstEtt popup-fönster öppnas där du kan mappa DNN-roller till Läsa, Skapa (Ladda upp och skapa mapp), Uppdateringoch Radera behörigheter för det objektet.
- Välj de DNN-roller som krävs för varje behörighetstyp (till exempel mappning Registrerade användare och abonnenter under Läsa), Klicka sedan Spara för att tillämpa åtkomstinställningarna.
- Navigera till Översikt över åtkomst fliken för att visa alla filer eller mappar med en explicit ACL. Använd filtren för att söka efter namn, nod-ID eller roll. Tabellen visar de mappade rollerna under Läsa, Skapa, Uppdateringoch Radera. Från Handling kolumnen kan du redigera eller ta bort en befintlig ACL-post.
5. Bädda in kortkoder i DNN
- Innan du lägger till kortkoderna på DNN-sidorna är det nödvändigt att lägga till shortCode.js av miniOrange DNN Sharepoint Connector som kommer att hantera renderingen av kortkoderna.
<script src="/DesktopModules/MVC/DNNSharepointIntegrator/includes/js/shortCode.js"
type="text/javascript"></script>
- Lägg till den här Javascript-källfilen på din DNN-sida med hjälp av DNN HTML-modulen enligt nedan:
- Öppna DNN HTML-modulen och klicka på "Källa", Lägg till ovanstående shortCode.js och specifik shortCode på den sidan.
- Klicka på "Spara" knappen för att spara sidändringarna och sedan kommer du att kunna se den specifika Sharepoint-mappen på din DNN-webbplats.
Den här guiden hjälper dig att konfigurera och integrera SharePoint-filer för din DNN-webbplats. Genom att använda miniOrange DNN SharePoint-integration.
Relaterade artiklar