Enforces that no federated learning site bundle or summary table leaves an
institution without an explicit cryptographic sign-off from an authenticated
site_admin principal, verifying minimum-cell k-anonymity and manifest
SHA-256 integrity.
Public fields
k_min
Minimum cell count required for outbound approval.
Methods
Method new()
Initialize an outbound approval gate.
Arguments
gate_secret
Secret HMAC-SHA256 signing key held by the site governance enclave.
k_min
Minimum cell count threshold (default 10L).
Method manifest_digest()
Compute canonical SHA-256 digest of an outbound manifest.
Usage
fl_site_approval_gate$manifest_digest(manifest)
Arguments
manifest
Named list describing the outbound cohort/model manifest.
Returns
Hexadecimal SHA-256 digest string.
Method approve_export()
Issue a signed site_admin approval receipt for an outbound manifest.
Usage
fl_site_approval_gate$approve_export(
principal,
manifest,
dp_epsilon = NULL,
dp_delta = 0,
min_cell_count
)
Arguments
principal
List or RBAC principal containing user_id and role.
manifest
Named list describing the outbound cohort/bundle.
dp_epsilon
Optional declared DP epsilon budget.
dp_delta
Optional declared DP delta budget.
min_cell_count
Minimum cell count in the outbound dataset/summary.
Returns
An object of class "dicomtk_fl_approval_receipt".
Method verify_receipt()
Verify a site_admin approval receipt against an outbound manifest.
Usage
fl_site_approval_gate$verify_receipt(receipt, manifest)
Arguments
receipt
A "dicomtk_fl_approval_receipt" object.
manifest
Named list matching the approved manifest.
Returns
TRUE if valid; otherwise aborts with dicomtk_fl_unauthorized_export_error.
Method revoke_receipt()
Revoke a previously issued approval receipt.
Usage
fl_site_approval_gate$revoke_receipt(receipt_id)
Arguments
receipt_id
Character scalar receipt ID.
Method clone()
The objects of this class are cloneable with this method.
Usage
fl_site_approval_gate$clone(deep = FALSE)
Arguments
deep
Whether to make a deep clone.