Skip to main content

Enroll Secret

An enroll secret is a key endpoints use to join EndpointOps during agent install. Each secret is tied to a Department and Location, so endpoints that enroll with it are organized automatically.

How to get here​

You reach this page through Settings, so you need administrator (settings) permission. If you don't see the Settings icon, ask your administrator for access.

  1. Sign in to EndpointOps.
  2. In the top-right of any screen, click the Settings (gear ⚙️) icon.
  3. In the Settings menu on the left, open Agent Management and click Enroll Secret.

Navigate to: Settings → Agent Management → Enroll Secret

URL path: /settings/agent-management/enroll-secret

The Enroll Secret screen​

Enroll Secret listEnroll Secret list

Columns: Name, Secret, Department, Location, Created On. Each row has a delete (🗑️) action.

The toolbar​

Above the list, the same toolbar appears on every list screen:

  • Create- add a new item (opens a form panel from the right).
  • Refresh- reload the latest data.
  • Export- download the current list.
  • Columns- choose which columns to show (covered under "Choosing which columns to show" below).

Working with the list​

These controls behave the same on every list:

  • Search- type in the Search… box above the table to filter rows as you type.
  • Sort- click the arrows in a column header to sort by that column.
  • View details- click a row's link in the first column to open a read-only view.
  • Edit / delete- use the edit (✏️) and delete (🗑️) icons at the end of a row.
  • Pagination- when a list runs to more than one page, use the page controls at the bottom-right and the / page selector to change how many rows show.
  • Permissions- you only see Create, edit, and delete if your role grants the matching permission; otherwise the screen is read-only.

When you save a new or edited record, a success message appears, the panel closes, and the list refreshes. Required fields are marked with a red asterisk.

How do I create an enroll secret?​

  1. Click Create. The form panel opens.

    Create Enroll Secret formCreate Enroll Secret form

  2. Fill in the fields (all required):

    FieldNotes
    NameA label for the secret.
    DepartmentThe department endpoints enrolled with this secret belong to.
    LocationThe location endpoints enrolled with this secret belong to.

  3. Click Create. The generated Secret appears in the list.

Use the secret at install time

Copy the Secret value and use it when installing the agent on an endpoint. The endpoint then joins under the secret's Department and Location.

Choosing which columns to show​

Click the Columns icon on the right of the toolbar to open the column picker.

Enroll Secret column pickerEnroll Secret column picker

Tick the columns to show, untick to hide, drag to reorder, then click Apply.