Configuring a BlackBerry MDS Connection Service to trust web servers
You can configure the BlackBerry® MDS Connection Service to permit BlackBerry devices to pull application data and updates from trusted or untrusted web servers. If you want to open trusted connections between web servers and the BlackBerry MDS Connection Service, you must import the certificate for the web server into the JRE™ certificates keystore file (JRE cacerts).
The BlackBerry MDS Connection Service supports LDAP, OCSP, and CRL to retrieve certificates and certificate status, and HTTPS and SSL/TLS for connections that use trusted certificates.
Specify whether the BlackBerry MDS Connection Service requires trusted HTTPS connections from web servers
Specify whether the BlackBerry MDS Connection Service requires trusted TLS connections from web servers
- In the BlackBerry® Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view.
- Click MDS Connection Service.
- Click Edit component.
- On the TLS tab, in the Name field, type the name of a web server.
- In the Service URL field, type the regular expression for the web address of the web server.
- In the Settings section, in the Allow untrusted servers drop-down list, perform one of the following actions:
- Click the Add icon.
- Repeat steps 4 to 7 for each web server that you want to specify.
- Click Save all.
Configuring certificate server information for the BlackBerry MDS Connection Service
The certificate for the BlackBerry® MDS Connection Service permits push applications to make HTTPS connection to the BlackBerry MDS Connection Service. You can configure the BlackBerry MDS Connection Service to search for and retrieve certificates and the status of the certificates that external web servers use to make HTTPS connections.
To search for and retrieve certificates from an LDAP server, you can configure the BlackBerry MDS Connection Service to use LDAP or DSML. The BlackBerry MDS Connection Service searches each LDAP server using LDAP or DSML in the order that you specify. If you configure the BlackBerry MDS Connection Service to use both LDAP and DSML to search and retrieve certificates, the BlackBerry MDS Connection Service searches the servers using LDAP and then searches the servers using DSML. After the BlackBerry MDS Connection Service retrieves the certificate, the BlackBerry® Enterprise Server sends the certificate to the BlackBerry device, and the BlackBerry device displays the certificate so that the user can accept it. The BlackBerry MDS Connection Service supports DSML version 2.
To search for and retrieve the status of the certificates, you can configure the BlackBerry MDS Connection Service to search the OCSP servers or CRL servers. If you search for the status of the certificates using an OCSP server or a CRL server, which server you choose to search for the status of the certificates first does not matter because each server creates a prioritized list automatically.
For more information about certificates, see the BlackBerry Enterprise Solution Security Technical Overview.
Configure the LDAP servers that the BlackBerry MDS Connection Service uses to retrieve certificates
If you change the LDAP port number or host server information, you must stop and restart the BlackBerry MDS Connection Service so that the BlackBerry MDS Connection Service can use the new port number or host server information immediately.
- In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view.
- Click MDS Connection Service.
- On the LDAP tab, click Edit component.
- Perform one of the following tasks:
Task
Steps
Create an LDAP server configuration.
Change an existing LDAP server configuration.
- Click Save all.
LDAP server settings
Field |
Description |
|---|---|
Base Query |
This field specifies the base query for the default LDAP server. You can use %20 for spaces. Each LDAP server can host multiple Windows® domains but can search in only one Windows domain at a time. You might need to configure a default base query for some LDAP servers. |
Password and Confirm Password |
These fields specify a password if the LDAP server requires simple authentication. |
Query Limit |
This field specifies the maximum number of entries that you want to return for each query. |
| Service URL |
This field specifies the FQDN and port number of the LDAP server. You must use the <FQDN>:<Port> format. |
User name |
This field specifies the user name if the LDAP server requires simple authentication. |
Configure the BlackBerry MDS Connection Service to use DSML to retrieve certificates
- In the BlackBerry® Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view.
- Click MDS Connection Service.
- On the DSML tab, click Edit component.
- In the Protocol service information section, in the Query limit field, type the maximum number of certificates that the BlackBerry MDS Connection Service can retrieve during each search it performs.
- Perform one of the following tasks:
- Click Save all.
- To configure the BlackBerry MDS Connection Service to retrieve the status of certificates from an OCSP server or CRL server, you must configure the OCSP server and CRL server information.
- Add the communication information that you configured for the DSML server to the BlackBerry MDS Connection Service configuration set.
Configure the OCSP servers that the BlackBerry MDS Connection Service uses to retrieve the status of certificates
- In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view.
- Click MDS Connection Service.
- On the OCSP tab, click Edit component.
- Perform the following actions:
- Configure the BlackBerry MDS Connection Service to accept OCSP servers that BlackBerry devices specify.
- Perform one of the following tasks:
Task
Steps
Create an OCSP server configuration.
Change an existing OCSP server configuration.
- Click Save all.
Configure the CRL servers that the BlackBerry MDS Connection Service uses to retrieve the status of certificates
- In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry solution topology > BlackBerry Domain > Component view.
- Click MDS Connection Service.
- On the CRL tab, click Edit component.
- In the CRL Service information section, perform the following actions:
- Configure the BlackBerry MDS Connection Service to accept CRL servers that BlackBerry devices specify.
- Perform one of the following tasks:
Task
Steps
Create a CRL server configuration.
Change an existing CRL server configuration.
- Click Save all.
Add communication information to a BlackBerry MDS Connection Service configuration set
- In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view.
- Click MDS Connection Service.
- Click Edit component.
- On the Configuration Sets tab, perform one of the following actions:
- In the Priority Service group drop-down list, click the name of the service that you want to configure the communication method for.
- In the Service (Name : Description) drop-down list, click the name of the communication method that you want to configure.
- Click the Add icon.
- To specify the communication method that the BlackBerry MDS Connection Service should try to connect to the server with first , click the Up and Down arrows. The BlackBerry MDS Connection Service resolves conflicts by applying communication methods in the order that you specify. The order of that you specify for LDAP, DSML, or file communication applies to each communication method separately. The order permits the BlackBerry MDS Connection Service to resolve conflicts between domains if you created multiple communication methods for a specific URL.
- Perform one of the following actions:
- Click Save all.
Assign a BlackBerry MDS Connection Service configuration set to a BlackBerry MDS Connection Service instance
- In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view.
- Click MDS Connection Service.
- Click the instance that you want to change.
- Click Edit instance.
- On the Component Configuration Sets tab, in the Available component configuration sets section, in the Service configuration sets drop-down list, click the configuration set that you want to assign to the BlackBerry MDS Connection Service instance.
- Click Save all.
- To restart the BlackBerry MDS Connection Service instance, on the Instance information tab, in the Status list, click Restart instance.
- To assign the BlackBerry MDS Connection Service configuration set to another BlackBerry MDS Connection Service instance, repeat steps 3 to 7.
Add a retrieved certificate for a web server to the key store
- Save the certificate from a secure web site to a .cer file.
- On the computer that hosts the BlackBerry MDS Connection Service, copy the .cer file to <drive>:\Program Files\Java\<JRE_version>\lib\security.
- At a command prompt, navigate to <drive>:\Program Files\Java\<JRE_version>\bin.
- Type keytool -import -trustcacerts -alias <alias_name> -file <cert_filename> -keystore cacerts.
- Type the key store password.
- To add the certificate to the key store, at the command prompt, type Yes.