Monday, February 11, 2008

Managing the BlackBerry Device Firewall Remotely... Possible?

Over the past few weeks as I was playing with setting device options remotely, I made a few mental notes when encountering databases (i.e. configurations) backed up to the SQL db. One of these was 'Firewall Options'.

I particularly noted this one because I have been looking for a solution to the firewall popups that appear on our user's devices. Overall of course the firewall is a good thing, but I like to keep the experience of our users seamless whenever possible, and incomprehensible (to the user) firewall popups do not make for a seamless experience.

One example of this is the RSA SecurID software for our BlackBerry devices, which we deploy so our users do not need to carry around a hardware token. The first thing this software does when installed on the device is listen for a software token which is wirelessly pushed to the device via a separate app.

This listening process constitutes a 'server' on the device, so upon installation we see the following firewall popup:



Now if I am pushing this software from the server to a device out in the field, then based on this screen the end user will be confused as to what to do. 80% of the time they may choose correctly and scroll down to click allow, but that other 20% may result in a support call.

So is it possible to:

1) Set the 'Allow' rule in the device's 'Firewall Settings' database in SQL
2) Push the 'Firewall Settings' configuration down to the device
3) Push the application and have it immediately begin listening for a token without user input?

Let's find out!

First we will monitor the SYNC log again to see if anything gets backed up to the server when an option on this firewall prompt is selected.

The first thing I notice is that if I leave the "Don't ask this again for:" box unchecked, then nothing happens... I see no log entries on the server side. If I reset the app and enable the listener again, this time choosing to check the box, however:


... voila! I do see something coming through to the server:

[60000] (02/11 11:50:51.111):{0x1710} [ODBCRecord::DoSetValue] DATA = "DbVersion[0] Data[0x270000010107536563757249440001046874747000020000000005000004000003000002000001000000] UserConfigID[17] DatabaseName[Firewall Options] UID[1] ".

This tells me that my hunch was correct, and that any saved settings are stored in the 'Firewall Options' configuration, and therefore backed up to the server. Good news!

So let's now reset everything and query the 'Firewall Options' configuration to see the default value as compared to the updated settings:

0x1100000005000004000003000002000001000000 (Default)
0x270000010107536563757249440001046874747000020000000005000004000003000002000001000000 (RSA Allowed)


It looks like the first numbers were changed from 11 to 27, then a bunch of numbers were inserted, extending the configuration string. I am guessing that this new set of numbers uniquely identifies the SecurID server application and the 'Allow' setting I chose.

If we reset the app, then choose 'Deny' here is what the string becomes:

0x270000010107536563757249440001046874747000060000000005000004000003000002000001000000

Everything is the same except for a single number, the '2' about 2/3 of the way through the string has changed to a '6'. So perhaps a '2' means allow, and a '6' means deny. Let's try clearing everything out, and then pushing the 'allow' string to the device before the software push:

use BESConfig
UPDATE SyncBackupRestore SET Data=0x270000010107536563757249440001046874747000020000000005000004000003000002000001000000 WHERE UserConfigID = 17 AND DatabaseName = 'Firewall Options'
UPDATE SyncConfig set SyncType=1 WHERE UserConfigId = 17 AND SyncDataSourceId=11109
go


Now we reload the application, and...


Bummer.

Guess I'll have to keep digging on this one...

[Update 2/13/08]
I have been gently reminded of the use of application control policies by a fellow blackberryforums.com member, ACJones. By setting a policy on the software configuration for the RSA SecurID software, and modifying the 'Internal Network Connections' option from 'Prompt' to 'Allow', you can avoid the initial firewall prompt completely upon OTA installation!



I have tested this and it works flawlessly. Thanks AC!

Wednesday, February 6, 2008

Managing BlackBerry Configuration Settings Remotely - Putting it all Together

Now that we know how to update the device settings, let's see how it works in a real world scenario. I have just nuked, reloaded, and reactivated my test 8700g with 4.2 OS - here is the before shot of the relevant configuration screens:


Now let's push down some common changes to our device settings:

1. [Messages Options / General Options] Hide Filed Messages = Yes (default = No)
2. [Messages Options / General Options] Hide Sent Messages = Yes (default = No)
3. [Messages Options / General Options] Keep Messages = Forever (default = 30 Days)
4. [Messages Options / Email Reconciliation] Delete On = Mailbox & Handheld (default = Handheld)
5. [Calendar Options] Initial View = Week (default = Day)
6. [Calendar Options] Keep Appointments = Forever (default = 60 Days)
7. [Address Book Options] Sort By = Last Name (default = First Name)
8. [Options / Date/Time] Time Zone = Central Time (-6) (default = Casablanca (GMT))
9. [Options / Screen/Keyboard] Backlight Timeout = 2 Min. (default = 30 Sec.)

