This article relates to our product Cloud Drive Mapper.
*** Important - update as of 22/03/23 - V2.15 has WebView2 enabled by default. MasterSettings 4 has been deprecated in this version. If you're updating from a previous version then 4 can be removed from your existing MasterSettings registry key, or if its set to = 4, then the key can be removed. Further details can be found here. ***
Cloud Drive Mapper is quite simple on the surface, but beneath the basic shell are quite a few custom capabilities that you can enable via registry keys. Registry keys can be used to enable and optimise compatibility of Cloud Drive Mapper within an IT environment (see separate article for these) or activate useful features and customisations (see below).
All keys are Reg_SZ and should be place in one of the following locations dependent on the key
- HKCU\Software\IAM Cloud\CloudDriveMapper
- HKLM\Software\IAM Cloud\CloudDriveMapper
TABLE OF CONTENTS
MasterSettings
From 2.9 onwards MasterSettings has been updated to consolidate the configuration of advanced features and troubleshooting features into a single setting.
For example to enable WebView2, the reg key would look like:
For it to take affect just exit and reload CDM.
MasterSettings is a bitmask, so the value can be computed by adding together the values from all the settings you want to be enabled. So for example, if you wished to enable verbose logging to local app data (32) and run CDM in a VDI environment under multiple instances (256) you would set MasterSettings = 288
The most commonly used combination is 36, 32 for the logs and 4 to enable WebView2.
| 1 | EnableBasicMode | By default from version 2.9.1 and above, Cloud Drive Mapper will use the Advanced Mode AAD Enterprise App as standard. For customers who had previously used the 'Standard mode' use this setting |
| 2 | UseCookies | If experiencing auth issues use this to troubleshoot. Used for legacy authentication. |
| 4 | TurnOnWebView2 | Turns on WebView2 component, default is WebControl. There are no specific differences in terms of features between WebControl and WebView2, however in some environments if there are issues with SSO not working or drives not mapping then WebView2 maybe needed as it's the more modern framework. If WebControl works ok then there's no immediate need to use WebView2, but WebControl is a legacy authentication method and thus Microsoft may make changes to authentication in the future which WebControl does not properly support, whereas WebView2 is the current technology so will support Microsoft changes |
| 8 | NoIWAAuth | Ensures Windows Integrated Authentication is not used. |
| 16 | NoSilentAuth | Will not try SSO. The browser window that shows will be interactive. |
| 32 | VerboseLogging | Enables Cloud Drive Mapper logging to text files created in %localappdata%/IAM Cloud/Cloud Drive Mapper |
| 64 | NoUserExit | Prevents users from being able to exit the CDM application |
| 128 | WriteLogToEventLog | Writes logs to the Windows Event Log |
| 256 | AllowMultipleInstances | Required for VDI / VAI environments (Citrix, RDSH, VMWare) |
| 512 | DisableEnforceChangeDriveLabel | Do not enforce the drive label. |
| 1024 | DisableCredentialSave | Stops CDM saving credentials in Windows Credential Manager. |
| 2048 | PreAuthClearDown | In some environments we've found that previously cached authentication data can interfere with the successful operation of CDM. Enabling this setting forces CDM to remove all pre-existing authentication cache before it launches. |
| 4096 | PreCacheClearDown | In some environments we've found that previously cached drive and settings data can interfere with the successful operation of CDM. Enabling this setting forces CDM to remove all pre-existing drive and settings cache before it launches. |
| 8192 | ExitConvergeClearDown | Removes the cached directory structure for converged on CDM exit. Not set on default for performance purposes. |
| 16384 | AllowUsersLanguageSelection | Cloud Drive Mapper is translated into several languages and will auto-detect the default language set on the machine. If a language is set to a language we don't support it will default to English. However, enabling this feature will allow users to be able to over-ride the automatic language options and select their preferred language from a list of our supported languages. When this feature is enabled, it will appear as a menu item when right-clicking on the CDM system tray icon. |
| 32768 | DoNotUseAzureAD | Stops CDM from logging in with the account associated with Azure AD. A user might want to use an Azure AD tenant not associated with your organisation Azure AD in specific circumstances. |
| 65536 | IncludeAuthInfoInLogs | By default CDM's logs do not contain any sensitive information, however for challenging authentication related issues it may be necessary to see detailed information for the users authentication session tokens. This option should be used sparingly and with care. |
| 131072 | OnExitDoNothing | Do not unmap drives or undo folder redirection on exit. |
| 262144 | DoNotCacheInOD | Prevents CDM using cdmsettings in OneDrive. |
| 524288 | DisableUserLogMenu | Will not display logging options when using Ctrl + Right Click |
| 1048576 | DoNotSuppressJSError | Used for authentication issue diagnosis. |
| 2097152 | DisableModernSharing | Removes the default Windows 'Share' menu item from the right-click file menu. See further information. |
| 4194304 | HideLicenceKey | Hides the licence key from being visible on the 'About' screen of the Cloud Drive Mapper client. |
| 8388608 | RevertToWebControl | Reverts authentication method to WebControl |
| 16777216 | DisableCustomCoAuth | Disables Co - Authoring in Office |
ListConvergeSettings
NB: In versions 2.8.x and below this feature was called MasterSettings, but from 2.9 onwards MasterSettings has been repurposed and the settings that used to exist there have now been moved to this dedicated key ListConvergeSettings.
ListConvergeSettings is a bitmask. The value can be computed by adding together the values from all the settings you want to be enabled. So for example, if you wanted to remove modern sites (unified groups) from SharePoint Converged drive and remove the custom SP icons (in favour of folder icons) then you would use 1+16. E.g. ListConvergeSettings = 17
| 1 | SPConverge-> OnlyShowSitesWithMembership | Will remove modern sites (unified group) where you are not a member (such as public) |
| 2 | FullConverge -> ShowOnlyTeams | This allows Teams to work in the traditional SP doc-lib model rather than using Teams channels. Use in conjunction with 4 (i.e. 2+4=6) to use the Teams icons within the drive to recreate the previous ‘TeamstoDocLib’ registry setting. |
| 4 | FullConverge -> ShowServiceIcons | Uses SharePoint icons for SharePoint site and Teams icon for Teams. Cannot be used with 8 |
| 8 | FullConverge -> NoIcons | Uses normal Windows folder icons for Teams and SharePoint sites. Cannot be used with 4 |
| 16 | SPConverge-> NoIcons | Uses folder icons within a SP converged drive. |
| 32 | TeamsConverge -> NoIcons | Uses folder icons within a Teams converged drive. |
| 64 | FullConverge -> OnlyShowSitesWithMembership | Will remove modern sites (unified group) where you are not a member (such as public) |
| 128 | FullConverge -> OnlyShowSiteWithGroups | Will only show spsites that have groups (modern sites) |
| 256 | SPConverge-> OnlyShowSiteWithGroups | Will only show spsites that have groups (modern sites) |
| 512 | OneDrive -> NoIcons | Uses folder icon instead of the IAM Cloud icon within the CreateToFolder setting |
| 1024 | TeamsConverge -> Show Archived Teams | Archived Teams are automatically hidden - enabling this feature will show them in your Teams converge drive |
| 2048 | FullConverge -> Show Archived Teams | Archived Teams are automatically hidden - enabling this feature will show them in your Full Converge drives |
| 4096 | FullConverge -> Show SPO Communication sites without membership | By default converge drives only map SPO sites that a user has been explicitly granted membership/permission for. This means 'communication' SPO sites are normally excluded. Enabling this key means they will be included in your FullConverge drive |
| 8192 | SPConverge -> Show SPO Communication sites without membership | By default converge drives only map SPO sites that a user has been explicitly granted membership/permission for. This means 'communication' SPO sites are normally excluded. Enabling this key means they will be included in your SPConverge drive |
DisableNotifications
By default all notifications are enabled, however you can optionally remove different notification types
- LicenceKey = 2,
- Error = 4,
- Information = 8,
- Authentication = 16,
- LicenceKeyNotPresent = 32