On this page
Choose which roles read masked names, list the terms to hide, and preview every role before sharing a link.
Who can do this: an owner or admin; a super admin can also open the page.
Before you start#
- At least one enabled plane declares an identity kind; otherwise the add-term form has nothing to offer.
Steps#
- Open Settings > Data masking ("Cài đặt > Che dữ liệu") and tick the roles that read masked data. Editor and viewer are ticked until the first save; the two switches extend masking to the menu and to detail-table records. The Demo role always reads masked data and needs no tick.
- Add a term: the original term (2 to 128 characters, spelled as in the data), an optional alias, the identity kind, the match rule (whole word, exact, prefix) and a brand scope.
- Suggest with AI, when an AI connection exists: choose the kinds to scan, review the list, pick Brands to mask (all brands by default) and an AI model (only models from the organization's own AI settings; the others stay as failover), edit the replacement on each row, use Select all or Select none, then Accept selected. Nothing is written before you accept. Near the 200-term limit the dialog states how many slots are left and skips rows past it. AI also suggests a masked organization name; it applies only if you tick Apply this name on accept.
- Organization identity when anonymised: enter a Display name and upload a Logo (PNG, JPG or WebP), then Save identity. Left empty, the generic "Tổ chức A" and a monogram are used. The Demo role sees this name and logo in place of the real ones; brands read "Nhãn A", "Nhãn B"... in creation order, or the curated replacement when a term exists.
- Preview masking results with a sample text: one card per role plus the public link viewer, each marked raw or masked. Every role that must not read real names, and the public link viewer, should show "Masked".
- Archive a term that no longer applies. The row is kept; adding the same term again revives it.
If it fails#
| Symptom | Cause | Fix |
|---|---|---|
| Tab visible, page not found | Settings capability without an owner or admin role | Change the role, or ask an owner or admin. |
| Add-term form has no save button | No enabled plane declares an identity kind | Enable the plane; see Organization types. |
| "AI is not configured" on Suggest | No AI connection yet | Configure AI and the data assistant. |
| A suggestion run returns nothing | The chosen kinds have no data | Pick other kinds, or add terms by hand. |
| A name still reads real for a ticked role | The match rule misses that spelling | Switch to whole word, or add that exact form. |
| A downloaded file shows the real name | Exported before the term existed | Export again; masking applies when served, never retroactively. |