> For the complete documentation index, see [llms.txt](https://docs.reveald.com/technical-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.reveald.com/technical-documentation/data-sources/ncentral.md).

# NCentral

## About This Document

This guide details the steps necessary to connect data to the Epiphany Intelligence Platform.  The Epiphany Intelligence Platform leverages data about network appliances to provide greater visibility into the network exposure in your environment. 

## Overview

NCentral allows API access by virtue of an API key, URL, and a username. These are created in NCentral's management console by an admin user. 

Epiphany only requires a read-only (Default Dashboard Role) user to collect NCentral's data. This is a default role in NCentral when generating API credentials.

To perform the steps in this document, you can do either of the following: 

* **Option 1:** Create a new user, who is designated for use by Epiphany, and provide the user the proper privileges. 
* **Option 2:** Leverage an existing user and follow the steps to ensure the user has the correct privileges to collect all necessary data. 

## Version Compatibility

* **Epiphany**: Epiphany Collector version 1.0 and later.
* **NCentral**: Non end-of-life NCentral versions.

## Prerequisites

* [ ] Ability to create a user, or access to an existing user with the read-only role.

## What is Needed for Integration <a href="#hlk85191078" id="hlk85191078"></a>

* [ ] A username with the role of read-only and its API Key.&#x20;
* [ ] The URL of the NCentral console.

[Legal Notice](/technical-documentation/legal-notice.md)


---

# 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:

```
GET https://docs.reveald.com/technical-documentation/data-sources/ncentral.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.