Click or drag to resize

How to integrate Visual Guard in Sharepoint

To integrate Visual Guard in your sharepoint web site you have to:
  • Add the assemblies of Visual Guard as references of your Sharepoint web site.
  • Modify the "web.config" file of Sharepoint your web site to integrate the Visual Guard module.
  • Create a Visual Guard repository and declare your application by using the Visual Guard console. This repository will contain all security items (users, roles, permissions ...) of your application.
  • Generate the Visual Guard configuration files by using the Visual Guard console. These configuration files will be needed to connect your application to the repository.
  • Grant read/write permissions to the repository.
Modify the authentication type in Centrale Sharepoint Administration Console
  • Open the Sharepoint administration console,
  • In Application Management,
  • Under "Application Security", click on Authentication Providers as shown here:

    SP 1
  • Under the Membership Provider Name (which should say "Default"), click the "Default" word as shown below:

SP 3
  • When prompted to Edit Authentication, Select "Form" for the authentication type, type in "VGMemberShipProvider" for the membership provider name and "VGRoleProvider" for the role manager name. The following image shows how you'd input these changes:

SP 2
  • Click on Save.
Modify the web.config file of the Central Sharepoint Administration Console
  • Open the config file : "C:\inetpub\wwwroot\wss\VirtualDirectories\XX\web.config"
  • In the section "system.web" add instructions bellow
<membership defaultProvider="VGMemberShipProvider">
  <providers>
    <add
      name="VGMemberShipProvider"
      type="Novalys.VisualGuard.Security.WebForm.VGMemberShipProvider, Novalys.VisualGuard.Security.WebForm"/>
  </providers>
</membership>

/>
  • To inform the web site that the role management will be donne by Visual Guard, you have to add in the section "<system.web>" the code bellow.

<roleManager defaultProvider="VGRoleProvider" enabled="true">
  <providers>
    <add
    name="VGRoleProvider"
    type="Novalys.VisualGuard.Security.WebForm.VGRoleProvider, Novalys.VisualGuard.Security.WebForm"/>
  </providers>
</roleManager>
  • To activate Visual Guard you have to add in the section "<httpModules>" instructions bellow:

<add type= "Novalys.VisualGuard.Security.WebForm.VGHttpModule, Novalys.VisualGuard.Security.WebForm" name="VGModule" />

Referencing Visual Guard assemblies

