Configuring synchronization to Office 365® SharePoint® using token authentication - AcceleratorKMS - Version 3.12 - Help - Hexagon

Create and configure the application to allow Office 365® SharePoint® using token authentication to synchronize copies of published content.

Before you begin

• You must be an Administrator.

• Published content synchronization must be enabled by AcceleratorKMS.

• Create or designate an Office 365® SharePoint® site to store the PDF versions of published content.

About this task

Use the following setup process when using an Office 365® SharePoint® library as the external storage library.

Procedure

1. Navigate to tenantname- admin.sharepoint.com/_layouts/15/appregnew.aspx >. Where tenantname is replaced with your domain name.

2. In the Client Id and Client Secret fields, click Generate to create a client Id and client secret.

   Copy the Client ID and Client Secret as they are required for the AcceleratorKMS Configuration page.

3. Type a title for the application.

   This appears in AzureAD Apps.

4. In the App Domain field, type the hosting URL.

5. In the Redirect URL field, accurately input https://www.localhost.com.

6. Click Create.

   The system displays a confirmation screen.

7. On the confirmation screen, click OK.

8. Navigate to the appinv page, which is the site to where you want to assign permissions to the app. For example,

   https:// < tenantName>.sharepoint.com/sites/<siteName>/_layouts/15/appinv.aspx Where < tenantName> and < siteName> are replaced with client specific details.

9. Type the App Id, and click Lookup.

   

   • The App Id is also the Client Id.

   • By default, the client secret is set to expire one year after it is created. Before the expiry date, either a new secret should be created and set up in AcceleratorKMS, or the existing secret should be updated to expire at a later date by the Office 365® administrators within your tenant.

   • The next three fields are populated automatically:

     • Title

     • App Domain

     • Redirect URL

10. In the Permission Request XML field, paste the XML including line breaks to grant app permissions to the site. For example,

    <AppPermissionRequests AllowAppOnlyPolicy="true">

    <AppPermissionRequest Scope=" http://sharepoint/content/sitecollection&quot ; Right="FullControl" />

    </AppPermissionRequests>

11. Click Create.

12. On the trust confirmation screen, click Trust It.

13. Navigate to the new or designated SharePoint® site.

14. Add a column to the document library with the following specifications.

    Document library column specifications for online Office 365® SharePoint® configuration

    Field	Value
    Name	ProcedureID
    Type of information	Single line of text
    Description	Procedure ID of content (document or flow) in AcceleratorKMS
    Requires that this column contain information	No
    Enforce unique values (indexed)	No for Office 365® SharePoint® configuration
    Add to default view	No

    Create an index to the ProcedureID column using the following steps:

15. On the menu bar, click the gear icon > Library Settings.

    1. Navigate to Columns section, click Indexed Columns.

    2. Click Create a new index.

       The Indexed Columns page opens.

       Document library column specifications

       Field	Value
       Primary column	ProcedureID
       Secondary column	(none)

    3. Click Create.

       This may take some time to finish processing.

Configure AcceleratorKMS

1. Log in to AcceleratorKMS as an Administrator.

2. On the menu bar, click the gear icon > Configuration.

3. Navigate to the Export section, and add values for the following keys.

   Export keys

   Export Key	Description
   OutputControlMessageTemplate	Specify a message to identify an uncontrolled printed copy. Enter a value of {0} to print current date and time, {0:d} to print only the date. For example, Hard copy printed on {0}. Copy is valid for the date printed.
   OutputStoreBaseURL	The base URL used when updating attachment paths and content links for an external environment. For example: https://<companyName>/sharepoint.com/sites/AcceleratorKMSBackups/SyncedContent/
   OutputStoreControlMessageTemplate	Specify a message and the date value for a copy generated to designated output store. Enter a value of {0} to print current date and time, {0:d} to print only the date. For example, Copy generated on {0}.
   SharePointLibraryName	Specify internal name where published content output is saved.
   SharePointLibraryTitle	Specify the display title where content output is saved.
   SharePointOnlineClientId	Specify ClientID for SharePoint® Online instance.
   SharePointOnlineClientSecret	Specify ClientSecret for SharePoint® Online instance.
   SharePointOnlineRealmId	Specify the realm ID for the SharePoint® Online instance.
   SharePointSelector	Specify SharePointOnline for Office 365® SharePoint® from the drop-down list.
   SharePointSitePath	Specify the URL path to the SharePoint® site where published content output is saved. For example: https://<companyName>/sharepoint.com/sites/AcceleratorKMSBackups/
   SyncProcedureOutputJobEnabled	Specify yes to save published content to designated output store.
   WebApplicationUrl	Web address to the AcceleratorKMS application; used for links in email notifications and content output. For example: https://<companyName>.acceleratorkms.com
   WebRootDirectory	Specify the server file system directory for the web application

4. Click Save.