...
When a client starts an OIDC Authorization Code Flow for a municipal user, it uses SEB and KOMBIT Context Handler and goes through the following federation process.
...
Term | Description |
---|---|
User-facing system (Danish: Brugervendt system) | An IT system that provides an access-controlled user interface, A user-facing system registered in the KOMBIT STS admin enables it to use KOMBIT systems for access control of end-users. For the KOMBIT external test environment the following eHealth environments are registered as user-facing systems, and thereby use KOMBIT systems for access control:
Similar registrations are made in the KOMBIT STS Admin in the KOMBIT production environment, only here the sole SAML Proxy is in eHealth Infrastructure production environment (PROD). |
User system role (Danish: Brugersystemrolle) | Grouping of rights or permissions that define access and access restrictions to a specific user-facing system
|
Data constraint (Danish: Dataafgrænsning) | Restriction of a “user system role”, which narrows the system role's field of action Concerning eHealth Infrastructure, these are: System-specific data constraint
Cross-cutting (data constraint
|
Job function role (Danish: Jobfunktionsrolle) | Grouping of user system roles for an authority (e.g. municipality) used by the authority to assign access to the user. Each municipality shall maintain a set in KOMBIT STS Admin. Concerning eHealth Infrastructure, these the job function role should comprise:
|
User facing system
For the KOMBIT external test environment the following eHealth environments are registered as user-facing systems, and thereby use KOMBIT systems for access control:
User facing system in FK Administration | System | |||
---|---|---|---|---|
1 | FUT - SAML Proxy (devtest) | FUT saml-proxy for the internal Systematic Test Environment | ||
2 | FUT - SAML Proxy (inttest) | FUT saml-proxy for the eHealth Internal Test Environment | ||
3 | FUT - SAML Proxy (exttest) | FUT saml-proxy for the eHealth External Test environment (exttest) and external development environment (devenvcgi). | ||
4 | FUT - SAML Proxy (test002) | FUT saml-proxy for the eHealth Education environment (TEST002) | ||
5 | FUT - SAML Proxy (preprod) | FUT saml-proxy for the eHealth pre-production environment | ||
6 | “T-SEB”
| T-SEB for all eHealth test (incl. pre-prod) environments. |
Similar registrations are made in the KOMBIT STS Admin in the KOMBIT production environment, only here the sole SAML Proxy is in the eHealth Infrastructure production environment (PROD).
Data constraints (Danish: “data afgrænsninger”)
...
CareTeam - a system-specific data constraint identifying a CareTeam. The optional for some user system roles, required for others (see below)
Organisation - Cross-cutting (data constraint) identifying Organisation from KOMBIT FK Organisation.
...
Usersystem
This data constraint is defined and maintained outside eHealth.
User facing system | Data Contraint Name | EntityId | Syntax validation | |||||||
---|---|---|---|---|---|---|---|---|---|---|
1 | DEVTEST | Careteam |
| ([0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[0-9a-f]{4}-[0-9a-f]{12})+(,\s*[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[0-9a-f]{4}-[0-9a-f]{12})* | ||||||
2 | INTTEST | Careteam |
| ([0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[0-9a-f]{4}-[0-9a-f]{12})+(,\s*[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[0-9a-f]{4}-[0-9a-f]{12})* | ||||||
3 | EXTTEST, DEVENVCGI | Careteam |
| ([0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[0-9a-f]{4}-[0-9a-f]{12})+(,\s*[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[0-9a-f]{4}-[0-9a-f]{12})* | ||||||
4 | TEST002 | Careteam |
| ([0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[0-9a-f]{4}-[0-9a-f]{12})+(,\s*[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[0-9a-f]{4}-[0-9a-f]{12})* | ||||||
5 | PREPROD | Careteam |
| ([0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[0-9a-f]{4}-[0-9a-f]{12})+(,\s*[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[0-9a-f]{4}-[0-9a-f]{12})* | ||||||
6 | “T-SEB”
| Careteam
|
| ([0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[0-9a-f]{4}-[0-9a-f]{12})+(,\s*[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[0-9a-f]{4}-[0-9a-f]{12})* |
STS Admin User system roles for the eHealth Infrastructure
...
shall have an EntityId on the form:
<namespace>
appended with<KOMBIT user system role for the eHealth Infrastructure>
(see below).can have (and should have) a name in Danish which is the Danish designation https://docs.ehealth.sundhed.dk/latest-released/ig/CodeSystem-ehealth-oio-bpp-roles.html for the corresponding eHealth Infrastructure OIO BPP system role.
Note |
---|
|
The <namespace>
shall reflect the eHealth Infrastructure environment for registration in the KOMBIT STS Admin. The <namespace>
shall be one of the following:
eHealth Infrastructure Environment | <namespace>Namespace | |||||
---|---|---|---|---|---|---|
1 | INTTEST |
| ||||
2 | EXTTEST, DEVENVCGI |
| ||||
3 | TEST002 |
| ||||
4 | PREPROD |
| ||||
5 | PROD |
| ||||
6 | “T-SEB”
|
|
Note |
---|
In case of change in what eHealth Infrastructure environments shall support municipal federation of authentication and authorization, the above list needs to be updated. In addition, such a change needs to be implemented in the mapping performed by the SAML Proxy. |
...
KOMBIT user system roles for the eHealth Infrastructure | Data constraints (EXTTEST) | Data constraints | ||||||
---|---|---|---|---|---|---|---|---|
STS Organisationsenhed | Careteam | Data constraints (Prod) Organisation | SOR Organisationsenhed | SSL Organisationsenhed | Careteam | |||
|
| Mandatory | Mandatory | XOptional | ||||
|
| Mandatory | Mandatory | Mandatory | xOptionalx | Optional | ||
|
| Mandatory | Mandatory | xOptional | ||||
|
| Mandatory | Mandatory | Mandatory | xOptionalx | Optional | ||
|
| Mandatory | Mandatory | Mandatory | xOptional | |||
|
| Mandatory | Mandatory | Mandatory | xOptional | |||
|
| Mandatory | Mandatory | Mandatory | xOptionalx | Optional | ||
|
| Mandatory | Mandatory | Mandatory | xOptional | XOptional | ||
|
| Mandatory | Mandatory | xOptionalx | Optional | |||
|
| Mandatory | Mandatory | xOptional | ||||
|
| Mandatory | Mandatory | xOptionalx | Optional | |||
|
| Mandatory | Mandatory | xOptional | ||||
|
| Mandatory | Mandatory | xOptionalx | Optional | |||
|
| Mandatory | ||||||
|
| Mandatory | xOptionalx | Optional | ||||
|
| Mandatory | xOptionalx | Optional | ||||
|
| Mandatory | xOptionalx | Optional |
Note |
---|
If the OIO BPP system roles system listed above deviate from the list in eHealth Infrastructure OIO BPP system roles https://ehealth-dk.atlassian.net/wiki/spaces/EDTW/pages/291176482/Tokens+Roles+and+RBAC+ABAC#Privilege-Roles , the above list needs to be updated. In addition, such a change needs to be implemented in the mapping https://ehealth-dk.atlassian.net/wiki/spaces/EDTW/pages/2172125189/SAML+Proxy#Mapning-af-privilegier-og-constraints performed by the SAML Proxy. |
...