Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry Web Services 12.13
  3. BlackBerry Web Services OAuth Implementation Guide
  4. Using OAuth with a third-party app in a cloud environment
  5. Configure the app resources in BlackBerry Online Account

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
For all tasks that involve the use of 
BlackBerry Online Account
, see the BlackBerry Online Account User Guide for complete instructions.
  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.