cleandataengineering.aiAgent Harness, drawn simply
You are here: End to end › Checks › 5 · The tool itself › token again

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.

Open: 11before loopopen ›Open: 22before modelopen ›Open: 33after modelopen ›Open: 44before toolopen ›Open: 55the toolopen ›Open: 66after toolopen ›Open: 77after loopopen ›Open: 88before replyopen ›It readsthe on-behalf-of token the harnesssends with each MCP calltoken againrule · claims systempassCarries onfailIf it failsNotAuthorised → an error resultWHERE IN THE CODE: claims_system/server.py _Gate
The strip at the top shows every check point where this check runs, in dark.

How we took care of it.

  1. The claims system verifies it itself: Entra signature, audience api://claims-system, a scope per operation.
It readsthe on-behalf-of token the harness sends with each MCP call
Kindrule
Provided byclaims system
If it failsNotAuthorised → an error result
Where in the codeclaims_system/server.py _Gate
Runs at5 · 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