Agent Harness Tutorial · End to end · Zoom level 3
How we take care of it: token again
token again catches wrong audience or missing scope.
How we took care of it.
- The claims system verifies it itself: Entra signature, audience api://claims-system, a scope per operation.
| It reads | the on-behalf-of token the harness sends with each MCP call |
| Kind | rule |
| Provided by | claims system |
| If it fails | NotAuthorised → an error result |
| Where in the code | claims_system/server.py _Gate |
| Runs at | 5 · The tool itself |
Real exampleThe harness can't call a tool with more authority than Rohan has.
More on this: Tool call.
How it is done: the real code
Cut from the live repositories each time the site is built, so it always matches what runs.
@dataclass(frozen=True)
class _Gate:
"""Who is asking, and whether money may move: this system's checks."""
store: Store
authorise: Authorise
approvals: ApprovalRecordReader | None
clock: Callable[[], float]
limits: Settings
async def record(self, meta: Mapping[str, object]) -> ApprovalRecord | None:
named = meta.get(APPROVAL_META)
if self.approvals is None or not isinstance(named, str):
return None
return await self.approvals.approval(named)
async def holder(
self, operation: str, arguments: dict[str, Any], ctx: Context | None
) -> str | None:
meta = _meta(ctx)
call = Call(operation, SCOPES.get(operation, READ_SCOPE), _bearer(ctx, meta), meta)
try:
caller = await self.authorise(call)
except CallRefused as exc:
raise NotAuthorised(f"{operation} refused: {exc}") from None
if caller.holder is not None or not _workflow(caller):
return caller.holder
return _on_approval(await self.record(meta), operation, arguments)
async def payable(self, claim_id: str, who: str, ctx: Context | None) -> None:
"""The far end's own check on money moving (AHC-0057)."""
claim = await self.store.get_claim(who, claim_id)
if not claim.get("found"):
return # answered as unknown by the store, never as refused