> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neoagent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Connect your N-Able N-Central to Neo Agent for automated script execution and device management

N-Able N-Central integration enables Neo Agent to access your automation policies, devices, and monitoring data for powerful automation capabilities.

## Prerequisites

Before starting the integration setup, ensure you have:

* **Admin Access**: Administrator access to your N-Central instance
* **Role-Based Permissions**: Ability to create users and configure role-based permissions
* **API User Creation**: Permissions to create dedicated API users

## Setup Guide

<Steps>
  <Step title="Create API user">
    Set up a dedicated API user account with appropriate role-based permissions:

    1. Navigate to **Administration → User Management**
    2. Click **Create User** or **Add New User**
    3. Configure the user details:
       * **Username**: Use a descriptive name (e.g., `neo_agent_api`)
       * **Email**: Set to a monitored email for notifications
       * **Authentication**: Configure for API access

    <Tip>
      Creating a dedicated API user for Neo Agent makes it easier to manage permissions and audit activity.
    </Tip>
  </Step>

  <Step title="Configure role-based permissions">
    Assign the necessary permissions for monitoring, alerting, and automation tasks:

    1. Navigate to **Administration → Role Based Permissions**
    2. Create a new role or modify an existing one for Neo Agent
    3. Enable the following permission categories:
       * **Devices**: Read and manage device information
       * **Automation**: Execute scripts and automation policies
       * **Monitoring**: Access monitoring data and alerts
       * **Alerts**: View and manage alerts

    <Warning>
      Insufficient permissions will cause Neo Agent to fail when attempting certain operations. Start with broader permissions and narrow down as needed.
    </Warning>
  </Step>

  <Step title="Generate API credentials">
    Generate the authentication credentials for your API user:

    1. Access the API user settings
    2. Generate an API key or JWT token based on your N-Central configuration
    3. Securely store the credentials

    <Check>
      Note down the API endpoint URL for your N-Central instance as you'll need this during configuration.
    </Check>
  </Step>

  <Step title="Configure in Neo Agent">
    Navigate to the [Neo Agent Dashboard](https://dashboard.neoagent.io/integrations) and select **N-Able N-Central** from the RMM integrations.

    Enter your credentials:

    * **API URL**: Your N-Central instance URL
    * **API Key/Token**: The authentication credential generated
    * **Additional settings**: Any region or instance-specific configuration
  </Step>

  <Step title="Test and save">
    Neo Agent will validate your credentials and establish the connection.

    <Check>
      A successful connection allows Neo to access your devices, automation policies, and monitoring data.
    </Check>
  </Step>
</Steps>

## Role-Based Permissions Reference

Configure the following permissions for the Neo Agent API user:

### Device Management

| Permission        | Level      | Purpose                             |
| ----------------- | ---------- | ----------------------------------- |
| View Devices      | All        | Access device inventory and details |
| Manage Devices    | All        | Execute management tasks on devices |
| Device Properties | Read/Write | Access and update device properties |

### Automation

| Permission          | Level | Purpose                                 |
| ------------------- | ----- | --------------------------------------- |
| View Scripts        | All   | Browse available automation scripts     |
| Execute Scripts     | All   | Run scripts on managed devices          |
| Automation Policies | Read  | Access automation policy configurations |

### Monitoring and Alerts

| Permission      | Level | Purpose                             |
| --------------- | ----- | ----------------------------------- |
| View Monitoring | All   | Access monitoring check results     |
| View Alerts     | All   | Access active and historical alerts |
| Manage Alerts   | All   | Clear and acknowledge alerts        |

<Info>
  Permission levels may vary based on your N-Central version. Consult the N-Central documentation for your specific version's permission structure.
</Info>

## What Neo Can Do

With N-Able N-Central connected, Neo Agent can:

<AccordionGroup>
  <Accordion title="Automation Policy Execution">
    * Browse available automation policies and scripts
    * Execute automation on specific devices
    * Monitor automation job status
    * Take follow-up actions based on results
  </Accordion>

  <Accordion title="Device Management">
    * Look up devices across your managed clients
    * Access device details, status, and properties
    * View software inventory and installed applications
    * Identify devices related to tickets or end users
  </Accordion>

  <Accordion title="Monitoring and Alerts">
    * Access real-time monitoring data
    * Process and respond to alerts
    * Clear alerts after successful remediation
    * Correlate monitoring status with ticket context
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authentication Errors">
    * Verify the API credentials are entered correctly
    * Check that the API user account is active
    * Ensure the API URL is correct for your instance
    * Confirm the authentication method matches your configuration
  </Accordion>

  <Accordion title="Permission Denied">
    * Review the role-based permissions for your API user
    * Ensure all required permission categories are enabled
    * Check for any customer/site level permission restrictions
  </Accordion>

  <Accordion title="Devices or Scripts Not Visible">
    * Verify the API user has access to the relevant customers/sites
    * Check device-level and script-level permissions
    * Ensure automation policies are not restricted
  </Accordion>
</AccordionGroup>

## External Resources

<Card title="N-Able N-Central API Documentation" icon="link" href="https://documentation.n-able.com/N-central/userguide/Content/User_Management/Role%20Based%20Permissions/role_based_permissions_create_APIuser.htm">
  Official N-Able documentation for creating API users with role-based permissions.
</Card>