Welcome to the official BlackBerry Support Community Forums.

This is your resource to discuss support topics with your peers, and learn from each other.

inside custom component

Testing and Deployment

Add an email address and PIN to HTTP requests from the BlackBerry Mobile Data Service

by Retired on ‎02-17-2010 03:53 PM - edited on ‎10-31-2013 12:49 PM by BlackBerry Development Advisor (7,486 Views)



This article applies to the following:

  • BlackBerry® Mobile Data Service
  • BlackBerry® Browser





Note: This is not currently supported on BlackBerry Enterprise Server 10.


You can include a BlackBerry smartphone personal identification number (PIN) and email address to the Hypertext Transfer Protocol (HTTP) headers for requests originating from the BlackBerry Mobile Data Service.


In the rimpublic.property file, under the [HTTP HANDLER] heading, do one of the following:

  • To add a PIN, add the following line:


  • To add an email address, add the following line:


  • To add both a PIN and an email address, add the following line:

    application.handler.http.header=email,pin (applies to BlackBerry Mobile Data Service 4.0 and later only)

If you want to keep the PIN and email address private, restrict the additional headers to specific domains. For example, to add headers to requests that are only destined for acme.com or acme.net domains, add the following line to the rimpublic.property file:




           The two additional values are required for the root domain. acme.net and acme.com will not be   included in the specific domain list if only .+\.acme\.net;.+\.acme\.com are the listed values.



The headers will appear as follows:


     Rim-device-email: <user_name>@acme.com


     im-device-id: <PIN>


Note: To include an email address in the HTTP headers, the BlackBerry Mobile Data Service relies on the PIN to email address mapping, which resides in the BlackBerry Configuration Database. Therefore, the BlackBerry Database Consistency Service must be running so that the PIN to email address mapping is kept up-to-date.



Additional Information


The rimpublic.property file can usually be found in the following locations:


     For the BlackBerry Enterprise Server (BlackBerry Mobile Data Service)


  C:\Program Files\Research In Motion\BlackBerry Enterprise Server\MDS\Servers\<MDS Server Name>\config


     For the simulator


  C:\Program Files\Research In Motion\BlackBerry JDE 4.0\MDS\config

Users Online
Currently online: 28 members 1,126 guests
Please welcome our newest community members: