Skip to content

Commit 2c8df4d

Browse files
committed
docs: fix OPA/token-issuance conflation in architecture summary and PRD
OPA is the PDP and returns an allow/deny decision or entitlements; it does not mint OAuth tokens. Token issuance under RFC 8693 is Keycloak's role as authorization server, initiated by AuthBridge as PEP. Signed-off-by: Oleg Blinder <olegb@il.ibm.com>
1 parent dac6b08 commit 2c8df4d

2 files changed

Lines changed: 2 additions & 2 deletions

File tree

aiac/docs/specs/ARCHITECTURE-SUMMARY.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ AIAC introduces a strict three-layer model that cleanly separates policy concern
3535
| Layer | Component | Responsibility |
3636
|---|---|---|
3737
| **Policy Management** | AIAC Agent | Translates natural-language policy into PDP configuration on every trigger |
38-
| **Policy Decision (PDP)** | OPA | Evaluates LLM-generated Rego rules; issues scoped tokens |
38+
| **Policy Decision (PDP)** | OPA | Evaluates LLM-generated Rego rules; returns the caller's entitlements/decision |
3939
| **Policy Enforcement (PEP)** | AuthBridge | Intercepts traffic; exchanges tokens; carries no policy knowledge |
4040

4141
The AIAC Agent subscribes to an event stream (NATS JetStream) and reacts to entity lifecycle

aiac/docs/specs/PRD.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ AIAC enforces a strict three-layer model:
5555
| **Policy Decision (PDP)** | OPA | Evaluates LLM-generated Rego rules; decides what a caller may access |
5656
| **Policy Enforcement (PEP)** | AuthBridge | Intercepts traffic; exchanges tokens; carries no policy knowledge |
5757

58-
The PEP (AuthBridge) is a pure enforcement layer. It performs RFC 8693 token exchanges sending only the target `audience` — no `scope` parameter. OPA evaluates the caller's role against the Rego rules and issues a token containing exactly the entitlements that role grants on the target service.
58+
The PEP (AuthBridge) is a pure enforcement layer. It performs RFC 8693 token exchanges sending only the target `audience` — no `scope` parameter. OPA evaluates the caller's role against the Rego rules and returns exactly the entitlements that role grants on the target service; Keycloak, as the authorization server, issues the token scoped to those entitlements.
5959

6060
This means `token_scopes` is absent from `authproxy-routes`. Route configuration carries routing intent only (`host``target_audience`). Policy intent lives entirely in OPA, kept current by AIAC.
6161

0 commit comments

Comments
 (0)