Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

3.1 Changes to web.config

Open your Sitecore's web.config file. Before  Before you start making changes, it is advised that you make a copy of the the web.config file, so you always will have the ability to ability to fully recover.

3.1.1 Add 1 Add handler

DFS has its own handler for serving media files. To enable the handler:

  • Navigate to the section "/configuration/system.webServer/handlers".

  • Now add the following handler, inside the handlers section.

    Code Block
    linenumbers
    languagexmltrue
    <add name="MediaHandler" verb="GET" path="dfsmedia/*/*-*" type="DFS.Client.Services.Handlers.MediaHandler"/>

3.1.2

Assembly bindings

Content-Security-Policy

Our embedded Media Manager that are loaded in an IFrame must be added to the content security policy. Otherwise you will see a “This content is blocked” when opening the Media Manager or download asserts from the Media Manager.

  • Navigate to the section "/runtime/assemblyBinding".

  • Add this dependentAssembly:

    Code Block
    languagexml
    <dependentAssembly>
    	<assemblyIdentity name="Microsoft.Extensions.Http" publicKeyToken="adb9793829ddae60"/>
    	<bindingRedirect oldVersion="0.0.0.0-3.1.14.0" newVersion="3.1.14.0"/>
    </dependentAssembly>

    Change the version of the following assembly:

    Code Block
    languagexml
    <dependentAssembly>
    	<assemblyIdentity name="Microsoft.Bcl.AsyncInterfaces" publicKeyToken="cc7b13ffcd2ddd51"/>
    	<bindingRedirect oldVersion="0.0.0.0-1.0.0.0" newVersion="1.0.0.0"/>
    </dependentAssembly>

    to

    Code Block
    languagexml
    <dependentAssembly>
    	<assemblyIdentity name="Microsoft.Bcl.AsyncInterfaces" publicKeyToken="cc7b13ffcd2ddd51"/>
    	<bindingRedirect oldVersion="0.0.0.0-6.0.0.0" newVersion="6.0.0.0"/>
    </dependentAssembly>

    Change the version of the following assembly:

    Code Block
    languagexml
    <dependentAssembly>
    	<assemblyIdentity name="System.Runtime.CompilerServices.Unsafe" publicKeyToken="b03f5f7f11d50a3a"/>
    	<bindingRedirect oldVersion="0.0.0.0-4.0.6.0" newVersion="4.0.6.0"/>
    </dependentAssembly>

    to

    Code Block
    languagexml
    <dependentAssembly> <assemblyIdentity name="System.Runtime.CompilerServices.Unsafe" publicKeyToken="b03f5f7f11d50a3a"/> <bindingRedirect oldVersion="0.0.0.0-6.0.0.0" newVersion="6.0.0.0"/> </dependentAssembly>
  • location/system.webServer/httpProtocol/customHeaders

  • Locate the header Content-Security-Policy, you must add all the Media Manager portal urls and the DAM api urls to the default-src. (Be aware that Digizuite can be configured with multiple portal and api urls, these urls can be received from your Digizuite consultant).

  • Example, here we added https://mm.example.com and https://api.example.com.

    Code Block
    <add name="Content-Security-Policy" value="default-src 'self' 'unsafe-inline' 'unsafe-eval' https://mm.example.com https://api.example.com; img-src 'self' data: https://s.gravatar.com https://*.wp.com/cdn.auth0.com/avatars; style-src 'self' 'unsafe-inline' https://fonts.googleapis.com; font-src 'self' 'unsafe-inline' https://fonts.gstatic.com; upgrade-insecure-requests;" />

3.2 Setting up the connection to Digizuite™

DFS synchronizes data from Digizuite™ DAM Center (DC) into Sitecore. Data is stored in a silo (item bucket)Before we can begin synchronizing, we have to fill out some config parameters telling Sitecore which DAM to fetch data from. There are 3 parameters in this file \App_Config\Include\damforsitecore\DFS.Settings.config. 

Code Block
languagexml
linenumberstrue
<setting name="DFS.AssetSiloSettingsDigizuite.Default.BaseAddressMediaManagerUrl" value="{URL TO THEMEDIA DAM SERVERMANAGER}" />
<setting name="DFS.Digizuite.Sync.MediaManagerUrlUsername" value="{URLUSERNAME OF TOTHE MEDIASYNC MANAGERUSER}" />
<setting name="DFS.Digizuite.Sync.ChannelFolderIdPassword" value="{IDPASSWORD OF THE CHANNELSYNC FOLDERUSER}" />

We do not recommend that you change these parameters in this file. Instead create a new config file where you patch the parameters (This is best practice). Here is an example of the patch config file. It is important that the file is loaded after DFS.Settings.config, otherwise the patch file won't have any effect. If you name the config file z.DFS.Settings.config and place it in the folder \App_Config\Include\damforsitecore\ you should be safe.

Code Block
languagexml
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/">
	<sitecore>
		<settings> 			
			<setting name="DFS.AssetSiloSettingsDigizuite.Default.BaseAddressMediaManagerUrl">
        				<patch:attribute name="value">https://dammm.digizuiteexample.dk/<com</patch:attribute>
	      		</setting>      			
            <setting name="DFS.Digizuite.Sync.MediaManagerUrlUsername">
        		      <patch:attribute name="value">https://mm.digizuite.dk</>DFS System</patch:attribute>
          		  </setting>
      		      <setting name="DFS.Digizuite.Sync.ChannelFolderIdPassword">
        		      <patch:attribute name="value">134<>6Jz7b6KBnFvdLW9y</patch:attribute>
            		</setting>      
		</settings>
	</sitecore>
</configuration>
  • Edit the values in the file to match your site (use the below table):

Variable

Description

Default

Example

BaseAddress

DFS.Digizuite.MediaManagerUrl

URL to your

DC. It MUST end with a forward slash

https://[yourdam]/

https://dam.digizuite.dk/

Username

Username for the user to be used when synchronizing between Sitecore and your DAM

DAM for Sitecore

DAM for Sitecore

Password

Password for the user to be used when synchronizing between Sitecore and your DAM

sitecore

sitecore

Once the config file is in place, reload the

Media Manager

DFS.Digizuite.Sync.Username

The username of the user to synchronize assets in the background

DFS.Digizuite.Sync.Password

The password of the user to synchronize assets in the background

Reload the site.

Table of Contentstoc