e744336385
C-6: ConnectorRuntime enforces capability_mask per operation.
READ-only ACs cannot invoke MUTATE operations (wipe, lock, retire).
C-7: AC validated against database (exists, active, not expired)
before connector invocation.
C-9: Delegated AC capability bounded by delegator's capability.
C-10: Command counter uses atomic SQL increment with limit check.
M-23: expire_stale() uses same atomic SQL pattern.
H-1: Sensitive credential fields hidden from repr/logs via repr=False.
H-2: Stub backend requires ALLOW_STUB_CREDENTIALS=true to activate.
H-3: Kerberos backend raises CredentialResolutionError instead of
returning stub ticket.
H-4: Chronicle INTENT emitted before execution, RESULT after.
H-5: device_id validated as UUID before Graph API URL interpolation.
H-8: ConnectorRuntime enforces governance for all connector invocations.
Signed-off-by: Tyler King <tking@guildhouse.dev>
61 lines
1.8 KiB
Python
61 lines
1.8 KiB
Python
from collections.abc import Callable
|
|
from typing import Annotated, Any
|
|
|
|
from annotated_doc import Doc
|
|
from starlette.background import BackgroundTasks as StarletteBackgroundTasks
|
|
from typing_extensions import ParamSpec
|
|
|
|
P = ParamSpec("P")
|
|
|
|
|
|
class BackgroundTasks(StarletteBackgroundTasks):
|
|
"""
|
|
A collection of background tasks that will be called after a response has been
|
|
sent to the client.
|
|
|
|
Read more about it in the
|
|
[FastAPI docs for Background Tasks](https://fastapi.tiangolo.com/tutorial/background-tasks/).
|
|
|
|
## Example
|
|
|
|
```python
|
|
from fastapi import BackgroundTasks, FastAPI
|
|
|
|
app = FastAPI()
|
|
|
|
|
|
def write_notification(email: str, message=""):
|
|
with open("log.txt", mode="w") as email_file:
|
|
content = f"notification for {email}: {message}"
|
|
email_file.write(content)
|
|
|
|
|
|
@app.post("/send-notification/{email}")
|
|
async def send_notification(email: str, background_tasks: BackgroundTasks):
|
|
background_tasks.add_task(write_notification, email, message="some notification")
|
|
return {"message": "Notification sent in the background"}
|
|
```
|
|
"""
|
|
|
|
def add_task(
|
|
self,
|
|
func: Annotated[
|
|
Callable[P, Any],
|
|
Doc(
|
|
"""
|
|
The function to call after the response is sent.
|
|
|
|
It can be a regular `def` function or an `async def` function.
|
|
"""
|
|
),
|
|
],
|
|
*args: P.args,
|
|
**kwargs: P.kwargs,
|
|
) -> None:
|
|
"""
|
|
Add a function to be called in the background after the response is sent.
|
|
|
|
Read more about it in the
|
|
[FastAPI docs for Background Tasks](https://fastapi.tiangolo.com/tutorial/background-tasks/).
|
|
"""
|
|
return super().add_task(func, *args, **kwargs)
|