The use of the BlackBerry® Browser can be identified both generically and uniquely. When making a request to a web server, the User-Agent header is used to determine if a BlackBerry Browser is accessing a web page. The following examples demonstrate how the User-Agent can appear:
For a BlackBerry® 7290 smartphone running BlackBerry® Device Software 4.0.2, the User-Agent appears as follows:
The User-Agent headers look identical for the BlackBerry Browser, Internet Browser, Hotspot Browser and Wireless Access Protocol (WAP) Browser that could be running on the same BlackBerry smartphone. These can be differentiated by using the via header. The following are examples of the via header for all four browser types:
The specifications used for the BlackBerry smartphone and BlackBerry Device Software can be found through the use of the profile header. The profile header provides a link to an Extensible Markup Language (XML) document that describes the specifications and supported features of the BlackBerry smartphone accessing the page. The following example shows how a profile header can appear:
Each BlackBerry Browser user can also be uniquely identified. A BlackBerry® Mobile Data Service administrator can configure a BlackBerry Mobile Data Service server to send a BlackBerry smartphone user’s email address and personal identification number (PIN) with each Hypertext Transfer Protocol (HTTP) request from a BlackBerry Browser. The BlackBerry Mobile Data Service can also be configured to send this information to a certain domain, such as a corporate intranet. If configured, the email address and PIN are sent as headers in the HTTP request and appear as follows:
Note: The Rim-device-email and Rim-device-id parameters can only be sent when using the BlackBerry Browser, and are not available when using the WAP or the BlackBerry® Internet Service Browser.
The BlackBerry Mobile Data Service Simulator can be configured to send the email address and PINs of a BlackBerry Simulator with each HTTP request from the BlackBerry Browser. To do so, you must edit the rimpublic.property file located in the MDS\config directory and modify the line under the “#[HTTP HANDLER]” header. You must also specify the value you wish to send, as shown below:
Note: BlackBerry Device Software 4.0 and later support the email.pin parameter. In earlier versions, you must choose either email or pin.
The BlackBerry Mobile Data Service can be configured to only send the email address or PIN to specific domains, such as a corporate intranet. You can specify domains in the application.handler.http.header.domain parameter. This parameter accepts domains as a regular expression. The following example will send the email address or PIN to all rim.net subdomains: