Cross-cutting Concepts
Data Strategy
Metadata Model (HealthDCAT-AP)
To ensure semantic interoperability and alignment with the European Health Data Space (EHDS), 1+MG adopts the HealthDCAT-AP 5.0 standard (a health-specific profile of DCAT-AP)1 2 3.
Core Entities:
- Catalog: The collection of datasets held by a Node (
dcat:Catalog). - Dataset: A logical grouping of genomic/clinical data (
dcat:Dataset).- Must include:
healthCategory(e.g.,Human Genomic Data). - Must include:
accessRights(mapped to DPV).
- Must include:
- Distribution: The physical form (
dcat:Distribution).- Example: VCF File, Beacon API Endpoint, WES Endpoint.
Identifier Schema
All resources within the 1+MG network MUST adhere to the following Persistent Identifier (PID) pattern to guarantee global uniqueness across the federation1:
Pattern: ^(GOE|GDI)-[A-Z]{2}-[A-Z]+-[0-9]+$
Segments:
- Prefix:
GOE(Genome of Europe) orGDI(Genomic Data Infrastructure). - Country: ISO 3166-1 alpha-2 code (e.g.,
FI,ES,DE). - Type: Resource type code (e.g.,
COHORT,DATASET,SAMPLE). - Sequential ID: Numeric identifier.
Examples:
GDI-FI-COHORT-001(First cohort from Finland GDI Node)GOE-ES-SAMPLE-9942(Genome of Europe sample from Spain)
Security & Compliance
Data Protection by Design (Five Safes)
We adhere to the Five Safes framework to demonstrate compliance with GDPR Data Protection by Design and Default (DPbDD)4:
- Safe Projects: Is this use of the data appropriate, lawful, ethical? (Handled by DAAMS/DAC).
- Safe People: Can the users be trusted? (Handled by LS AAI & Passports).
- Safe Data: Is the data itself safe? (Encryption, Pseudonymisation).
- Safe Settings: Does the access facility limit unauthorized use? (Secure Processing Environment).
- Safe Outputs: Is confidentiality maintained for outputs? (Airlock/Egress Control).
Controlled Vocabularies
We rely on the Data Privacy Vocabulary (DPV) to express legal bases and consent status in a machine-readable way5.
dpv:Consent: Processing based on explicit data subject consent.dpv:LegitimateInterest: Processing based on legitimate interest (secondary use).
Encryption
- Data at Rest: All genomic files (VCF/BAM) are encrypted using Crypt4GH (standard container format for encrypted genomic data)6.
- Data in Transit: TLS 1.3 is mandatory for all APIs.
Authentication & Authorization
- Authentication: Federated via AAI. Users authenticate at their Home Organisation (IdP).
- Authorization: Claims are transported via GA4GH Passports7.
- Visas: Signed JWTs asserting permissions (e.g.,
ControlledAccessGrants). - Verification: The National Node PEP MUST cryptographically verify the Visa signature against the DAC's public key8.
- Visas: Signed JWTs asserting permissions (e.g.,
Observability & Reliability
Logging & Auditing
- Audit Trails: Every access to genomic data (successful or denied) MUST be logged.
- Privacy: Logs must NOT contain PII (e.g., query parameters with variant details) but MUST record User ID, Resource ID, Timestamp, and Decision5.
Error Handling
- Standard: APIs must return standard HTTP status codes (401 vs 403 distinction is critical).
- Format: Error bodies MUST follow RFC 7807 (Problem Details for HTTP APIs)9.