How to configure Rules based on Corporate Device Recognition

This article applies to the following products:    
     Messageware AttachView 2016

     Messageware AttachView 2013

     Messageware AttachView 2010

     Messageware AttachView 2007

     Messageware AttachView 2003

 

SUMMARY

 

Corporate Device Recognition can be incorporated with Messageware AttachView to provide users on company owned devices a specific set of Messageware AttachView functionality.

Devices are tagged by editing the browser’s user agent string; this article describes how this can be achieved when using the following browsers:

 

·           Internet Explorer (Windows)

·           Mozilla Firefox (Windows and Macintosh)

·           Netscape (Windows)

·           Google Chrome (Windows)

 

RESOLUTION

 

This section is divided into the following two parts: A) Configuring the user agent string in the AttachView Management Console; and B) Configuring the user agent string in the browser settings

 

A) Configuring the user agent string in the AttachView Management Console

 

1.       On the server, open the AttachView Management Console

2.       Select the Rule to be configure

3.       Press the Edit   button beside the CDR field and press Add   to enter a new User Agent tag
Example: Corporate_Device_User;
  (   Corporate_Device_User)  
NOTE: When using Netscape in your environment the CDR string needs to be added again and surrounded by brackets

4.       Press OK, OK and Apply to accept the changes


 

B) Configuring the user agent string in the browser settings

 

The user agent string is configured per browser on the client machine.  Below are the details on how to configure the user agent string for the following browsers: Internet Explorer (Windows); Mozilla Firefox (Windows and Macintosh); Netscape (Windows); Google Chrome (Windows).

 

Internet Explorer (Windows)

 

1.       On the Client machine, open the registry editor (regedit)

2.       Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\ Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent\Post Platform

3.       In the right frame, right-click and select New\String Value

4.       Enter the name of value.  The name is the User Agent tag entered in the Messageware AttachView Administrative Console

5.       No value data is required

6.     Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\ Wow6432Node\ Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent\Post Platform

7.    In the right frame, right-click and select New\String Value

8.       Enter the name of value.  The name is the User Agent tag entered in the Messageware AttachView Administrative Console

9.       No value data is required

10.      Close the registry editor

 

NOTE:  When using Internet Explorer to access OWA via Exchange Forms-based Authentication, choosing the Basic client option overwrites the asset tag and therefore the user agent cannot be distinguished.

 

Mozilla browsers including Mozilla Firefox (Windows and Macintosh)

 

1.       Open a new Mozilla browser window

2.       In the address bar type about:config and press Enter

3.       Create a new String and name it general.useragent.extra.<Enter a relevant title>
Example: general.useragent.extra.AttachViewLaptop

4.       Provide a value which will be the user agent string
Example: Corp_Device_User
NOTE: This value will be visible in the user agent string

5.       Close the browser and open a new browser

 

Netscape (Windows and Macintosh)

 

1.       Open a new Netscape browser window

2.       In the address bar type: about:config and press Enter

3.       Create a new String and name it general.useragent.vendorComment

4.       Provide a value which will be the user agent string
Example: Corp_Device_User
NOTE: This value will be visible in the user agent string

5.       Close the browser and open a new browser

 

Google Chrome (Windows)

 

1.       Open a new Google Chrome browser window

2.       In the address bar type: http://w3.messageware.com/download/support/agent.html and press Enter

3.       Take a copy of the displayed User Agent String.

      Example: Mozilla/5.0 (Windows NT 6.3; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/34.0.1847.116 Safari/537.36

4.       Edit the Chrome Shortcut in your start menu, Desktop, Quick launch bar or wherever else it may be located to add --user-agent=(User Agent from Step 3, Corp_Device_User)
Example: "C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" --user-agent=” Mozilla/5.0 (Windows NT 6.3; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/34.0.1847.116 Safari/537.36 Corp_Device_User”
NOTE: This value will be visible in the user agent string

5.       Close the browser and open a new browser

 

 

MORE INFORMATION

 

Please note that research has indicated that the user agent tag cannot be configured for the Safari browser on the Macintosh.

 

REFERENCES

 

Please refer to the articles below for further reference on the user agent configuration.

 

Understanding User-Agent Strings  
http://msdn.microsoft.com/library/?url=/workshop/author/dhtml/overview/aboutuseragent.asp

 

About:config entries (Mozilla Firefox)  
http://kb.mozillazine.org/Firefox_:_FAQs_:_About:config_Entries

 

This article applies to the following products:    
     Messageware AttachView 2016

     Messageware AttachView 2013  

     Messageware AttachView 2010

     Messageware AttachView 2007

     Messageware AttachView 2003