Skip Navigation

Data flow: Activating
BBM Enterprise
on a device

Data flow: BBM Enterprise activation
  1. You perform the following actions:
    1. Create a
      BBM Enterprise
      profile.
    2. Review the
      BBM Enterprise
      activation email template and modify it if necessary.
    3. Add a user to
      BlackBerry UEM
      as a local user account or using the account information retrieved from your company directory.
    4. Assign the
      BBM Enterprise
      profile to a user.
      UEM
      pushes the assigned
      BBM Enterprise
      profile through the
      BlackBerry Infrastructure
      to
      BBM Enterprise
      .
    5. UEM
      pushes the assigned
      BBM Enterprise
      profile through the
      BlackBerry Infrastructure
      to
      BBM Enterprise
      .
    6. Use one of the following options to provide the user with activation details:
      • Automatically generate a device activation password and send an email with activation instructions for the user.
      • Set a device activation password and communicate the username and password to the user directly or by email.
      • Don't set a device activation password and communicate the
        BlackBerry UEM Self-Service
        address to the user so that they can set their own activation password.
  2. The user downloads and installs
    BBM Enterprise
    on their device. After it is installed, the user opens
    BBM Enterprise
    and enters the email address and activation password. If provided, the user can click a link in the activation email to be taken directly to
    BBM Enterprise
    .
  3. The
    BBM Enterprise
    client on the device performs the following actions:
    1. Establishes a connection to the
      BlackBerry Infrastructure
    2. Sends a request for activation information to the
      BlackBerry Infrastructure
      .
  4. The
    BlackBerry Infrastructure
    performs the following actions:
    1. Verifies that the user is a valid, registered user.
    2. Retrieves the
      UEM
      address for the user.
    3. Sends the address to the
      BBM Enterprise
      client.
  5. The
    BBM Enterprise
    client performs the following actions:
    1. Establishes a connection with
      UEM
      using HTTP Connect over port 443.
    2. Generates a shared symmetric key that is used to protect the CSR (certificate signing request) and responds to
      UEM
      using the activation password and EC-SPEKE.
    3. Creates an encrypted CSR and HMAC as follows:
      • Generates a key pair for the certificate.
      • Creates a PKCS#10 CSR that includes the public key of the key pair.
      • Encrypts the CSR using the shared symmetric key and AES-256 in CBC mode with PKCS#5 padding.
      • Computes an HMAC of the encrypted CSR using SHA-256 and appends it to the CSR.
      • Sends the encrypted CSR and HMAC to BlackBerry UEM.
  6. UEM
    performs the following actions:
    1. Verifies the HMAC of the encrypted CSR and decrypts the CSR using the shared symmetric key.
    2. Retrieves the username, work space ID, and your organization’s name from the
      UEM
      database.
    3. Packages a client certificate using the information it retrieved and the CSR that the device sent.
    4. Signs the client certificate using the enterprise management root certificate.
    5. Encrypts the client certificate, enterprise management root certificate, and the
      UEM
      URL using the shared symmetric key and AES-256 in CBC mode with PKCS#5 padding.
    6. Computes an HMAC of the encrypted client certificate, enterprise management root certificate, and the
      UEM
      URL and appends it to the encrypted data.
    7. Sends the encrypted data and HMAC to the device.
  7. The
    BBM Enterprise
    client performs the following actions:
    1. Verifies the HMAC.
    2. Decrypts the data it received from
      UEM
      .
    3. Stores the client certificate and the enterprise management root certificate encrypted in
      BBM Enterprise
      .
    4. Sends the device information (if it is available) and
      BBM Enterprise
      software information to
      UEM
      .
  8. The
    UEM Core
    assigns the
    BBM Enterprise
    device to a
    UEM
    instance in the domain.
  9. The
    BBM Enterprise
    client performs the following actions:
    1. Retrieves a SCEP profile from
      UEM
      . This profile is used to trigger an assisted SCEP procedure in order to obtain a device-specific certificate, which will be used to access
      UEM
      and servers that are providing
      BBM Enterprise
      services.
    2. The
      BBM Enterprise
      snap-in returns a SCEP profile (default or configured).
    3. The
      BBM Enterprise
      client performs an assisted SCEP operation against the
      BlackBerry Enterprise Identity
      service mediated by
      UEM
      .
    4. The resulting certificate, specific to a
      BBM Enterprise
      device, is sent back to the
      BBM Enterprise
      client.
  10. The activation process is complete.
  11. The
    BBM Enterprise
    client uses the device certificate to connect to the
    BBM Enterprise
    infrastructure and retrieves the
    BBM Enterprise
    policy configured for the user and completes the activation.