Skip to main content
Skip table of contents

Prepare to use the SharePoint Online Connector

These instructions are provided for convenience.  Registering the SharePoint App and creating the catalog are out of scope for Gimmal Support.  Please contact your SharePoint Online or Microsoft 365 administrator for help completing these tasks.

You cannot configure the SharePoint Online Connector app (effectively the same O365 tenant) to work with two different instances of Records Management. You must provide distinct Microsoft 365 tenants to accomplish this requirement. For example, https://test-company.sharepoint.com is registered to https://test.recordlion.netand https://company.sharepoint.com is registered to https://app.recordlion.net

Registering the SharePoint App

For the SharePoint Online Connector (SPOC) to be able to connect to SharePoint Online using OAuth, the app identity needs to be registered with Microsoft Azure Access Control Service (ACS) and the SharePoint App Management Service of the tenancy. To register the app, perform the following steps:

  1. Navigate to the following location: http://{your_sponline_url_to_any_sitecollection}/_layouts/15/appregnew.aspx

    The following page displays, where you will provide the necessary configuration information described below.


  1. Prior to clicking Create in the next step, copy the Client ID and Client Secret to a file because they will be used when installing the Web and Services components of the SharePoint Online Connector. This file must be stored in a secure location so it can be referenced for future upgrades.

  2. Make note of the Client ID and Client Secret in a secure location as they will be used when installing the Web and Services components of the SharePoint Online Connector.

    Failure to make note of the Client ID and Client Secret will require you to regenerate them before installing the connector.

  3. Click Create to complete the registration process.

    Following the registration process, the Client Secret that is generated is only good for one year, and will need to be replaced by generating a new Client Secret for the corresponding Client ID. For information on how to renew a client secret, see Renewing a Client Secret

Creating the SharePoint App Catalog

To enable an App Package to be deployed to SharePoint Online, you must create the App Catalog where App Packages will be hosted and made available to each SharePoint Online Web. If this has not already been done for your tenancy, perform the following steps:

  1. Open the SharePoint Online Admin Center.

  2. Select “apps” from the left menu.

  3. Click App Catalog, then click OK to accept the default option.

  4. On the Create App Catalog Site Collection page, specify the Title and Address for your App Catalog, as well as any other options indicated.

  5. Click OK to create the App Catalog.




JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.