Source: https://nishanth-fern-test.docs-staging.pageloop.ai/os/generate-clientid-and-secretkey-for-sharepoint-integration

# Generate ClientID and SecretKey for SharePoint Integration

Generating Client ID and Secret Key for SharePoint Integration is a two-step process. **Step 1**: Register the Add-In **Step 2**: Grant permissions for the Add-in

### Step 1 : Register the Add-In

1. Log in with an admin account on the parent site, and then go to the following URL,

```plaintext
https://[sitename].sharepoint.com/_layouts/15/appregnew.aspx
```

- **For sites**: Replace the **\[sitename]** in the above URL with your site name. For example, if your SharePoint site is <https://abcd.sharepoint.com>, then replace the with **abcd**.
- **For subsites**: To add subsites, append your subsite name to the site URL. For example, if your subsite URL is of the form: <https://abcd.sharepoint.com/sites/subsite1>, then the above URL is **<https://abcd.sharepoint.com/sites/subsite1/_layouts/15/appregnew.aspx>**

1. Enter the following information on the page that is displayed when you first visit the URL.

- In the **App Information** section, click the **Generate** button next to the **Client Id** and **Client Secret** text boxes to generate the respective values.
- In the **Title** textbox, enter the **Add-In**.
- In the **App Domain** text box, enter the **localhost**.
- In the **Redirect URL** text box, enter **<https://localhost>**

1. Click **Create**. ![RB\_DB\_CR.png](/images/49/RB_DB_CR-1-49ac0caa.png)

> [!INFO]
>
> The Add-in is registered, and the following message is displayed. ![RB\_DB\_CR\_addin](/images/a5/RB_DB_CR_addin-a587762a.png)

> [!WARNING]
>
> Make a note of the above information and share the Client ID and Client Secret with a Whatfix representative.

### Step 2: Grant Permissions for the Add-in

Once the Add-In is registered, the next step is to set the permissions for that add-in to access the SharePoint data.

> [!WARNING]
>
> Whatfix sets the read permission level to the web scope to be able to read the web information.

1. Go to the following URL in the browser. This redirects to the **Grant permission** page.

```plaintext
https://<sitename>.sharepoint.com/_layouts/15/appinv.aspx
```

- **For sites**: Replace the `&lt;sitename&gt;` in the above URL with your site name. For example, if your SharePoint site is <https://abcd.sharepoint.com>, then replace the `&lt;sitename&gt;` with **abcd**.
- **For subsites**: To add subsites, append your subsite name to the site URL. For example, if your subsite URL is of the form: <https://abcd.sharepoint.com/sites/subsite1>, then the above URL is **<https://abcd.sharepoint.com/sites/subsite1/_layouts/15/appinv.aspx>**

1. Enter the Client ID (which you have generated earlier) in the **App Id** textbox, and click the **Lookup** button.

> [!INFO]
>
> This populates the value to other text boxes in Title, App Domain, and Redirect URL.

1. In the **App's Permission Request XML** section, enter the following permission request in XML format.

```plaintext
<AppPermissionRequests 
AllowAppOnlyPolicy="true"><AppPermissionRequest 
Scope="http://sharepoint/content/sitecollection/web" 
Right="Read" /></AppPermissionRequests>
```

> [!WARNING]
>
> The permissions granted are Read-Only, so our API cannot update or delete any data from your SharePoint site.

1. Click **Create**. ![RB\_DB\_CR.png](/images/49/RB_DB_CR-1-49ac0caa.png)
2. Click **Trust It** to trust the add-in to read items from your website. ![RB\_DB\_Trustit](/images/2a/RB_DB_Trustit-2a1421ea.png)
