summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorPaul-Christian Volkmer2026-10-05 09:32:16 +0200
committerGitHub2026-10-05 07:32:16 +0000
commit3e49d70ff69b5382e0ad62d8f321aa0c15b1f85b (patch)
tree812359ba361f290a5980eb8de9d3239587b16edc /README.md
parentd9961a9baccaff511662b1aa1de18bdd02f94f5e (diff)
feat: add SHA256-HMAC for use in build-in pseudonym generator (#324)
Diffstat (limited to 'README.md')
-rw-r--r--README.md17
1 files changed, 15 insertions, 2 deletions
diff --git a/README.md b/README.md
index 71b4356..baeb55c 100644
--- a/README.md
+++ b/README.md
@@ -166,6 +166,7 @@ Ist diese nicht gesetzt. wird intern eine Anonymisierung der Patienten-ID vorgen
* `APP_PSEUDONYMIZE_PREFIX`: Standortbezogenes Präfix - `UNKNOWN`, wenn nicht gesetzt
* `APP_PSEUDONYMIZE_GENERATOR`: `BUILDIN` oder `GPAS` - `BUILDIN`, wenn nicht gesetzt
+* `APP_PSEUDONYMIZE_HMAC_KEY`: Wenn gesetzt, wird anstelle `SHA256` nun `SHA256-HMAC` mit diesem Key verwendet.
**Hinweis**
@@ -177,8 +178,20 @@ vergleichbare IDs bereitzustellen.
#### Eingebaute Anonymisierung
Wurde keine oder die Verwendung der eingebauten Anonymisierung konfiguriert, so wird für die
-Patienten-ID der entsprechende SHA-256-Hash gebildet und Base64-codiert - hier ohne endende
-"=" - zuzüglich des konfigurierten Präfixes als Patienten-Pseudonym verwendet.
+Patienten-ID der entsprechende SHA-256-Hash gebildet und Base32-codiert - hierzu werden die ersten 42 Zeichen des Hashes
+ohne endende "=" - zuzüglich des konfigurierten Präfixes als Patienten-Pseudonym verwendet.
+
+Beispiel für ID `123` und Prefix `123`:
+
+`UNKNOWN_uzs2iwjaiixz2ql6jbt67xcpxcqeuhz774p2a7uzr2`
+
+Wird `APP_PSEUDONYMIZE_HMAC_KEY` konfiguriert, wird der Hash mit diesem Wert als HMAC-Key gebildet.
+Auch hier werden die ersten 42 Zeichen Base64-codiert verwendet.
+Hierdurch wird die Nutzung von Rainbow-Tables erschwert, solange der HMAC-Key geheim gehalten wird.
+
+Beispiel für ID `123` und HMAC-Key `TEST` (gleichzeitig HMAC-Key):
+
+`UNKNOWN_3u2nc3hzwbe2kylbmcrhoahgkisxl5jfbcwr3wonr3`
#### Pseudonymisierung mit gPAS