🔐 New: A CISO’s benchmark for authorization maturity ➔ [Download the ebook](https://solutions.cerbos.dev/authorization-maturity-model-a-cisos-benchmark)

# Authorization-aware data filtering for Mongoose

Convert Cerbos query plans into native Mongoose filters, return only the data your users are authorized to see.

[Mongoose adapter v2.0](/content/blog/updated-mongoose-adapter-for-cerbos-query-plans-v2/index.html)[Integration library](https://github.com/cerbos/query-plan-adapters/tree/main/mongoose)

### Extend user roles

Fine-grained access controls extending the roles defined in Mongoose models

### Enrich with context

Request-time attribute-based authorization enables more contextual access controls

### Avoid token bloat

Independent authorization logic avoids bloated tokens and workarounds

## How Cerbos works with Mongoose

When users should only see a subset of data, traditional approaches filter results in application code, leading to duplicated logic, inconsistencies, and performance problems at scale.

Cerbos query plan evaluation converts your authorization policies into native Mongoose filters. Instead of fetching all data and filtering after the fact, your database only returns rows the user is authorized to see.

The same YAML policies that control API-level access now drive data-level filtering, one source of truth for who can see what, managed by product and security teams without touching application code.

[Policy-as-codeHuman-readable YAML policies managed like source code](/content/features-benefits-and-use-cases/human-readable-authorization/index.html) [Scalable PDPStateless policy decision point with sub-millisecond latency](/content/features-benefits-and-use-cases/scalability/index.html) [Centralized managementManage, test, and deploy policies from a single control plane](/content/features-benefits-and-use-cases/centralized-management/index.html)

### How Cerbos filters data in Mongoose

1. **Define authorization policies in YAML**, Write resource policies that describe who can see which records, using roles and attributes.
2. **Request a query plan from Cerbos**, Your application calls the PlanResources API, and Cerbos returns an abstract query plan.
3. **Convert the plan to a native Mongoose filter**, Map the Cerbos query plan to a Mongoose query predicate so filtering happens at the data layer.
4. **Database returns only authorized rows**, The query executes with the authorization filter baked in, no post-fetch filtering required.

## FAQ

### How does Cerbos filter data in Mongoose?

Cerbos evaluates your authorization policies and produces a query plan. The Mongoose adapter converts that plan into a native query filter, so your database only returns rows the user is authorized to see.

### Does this replace application-level authorization checks?

Data filtering complements API-level checks. Cerbos handles both, the same policies that control who can access an endpoint also determine which rows are visible at the data layer.

## Cerbos + Mongoose

- Cerbos policies converted to native Mongoose query filters
- Database returns only rows the principal is authorized to see
- One source of truth for API and data-level access control
- Filtering happens at the query level, not post-fetch