MunitasFeature tourAll walkthroughs

All walkthroughs / Health organisation

Health organisation · Set-up: Departments, Roles and Limits

Before the programme starts: who owns what, and who may do what

Before a research programme brings in any new data, the Health organisation already has its structure in place. Priya, who runs the platform, walks through it: the departments and who answers for each, the people and their roles, what each role may read without asking, and the limits on what people may ask for.

5Steps
1Person
about 4Minutes to read
Who is involved
Priya
Platform administrator, who runs Munitas itself

How to read this page

Words used on this page

Organisation
A company or hospital group that uses Munitas. Each organisation sees only its own data.
Department
A team inside an organisation that owns some of its data, such as Cardiology.
Dataset
A named collection of records, such as a table of patient admissions.
Custodian
A person who holds the data custodian role, which allows deciding who may read data. A custodian decides for the departments they are an approver for.
Department approver
A custodian who is listed for one department and may approve access to its data and confirm claims about it. A department can have several, and any one of them can act on their own.
Role
A named set of permissions that a person can hold, such as the permission to decide who may read a department’s data.
Platform administrator
The person who runs Munitas itself. The role gives no say over who may read any department’s data.
Lease
Permission, given by the custodian, to read one dataset for one stated purpose and for a limited time.
Access level
How restricted a dataset is. Raw is the most restricted, and nobody may read it without permission. Published is the most open.
Version
One sealed state of a dataset. Changing the contents means making a new version, never editing an old one.
Locked column
A column whose values are scrambled under a key made for each person. Reading them back needs permission. Destroying a person’s key later makes their values unreadable for good, while the sealed table itself never changes.

Who is who in the Health organisation

Thirteen fictitious people are registered in the Health organisation. Each holds a role, which is a named set of permissions, and a data custodian is an approver for one department. Step 3 shows the screen that this table comes from.

PersonRoleWhat the role is forApproves access for
PriyaPlatform administrator, Support and reliabilityRuns Munitas itself and looks after the organisation's setup, with no say over who may read a department's data.No department
RaviPlatform administrator, Support and reliabilityRuns Munitas itself and looks after the organisation's setup, with no say over who may read a department's data.No department
HartleyData custodianDecides who may read the data of one department, and can approve access to that department's data only.Cardiology
MensahData custodianDecides who may read the data of one department, and can approve access to that department's data only.Oncology
LindqvistData custodianDecides who may read the data of one department, and can approve access to that department's data only.Orthopaedics
OkonjoData custodianDecides who may read the data of one department, and can approve access to that department's data only.Radiology
DeviData engineerBrings data in, and registers pipelines and agents.No department
SamResearcherAsks to read data, and works with data that has already been de-identified.No department
ImaniDe-identification reviewerDecides whether a result with the names removed may be released.No department
MarlowPrivacy auditorChecks how locked data was used, and reads records of use but no personal data.No department
NakamuraData protection officerWatches how the organisation handles personal data, and decides nothing about who may read it.No department
OkaforAI risk ownerAnswers for how the organisation holds its AI agents: writes the risk levels and the approved tools list, confirms each agent's level, and gives the second approval.No department
TurnerNetwork architectDecides which external hosts an AI agent may call.No department
PART ONE

Who owns what, and who may do what

Priya is the platform administrator at a hospital group that uses Munitas. The platform administrator keeps Munitas itself running and looks after the organisation's setup, but has no say over who may read a department's data. That belongs to the departments that own the data and to their approvers.

1
Priya
Priya signs in
Munitas console · Sign in · /auth/login

Priya types an email address and a password. Munitas never takes a typed name as proof of who somebody is. Everyone signs in for real, and what the console shows afterwards depends on who signed in and which organisation they belong to.

Screenshot: Priya signs in
The page still says Nobody is signed in, and the email box holds priya@health.example. The picture was taken just before Priya pressed Sign in.
2
Priya
The Departments page shows who answers for each department
Munitas console · Departments · /departments

A department is the part of an organisation that owns a set of datasets, and a dataset is a named collection of data that Munitas keeps. Each card is one department of the Health organisation, with the number of datasets it owns and its approvers. The approvers are data custodians, people who hold the role that lets them decide who may read the department's data. Permanent means the entry has no end date. Only an approver of a department can change that department's list, so even Priya, who runs the platform, cannot add anybody to it.

Screenshot: The Departments page shows who answers for each department
There are four cards: Cardiology, Oncology, Orthopaedics and Radiology. Each has one approver, Hartley, Mensah, Lindqvist and Okonjo in that order, and every card ends with Only an approver of this department can change this list.
3
Priya
The same list is on the People and roles page in the console
Munitas console · People and roles · /directory

In the console, the menu entry People and roles opens the screen that the table at the top of this page comes from. The last column of the screen says which department a data custodian may approve for.

Screenshot: The same list is on the People and roles page in the console
Hartley is a Data custodian for Cardiology, and the last column says Cardiology only: Hartley can approve access to Cardiology's data and nobody else's. Devi is a Data engineer, and the last column says no, as it does for everyone who is not a data custodian.
4
Priya
No role reads sensitive data without permission, and that includes the platform administrator
Munitas console · What each role can do · /roles

This page is the same in every organisation. It lists each role a person can hold, the most sensitive data that role may read without asking, and whether the role may approve access beyond that. An access level says how restricted data is, and Published is the most open. Anything more sensitive needs a lease, which is permission to read one version of one dataset for one stated purpose and for a limited time. Somebody else has to approve it.

Screenshot: No role reads sensitive data without permission, and that includes the platform administrator
Look at the Can read without a lease column. For the platform administrator, and for every other role a person can hold, it says Published data only. Only the Data custodian may approve access, and the page says yes, for their own department. The last section puts it plainly: Nobody else can, including administrators, and you cannot approve your own.
5
Priya
The organisation sets limits on what people may ask for
Munitas console · Limits · /limits

When somebody asks for access, they say what they want, why, and for how long. This page shows the limits the organisation has set on how much a person may ask for. A locked column holds values that identify a person, and a locked file is a file that stays unreadable until somebody is allowed to open it. For each limit the page shows the value in force now, the default, and the highest value the platform allows. An approver still decides every request.

Screenshot: The organisation sets limits on what people may ask for
Take Most rows in one request: the limit now is 20 rows, which is also the default, and the platform allows at most 100 rows. Every line ends with Not changed, because the organisation has kept the defaults. At the top the page says To change a limit, ask your platform administrator.