Guide 02
Members
Managing the people who consume access — their accounts, their devices, and what they are allowed to reach.
Route: /member · Menu: Management › Members · Page permission: member:R
A member is a managed person. Members do not sign in to the Console; they use the Agent on their desktop or the Agentless Portal in a browser. Console administrators are a different thing entirely — see 08 · Administrators & Roles.
What you can do here
- As an administrator, I want to see every member account, so that I can manage them.
- As an administrator, I want to create an account for a new colleague, so that they can reach the systems they need.
- As an administrator, I want to act on an account’s state — deactivate, reactivate, unlock, reset MFA, delete — so that I can keep accounts safe.
- As an administrator, I want to edit who a member is and what they may reach, so that access follows their job.
- As an administrator, I want to manage the devices registered to a member, so that a lost laptop cannot keep connecting.
- As a security officer, I want every new member to be forced into MFA by default, so that an exemption is always a deliberate act.
1. The member list
1.1 Columns
| Column | Meaning |
|---|---|
| Avatar | Profile picture, or a generated placeholder. |
| Account | The login name — always an email address. |
| Nickname | Display name. |
| Organization | The organizations the member belongs to. |
| Status | Active / Pending / Inactive / Locked — see §1.2. |
| Devices | - when none. Otherwise an icon button; the tooltip carries the count and clicking opens the device list dialog. |
| MFA Required | Whether an administrator requires this account to use MFA (ON/OFF). |
| MFA Enabled | Whether the account has actually enrolled an authenticator (ON/OFF). Server-managed, read-only. |
| Created At | When the account was created. |
| Updated At | When the record last changed. |
| Action | The buttons available for this row, filtered by status and by your permissions. |
MFA Required vs MFA Enabled. Required is policy — what you decided. Enabled is fact — what the member actually did. A member with Required ON and Enabled OFF will be forced to enroll at their next sign-in.
1.2 Member statuses
| Status | Can sign in | Typical cause |
|---|---|---|
| Active | Yes | Normal working account. |
| Pending | No | Created with an automatic password; waiting for activation. |
| Inactive | No | Deactivated by an administrator. |
| Locked | No | Locked by the system, usually after repeated failed sign-ins. |
1.3 Searching and filtering
Open the filter panel from the toolbar.
| Filter | Type | Notes |
|---|---|---|
| Keyword | Text, 1–50 chars | Fuzzy match on account and nickname. |
| Status | Multi-select | Nothing selected = all. |
| Organization | Multi-select | Nothing selected = all. |
| MFA Status | ON / OFF checkboxes | Tri-state: ticking exactly one filters by it; ticking both or neither = no filter. |
| MFA Required | ON / OFF checkboxes | Same tri-state rule. |
| Agentless Seat | ON / OFF checkboxes | Same tri-state rule. Flag-gated. Filters the seat, not “has agentless applications”. |
Rules that apply throughout:
- Different filters combine with AND; multiple values inside one filter combine with OR.
- Applying a filter resets you to page 1.
- Conditions are written into the URL, so a filtered view can be bookmarked or shared.
- Searching is debounced (1 s) so typing does not hammer the server.
1.4 Sorting
Click a sortable column header to cycle ascending → descending → default. The default is updated time, newest first. Sortable fields: name, email, status, MFA required, MFA enabled, agentless seat, created time, updated time.
1.5 Paging
Page sizes 10 / 25 / 50 / 100. Next to the selector a summary reads 共 {total} 筆; when a member quota is in force it also shows / 上限 {limit}.
1.6 Row interaction shortcuts
- Double-click a row → open its detail page.
- Single-click a row body → toggles selection, but only after you have already ticked at least one checkbox. Before that, clicking a row body does nothing, so you cannot select rows by accident.
- Clicking a button or a checkbox inside a row triggers only that control.
1.7 Saving a default filter
In the filter panel, Save as default stores the conditions currently shown in the panel (including ones you have not submitted yet) on this machine, synced across tabs. Next time you open the list with no filter parameters in the URL, that default is applied automatically and the panel opens. A URL that already carries filters always wins. Clear default removes it; you can also clear it from Preferences.
2. Row actions and when they are available
| Action | Allowed statuses | Permission |
|---|---|---|
| Detail | Any | page access |
| Copy | Any | member:C |
| Deactivate | Active | member:U |
| Unactivate | Inactive — reactivates the account | member:U |
| Unlock | Locked | member:U |
| Start | Pending — activates the account | member:U |
| Send Email | Pending — (re)sends the set-password mail | member:U |
| Reset MFA | Active / Locked, and only when MFA Enabled is ON | member:U |
| Delete | Inactive / Pending / Locked | member:D |
Editing is not a row action. A member’s fields are edited inline on the detail page, which requires
member:U— see §8.
A button you have no permission for is not shown. A button whose status precondition is unmet is likewise not shown for that row.
The label Unactivate is what the interface says for “put this inactive account back into service”. It is the counterpart of Deactivate, not another way of saying it.
2.1 Deleting a member that is still in use
If the backend refuses the delete because the member still has linked resources, a force delete confirmation appears. Confirming re-issues the delete with force=true, removing the linked resources along with the account.
Members are the only resource with a force-delete recovery path. Applications, organizations, roles and Console users do not have one — if their delete fails, that is final until you clear the dependency yourself.
3. Creating a member
Route: /member/create · Permission: member:C
A two-step wizard, then a result page.
3.1 Step 1 — Basic information
| Field | Required | Rules |
|---|---|---|
| Account | Yes | Email format; must not already exist (checked as you type). |
| Nickname | Yes | Max 50 characters. |
| MFA Required | — | Switch, default ON. |
Why MFA Required defaults to ON. Removing a second factor is a security decision and must be somebody’s deliberate act. Forgetting to switch it on must never silently produce an exempt account. Every creation path — this wizard, copy, the topology chart’s quick-create, and CSV import — starts from ON. To create an exempt account you must switch it off, or explicitly write a falsy value in the import file’s MFA Required column.
3.2 Step 2 — Password mode
| Field | Required | Default | Notes |
|---|---|---|---|
| Status | — | Pending | Read-only; derived from the password mode. |
| Password Mode | Yes | Auto | Automatic or Manual. |
| Password | Only in Manual mode | — | Max 20 characters; needs 1 upper case, 1 lower case, 1 digit. |
| Is Default Password | Yes | true | Force a password change at first sign-in. |
| Password mode | What happens |
|---|---|
| Automatic | The system generates a random password, the account is created as Pending, and an activation mail goes out. Following the link takes the member to the activation page; once they set a password the account becomes Active. |
| Manual | You type the password yourself and the account is created Active. You may still require a change at first sign-in. |
3.3 The activation mail
- Valid for one hour.
- Resending invalidates the previous mail’s token. Only the newest link works.
3.4 Failure to create
The account name is checked for duplication both as you type and again on submit. Other failures show on the result step with the reason; the wizard stays open so you can correct and retry.
4. Copying a member
Entries: list row action → /member/create/:id (returns to the list) · detail toolbar → /member/:id/create (returns to that member) Permission: member:C
Copying opens the ordinary create wizard with the source member’s values already filled in.
| Field | Seeded value |
|---|---|
| Nickname | <source name> - Copy |
| Account | <local>+copy@<domain> (sub-addressing) |
| MFA Required | Follows the source member, not the create default. Copying reproduces a member, and the source’s setting was itself a deliberate decision. |
| Organization | Follows the source. Needs organization:R, otherwise not copied. |
| Applications | Only the directly assigned applications. Ones inherited through an organization come along with the organization. Needs application:R, otherwise not copied. |
If the seeded name or address is already taken, Merak appends a number — Copy, Copy1, Copy2, … — probing up to 20 times. Beyond that it fills in the last candidate and lets the field’s own duplicate check flag it.
Why the suffix is
- Copyand not(Copy). The display name is written through to the underlying identity system, whose person-name validation rejects parentheses outright. A parenthesised seed value could never be submitted at all.
Missing a cross-feature read permission does not break the copy — the related items are simply not seeded, rather than sending a request that would be refused.
5. Member detail and account actions
Route: /member/:id · Permission: member:R
The detail page shows the full record plus cards for the member’s devices, organizations, applications and — when the feature is on — agentless applications.
5.1 Toolbar actions
The toolbar carries the same actions as the list row, plus Flow Chart.
| Action | Allowed statuses | Permission | What it does |
|---|---|---|---|
| Flow Chart | Any | page access | Opens this member’s topology view. |
| Copy | Any | member:C | Opens the copy wizard. |
| Deactivate | Active | member:U | The member can no longer sign in and their tokens are invalidated immediately. |
| Unactivate | Inactive | member:U | Puts a deactivated account back into service. |
| Unlock | Locked | member:U | Clears a lock caused by abnormal activity. |
| Start | Pending | member:U | Activates an account that is still waiting on activation. |
| Send Email | Pending | member:U | (Re)sends the set-password mail and invalidates the previous link. |
| Reset MFA | Active / Locked, only when MFA Enabled | member:U | Clears the enrolled authenticator so the member can enroll again. |
| Log | Any | auditLog:R | Opens this member’s audit trail. |
| Delete | Inactive / Pending / Locked | member:D | Deletes the account. |
There is no “reset password” action for members. To get a member back onto a fresh password, use Send Email while the account is pending, which re-issues the set-password mail. A member who is already active resets their own password through the sign-in page’s Forgot password flow.
5.2 Cards on the detail page
| Card | Requires | Contents |
|---|---|---|
| Devices | device:R | Machines registered by the Agent. See §7. |
| Organizations | organization:R | The groups this member belongs to. |
| Applications | application:R | What the member may reach, directly or through an organization. |
| Agentless applications | application:R + flag + the member holds a seat | Browser-reachable applications bound to this member. See §6. |
If you lose a cross-feature permission, the whole card disappears — Merak does not show an empty card you could mistake for “this member has none”.
6. Agentless seats and bindings
Flag-gated. If your deployment has agentless off, none of this appears.
Agentless access has two independent layers, and both must be in place before a member can open anything in a browser.
| Layer | Where you set it | Consumes a seat |
|---|---|---|
| Tier 1 — Agentless seat | Member detail, Agentless Seat field | Yes |
| Tier 2 — Application binding | Member’s Agentless applications card, or the application’s Agentless authorized members card | No |
6.1 Granting a seat (tier 1)
- Open the member’s detail page and enter edit mode.
- Switch Agentless Seat on and save.
The seat is written separately from the rest of the form, because it moves a tenant-level billing count.
When the switch is disabled:
| Reason | What you see | Fix |
|---|---|---|
| No seats left, or none purchased | Switch disabled with the reason shown | Free a seat, or purchase more. |
| Turning off while bindings exist | The backend refuses and reports how many bindings remain | Remove the member’s agentless bindings first. |
Seat availability is pre-checked in the browser, but the backend is the final word — someone else may take the last seat between your check and your save. Granting and releasing seats each raise their own audit events.
6.2 Binding applications (tier 2)
Open the Agentless applications card and pick from the list.
- Only applications the member can already reach and that have agentless switched on themselves are selectable.
- If the member has no seat, the panel says so and the unticked rows are disabled — you are stopped before you can build a selection the backend would refuse.
- Only directly assigned applications can be bound; there is no equivalent binding for organization-inherited access.
A binding is real access control, not a UI flag: an unbound member cannot reach the application even with a valid session, and removing a binding disconnects them immediately.
7. Devices
Devices are registered by the Agent when a member enrolls a machine. You can rename, deactivate and delete them, but you cannot create one from the Console.
7.1 Device fields
| Column | Notes |
|---|---|
| Device Name | Editable, max 50 characters. Auto-generated at first registration. |
| Description | Read-only, - when empty. |
| OS | Reported by the Agent on connect. Read-only. |
| Created By | Read-only. |
| Last Edited By | Read-only. |
| Device Type | Phone / computer / tablet / unknown. |
| Token | Device identifier. Read-only. |
| Status | Normal / Inactive / Pending. |
| Last Login | Read-only. |
| Created At | Registration time. |
7.2 Device statuses
| Status | Can connect | Can be deleted |
|---|---|---|
| Normal | Yes | No |
| Inactive | No | Yes |
| Pending | No — awaiting verification | No |
7.3 Rules and limits
- A member may register at most 5 devices.
- A new device starts as Pending and becomes Normal once verified.
- Deactivating a device invalidates its tokens immediately.
- Only an Inactive device can be deleted. Deactivate first.
- Deleting a device removes its sign-in records.
7.4 Device permissions
| Action | Permission |
|---|---|
| View devices | device:R |
| Rename a device | device:U |
| Deactivate | device:U |
| Delete | device:D |
8. Editing a member
Route: the detail page, edit mode · Permission: member:U
| Field | Rules |
|---|---|
| Account | Required, email format, must not clash with another member. |
| Nickname | Required, max 50 characters. |
| Organizations | Multi-select. |
| Allow Applications | Multi-select. |
| MFA Required | Switch; saved with the rest of the form. |
| Agentless Seat | Switch; saved separately (see §6.1). |
8.1 Quick-select: copying someone else’s application set
Picking applications one by one for every new joiner is slow. In edit mode the application picker offers three search modes above the search box:
| Search by | Behaviour |
|---|---|
| Keyword | (Default) filters the application list itself. |
| Member | Find another member and apply their applications to your current selection. |
| Organization | Find an organization and apply its applications. Requires organization:R. |
When you choose Member or Organization, a second control decides what applying means:
| Apply mode | Effect |
|---|---|
| Add (default) | Union — the source’s applications are added; everything already ticked stays ticked. Apply several sources in a row to build a set up. |
| Remove | Intersection — only applications the source also has are removed from your selection. Items the source does not have are untouched. |
Three things make this safe to use:
- Applications already inherited from an organization are excluded in both directions. Adding them would create a redundant direct grant that survives the member leaving the organization (a silent permission leftover); removing them would revoke a direct grant hidden under a row that stays ticked regardless — you would not see it happen.
- A confirmation dialog lists exactly what will be added or removed, by name and count, before anything changes. If the source changes nothing, you get a message instead of an empty dialog.
- Applying is not saving. The dialog only changes local ticks; the actual grant still needs the picker’s Confirm and then the form’s save. You can preview freely.
A Clear all button at the bottom of edit mode empties every togglable tick in one action, through the same confirmation dialog. Organization-inherited items are unaffected.
The mirror image of this exists on the application side — pick members by copying another application’s or an organization’s member set. See 03 · Applications §7.1.
9. Bulk work
Members support the full batch toolkit: Export, multi-select batch actions (deactivate / activate / unlock / delete) and CSV import in both create and modify modes.
Two member-specific notes:
- Resend activation mail and Reset MFA exist as single-row actions only. The first has an obvious per-person side effect that should not be fired en masse; the second depends on each row’s own MFA-enabled state.
- Member batch delete does offer a force-delete recovery path, unlike other resources.
Full instructions: 09 · Bulk Operations.
10. Permission summary
| Task | Permission |
|---|---|
| View the list and details | member:R |
| Create / copy / import | member:C |
| Edit | member:U |
| Deactivate / Unactivate / Unlock / Start / Send Email / Reset MFA | member:U |
| Delete | member:D |
| View / manage devices | device:R / device:U / device:D |
| See the member’s log tab | auditLog:R |
Every state-changing action on a member maps to the single key
member:U. There are no finer-grained keys such asmembers.unlock— the whole permission catalogue is<resource>:C/R/U/Dand nothing else.
Next
- Group members so access can be granted collectively: 04 · Organizations
- Publish something for them to reach: 03 · Applications