Skip to content
MSO CloudDocumentation

Set up identity masking

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.
Data masking"Che dữ liệu"Role-based masked data visibilityOwnerAdminEditorViewerchecked = sees masked data; editor and viewer are checked until the first saveMask brand names in navigation & interfaceMask source records in detail tables tooSave changes1Masked terms catalogAdd a termSuggest with AI23KindOriginal termReplacementMatch ruleSourceBrand scopeBrandVinasoyBrand AIn a sentence (Whole word)Manual entryAll brandsCreatorLinh ReviewCreator BExact match (100%)AI suggested (Approved)Brand 1CompetitorNutifoodCompetitor CStarts with (Prefix)Manual entryAll brandsArchiveArchiveArchive5Add a term: original term (2-128 characters), optional alias, identity kind, match rule, brand scope. The term is stored verbatim; only the display is rewritten.Suggest with AI: pick the kinds to scan, review, then Accept selected; nothing is written before that. Archive keeps the row for re-adding.Preview masking resultsSample textVinasoy tăng 12% nhờ Linh ReviewPreview results4Display result by role:OwnerRaw dataVinasoy · Linh ReviewAdminRaw dataVinasoy · Linh ReviewEditorMaskedBrand A · Creator BViewerMaskedBrand A · Creator BPublic link viewerMaskedBrand A · Creator B
Settings > Data masking. Callout N marks the control used in step N.

Steps#

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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".
  6. Archive a term that no longer applies. The row is kept; adding the same term again revives it.
ViewerSees the tabOpens the pageReads by defaultOwner or adminyesyesreal names, until the role is checkedOther role holding organization settingsyesnoper the role checkboxSuper adminyesyesreal names, unless platform demo posture is onPublic link viewernonoalways masked
Two gates decide who reaches Settings > Data masking; a third rule decides what each viewer reads.

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.