Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry Workspaces
  3. BlackBerry Workspaces Server 12
  4. BlackBerry Workspaces Server Administration Guide
  5. Configuring integrations
  6. Workspaces Connector for BEMS

Workspaces Connector for BEMS

A new connector for BEMS has been developed to allow the BlackBerry Work Docs app to access BlackBerry Workspaces repositories. Available Workspaces repositories are shown in the Docs app, allowing the user to view files in the repository and use Workspaces locations as a place to save documents. The connector is able to:
  • List, create, and delete workspaces and folders
  • List, upload, download, and delete files
For example, a manager receives a sensitive document as an attachment in the Work email app. The manager can tap to download the attachment, then select
Save to Docs
 and choose a Workspaces location to save the file. From the Docs app, the manager can retrieve the file from the Workspaces location later.
Only local workspaces can be accessed, not transient workspaces.
Use the following steps to configure and deploy the Workspaces Connector for BEMS. If you upgrade BEMS, you must redeploy the Workspaces Connector after the upgrade.
The minimum requirements for the Workspaces Connector for BEMS are:
  • BlackBerry Enterprise Mobility Server (BEMS) 2.8.7 and later
  • BlackBerry Workspaces Server 6.0.0 and later
  1. Create an OAuth Client ID and details for the organization.
    You must be a Workspaces administrator and have access to Workspaces Rotisserie to perform this step. For some Workspaces clients, this step will need to be performed by BlackBerry Support.
    1. Log in to Workspaces Rotisserie at
      https://<workspaces server>/rotisserie
      , using a Workspaces admin email and password.
    2. Select the
      Identity Provider Manager
       tab (key icon at upper right).
    3. Select the
      OAuth Client Details
       tab.
    4. Click
      Create
       to create a new OAuth client.
    5. In the
      Client Id
       field, enter a client id. (e.g.,
      servername.bems
      )
    6. Click the key icon to the right of the
      Client Secret
       field to generate a key.
    7. Leave the default values as is in the
      Authorities
      ,
      Authorized Grant Types
      , and
      Access Token Validity
       fields.
    8. In the
      Webserver Redirect URI
       field, enter the Workspaces FQDN.
      This field is required for the BEMS Docs App to work properly.
    9. Click
      Create OAuth Client
      .
  2. Install the Workspaces Connector for BEMS.
    1. BlackBerry will provide a custom .jar (Java ARchive) file to the client, based on the Client ID configuration in the previous step.
    2. Copy the .jar file to the following BEMS server location.
      The location may be different depending on your BEMS installation. For example,
      C:\Program Files\BlackBerry\BlackBerry Enterprise Mobility Server\Good Server Distribution\gems-quickstart-x.x.x\deploy
    3. If the connector jar is deployed successfully then the
      Workspaces
       type will appear under the Storage Provider dropdown in BEMS.
  3. Add a new Workspaces connector in the BEMS dashboard.
    You must be a BEMS administrator to complete the following.
    1. Log in to BEMS dashboard at
      https://<bems_server>:8443/dashboard
      .
    2. Create a new Storage by selecting
      Home > Docs > Storages > New Storage
      .
    3. Enter a name for the storage (e.g., Workspaces).
    4. Select
      Workspaces
       from the
      Storage Provider
       drop down.
    5. Select
      OAuth2
       from the
      Authentication Provider
       drop down. The OAuth2 Base URL format depends on the user's authentication method. The Client ID and Client Secret were defined in the previous steps.
      • If the user uses OAuth2 or EID for authentication:
        https://
        <FQDN server>
        /saml-idp/oauth
      • If the user logs in with their email address and password:
        https://
        <FQDN server>
        /api/3.0/authentication
    6. To make the storage available on user devices, select
      Enable Storage
      .
    It may take up to an hour or a restart of the apps for storage changes to take effect on user devices. It may take up to five minutes for the changes to take effect on the server. Enabling and disabling storage providers on this page affects what storage resources are visible at any given time for users, but has no such impact on the server.
  4. Add a new Workspaces repository in the BEMS dashboard.
    1. Select
      Home > Docs > Repositories > New Repository
      .
    2. Add a name in the
      Display Name
       field (e.g., Workspaces).
    3. Select
      Workspaces
       from the
      Storage
       drop down.
    4. In the
      Path
       field, enter the path to the Workspace repository.
    5. Configure the rest of the form according to the steps documented in the Managing content connectors section.
    6. Click
      Save
      .
Once the Workspaces and BEMS configuration are complete, no additional setup is required on the Docs client. The Workspaces connector will be available automatically in the Docs app.
If you want to upgrade to a new version of the BEMS connector. Do the following:
  1. Go to the
    /gems-quickstart-x.x.x/deploy
     folder and delete the .jar file of the existing connector.
  2. Copy the .jar file of the new connector to the deploy folder.