Chapters Members

Guide 02

Members

Managing the people who consume access — their accounts, their devices, and what they are allowed to reach.

Updated

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

ColumnMeaning
AvatarProfile picture, or a generated placeholder.
AccountThe login name — always an email address.
NicknameDisplay name.
OrganizationThe organizations the member belongs to.
StatusActive / 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 RequiredWhether an administrator requires this account to use MFA (ON/OFF).
MFA EnabledWhether the account has actually enrolled an authenticator (ON/OFF). Server-managed, read-only.
Created AtWhen the account was created.
Updated AtWhen the record last changed.
ActionThe 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

StatusCan sign inTypical cause
ActiveYesNormal working account.
PendingNoCreated with an automatic password; waiting for activation.
InactiveNoDeactivated by an administrator.
LockedNoLocked by the system, usually after repeated failed sign-ins.

1.3 Searching and filtering

Open the filter panel from the toolbar.

FilterTypeNotes
KeywordText, 1–50 charsFuzzy match on account and nickname.
StatusMulti-selectNothing selected = all.
OrganizationMulti-selectNothing selected = all.
MFA StatusON / OFF checkboxesTri-state: ticking exactly one filters by it; ticking both or neither = no filter.
MFA RequiredON / OFF checkboxesSame tri-state rule.
Agentless SeatON / OFF checkboxesSame 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

ActionAllowed statusesPermission
DetailAnypage access
CopyAnymember:C
DeactivateActivemember:U
UnactivateInactive — reactivates the accountmember:U
UnlockLockedmember:U
StartPending — activates the accountmember:U
Send EmailPending — (re)sends the set-password mailmember:U
Reset MFAActive / Locked, and only when MFA Enabled is ONmember:U
DeleteInactive / Pending / Lockedmember: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

FieldRequiredRules
AccountYesEmail format; must not already exist (checked as you type).
NicknameYesMax 50 characters.
MFA RequiredSwitch, 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

FieldRequiredDefaultNotes
StatusPendingRead-only; derived from the password mode.
Password ModeYesAutoAutomatic or Manual.
PasswordOnly in Manual modeMax 20 characters; needs 1 upper case, 1 lower case, 1 digit.
Is Default PasswordYestrueForce a password change at first sign-in.
Password modeWhat happens
AutomaticThe 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.
ManualYou 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.

FieldSeeded value
Nickname<source name> - Copy
Account<local>+copy@<domain> (sub-addressing)
MFA RequiredFollows the source member, not the create default. Copying reproduces a member, and the source’s setting was itself a deliberate decision.
OrganizationFollows the source. Needs organization:R, otherwise not copied.
ApplicationsOnly 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 - Copy and 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.

ActionAllowed statusesPermissionWhat it does
Flow ChartAnypage accessOpens this member’s topology view.
CopyAnymember:COpens the copy wizard.
DeactivateActivemember:UThe member can no longer sign in and their tokens are invalidated immediately.
UnactivateInactivemember:UPuts a deactivated account back into service.
UnlockLockedmember:UClears a lock caused by abnormal activity.
StartPendingmember:UActivates an account that is still waiting on activation.
Send EmailPendingmember:U(Re)sends the set-password mail and invalidates the previous link.
Reset MFAActive / Locked, only when MFA Enabledmember:UClears the enrolled authenticator so the member can enroll again.
LogAnyauditLog:ROpens this member’s audit trail.
DeleteInactive / Pending / Lockedmember:DDeletes 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

CardRequiresContents
Devicesdevice:RMachines registered by the Agent. See §7.
Organizationsorganization:RThe groups this member belongs to.
Applicationsapplication:RWhat the member may reach, directly or through an organization.
Agentless applicationsapplication:R + flag + the member holds a seatBrowser-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.

LayerWhere you set itConsumes a seat
Tier 1 — Agentless seatMember detail, Agentless Seat fieldYes
Tier 2 — Application bindingMember’s Agentless applications card, or the application’s Agentless authorized members cardNo

6.1 Granting a seat (tier 1)

  1. Open the member’s detail page and enter edit mode.
  2. 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:

ReasonWhat you seeFix
No seats left, or none purchasedSwitch disabled with the reason shownFree a seat, or purchase more.
Turning off while bindings existThe backend refuses and reports how many bindings remainRemove 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

ColumnNotes
Device NameEditable, max 50 characters. Auto-generated at first registration.
DescriptionRead-only, - when empty.
OSReported by the Agent on connect. Read-only.
Created ByRead-only.
Last Edited ByRead-only.
Device TypePhone / computer / tablet / unknown.
TokenDevice identifier. Read-only.
StatusNormal / Inactive / Pending.
Last LoginRead-only.
Created AtRegistration time.

7.2 Device statuses

StatusCan connectCan be deleted
NormalYesNo
InactiveNoYes
PendingNo — awaiting verificationNo

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

ActionPermission
View devicesdevice:R
Rename a devicedevice:U
Deactivatedevice:U
Deletedevice:D

8. Editing a member

Route: the detail page, edit mode · Permission: member:U

FieldRules
AccountRequired, email format, must not clash with another member.
NicknameRequired, max 50 characters.
OrganizationsMulti-select.
Allow ApplicationsMulti-select.
MFA RequiredSwitch; saved with the rest of the form.
Agentless SeatSwitch; 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 byBehaviour
Keyword(Default) filters the application list itself.
MemberFind another member and apply their applications to your current selection.
OrganizationFind an organization and apply its applications. Requires organization:R.

When you choose Member or Organization, a second control decides what applying means:

Apply modeEffect
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.
RemoveIntersection — 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:

  1. 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.
  2. 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.
  3. 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

TaskPermission
View the list and detailsmember:R
Create / copy / importmember:C
Editmember:U
Deactivate / Unactivate / Unlock / Start / Send Email / Reset MFAmember:U
Deletemember:D
View / manage devicesdevice:R / device:U / device:D
See the member’s log tabauditLog:R

Every state-changing action on a member maps to the single key member:U. There are no finer-grained keys such as members.unlock — the whole permission catalogue is <resource>:C/R/U/D and nothing else.


Next