# Microsoft Sharepoint

## Connection Requirements

{% stepper %}
{% step %}

### Tenant ID and Client ID

Steps to create a Tenant ID and Client ID:

* Log in to the Azure Portal with an administrator account.
* Select **Azure Active Directory**.
* Select **App registrations > New registration**. Fill in the details and click **Register**.
* After you have created the app, you will see its **Application (client) ID** and **Directory (tenant) ID**. These values are your **Client ID** and **Tenant ID**.
  {% endstep %}

{% step %}

### Client Secret

* In the left menu, select **Certificates & secrets > New client secret**. Click **Add** and copy the generated secret value immediately.
* In the left menu, select **API Permissions > Add a permission**.
* Select **Microsoft Graph**.
* Select **Application permissions**.
* Add the necessary permissions, **Sites.Read.All** and **Files.Read.All**.
* After adding permissions, you must click the **Grant admin consent** button.

{% hint style="warning" %}
This is an example of the URL format:

<https://SharepointDomain/FolderType/YourSite/Lists/ListName>
{% endhint %}
{% endstep %}

{% step %}

### Sharepoint Domain

The hostname of your SharePoint site collection (e.g., yourtenant.sharepoint.com).
{% endstep %}

{% step %}

### Folder Type

The folder type of your SharePoint site collection. (e.g., personal, marketing, etc.).
{% endstep %}

{% step %}

### Site Address

The server-relative path to your site. (e.g., your\_site\_com)
{% endstep %}

{% step %}

### List Name

The name of the list you want to see in the OctoXLabs. In the url you can see at the end:

<https://Domain/FolderType/YourSite/Lists/ListName>
{% endstep %}

{% step %}

### Hostname Field

The name of the column in your list that contains the device hostnames. (No empty spaces)
{% endstep %}

{% step %}

### IP Address Field

The name of the column in your list that contains devices ip address. This field is optional. (No empty spaces)
{% endstep %}

{% step %}

### First Seen Field

The name of the column in your list that contains devices first seen field. This field is optional. (No empty spaces, if the name is FirstSeen you don't need to write this field.)

{% hint style="info" %}
First seen and last seen fields dates will be displayed in the format **YYYY-MM-DDTHH:MM:SS.ssssssZ** (e.g., *2025-08-11T19:45:32.123456Z*), which is an ISO 8601 UTC timestamp. You need to change the formats if you want to view these fields. You can add the remaining fields as you wish.
{% endhint %}
{% endstep %}

{% step %}

### Last Seen Field

The name of the column in your list that contains devices last seen field. This field is optional. (No empty spaces, if the name is LastSeen you don't need to write this field.)
{% endstep %}

{% step %}

### SSL

Use SSL for connection. (optional, default: **Encrypted**).
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Please remove any whitespace from the hostname and IP address field when entering them.

Please perform a connection test to ensure there is a valid connection to the Microsoft Sharepoint host. When the discovery operation finalized you will be able to see the details on Assets page.
{% endhint %}