Add a content connector

To add a connector for SharePoint Online, verify the following:
  • You have a copy of a generated public and private key pair certificate in the .pem format. You can use a self-signed certificate or from an existing CA server.
  • You have created an app registration in Entra that BlackBerry Workspaces can use to authenticate with Entra. For more information, see Create an app registration in Entra
  • You have recorded the Tenant ID and Application (client) ID. For more information, see Create an app registration in Entra.
  1. In the left pane, click Content Connectors.
  2. Click The Add icon.
  3. In the Repository Type list, click the type of connector that you want to configure.
  4. In the Connector display name box, type a name for the connector.
  5. In the Allowed path field, type the root path of the repository.
    • If you selected Alfresco, the allowed path should match the CMIS service URL. For example: http://<server ip or FQDN>:8080/alfresco/api/-default-/public/cmis/ versions/1.1/atom/
      You can add a relative path to the end of the service URL; however, do not use the Alfresco site or shared files location in the allowed path. Refer to the Alfresco documentation (https://community.alfresco.com/docs/DOC-5527-cmis#w_cmisserviceurl), section 3.1, CMIS Service URL for more details.
      Note: If the Alfresco connector URL changes when upgrading the Alfresco server, the connector and all associated workspaces will need to be recreated.
    • If you selected OneDrive for Business, the allowed path should match the root FQDN of the OneDrive site.
    • If you selected SharePoint or SharePoint Online, the allowed path can be either a site URL or a document library path.
  6. If you selected SharePoint or Windows File Share and your organization uses Kerberos Constrained Delegation (KCD), select Enable KCD.
  7. In the Provide access to section, select one of the following:
    • All organization: All workspace owners (users that are assigned the "Workspace owner" role) in the organization can access this repository.
    • An individual user: Only users that are assigned the "Individual connector workspace owner" role can access this repository.
  8. In the UCC credentials section:
    • If your organization is working with Appliance-X, the UCC credentials are auto-populated and need not be changed.
    • If your organization is working with a Cloud service (i.e., manual installation), for Alfresco, SharePoint and Windows File Share connectors, click Edit to enter the required BEMS URL, Username, and Password.
  9. If you selected Microsoft SharePoint Online, in the Azure Credentials section, type the following information.
    • Azure Tenant ID: This is the Directory (tenant) ID that was generated by the Entra app registration. For more information, see Create an app registration in Entra.
    • Azure Client ID: This is the Application (client) ID that was created during the app registration.
    • Public Certificate: Paste the public certificate key that was created. Include the Begin and End Certificate request lines.
    • Certificate Private Key: Paste the private certificate key information. Include the Begin and End Certificate request lines.
  10. Click Add.
To manage the connector, click the connector in the Content Connectors list and do one of the following:
  • Click Verify to test the connector with the external repository, cli.
  • Click Edit and make the necessary changes.
  • Click Delete to remove the connector.