Configure the app resources in BlackBerry Online Account

Complete this task in your BlackBerry Online Account to:
  • Add the details of the app (name, description, entitlement ID, version, capabilities)
  • Create a client template that defines the default settings for all clients that belong to the app
  • Use the client template to define the app client and generate a unique client ID (and if applicable, client secret) that the app can use to connect to UEM and invoke the REST APIs
  • Entitle the app to your customer
  1. Log in to BlackBerry Online Account.
  2. On the menu bar, click Applications. On the Organization tab, click Add Application.
  3. Specify the app details. In the Capabilities section, select the BlackBerry Platform APIs check box only (unless you are making changes to an existing app that uses other capabilities). For example:
    • Name: BB Sample 3rd Party Cloud App
    • Entitlement ID: com.domain.bb.sample.ua
    • Entitlement version: 1.0.0.0
    • Type: Application or Solutions
    • Capabilities: BlackBerry Platform APIs
  4. Click Add Application.
  5. On the BlackBerry Platform APIs tab for the app, on the Template tab, click Add Template.
  6. Specify the template details. Specify or select the following options:
    • Redirect URLs: the app web page address that BlackBerry Enterprise Identity will invoke as a browser redirect for user authentication (for example, https://localhost:9443/cb)
    • Type: web
    • Grant Type: recommend authorization_code or authorization_code,refresh_token
    • Response Types: code
    • Token Endpoint Auth Method
      • To generate a client secret code, click client_secret_basic.
      • To require the generation of a public/private key pair, click private_key_jwt.
    • Application Scope: Global (this option prevents your customer from creating additional app clients in the organization’s BlackBerry Online Account; your customer will use the app client that you define)
    • API Scopes: Mobile Device Management

    The SampleWithAuthorizationCodeAndClientSecretRefreshToken.ps sample demonstrates the use of the authorization_code grant type with the use of a refresh token that can be used to request a new access token from BlackBerry Enterprise Identity on expiry. The refresh token expiry is 1 year, and it must be stored securely. A new refresh token is provided with a new access token.

  7. Click Register.
  8. On the BlackBerry Platform APIs tab for the app, on the Client tab, click Add Client.
  9. Specify the required information.
  10. Click Register.
    The client ID (and if applicable, the client secret) is generated. The client app will use the client ID and either a client secret or private key (depending on the configuration) to connect to the BlackBerry Web Services REST APIs.
  11. On the menu, click Manage Customers.
  12. Click a customer.
  13. In the Publishing Status column, click the UNPUBLISHED check box to entitle the app to your customer.
Develop the client app.