These modifications will require the following sequence of SQL updates (you will need to replace the '15' UserConfigID with your target account's UserConfigID in your SQL DB) :

use BESConfig
UPDATE SyncBackupRestore SET Data = 0x550000010101000001010101000301010800014465736B746F70000A000
2543336323538313330000100030101000A00020005FFFF01000601020008
01000100090102000B000002000C000002000D000001000E00000000
WHERE UserConfigID = 15 AND DatabaseName = 'Message List Options'
UPDATE SyncBackupRestore SET Data = 0x270000000000001C02FC0300000000010000000F0000000101000500000
00100FFFF0000000F00000001 WHERE UserConfigID = 15 AND DatabaseName = 'Calendar Options'
UPDATE SyncBackupRestore SET Data = 0x0A000001010100000000000100 WHERE UserConfigID = 15 AND DatabaseName = 'Address Book Options'
UPDATE SyncBackupRestore SET Data = 0x040001000000000400021400000001000302 WHERE UserConfigID = 15 AND DatabaseName = 'Options' AND UID = -447168820
UPDATE SyncBackupRestore SET Data = 0x1000019A71C67ACBC67AB400000002000000000E00018131D8CDC28BB8
B90000000700000D0001D30CB969B820BFDD0000000600100001C2C1986B
11CE32B000000002000000780D0001BDAAFA49FFAD48CC00000006011000
013E3CBC03163D39CF00000002000001C24F0001CB2088784AFC39CC0000
000000416A6176613A2F6E65742E72696D2E6465766963652E7468656D652
E626264696D656E73696F6E5F7A656E5F333230783234305F772E5468656D
65466163746F72790D0001416028234B233EA70000000600100001F5006E1
93847CE260000000200000001100001BD91E3D465E4816900000002000000
00100001EBB9DE74CE5F773800000002000000322600011F0091A81B93E1C
30000000000186E65745F72696D5F6170706C69636174696F6E5F6D656E75
08000138D4D5F7DC80C5472E0001DA36AA198C1233A40000000000206E65
745F72696D5F62625F70726F66696C65735F6170702E50726F66696C65734
F00019B05812B5A1A15DC0000000000416A6176613A2F6E65742E72696D2
E6465766963652E7468656D652E626264696D656E73696F6E5F7A656E5F33
3230783234305F772E5468656D65466163746F72790D0001F33AFBD074DB0
7F100000006001000016B506A6FCD9D596A00000002000000011000012ECB
C575BEF57F3E00000002000000C80D0001094AC736D16697C800000006001
000011762E2440C4D5D510000000200000064080001E8D6CB484814CA60
WHERE UserConfigID = 15 AND DatabaseName = 'Options' AND UID = -1321243196
UPDATE SyncConfig set SyncType=1 WHERE UserConfigId=15 AND SyncDataSourceId=11109
go


This will kick off a one way sync from the server to the device, pushing all the configuration databases managed by the Backup component. It will take less than a minute for the SYNC process to pick up on this change, and about another 30 seconds or so to re-sync all the settings. [sleep 120] Now back to our handheld... it appears that all changes (in green boxes) have been picked up:


Now we must be sure to run the following command to restore the device to server synchronization:

UPDATE SyncConfig set SyncType=3 WHERE UserConfigId=15 AND SyncDataSourceId=11109

If we didn't do this, then any configuration updates from the handheld would not be backed up to the server. Actually, this might be an interesting option to employ for some firms who want total control over the handheld... one could schedule a daily push to refresh settings to the organizational standard settings to discourage end-user customization.

All of these commands could be easily scripted by putting them in a text file such as 'PushSettings.sql' and using the OSQL command's -i switch, i.e.:

osql -S sqlservername.company.com -U sqlaccountname -P sqlpassword -i PushSettings.sql

So that's it... We've gone down the rabbit hole into the depths of the BES SQL DB in order to discover some of it's secrets, and we came away with a method of pushing normally hidden device configuration settings over the air. Have fun, but remember to backup your SQL database regularly and TEST TEST TEST your scripts outside of production first!

Monday, February 4, 2008

Managing BlackBerry Configuration Settings Remotely - Part Five

Here are the options for the Calendar, first with default settings, then with the individual options enabled along with the resulting Data string:


[Default Settings Above]
0x270000FFFFFFFF1C02FC030000000001000000
0F0000000001000500000001003C000000000F00000001

[Initial View: Week]
0x270000000000001C02FC030000000001000000
0F0000000
101000500000001003C000000000F00000001

[Initial View: Month]
0x270000000000001C02FC030000000001000000
0F0000000
201000500000001003C000000000F00000001

[Initial View: Agenda]
0x270000000000001C02FC030000000001000000
0F0000000
301000500000001003C000000000F00000001

[Initial View: Last]
0x270000000000001C02FC030000000001000000
0F0000000
401000500000001003C000000000F00000001

[Enable Quick Entry: No]
0x270000000000001C02FC030000000001000000
0F000000000
0000500000001003C000000000F00000001

[Default Reminder: None]
0x270000000000001C02FC030000000001000000
FFFFFFFF0001000500000001003C000000000F00000001

[Default Reminder: 0 Min]
0x270000000000001C02FC030000000001000000
0
00000000001000500000001003C000000000F00000001

[Default Reminder: 1 Hour]
0x270000000000001C02FC030000000001000000
0
3C000000001000500000001003C000000000F00000001
(Minutes in hex: 3C = 60 decimal)

[Default Reminder: 1 Week]
0x270000000000001C02FC030000000001000000
0
60270000001000500000001003C000000000F00000001
(Minutes in transposed hex: 2760 = 10080 decimal ; 10080/ 60 = 168 hours / 24 = 7 days)

[Snooze: None]
0x270000000000001C02FC030000000001000000
0F000000000100
FFFFFFFF01003C000000000F00000001

[Snooze: 1 Min]
0x270000000000001C02FC030000000001000000
0F0000000001000
100000001003C000000000F00000001

[Snooze: 10 Min]
0x270000000000001C02FC030000000001000000
0F0000000001000
A00000001003C000000000F00000001

[Snooze: 30 Min]
0x270000000000001C02FC030000000001000000
0F000000000100
1E00000001003C000000000F00000001

[Start of Day: 8 AM]
0x27000000000000
E001FC030000000001000000
0F0000000001000500000001003C000000000F00000001
(Minutes past midnight in transposed hex: 01E0 = 480 decimal ; 480/60 = 8 hours)

[End of Day: 6 PM]
0x270000000000001C02
38040000000001000000
0F0000000001000500000001003C000000000F00000001
(Same as above, 0438 = 1080 decimal ; 1080/60 = 18 hours or 6 PM}

[First Day of Week: Mon]
0x2700000
10000001C02FC030000000001000000
0F0000000001000500000001003C000000000F00000001

[First Day of Week: Tue]
0x2700000
20000001C02FC030000000001000000
0F0000000001000500000001003C000000000F00000001

[Confirm Delete: No]
0x270000000000001C02FC030000000000000000
0F0000000001000500000001003C000000000F00000001

[Show Free Time in Agenda View: No]
0x270000000000001C02FC030000000001000000
0F0000000001000500000001003C0000000
10F00000001

[Show End Time in Agenda View: No]
0x270000000000001C02FC030000000001000000
0F0000000001000500000001003C000000000F0000000
0

[Keep Appointments: 15 Days]
0x270000000000001C02FC030000000001000000
0F000000000100050000000100
0F000000000F00000001

[Keep Appointments: Forever]
0x270000000000001C02FC030000000001000000
0F000000000100050000000100
FFFF0000000F00000001

[Wireless Synchronization: No]
0x270000000000001C02FC030000000001000000
0F000000000100050000000
0003C000000000F00000001

[Show Tasks: Yes]
0x270000000000001C02FC030000000001000000
0F0000000001000500000001003C000
100000F00000001


Now for the Address Book:


[Default Settings Above]
0x0A000001010000000000000100

[Sort By: Last Name]
0x0A000001010
100000000000100

[Sort By: Company]
0x0A000001010
200000000000100

[Confirm Delete: No]
0x0A0000010
00000000000000100

[Allow Duplicate Names: No]
0x0A000000010000000000000100

[Wireless Synchronization: No]
0x0A000001010000000000000
000


And finally, Tasks:


[Default Settings Above]
0x0F000000000000000000000101FFFFFFFF01

[Sort By: Priority]
0x0F000001000000000000000101FFFFFFFF01

[Sort By: Due Date]
0x0F000002000000000000000101FFFFFFFF01

[Sort By: Status]
0x0F000003000000000000000101FFFFFFFF01

[Confirm Delete: No]
0x0F000000000000000000000001FFFFFFFF01

[Snooze: 1 Min]
0x0F0000000000000000000001010100000001

[Snooze: 10 Min]
0x0F0000000000000000000001010A00000001

[Snooze: 30 Min]
0x0F0000000000000000000001011E00000001

[Wireless Synchronization: No]
0x0F000000000000000000000101FFFFFFFF00