How amberSearch mirrors Salesforce permissions
amber shows a Salesforce record only to users who can open that record in Salesforce. During indexing, amber reads your Salesforce sharing settings and stores the allowed audience with every record. At search time, a user finds a record only if they belong to that audience.
Permission mirroring is switched on per data source by the amber team. Without it, every user with access to the Salesforce data source in amber can find all indexed Salesforce content.
How access is decided
For each record, amber first checks the org-wide default (OWD) of its object.
Public objects (OWD Public Read Only or higher): everyone who has Read on the object, through a profile or a permission set, can find the record.
Private objects: a user can find the record if at least one of these applies.
Controlled by Parent objects take the audience of their parent record.
Owners and directly shared users must also have Read on the object. If amber cannot determine who may read a record, the record is hidden, not shown to everyone.
Special content types
Known limitations
Folders shared with selected users or groups are visible to View All Data users only, because Salesforce does not expose folder shares through its API.
When a record is shared with a group or role, every member can find it, including members who lack Read on the object.
The role hierarchy is always applied, also for custom objects where Grant Access Using Hierarchies is turned off.
A file link counts only if it points to a user, a library, the whole organization, or an account, contact, lead, opportunity, case or campaign. A file shared only through a Chatter group or another object type is visible to Query All Files users only.
Requirements
The amber user from the connected app setup must be able to read your sharing configuration, in addition to the content itself:
Org-wide defaults, profiles, permission sets and their assignments
Users, roles and folders
Share entries of the indexed objects and the links of files
In practice this means the permissions View Setup and Configuration and View All Data for the amber user.
When changes take effect
Salesforce does not mark a record as modified when only its sharing changes. Removing access therefore takes effect with the next full run.