Prerequisites for connecting to Blackberry

This section describes prerequisite procedures you need to perform before you can start connecting to Blackberry.

NOTE—You must have the role Security Administrator to perform these tasks.

Step 1: Add the app

1. Log in to https://myaccount.blackberry.com.

2. Go to Applications.

3. In the Organization tab, click Add Application.

4. In the Add Application screen, fill in the app's details:

   1. Enter a name for the app, for example, Knox E-FOTA.

   2. In Entitlement ID, enter a unique ID in reverse DNS notation, for example, com.mycompany.myproject.

   3. In Capabilities, select Blackberry Platform APIs.

   4. Fill in the other fields as needed.

5. Click Add Application.

   The app is added to the Applications list.

Step 2: Create a client ID and client secret in Blackberry

This is a continuation of the previous procedure.

1. Log in to https://myaccount.blackberry.com if you're not already logged in.

2. Select your newly created app from the Applications list.

3. Add a template for your application:

   1. Under Blackberry Platform APIs > Template, click Add Template.

   2. In the next screen, fill in the template's details:

      1. In Redirect URLs, enter https://localhost:9443/cb.

      2. In Type, select web.

      3. In Grant Type, select client_credentials.

      4. In Response Types, select none.

      5. In Token Endpoint Auth Method, select client_secret_basic.

      6. In API Scopes, select Mobile Device Management.

      7. Fill in the other fields as needed.

   3. Click Register.

      The template is added.

4. In the Client tab, click Add Client.

5. Fill in the client's details:

   1. Enter a name for the client, for example, Knox E-FOTA.

   2. In Tenants, select the Blackberry instance you want to register the client to, and click >.

      The tenant ID you selected moves to the Selected box.

6. Click Register.

   The client's details are displayed, including details you need to connect to Blackberry from the Knox Admin Portal.

   TIP—Click Download in the upper-right corner of the screen to download the client's details in JSON format.

Step 3: Add the app as an OpenID Connect app

1. Log in to the Blackberry UEM for the particular tenant you registered the client to.

2. In Settings > Blackberry Enterprise Identity, click Services.

3. Under OpenID Connect apps, click the + icon, and select the app you created.

4. Click Save.

Step 4: Assign an admin to the web service client

1. Log in to the Blackberry UEM for the particular tenant you registered the client to if you're not already logged in.

2. If the admin user you want to assign to the client doesn't exist yet, create one:

   1. In Users, click Add user.

   2. Fill in the user details.

   3. Click Save.

      The newly created user is added to the All users list.

   4. In Settings > Administrators, click Users.

   5. In the upper-right corner of the screen, click the icon to add a user.

   6. Search for the user you created and select it.

   7. Ensure that the role selected is Enterprise Administrator.

   8. Click Save.

3. In Settings > Administrators, click Web service clients.

4. In the table, find the client you added.

5. In the Administrator column for that client, select the administrator you created.

6. Click Assign.

Step 5: On-premise environment: Enable access to the BlackBerry Web Services APIs

If your on-premise environment restricts access through port 18084, you must perform this procedure.

1. Log in to the Blackberry UEM for the particular tenant you registered the client to if you're not already logged in.

2. In Settings > General settings, click BlackBerry Web Services access.

3. Click Enable.