Use Security.stripInaccessible to enforce CRUD/FLS on user-supplied records before DML, and to scrub query results before returning them to clients. Covers AccessType.READABLE/CREATABLE/UPDATABLE/UPSERTABLE, the SObjectAccessDecision API, when to prefer WITH USER_MODE on the SOQL itself, and integration with the SecurityUtils template. NOT for class-level sharing keyword choice (with sharing / without sharing / inherited sharing — see apex-sharing-keywords). NOT for managed sharing or Apex managed sharing recalculations (see sharing-selection decision tree).
Instrucciones de origen · Vista previa de solo lectura
name
apex-stripinaccessible-and-fls-enforcement
description
Use Security.stripInaccessible to enforce CRUD/FLS on user-supplied records before DML, and to scrub query results before returning them to clients. Covers AccessType.READABLE/CREATABLE/UPDATABLE/UPSERTABLE, the SObjectAccessDecision API, when to prefer WITH USER_MODE on the SOQL itself, and integration with the SecurityUtils template. NOT for class-level sharing keyword choice (with sharing / without sharing / inherited sharing — see apex-sharing-keywords). NOT for managed sharing or Apex managed sharing recalculations (see sharing-selection decision tree).
["how do i enforce field level security before insert in apex","stripinaccessible vs with user_mode vs with security_enforced","user can edit fields they should not be able to edit via my rest endpoint","apex aura controller exposing fields the running user cannot read","sobjectaccessdecision getrecords getremovedfields how to use","should i call stripinaccessible after a user_mode soql query"]
inputs
["User-supplied SObject records about to be inserted, updated, or upserted","Query results that will be returned to a less-privileged caller (LWC, REST, Aura)","Running user context (System.runAs target during tests)","AccessType the operation requires (READABLE / CREATABLE / UPDATABLE / UPSERTABLE)"]
outputs
["DML-safe sanitized record list with inaccessible fields stripped","Audit log of removed fields per record (via SObjectAccessDecision.getRemovedFields)","Test class proving FLS enforcement under a non-admin profile","Decision: stripInaccessible vs WITH USER_MODE vs proactive describe checks"]
dependencies
[]
version
1.0.0
author
Pranav Nagrecha
updated
2026-04-28T00:00:00.000Z
Apex stripInaccessible and FLS Enforcement
Activate when Apex code accepts records from a less-privileged context (LWC, Aura, REST, Visualforce) and writes them to the database, OR when query results need to be scrubbed of fields the running user cannot read. Security.stripInaccessible(AccessType, records) removes inaccessible fields from a record collection and returns an SObjectAccessDecision you must operate on instead of the original list.
Before Starting
Confirm the records are user-supplied. Internal trusted-context data (e.g., trigger handler reading from the trigger context with without sharing) does not need stripInaccessible.
Decide the AccessType: are you reading, creating, updating, or upserting? The wrong enum will silently strip the wrong fields.
Confirm the calling class's sharing keyword. with sharing enforces record visibility; stripInaccessible enforces FIELD visibility. Both are needed for full enforcement.
If the SOQL itself is fetching records to return to a less-privileged caller, prefer WITH USER_MODE (Summer '23+) on the query and skip a redundant strip pass.
Core Concepts
The four AccessType enum values
AccessType is the first argument to Security.stripInaccessible. Each value evaluates a different permission:
AccessType.READABLE — strips fields the user cannot read. Use AFTER a SOQL query whose results you'll return to a less-privileged caller.
AccessType.CREATABLE — strips fields the user cannot create. Use BEFORE insert.
AccessType.UPDATABLE — strips fields the user cannot update. Use BEFORE update.
AccessType.UPSERTABLE — strips fields the user cannot create OR update. Use BEFORE upsert. This is the strict intersection: a field must be both creatable AND updatable to survive.
Picking the wrong AccessType is a real bug. READABLE before an update will leave create-only or update-only fields in the payload that the user could not have set themselves.
Security.stripInaccessible(...) returns an immutable SObjectAccessDecision. You cannot mutate the original list and call it safe — you must operate on the decision's outputs:
getRecords() — the sanitized list with inaccessible fields removed. Always DML on this, never on the original argument.
getRemovedFields() — a Map<String, Set<String>> keyed by SObject API name, value is the set of removed field API names. Useful for logging/audit and for surfacing soft warnings.
getModifiedRecords() — a Map<Id, SObject> of records that had at least one field stripped (post-DML id only — useful when re-fetching).
Canonical pattern wrapping DML
public void createCases(List<Case> userSupplied) {
SObjectAccessDecision decision =
Security.stripInaccessible(AccessType.CREATABLE, userSupplied);
if (!decision.getRemovedFields().isEmpty()) {
ApplicationLogger.warn('createCases',
JSON.serialize(decision.getRemovedFields()));
}
insert decision.getRecords(); // NEVER `insert userSupplied;`
}
The single most common bug is calling insert userSupplied; after the strip — the strip then has zero effect.
When stripInaccessible is the right choice vs WITH USER_MODE
Goal
Prefer
Querying records to return/manipulate as the running user
WITH USER_MODE on the SOQL itself
DML on records assembled from user input (e.g., REST body)
Rule of thumb: WITH USER_MODE is THROW-on-inaccessible, stripInaccessible is REMOVE-and-continue. Pick based on whether silent partial success is acceptable.
Performance — per-record FLS evaluation
stripInaccessible evaluates FLS for every field on every record. For large lists (10k+) it consumes CPU. It does NOT count against SOQL/DML governor limits, but it does count against the 10-second sync CPU limit. Profile before strip-then-DML on huge collections; consider chunking.
Gotcha: parent-child relationships are NOT recursively stripped
stripInaccessible evaluates fields on the SObject collection you pass. If a Case carries a populated Contact lookup with nested fields (e.g., caseRec.Contact.Email), those nested fields are NOT evaluated. You must strip child collections separately.
SObjectAccessDecision parents = Security.stripInaccessible(AccessType.UPDATABLE, cases);
SObjectAccessDecision contacts = Security.stripInaccessible(
AccessType.UPDATABLE,
Pluck.contacts(parents.getRecords()) // your own helper
);
Interaction with Schema.SObjectField.isCreateable / isUpdateable / isAccessible
Schema.DescribeFieldResult.isCreateable() is a CHEAP proactive check — use it to fail fast before assembling a payload. stripInaccessible is an EXPENSIVE post-hoc scrub — use it as the enforcement gate. They are complementary, not redundant.
if (!Schema.sObjectType.Account.fields.AnnualRevenue.isCreateable()) {
throw new AuraHandledException('You cannot set AnnualRevenue.');
}
// later, still call stripInaccessible before insert as defense-in-depth.
Testing with System.runAs
Tests run as the system user by default — FLS is bypassed. To prove stripInaccessible actually strips, create a non-admin user with limited permissions and wrap your test in System.runAs(testUser). Without runAs, your strip call returns the input unchanged and your test passes for the wrong reason.
Common Patterns
Pattern: REST endpoint — strip before DML
When to use:@RestResource accepting a JSON body of records.
How it works: Deserialize, strip with the appropriate AccessType, log removed fields for audit, DML on the stripped result.
Why not the alternative: Trusting the JSON payload assumes the running user can set every field they sent — they often cannot.
Pattern: Aura/LWC controller — strip on the way out
When to use:@AuraEnabled method returning records to the client.
How it works: Query with WITH USER_MODE (preferred) OR strip the result with AccessType.READABLE before returning. Returning unscrubbed records lets the client see fields the user cannot read in the UI.
Pattern: Defense-in-depth with WITH USER_MODE + stripInaccessible
When to use: The query already uses USER_MODE, but you also need to write back updates from a partially user-controlled object.
How it works: USER_MODE protects the read; stripInaccessible(UPDATABLE) protects the write. Each guards a different operation — do not collapse them.
Decision Guidance
Situation
Recommended Approach
Reason
REST/LWC inserts user-supplied records
stripInaccessible(CREATABLE, ...) then DML on getRecords()
Records originate from a less-trusted client
Aura controller returns records
WITH USER_MODE on the SOQL
Throws on inaccessible read, no silent strip
Upsert from a user-supplied list
stripInaccessible(UPSERTABLE, ...)
Intersects creatable AND updatable
Internal trigger handler updating fields the running user can edit anyway
Skip — not user-supplied
stripInaccessible cost not justified
Need to know WHICH fields got removed for audit
stripInaccessible + getRemovedFields()
USER_MODE throws, gives no per-field detail
Running on API < 48
WITH SECURITY_ENFORCED
stripInaccessible introduced in API 45, USER_MODE in 58
Recommended Workflow
Identify entry points where records cross from less-privileged caller (LWC, Aura, REST, Visualforce) into Apex. Mark every parameter.
For each entry point, pick the correct AccessType based on the DML you'll perform (CREATABLE for insert, UPDATABLE for update, UPSERTABLE for upsert, READABLE for outbound payloads).
Replace the raw DML on the input list with DML on Security.stripInaccessible(type, input).getRecords(). Capture the decision in a local variable so you can also call getRemovedFields().
Strip child collections separately if relationships are populated — parent strip does NOT recurse.
Log getRemovedFields() (or surface as a warning to the caller) so silent stripping is observable.
Add a test under System.runAs(nonAdminUser) that proves a restricted field IS stripped. The same test under default system context should be a no-op.
Run python3 scripts/check_apex_stripinaccessible_and_fls_enforcement.py over the changed .cls files to catch the "stripped-then-DML-on-original" mistake.
Review Checklist
Every user-supplied record list passes through Security.stripInaccessible before DML
DML targets decision.getRecords(), never the original argument
AccessType matches the DML operation (CREATABLE/UPDATABLE/UPSERTABLE)
Outbound query results either use WITH USER_MODE or AccessType.READABLE strip
Child collections are stripped independently when relationships are populated
getRemovedFields() is logged or surfaced; silent stripping is forbidden
Test class uses System.runAs(nonAdminUser) and asserts a restricted field was removed
No double-enforcement (USER_MODE in SOQL AND READABLE strip on the same path)
Salesforce-Specific Gotchas
DML on the original list silently bypasses the strip.stripInaccessible(...).getRecords() returns a NEW list. Calling insert userSupplied; after the strip line does nothing — the strip's effect is in getRecords().
Parent strip does not recurse into child collections.Security.stripInaccessible(UPDATABLE, cases) does not evaluate fields on case.Contact.*. Strip child collections separately.
Tests pass under system context regardless of FLS. Without System.runAs(nonAdminUser), every field is accessible and your strip call is a no-op — the test proves nothing.
AccessType.UPSERTABLE is the intersection of CREATABLE and UPDATABLE. A field accessible for create but not update gets stripped on UPSERTABLE — this is correct behavior for upsert but surprising if you expected union semantics.
SObjectAccessDecision is immutable. You cannot mutate getRecords() results and have those changes reflect anywhere; call DML directly on the returned list.
Output Artifacts
Artifact
Description
Sanitized DML payload
decision.getRecords() — the only safe input to insert/update/upsert
Removed-fields audit
decision.getRemovedFields() map for logging or warnings
FLS enforcement test
Test under System.runAs(nonAdmin) proving restricted field stripped
AccessType decision note
Documented choice of CREATABLE / UPDATABLE / UPSERTABLE / READABLE per entry point
Related Skills
apex/apex-with-user-mode-soql — when to prefer USER_MODE on the SOQL itself
apex/apex-sharing-keywords — class-level with sharing / without sharing / inherited sharing (record visibility, complements FLS)
apex/apex-security-utils — using the shared templates/apex/SecurityUtils.cls helpers
security/security-fls-crud-enforcement — broader CRUD/FLS strategy across the org
