liveBook · Manning

Is_authorized API

As explained in Authorization in Action

The Cedar is_authorized API is an interface that evaluates a Cedar authorization request and returns an access decision.

The Cedar is_authorized API evaluates an authorization request and returns an allow or deny decision. A policy enforcement point (PEP) assembles the request from the active identity, attempted action, target resource, context attributes, and relevant entity data. section 9.8

A PEP prepares each evaluation by:

  • Identifying the principal from a session or token. section 9.8
  • Selecting the action and resolving the target resource. section 9.8
  • Adding context such as device management status or time. section 9.8
  • Checking that attributes and entity references are complete, consistent with the Cedar schema, and correctly scoped. section 9.8

Document sharing request

A request to share a document can identify an employee as principal, use doc:share as the action, identify the document as resource, and include managed-device and time context. The PEP forwards the operation only when the API returns allow. section 9.8

Figure 9.2 The Policy Enforcement Point (PEP) in ACME’s Customer Collaboration platform translates a real-world /share request into a Cedar evaluation by combining session data (principal), entity data (resource relationships), and context signals (environment attributes). Cedar’s is_authorized API provides an allow or deny decision, which the PEP enforces before forwarding the request to the backend.

Trace how a real-world /share request becomes a Cedar evaluation combining session identity, resource relationships, and environmental signals. section 9.8

How Authorization in Action covers it

How deep it goes
Explains request assembly and validation, but does not detail Cedar’s internal policy-evaluation algorithm.
Examples
Uses document sharing with employee, document, managed-device, and time-of-day request values.
What it assumes
Assumes modeled entities, policies, and a Cedar schema while clarifying how runtime request data maps to them.
What you can do after
Apply Cedar authorization by constructing complete, consistent, correctly scoped requests and enforcing the returned decision.
How it connects
Connects principals, actions, resources, entity data, context attributes, Cedar schemas, and policy enforcement points.

This explainer was generated by Manning's knowledge graph from the text of Authorization in Action. The section links point to the parts of the book it draws on.