Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry Enterprise Mobility Server 3.7
  3. Configuring BlackBerry Mail
  4. BlackBerry Mail (BEMS Push Notifications service)
  5. Configure the Certificate Directory Lookup

Configure the Certificate Directory Lookup

The Certificate Directory Lookup service retrieves S/MIME digital certificates from the user's
Microsoft Active Directory
. These certificates enable email encryption and signature functionality in
BlackBerry Work
 apps. For more information about configuring and using S/MIME on devices, see the
BlackBerry Work
 Tasks, and Notes Administration Guide.
  1. In the
    BlackBerry Enterprise Mobility Server Dashboard
    , under
    BlackBerry Services Configuration
    , click
    Mail
    .
  2. Click
    Certificate Directory Lookup
    .
  3. Optionally, select the
    Include expired certificates in results
     checkbox.
  4. By default, the
    Enable Contact Lookup
     checkbox and
    Enable GAL Lookup
     checkbox are selected. If you clear the
    Enable GAL Lookup
     checkbox, users can't send encrypted email messages to public distribution lists and private or personal distribution lists (for example, distribution lists in the user’s contact folder).
  5. Optionally, select the
    Enable LDAP Lookup
     checkbox to use LDAP lookup to validate digital certificate connections to the LDAP server.
    1. In the
      LDAP Server Name
       field, type the name of the LDAP Server. For example, ldap.<
      DNS_domain_name
      >.
    2. In the
      LDAP Server port
       field, type the port number of the LDAP Server. By default, the port number is 389.
    3. Optionally, select the
      Enable SSL LDAP
       checkbox to tunnel data through an SSL-encrypted connection. If you enable SSL LDAP, the port number defaults to 636. This step requires you to import the LDAP certificate chain into the BEMS dashboard. For instructions, see "Upload the SSL certificate to the BEMS database" in the BEMS-Core configuration content.
    4. Optionally, edit the
      LDAP User Name Query Template
       field. The LDAP user name query searches for a user by their user name. BEMS replaces the "{key}" with the user name when performing the query. The default template is 
      (&(|(mail=*{key}*)(name=*{key}*)(displayName=*{key}*)(sAMAccountName=*{key}*) (givenName=*{key}*)(sn=*{key}*))(objectClass=user)(objectCategory=person)(!(userAccountControl:1.2.840.113556.1.4.803:=2)))
    5. Optionally, in the
      LDAP Base DN
       field, provide a base DN for the LDAP search. BEMS will try to find the base DN in the namingContexts attribute if this entry is not set. If this field is not completed, BEMS tries to find the base DN in the namingContexts attribute.
    6. In the
      Authentication Type
       drop-down list, select an authentication type. By default, the Authentication Type is Anonymous.
      • If you select
        Basic
        , enter the LDAP Logon User name and password. In a Microsoft Active Directory environment, enter the username in the format
        domain\username
         or User Principal Name (UPN)
        username@domain
        .
      • If you selected the
        Enable SSL LDAP
         checkbox and select
        Client Certificate
         authentication, enter the keystore password and certificate file.
    7. Optionally, specify the timeout before the BEMS connection attempt to the LDAP server times out. In the
      LDAP Connection Timeout
       field, increase or decrease the value, in seconds, as required. The default value is 30 seconds. You can specify between zero and 300 seconds. 
    8. Optionally, specify the timeout before the BEMS search for users and their S/MIME digital certificates from the users’ Active Directory times out. In the
      LDAP Search Timeout
       field, increase or decrease the value, in seconds, as required. The default value is 30 seconds. You can specify between zero and 300 seconds.
    9. In the
      End User Email Address
       field, type an end-user email address to search for.
    10. Click
      Test
      .
  6. Click
    Save
    . 
If you selected
Certificate
 authentication, you can view the certificate information. Click
Certificate Directory Lookup
. The following certificate information is displayed:
  • Subject
  • Issuer
  • Validation period
  • Serial number