> 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/rapid7-nexpose/create-a-new-rapid7-nexpose-user.md).

# Create a New Rapid7 Nexpose User

#### Step 1:

* Log in to your Nexpose instance as an administrator.
* Select **Administration** in the left menu.&#x20;

![In the left menu, select Administration.](/files/33lmJkfp0EdjLyEe6aZD)

#### Step 2:

* On the **Administration** page, in the **Users** section, select **Create**.

![Select Create in the Users section.](/files/pkwanhqtOHVE3YLetVwC)

#### **Step 3:**

* On the **General** tab under the **User Configuration** page, enter this information:
  * **User name**: Epiphany
  * **Authentication**: VM user
  * **Full Name**: Epiphany Access
  * **Email Address**: <assessment_creds@eip.io>
  * **Password**: create a secure/complex password.
  * **Confirm Password**: enter the same password as above.
* Be sure to check the **Account Enabled** check bo&#x78;**.**

![Fill out the fields as show above.](/files/kKm3VN7Asa73s6dZIYLy)

#### Step 4:

{% hint style="info" %}
The roles selected for the Epiphany user provide a scope of read only.
{% endhint %}

* On the **Roles** tab under the **User Configuration** page, make these settings:
  * **Role**: Custom
  * **Save Role**: Check the **Save Role** check box and then enter EpiphanyRole

![Use a custom role.](/files/zJNO1zr50z8CGkap5D26)

* **Global Permissions**: Check the **Appear on Ticket and Report List** checkbox.

![Select all of the checkboxes as seen above](/files/kQpEUgdl9VYfkwN5q7u8)

* **Site Permissions**: Check the **View Site Asset Data** checkbox.

![Select all of the checkboxes as seen above](/files/frmmwCIhPvsrNT65Fs60)

* **Asset Group Permissions**: Check the **View Group Asset Data** checkbox.

![Select all of the checkboxes as seen above](/files/HNWdlcL9h31QvEQNow0L)

* **Report Permissions**: None
* **Vulnerability Exception and Policy Override Permissions**: None
* **Vulnerability Investigation Permissions**: Check the **View Vulnerability Investigations** checkbox.

![Select all of the checkboxes as seen above](/files/Tk9J5Dqj2Erwn3fAqftn)

#### Step &#x35;**:**

* On the **User Configuration** page, on the **Site Access** tab, select the scope of the site access needed for Epiphany's data collection.

{% hint style="info" %}
Please contact your Epiphany representative if there are questions about the scope of the current collections to be performed.
{% endhint %}

* If all sites are needed, select the **Allow this user to access all sites** radio button.

![Select Allow this user to access all sites.](/files/UeCeB1HQnIG8MroW4OC0)

* If only certain sites are needed, select the **Create a custom list of sites that this user can access** radio button.
* Select th*e* **Select** **Sites** button.

![Select the Create a custom list, then Select Sites.](/files/8dnsOSr7raecqtlXgoDT)

* In **Select Sites**, check the checkbox for all sites within the scope of the current Epiphany collection.&#x20;
* Select **Save**.

![Select all needed sites](/files/oHrmb6H1Z8EVY9hGBRzn)

#### Step 6:

* On the **User Configuration** page, in the **Asset Group Access** tab, select the scope of the asset group access needed for Epiphany's data collection.

{% hint style="info" %}
Please contact your Epiphany representative if there are questions about the scope of the current collections to be performed.
{% endhint %}

* If all asset groups are needed, select the **Allow this user to access all asset groups** radio button.

![Select Allow this user to access all asset groups](/files/ZeXvXYiSDjX8eCcUovS8)

* If only certain sites are needed, select the **Create a custom list of asset groups that this user can access** radio button, then select the **Select Groups** button.

![Select Create a custom list, then Select Groups.](/files/Jbu2pQ2s5ydCkYha7Dty)

* In **Select Groups**, select all asset groups within the scope of the current Epiphany collection. Then select **Save**.

![Select all needed groups](/files/3JgqCVH7bSPLLtX7WGSC)

**Step 7:**

{% hint style="warning" %}
**Be sure to select Save once all fields are properly completed for the new user.**
{% endhint %}

![](/files/XZRRkWB3btEq8GCat2qk)


---

# 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/rapid7-nexpose/create-a-new-rapid7-nexpose-user.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.