In order to use Visual Guard, you must add references to Visual Guard assemblies:

  • Copy Visual Guard assemblies in the folder : "C:\inetpub\wwwroot\wss\VirtualDirectories\XX\bin"
  • In .Net tab, select the 4 assemblies
    1. Novalys.VisualGuard.Security
    2. Novalys.VisualGuard.Security.WebFrom
    3. Novalys.VisualGuard.Security.<RepositoryType> (Files, SQLServer or Oracle)
    4. Novalys.VisualGuard.Security.<ApplicationFrameworkType> (Depending on type of application's framework, whether .NetFramework or .NetCore)
    And, then click the Select button, and then click the OK button

Description of Visual Guard assemblies:

  • Novalys.VisualGuard.Security contains the main Visual Guard classes.
  • Novalys.VisualGuard.Security.Files contains the classes needed to access to a file based repository.
  • Novalys.VisualGuard.Security.SQLServer contains the classes needed to access to a repository stored in a Microsoft SQLServer database (SQLServer 2000 or higher). Available only in Visual Guard Enterprise Edition
  • Novalys.VisualGuard.Security.Oracle contains the classes needed to access to a repository stored in an Oracle database (8i or higher). Available only in Visual Guard Enterprise Edition
  • Novalys.VisualGuard.Security.WebForm contains the classes needed to ASP.Net application. You must reference this assembly in ASP.Net WebSite or ASP.Net WebService project.
  • Novalys.VisualGuard.Security.NetFramework contains all classes required to support .Net Framework applications. This assembly is needed only if you want to integrate Visual Guard in .net framework applications.
  • Novalys.VisualGuard.Security.Core contains all classes required to support .Net Core applications. This assembly is needed only if you want to integrate Visual Guard in .net core applications.

Note Note

Once the Visual Guard assemblies are referenced into project, you need to mark "Copy Local" property to "true" for each assembly.

Note Note

You must add either Novalys.VisualGuard.Security.NetFramework or Novalys.VisualGuard.Security.Core (Depending on type of application's framework)

Give authorisation to the role "Administrator"

this step is use to give authorisation to the administrator to acces to "Operations" and "Application management" in the administration console of Sharepoint.

The administration page of the console are in "C:\Program Files\Common Files\microsoft shared\Web Server Extensions\12\TEMPLATE\ADMIN".

  1. Open: "C:\Program Files\Common Files\microsoft shared\Web Server Extensions\12\TEMPLATE\ADMIN\web.config"
  2. Add the instruction bellow in the section "<system.web>":

<authorization>
  <para/>
  <allow roles="Administrator"/>
  <para/>
</authorization>
<para/>

The role "Administrator" has to be created in Visual Guard.

Modify the web.config file of the Central Sharepoint Administration Console
  • Open the config file : "C:\inetpub\wwwroot\wss\VirtualDirectories\XX\ web.config"
  • In the section "<system.web>" add instructions bellow

<membership defaultProvider="VGMemberShipProvider">
  <providers>
    <add
    name="VGMemberShipProvider"
    type="Novalys.VisualGuard.Security.WebForm.VGMemberShipProvider, Novalys.VisualGuard.Security.WebForm"/>
    </providers>
</membership>

/>
  • To inform the web site that the role management will be donne by Visual Guard, you have to add in the section "<system.web>" the code bellow.

<roleManager defaultProvider="VGRoleProvider" enabled="true">
  <providers>
    <add
    name="VGRoleProvider"
    type="Novalys.VisualGuard.Security.WebForm.VGRoleProvider, Novalys.VisualGuard.Security.WebForm"/>
  </providers>
</roleManager>
  • To activate Visual Guard you have to add in the section "<httpModules>" instructions bellow:

<add type= "Novalys.VisualGuard.Security.WebForm.VGHttpModule, Novalys.VisualGuard.Security.WebForm" name="VGModule" />

Referencing Visual Guard assemblies

In order to use Visual Guard, you must add references to Visual Guard assemblies:

  • Copy Visual Guard assemblies in the folder : "C:\inetpub\wwwroot\wss\VirtualDirectories\XX\bin"
  • select the 3 assemblies:
    • Novalys.VisualGuard.Security,
    • Novalys.VisualGuard.Security.WebFrom,
    • Novalys.VisualGuard.Security.<RepositoryType> (File, SQLServer or Oracle)

Description of Visual Guard assemblies:

  • Novalys.VisualGuard.Security contains the main Visual Guard classes.
  • Novalys.VisualGuard.Security.Files contains the classes needed to access to a file based repository.
  • Novalys.VisualGuard.Security.SQLServer contains the classes needed to access to a repository stored in a Microsoft SQLServer database (SQLServer 2000 or higher). Available only in Visual Guard Enterprise Edition
  • Novalys.VisualGuard.Security.Oracle contains the classes needed to access to a repository stored in an Oracle database (8i or higher). Available only in Visual Guard Enterprise Edition
  • Novalys.VisualGuard.Security.WebForm contains the classes needed to ASP.Net application. You must reference this assembly in ASP.Net WebSite or ASP.Net WebService project.

Configure Visual Guard

Declaration of Sharepoint applications in Visual Guard

SharePoint Administration Console SharePoint Web site
Application Type ASP.Net Web Site or Service (.Net 2.0 or Higher)
Runtime integration The visual Guard runtime is already integrated in the application
Application Path C:\inetpub\wwwroot\wss\VirtualDirectories\31670 C:\inetpub\wwwroot\wss\VirtualDirectories\80
Advanced Option Select options you want

Create "Administrator" Role
  1. Select the application in the Visuyal Guard administration console,
  2. Create the role "Administrator"
  3. Grant this role to the administraor user.

 

Create permissions

Sample:  when you suppress an application in sharepoint you can authorise to suppress the content database too. In our sample we want to suppress this option to the user with the role "Application administrator".

  1. Create the role "Application administor" in Visual Guard in application "Sharepoint administration console",
  2. Add this role in the file: C:\Program Files\Common Files\microsoft shared\Web Server Extensions\12\TEMPLATE\ADMIN\web.config
  3. In visual Guard console in the property "Other assemblies" add the assembly: C:\Program Files\Common Files\microsoft shared\Web Server Extensions\12\CONFIG\ADMINBIN\Microsoft.SharePoint.ApplicationPages.Administration.dll. This assembly is used to securise the aspx pages of adminstration console of Sharepoint.
  4. Create a permission,
  5. Create a property action,
  6. Select the page "Microsoft.SharePoint.ApplicationPages / DeleteWebApplicationPage ",
  7. Select the control: "RadDeleteContent",
  8. Put the property "Visible= False",
  9. Validate.

 

 

See Also