Skip to content
Try Pro free for 14 daysHeyBrain is now live for general availability; join leading teams using HeyBrain!Start Free
Research

How AI knowledge access works: identity, permissions and retrieval

· Updated · 4 min read

Contents

Who sees what

Identity, permissions and retrieval

Two employees ask an assistant for the project budget. One works on the project; the other does not. A well-designed access path can return the budget to the first employee while withholding it from the second. The important question is how that difference is enforced, from the request through the document link.

    Start with a small access map

    In this fictional design example, Project Elm has two documents. “Elm overview” says the team is preparing a customer workshop and is available to all employees. “Elm budget” says the approved workshop budget is $8,000 and is available only to the Elm project group. Ada is in that group; Ben is not. These documents and people are invented, not a HeyBrain test.

    The intended result is precise: Ada may receive the $8,000 answer and open its source. Ben may receive the public overview, but no budget amount, restricted excerpt or revealing citation title. This is the policy the implementation must enforce.

    1. Identify the requester, then authorize the resource

    Authentication establishes which account or service is making the request. Authorization determines whether that identity may perform an operation on a resource. NIST’s Zero Trust Architecture treats those as distinct functions; being inside the company network is not enough.

    Ada and Ben can both be successfully signed in while receiving different document permissions. An identity token is an input to the permission decision, not evidence that every document is allowed. An external agent also needs a supported identity or delegation path whose effective grants are understood.

    In the Elm example, group membership supplies the rule for the budget. Other designs might use attributes such as project assignment or document sensitivity. Role-based and attribute-based controls are options; calling a product an “AI brain” does not mean it implements both.

    2. Keep unauthorized content out of the answer’s evidence

    The retrieval path should enforce the resource decision before unauthorized text enters the model context or user-visible results. It can rank relevant material within an allowed set or use another design that enforces the same boundary. A shared index is not inherently insecure; an index without the required authorization is.

    For Ada, the authorized evidence contains the overview and budget. For Ben, it contains the overview only. A design that gives the model the budget and asks it not to tell Ben has already crossed the intended context boundary. Output checks can provide another layer, but do not undo that disclosure.

    OWASP’s authorization guidance recommends least privilege, denial by default and checks on each request. In a knowledge application, the linked document-open path matters as well as search: a restricted result should not become available through a guessed URL.

    3. Decide whether partial documents are supported

    Suppose the overview also contains the budget in an appendix. The implementation now needs a defined rule for that mixed document. It could exclude the whole document for Ben, provide an approved public version, or enforce a supported field or section restriction before returning content.

    Fine-grained redaction is a capability to establish, not a property implied by the category name. If it is unavailable or unreliable for the document format, excluding the mixed document may be the appropriate choice. Do not promise a salary column will disappear merely because retrieval checks file-level permission.

    4. Handle changes and records without overclaiming

    Removing Ada from the project group introduces a new question: when will the search index, cached results and existing client sessions honor that change? Source permission synchronization can be implemented in different ways. Establish the documented behavior and check the actual paths you plan to use; do not assume instant inheritance.

    Record enough information to investigate the request while protecting the records themselves. A timestamped resource reference and authorization result can be useful, but identifiers, titles and questions may still reveal sensitive information. Integrity evidence covers the records included in that mechanism, not every possible event.

    Deletion is separate again. Removing the Elm budget from active retrieval does not prove erasure from conversations, exports, logs, backups or a downstream client. A retrieval architecture alone cannot establish universal deletion or legal compliance.

    What to ask about an actual product

    Ask which identity reaches the permission check, where it is enforced, how document-open requests are protected, and how changes reach imported material. Then compare the answers with the actual configuration and a scoped test. The five-check access example supplies a practical starting fixture.

    HeyBrain’s privacy policy describes data handling, including imported content and separate records. This architecture explanation is not a claim that all HeyBrain connectors inherit permissions, that every account has single sign-on or field redaction, or that agents receive identical controls across all clients.

    Prepared by HeyBrain Editorial Team with AI assistance. Examples are fictional illustrations, not observed customer incidents or product tests. This correction retains the original publication date and removes unsupported security guarantees. Primary sources were checked on 13 October 2026.

    HeyBrain Editorial TeamEditorial · AI-assisted

    Stay in the loop

    Follow articles on AI knowledge, agent governance and product updates in your feed reader.

    Follow the HeyBrain blog

    Get new articles in your feed reader.

    Subscribe via RSS →