> For the complete documentation index, see [llms.txt](https://docs.nexthink.com/platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexthink.com/platform/~/revisions/9wozksdgFlDB2XPW9TSc/library-packs/collaboration-and-productivity-applications/workflow_-onedrive-compliance/configuration-guide-onedrive-compliance.md).

# Configuration guide: OneDrive Compliance

> ⚠️ The configuration options on this page are only accessible to [administrators](https://docs.nexthink.com/platform/user-guide/administration/account-management/roles#roles-administration).
>
> Refer to the [Usage guide: OneDrive Compliance Workflow](https://docs.nexthink.com/platform/user-guide/nexthink-library) to use library content as a standard user.

***

### Prerequisites

This library pack contains content from the following required expansion products:

* **Remote actions**
* **Campaigns**
* **Workflows**

> 💡 Some of these products offer default access to their respective content and can still be used without [expansion products](https://docs.nexthink.com/platform/latest/products).\
> Refer to the Nexthink Infinity thresholds and limits overview documentation for more information about default thresholds for expansion products.

***

### Included content and dependencies

This library pack contains the following content and dependencies:

| **Content type** | **Name**                              | **Description**                                                     | **Dependencies**                                   |
| ---------------- | ------------------------------------- | ------------------------------------------------------------------- | -------------------------------------------------- |
| Remote actions   | **Get OneDrive status**               | Checks if OneDrive is installed and running.                        | Required for OneDrive workflow automation          |
| Remote actions   | **Repair OneDrive**                   | Attempts to fix basic OneDrive client issues.                       | Triggered after detection of install/config issues |
| Remote actions   | **Get OneDrive sync status**          | Retrieves sync status (Paused, Syncing, Errors, etc).               | Used to guide sync-related remediation paths       |
| Remote actions   | **Reset OneDrive**                    | Resets the OneDrive client to address sync-related errors.          | Triggered on sync error detection                  |
| Remote actions   | **Restart OneDrive**                  | Restarts OneDrive for paused or stuck states.                       | Follows user approval via campaign                 |
| Campaigns        | **OneDrive-Sync-RestartAssistance**   | Asks users to approve restarting their OneDrive sync.               | Required for handling paused sync scenarios        |
| Campaigns        | **OneDrive-Sync-SupportTicketLogged** | Notifies users an incident was created and IT will follow up.       | Triggered when automated remediation fails         |
| Workflows        | **OneDrive Compliance Workflow**      | Remediates sync issues or triggers incident creation automatically. | Orchestrates all other components                  |

***

### Configuring OneDrive Compliance Workflow

> 💡 Adapt these suggested configuration steps to edit and customize content according to your organizational needs.

Follow these steps to install and configure content:

* Before configuration – [Install library pack content from Nexthink Library](https://docs.nexthink.com/platform/user-guide/nexthink-library)
* Step 1 – Configure remote actions
* Step 2 – Edit campaigns
* Step 3 – Configure ITSM API connector credentials
* Step 4 – Schedule the workflow

***

#### Step 1 – Configure remote actions

1. From the main menu, go to **Remote actions > Manage remote actions**.
2. Set each of the following remote actions to have a **Manual trigger** to ensure they function correctly within workflows:
   * **Get OneDrive status**
   * **Repair OneDrive**
   * **Get OneDrive sync status**
   * **Reset OneDrive**
   * **Restart OneDrive**

> 🔄 Manual triggers are required for remote actions when used in workflows, but they can be combined with other triggers if needed outside the workflow.

***

#### Step 2 – Edit campaigns

1. From the main menu, navigate to **Campaigns > Manage campaigns**.
2. For each campaign listed below, review and customize:
   * **Sender name and image**
   * **Text and questions**
   * **Target audience (if applicable)**
3. Publish the campaign when you're ready.

| **Name**                              | **Trigger** | **Priority** |
| ------------------------------------- | ----------- | ------------ |
| **OneDrive-Sync-RestartAssistance**   | Manual      | Not urgent   |
| **OneDrive-Sync-SupportTicketLogged** | Manual      | Not urgent   |

***

#### Step 3 – Configure ITSM API connector credentials

1. Go to **Administration > Connector credentials**.
2. Configure the credentials as follows:
   * **Protocol**: HTTPS
   * **URL address**: Root URL of your ITSM tool (e.g., <https://servicedesk.example.com>)
   * **Authorization**: Basic
   * Enter the **Username** and **Password**
   * Click **Save**
3. Open the **OneDrive Compliance Workflow** from **Workflows**.
4. In the **Service/API call** steps, assign the newly created credentials to:
   * Create Incident - Folder Missing
   * Create Incident - Not Installed
   * Create Incident - Unknown Error
   * Create Incident - Repair Remote Action expired
   * Create Incident - Get Status - Remote Action expired
   * Create Incident - Sync Error

***

#### Step 4 – Schedule the workflow

1. Navigate to **Workflows > OneDrive Compliance Workflow**.
2. Click the **Trigger configuration** tab.
3. Enable the **Schedule trigger** with the following settings:
   * **NQL**:

     ```
     devices during past 7d
     | where operating_system.platform == Windows
     and operating_system.name !in ["*server*"]
     ```
   * **Recurrence**: Weekly — select at least one day.
4. Optionally, enable the **Manual trigger** to allow for ad-hoc remediation.

> ✅ Once configured, Nexthink automatically validates the workflow every time it’s saved.

***

### RELATED TOPICS

* [Overview page: OneDrive Compliance Workflow](https://docs.nexthink.com/platform/user-guide/nexthink-library)
* [Usage guide: OneDrive Compliance Workflow](https://docs.nexthink.com/platform/user-guide/nexthink-library)

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.nexthink.com/platform/~/revisions/9wozksdgFlDB2XPW9TSc/library-packs/collaboration-and-productivity-applications/workflow_-onedrive-compliance/configuration-guide-onedrive-compliance.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.