
Honest-Broker Custody, Two-Person Re-Identification & Server Workflows
Source:vignettes/honest_broker_and_server.Rmd
honest_broker_and_server.RmdOverview
dicomtk.server provides multi-user research server
orchestration and walled-off honest-broker key custody for clinical
DICOM studies:
-
8-Role OIDC/Keycloak RBAC:
pi,coordinator,annotator,auditor,admin,site_admin,honest_broker, anddpo. - SHA-256 Hash-Chained Audit Log: Every de-identification, re-ID request, approval, disclosure, QA review, and job submission is appended to a tamper-evident JSONL ledger.
-
Walled-Off Custody Enclave: Master keys and
patient-identity crosswalks live inside an isolated closure inaccessible
to
piand non-broker roles. -
Two-Person Re-Identification: Requires distinct
honest_brokeranddpoprincipals to approve a request before time-limited disclosure.
Quick Walkthrough
library(dicomtk.server)
tmp_dir <- tempfile("dicomtk_vig_")
ctx <- server_create_context(work_dir = tmp_dir, jwt_secret = "vignette-secret")
adm <- server_principal("adm-1", roles = "admin", project_ids = "*")
pi <- server_principal("pi-1", roles = "pi", project_ids = "nsclc-01")
hb <- server_principal("hb-1", roles = "honest_broker", project_ids = "*")
dpo <- server_principal("dpo-1", roles = "dpo", project_ids = "*")
project_create(ctx$projects, "nsclc-01", title = "NSCLC Radiomics")
#> $project_id
#> [1] "nsclc-01"
#>
#> $title
#> [1] "NSCLC Radiomics"
#>
#> $deid_profile
#> [1] "ps3.15"
#>
#> $custody_mode
#> [1] "broker"
#>
#> $created_at
#> [1] "2026-11-14T15:22:17Z"
project_list(ctx$projects)
#> # A tibble: 1 × 5
#> project_id title deid_profile custody_mode created_at
#> <chr> <chr> <chr> <chr> <chr>
#> 1 nsclc-01 NSCLC Radiomics ps3.15 broker 2026-11-14T15:22:17Z
# Verify audit chain integrity
audit_verify(ctx$logger)
#> $passed
#> [1] TRUE
#>
#> $n_entries
#> [1] 0
#>
#> $corrupted_line
#> [1] NA
unlink(tmp_dir, recursive = TRUE, force = TRUE)