Configuring SharePoint app, sites, and app permissions
- Updated: 2023/11/02
Configuring SharePoint app, sites, and app permissions
The SharePoint package connects to a particular SharePoint domain using app-based permissions. You must configure your SharePoint domain and add relevant app permissions.
To register and configure a new app in SharePoint, you must complete the following steps before using the SharePoint package. You can use the client ID and client secret of the newly registered app to log in to SharePoint through the Automation 360 SharePoint package.
Configure new app
- To register a new app, go to: https://{your_sharepoint_domain}/_layouts/15/appregnew.aspx. Replace {your_sharepoint_domain} with your specific SharePoint domain (for example: automationanywhere.sharepoint.com).
- Click Generate to generate a new client ID and client secret.
- You can view the app details in the confirmation page. Copy and save the details to use in the package.
Configure app permissions
Once you have registered the app, you must configure the app-based permission.
- To configure app permission, go to: https://{your_sharepoint_domain}/_layouts/15/appinv.aspx. Replace {your_sharepoint_domain} with your specific SharePoint domain (for example: automationanywhere.sharepoint.com).
- Enter the client ID for the newly created app and click Lookup. Your app details will be displayed. Copy
the following XML snippet and paste it in the
Permission Request XML
box:
<AppPermissionRequests AllowAppOnlyPolicy="true"> <AppPermissionRequest Scope="http://sharepoint/content/sitecollection" Right="FullControl" /> </AppPermissionRequests>
- Click Create to save your
changes.
- In the next screen, click Trust It to grant the required permissions.
Configure individual SharePoint sites
You must configure individual SharePoint sites. If you have multiple SharePoint sites in your organization, repeat this process for each individual site you want to connect to.
- To configure individual sites, go to: https://{your_sharepoint_domain}/sites/{sitename}/_layouts/15/appinv.aspx. Replace {your_sharepoint_domain} with your specific SharePoint domain (for example: automationanywhere.sharepoint.com) and {sitename} with the site name you have created.
- Follow the instructions provided in Configure app permissions, to add the app based permissions to your SharePoint site.
Configure OAuth connection in SharePoint
You must configure an OAuth connection in SharePoint before creating the OAuth connection in Control Room.
- Complete step 1 to step 5 in Create OAuth connection.
- Log into Azure portal and navigate to App Registration.
- Click New registration and enter the following
details:
- Enter a name for the app.
- Select Single Tenant.
- In the Redirect URI field, select
Web from the drop-down and enter the
callback URL from Create OAuth connection.Note: For the OAuth connection to be successful you must enter the callback URL.
- Click Register.
- Go to App Overview.
- Copy the client ID from the Application (client) ID.
- Click Add a certificate or secret in the Client credentials field.
- Click New client secret.
- Copy the client secret from the Value field.
- Go to Create OAuth connection and complete the remaining steps to create an Oauth connection with the above details.