| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Arch_1 | „Security“ ist Bestandteil des Softwareentwicklungs- und Lebenszyklus. | „Security“ MUSS ein fester Bestandteil des Softwareentwicklungs- und Lebenszyklus‘ für die gesamte Anwendung sein (vgl. „iOS Security Framework”[iOSSF], beziehungsweise „Design for Safety“ [DfS]). | Der Evaluator prüft, ob der Quelltext und die Design-Dokumente auf die Verwendung aktueller „Best- Practices“ bei der Entwicklung schließen lassen. | CHECK |
See external SSDLC documentation.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Arch_2 | Berücksichtigung der Verarbeitung sensibler Daten in der Design-Phase. | Bereits in der Designphase der Anwendung MUSS berücksichtigt werden, dass die Anwendung in der Produktivphase sensible Daten verarbeiten wird. Die Architektur der Anwendung MUSS dafür die sichere Erhebung, Verarbeitung, Speicherung und Löschung der sensiblen Daten in einem Datenlebenszyklus gewährleisten. | Der Evaluator prüft Design- und Architektur-Dokumente auf die Berücksichtigung der Verarbeitung sensibler Daten inkl. des Datenlebenszyklus. | CHECK |
See external Data and Security concept.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Arch_3 | Dokumentation des Lebenszyklus von kryptographischem Material. | Der Lebenszyklus von kryptographischem Schlüsselmaterial MUSS einer ausgearbeiteten Richtlinie folgen, die Eigenschaften wie die Zufallszahlenquelle, detaillierte Angaben zur Aufgabentrennung von Schlüsseln, Ablauf von Schlüsselzertifikaten, Integritätssicherung durch Hash-Algorithmen etc., umfasst. Die Richtlinie SOLL auf anerkannten Standards wie [TR02102- 2] und [NIST80057] basieren. | Der Evaluator bewertet die ausgearbeitete Richtlinie des Herstellers und deren Berücksichtigung in der Risikobewertung. | CHECK |
All cryptography is specified by gemSpec_Krypt in corporation with BSI
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Arch_4 | Keine unverschlüsselten sensiblen Daten in Backups. | In Backups gespeicherte sensiblen Daten MÜSSEN gemäß dem aktuellen Stand der Technik verschlüsselt sein. | Der Evaluator prüft durch Quelltextanalyse und praktische Tests, ob sensible Daten unverschlüsselt in Backups vorhanden sind. | EXAMINE |
All data is either stored encrypted within the keychain or excluded from system backup, which also excludes files from cloud backup.
Database backup exclusion
Sources/eRpLocalStorage/CoreDataController.swift:L100// [REQ:BSI-eRp-ePA:O.Purp_8#4,O.Arch_4#2,O.Data_15#1] Database backup exclusion
if excludeFromBackup, let storeUrl = store.url {
Implementation of data storage that is persisted via keychain
Sources/eRpApp/Session/KeychainStorage.swift:L35// [REQ:gemSpec_eRp_FdV:A_19186]
// [REQ:gemSpec_eRp_FdV:A_19188] Deletion of data saved here is managed by the OS.
// [REQ:gemSpec_IDP_Frontend:A_21322] Storage implementation uses iOS Keychain
// [REQ:gemSpec_IDP_Frontend:A_21595] Storage Implementation
// [REQ:BSI-eRp-ePA:O.Purp_8#1,O.Arch_4#3] Implementation of data storage that is persisted via keychain
// [REQ:BSI-eRp-ePA:O.Source_7#2,O.Data_2#2,O.Auth_13#3] Implementation of data storage that is persisted via keychain
class KeychainStorage: SecureUserDataStore, IDPStorage, SecureEGKCertificateStorage {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Arch_5 | Verteilte Implementierung von Sicherheitsfunktionen. | Sicherheitsfunktionen MÜSSEN immer auf allen Außenschnittstellen und API-Endpunkten implementiert werden. | Der Evaluator prüft das Vorhandensein und die Güte von Sicherheitsfunktionen durch Quelltextanalyse und praktische Tests. Als Sicherheitsfunktionen sind unter anderem Authentifizierung, Autorisierung, Input-Validierung und die Verwendung von Escape- Syntaxen zu verstehen. | EXAMINE |
CAN and PIN verification is not done within the application but on the eGK chip. Actual authentication by confirming the eGK signature and validating the eGK certificate is done by the IDP. Authorization of users is done by the FD by validating the Access-Token signature. For Input-Validation and Escaping please see O.Source_1 and O.Source_2.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Arch_6 | Authentizitäts- und Integritätsschutz der Applikation. | Die Anwendung MUSS die Überprüfung der Integrität durch eine digitale Signatur ermöglichen. Die Authentizität der Anwendung ist durch die Vertrauenswürdigkeit der Bezugsquelle (s. A.Source) sichergestellt. | Der Evaluator prüft das Vorhandensein und die Güte des eingesetzten Authentizitäts- und Integritätsschutzes durch Quelltextanalyse und praktische Tests. Hierbei ist auf die Aktualität (siehe [TR02102-1]) der eingesetzten Signaturverfahren zu achten. Die Wirksamkeit gegen eine Manipulation der Applikation (siehe T.MemoryStructures ist in der Risikobewertung zu betrachten. | EXAMINE |
Apple already implements this with a signed binary delivered to customers. An altered application can only run on a jailbroken device. If a user is using a jailbroken device, may it be known or unknown, we display a security alert so a user can make an informed decision to use or not use the application.
trigger device security check
Sources/eRpApp/Screens/Main/MainView.swift:L105// [REQ:BSI-eRp-ePA:O.Arch_6#2,O.Resi_2#2,O.Plat_1#2] trigger device security check
store.send(.loadDeviceSecurityView)
calculate system risk for jailbreak and missing device pin
Sources/eRpApp/Session/Helper/DeviceSecurityManager.swift:L66// [REQ:BSI-eRp-ePA:O.Arch_6#3,O.Resi_2#3,O.Plat_1#3] calculate system risk for jailbreak and missing device pin
var showSystemSecurityWarning: AnyPublisher {
Jailbreak detection
Sources/eRpApp/Session/Helper/DeviceSecurityManager.swift:L120// [REQ:BSI-eRp-ePA:O.Arch_6#4,O.Resi_2#4] Jailbreak detection
func informJailbreakDetected() -> Bool {
Jailbreak information view
Sources/eRpApp/Screens/Main/DeviceSecurity/DeviceSecurityRootedDevice/DeviceSecurityRootedDeviceView.swift:L26// [REQ:BSI-eRp-ePA:O.Arch_6#5,O.Resi_2#5] Jailbreak information view
struct DeviceSecurityRootedDeviceView: View {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Arch_7 | Sichere Nutzung der Funktionen von Drittanbieter-Software. | Nutzt die Anwendung Drittanbieter-Software (etwa für Objektserialisierung), MUSS der Hersteller sicherstellen, dass nur solche Drittanbieter-Software zum Einsatz kommen, deren zu nutzenden Funktionen sicher genutzt werden können und dem Nutzer Informationen über den Nutzungsumfang und die eingesetzten Sicherheitsmechanismen klar darstellen. Die Anwendung MUSS diese Funktionen sicher nutzen. Der Hersteller MUSS darüber hinaus sicherstellen, dass ungenutzte Funktionen durch Dritte nicht aktiviert werden können. | Der Evaluator prüft, durch Quelltextanalyse und praktische Tests, dass Funktionalitäten sicher verwendet werden und ungenutzte Funktionalitäten nicht zugänglich sind. Darüber hinaus prüft er, ob der Nutzer ausreichend über die Verwendung von Drittanbieter- Software informiert wird. | EXAMINE |
See Source/eRpApp/Resources/en.lproj/FOSS.html for library usage purposes. We use Swift as our programming language. We do not use reflections for calling a businesslogic. That’s why we can be sure, that library code (that we do not use) cannot be executed.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Arch_8 | Zweckgebundener Zugriff auf verschlüsselte Speicher oder Nutzerdaten durch interpretierenden Code. | Interpretierter Code , der in möglichen Interaktionen mit Benutzereingaben steht (WebViews mit JavaScript), DARF KEINEN Zugriff auf verschlüsselte Speicher oder Nutzerdaten haben, sofern es für die Erfüllung des primären Zwecks der Anwendung nicht zwingend erforderlich ist. | Der Evaluator prüft durch Quelltextanalyse und praktische Tests, ob ein Zugriff auf verschlüsselte Speicher oder Nutzerdaten über interpretierten Code möglich ist. Falls dies der Fall ist, prüft er die Abwägungen des Herstellers zur zwingenden Notwendigkeit für die Erfüllung des primären Zwecks und die Berücksichtigung in der Risikobewertung. | EXAMINE |
Webview containing local html without javascript
Sources/eRpApp/Screens/Settings/TermsOfUse/TermsOfUseView.swift:L29// [REQ:BSI-eRp-ePA:O.Purp_3#2] Actual view for the Terms of Use display
// [REQ:BSI-eRp-ePA:O.Arch_8#1] Webview containing local html without javascript
struct TermsOfUseView: View {
Webview containing local html without javascript
Sources/eRpApp/Screens/Settings/FOSS/FOSSView.swift:L27// [REQ:BSI-eRp-ePA:O.Arch_8#2] Webview containing local html without javascript
struct FOSSView: View {
Webview containing local html without javascript
Sources/eRpApp/Screens/Settings/DataPrivacy/DataPrivacyView.swift:L29// [REQ:BSI-eRp-ePA:O.Purp_1#2] Actual View driving the display of `DataPrivacy.html`
// [REQ:BSI-eRp-ePA:O.Arch_8#3] Webview containing local html without javascript
// [REQ:gemSpec_eRp_FdV:A_19980#2] Actual View driving the display of `DataPrivacy.html`
struct DataPrivacyView: View {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Arch_9 | Barrierearme Möglichkeit zum Melden von Sicherheitsproblemen. | Der Hersteller MUSS dem Nutzer eine barrierearme Möglichkeit bereitstellen, um Sicherheitsprobleme zu melden. Die Kommunikation SOLL über einen verschlüsselten Kanal stattfinden. | Der Evaluator prüft, ob eine entsprechende Möglichkeit vorhanden ist. Falls kein verschlüsselter Kanal bereitgestellt wird, ist dies in der Risikobewertung zu berücksichtigen. | CHECK |
Link within DataPrivacy.html to https://www.gematik.de/datensicherheit
DataPrivacy display within Onboarding
Sources/eRpApp/Screens/Onboarding/OnboardingLegalInfoView.swift:L95// [REQ:BSI-eRp-ePA:O.Arch_9#2] DataPrivacy display within Onboarding
.sheet(isPresented: $store.showTermsOfPrivacy.sending(\.setShowPrivacy)) {
DataPrivacy display within Settings
Sources/eRpApp/Screens/Settings/SettingsLegalInfoView.swift:L48// [REQ:BSI-eRp-ePA:O.Arch_9#3,O.Purp_1#4] DataPrivacy display within Settings
Button {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Arch_10 | Anwendung fragt Zwangsupdates vom Hintergrundsystem ab. | Die Anwendung SOLL beim Start auf verfügbare sicherheitsrelevante Updates prüfen. Wenn ein sicherheitsrelevantes Update verfügbar ist, DARF die Anwendung sensible Daten NICHT mehr verarbeiten, ohne dieses Update einzuspielen. Der Nutzer MUSS über die Möglichkeit eines Updates und über ein durchgeführtes Update informiert werden. | Der Evaluator prüft die Güte der Implementierung der entsprechenden Funktionalität in der Anwendung. Falls diese nicht vorhanden ist, prüft er die Abwägungen des Herstellers zu den Auswirkungen auf die Sicherheit der Anwendung. Dies ist in der Risikobewertung zu berücksichtigen. Falls die Funktionalität vorhanden ist, prüft der Evaluator mit praktischen Tests, ob das Blockieren einzelner Anfragen eine weitere Nutzung der Anwendung wirksam unterbindet. | EXAMINE |
Implemented via APIKey usage against APOVZD and FD. All requests against the backends may respond with an 403 status code. The App stays usable, but only without any server connection. The user is informed, that an update is required.
Trigger for the update check
Sources/eRpApp/Screens/Main/MainView.swift:L101// [REQ:BSI-eRp-ePA:O.Arch_10#2] Trigger for the update check
await store.send(.checkForForcedUpdates).finish()
The actual business logic for the update check
Sources/eRpApp/Screens/Main/MainDomain.swift:L302// [REQ:BSI-eRp-ePA:O.Arch_10#3] The actual business logic for the update check
return .run(operation: { [updateChecked = state.updateChecked] send in
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Arch_11 | Bereitstellung von Updates über einen eigenen App-Store. | Der Hersteller MUSS für die Veröffentlichung der Anwendung (und ihrer Updates) eine Quelle wählen, auf der die Anwendung gegen Manipulation durch Unbefugte geschützt ist und die einen vertrauenswürdigen Kanal zum Bezug der Anwendung zur Verfügung stellt. | Der Evaluator prüft, ob der Hersteller einen eigenen App-Store zur Verfügung stellt. Daraus resultierende Abwägungen und Auswirkungen auf die Sicherheit sind in der Risikobewertung zu berücksichtigen. | CHECK |
Sole source for the app is the official Apple AppStore. Apple provides a secure ecosystem for downloading applications that incorporate signing and verification of the application. The app is only available in the AppStore and not in any other store.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Arch_12 | Nutzung kryptographischer Maßnahmen bei alternativen Download- Quellen/Mechanismen. | Der Hersteller MUSS dem App-Nutzer einfach und sicher zugängliche Wege zum Bezug der Anwendung bereitstellen (z.B. in Form einer Link-Liste auf seiner Website, als individuell zugestellter QR-Code, o. Ä.). | Der Evaluator prüft durch Quelltextanalyse das Vorhandensein und die Güte der eingesetzten Verfahren. | CHECK |
Not applicable as we are only using the official Apple AppStore.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Auth_1 | Herstellerkonzept zur Authentisierung , Autorisierung und Beenden von Anwendungssitzungen. | Der Hersteller MUSS ein Konzept zur Authentisierung auf angemessenem Vertrauensniveau (vgl. [TR03107-1]), zur Autorisierung (Rollenkonzept) und zum Beenden einer Anwendungssitzung dokumentieren. | Der Evaluator prüft das vom Hersteller bereitgestellt Konzept zur Authentisierung, Autorisierung und Beenden der Anwendungssitzung. Er bewertet die Güte der eingesetzten Verfahren Anhand des aktuellen Standes der Technik. Nach Einschätzung des BSI existieren aktuell keine Verbraucherendgeräte, die in einem unüberwachten Anwendungsszenario Biometrie zur Identifikation oder Authentisierung auf einem Vertrauensniveau „hoch“ einsetzen können. | CHECK |
Our authentication concept is described in the following repository: https://github.com/gematik/api-erp/blob/master/docs/authentisieren.adoc. Roles in the scope of the IDP are defined in https://gemspec.gematik.de/docs/gemSpec/gemSpec_IDP_Dienst/latest/#3.1. As stated in O.Auth_14, we have no mechanism to invalidate tokens. More context can be found in our privacy and security concept, section 2 - system overview.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Auth_2 | Getrennte Realisierung von Authentifizierungsmechanismen und Autorisierungsfunktionen. | Die Anwendung SOLL Authentisierungsmechanismen und Autorisierungsfunktionen separat realisieren. Sind für die Anwendung verschiedene Rollen notwendig, MUSS eine Autorisierung bei jedem Datenzugriff separat realisiert werden. | Der Evaluator prüft und bewertet die getroffenen Maßnahmen zur Trennung von Autorisierungs- und Authentifizierungsmechanismen. Sollte keine Trennung der Mechanismen vorgenommen sein, sind die Abwägungen des Herstellers zu prüfen und in der Risikobewertung zu berücksichtigen. | EXAMINE |
There is no client side separation of authentication and authorization.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Auth_3 | Zwei-Faktor-Authentisierung. | Jeder Authentifizierungsvorgang des Nutzers MUSS in Form einer Zwei-Faktor- Authentisierung umgesetzt werden. | Der Evaluator prüft durch Quelltextanalyse und praktische Tests das Vorhandensein und die Güte der Zwei-Faktor- Authentisierung. Insbesondere prüft er, ob die verwendeten Faktoren aus unterschiedlichen Kategorien stammen (Wissen und Besitz) und mit dem in O.Auth_1 beschriebenem Konzept übereinstimmen. | EXAMINE |
One way to connect to the FD is to login by using the eGK. For that login, the physical card, as well as knowledge of the PIN is required. Login via gID (Gesundheits ID) is described in O.Auth_4.
Implementation of eGK connection
Sources/FeatureCardWall/ReadCard/CardWallReadCardDomain.swift:L210// [REQ:BSI-eRp-ePA:O.Auth_3#2] Implementation of eGK connection
case .signChallenge,
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Auth_4 | Authentisierung über zusätzliche Verfahren, welche einem niedrigeren Sicherheitsniveau entsprechen. | Zusätzlich zu der in O.Auth_1 definierten Authentisierung auf einem angemessenen Vertrauensniveau, KANN der Hersteller dem Nutzer gemäß § 139e Abs. 10 SGB V, nach umfassender Information und Einwilligung, eine Authentisierungsmöglichkeit auf einem niedrigeren Vertrauensniveau anbieten. Dies schließt das Anbieten zusätzlicher Verfahren basierend auf den digitalen Identitäten im Gesundheitswesen gemäß § 291 Abs. 8 SGB V mit ein. | Der Evaluator prüft das Vorhandensein von Authentisierungsmöglichkeiten mit einem niedrigeren Sicherheitsniveau. Sollten solche Verfahren angeboten werden, prüft der Evaluator durch Quelltextanalyse und praktische Tests, ob diese eine angemessene Sicherheit bieten. Angemessene Sicherheitsanforderungen für niederschwellige Verfahren sind der jeweils aktuellen Version der „Spezifikation Sektoraler Identity Provider“ der gematik GmbH zu entnehmen [gemSpec_IDP_Sek]. Die Abwägungen des Herstellers, zum Bereitstellen zusätzlicher Authentisierungsmöglichkeiten und der gewählten Implementierung, sind in der Risikobewertung zu berücksichtigen. | EXAMINE |
Authentication via gID (Gesundheits ID) is possible. To do that an inter-app flow is used that opens the insurance company app on the users device, and after successfull authentication there, jumps back into the E-Rezept-App.
Button the user may use to start login via gID
Sources/FeatureCardWall/Introduction/CardWallIntroductionView.swift:L143// [REQ:BSI-eRp-ePA:O.Auth_4#2] Button the user may use to start login via gID
Button(action: {
Present the gID flow for selecting the correct insurance company
Sources/FeatureCardWall/Introduction/CardWallIntroductionDomain.swift:L224// [REQ:BSI-eRp-ePA:O.Auth_4#3] Present the gID flow for selecting the correct insurance company
.extAuthTapped:
View containing the list of insurance companies
Sources/FeatureCardWall/ExtAuth/CardWallExtAuthSelectionView.swift:L29// [REQ:BSI-eRp-ePA:O.Auth_4#4] View containing the list of insurance companies
struct CardWallExtAuthSelectionView: View {
User selection of the insurance company
Sources/FeatureCardWall/ExtAuth/CardWallExtAuthSelectionView.swift:L65// [REQ:BSI-eRp-ePA:O.Auth_4#5] User selection of the insurance company
Button(action: {
Business logic of user selecting the insurance company
Sources/FeatureCardWall/ExtAuth/CardWallExtAuthSelectionDomain.swift:L144// [REQ:BSI-eRp-ePA:O.Auth_4#6] Business logic of user selecting the insurance company
// [REQ:gemSpec_IDP_Frontend:A_22294-01] Select KK
// [REQ:BSI-eRp-ePA:O.Auth_4#7] Proceed to confirmation screen
state.destination = .confirmation(.init(profileId: state.profileId, selectedKK: entry))
Proceed to confirmation screen
Sources/FeatureCardWall/ExtAuth/CardWallExtAuthSelectionDomain.swift:L146// [REQ:BSI-eRp-ePA:O.Auth_4#6] Business logic of user selecting the insurance company
// [REQ:gemSpec_IDP_Frontend:A_22294-01] Select KK
// [REQ:BSI-eRp-ePA:O.Auth_4#7] Proceed to confirmation screen
state.destination = .confirmation(.init(profileId: state.profileId, selectedKK: entry))
Confirmation Dialog with brief explanation
Sources/FeatureCardWall/ExtAuth/CardWallExtAuthConfirmationView.swift:L28// [REQ:BSI-eRp-ePA:O.Auth_4#8] Confirmation Dialog with brief explanation
struct CardWallExtAuthConfirmationView: View {
User confirms the insurance company
Sources/FeatureCardWall/ExtAuth/CardWallExtAuthConfirmationView.swift:L89// [REQ:BSI-eRp-ePA:O.Auth_4#8] User confirms the insurance company
Button {
Start login via gID
Sources/FeatureCardWall/ExtAuth/CardWallExtAuthConfirmationDomain.swift:L109// [REQ:gemSpec_IDP_Frontend:A_22294-01] Start login via gID
// [REQ:BSI-eRp-ePA:O.Auth_4#9,O.Plat_10#2] Start login via gID
return .publisher(
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Auth_5 | Zusätzliche Informationen bei Bewertung des Authentifizierungsvorgangs einbeziehen. | Für die Bewertung eines Authentisierungsvorgangs SOLLEN zusätzliche Informationen (z. B. das verwendete Endgerät, der verwendete WiFi-Zugangsknoten oder die Zeit des Zugriffs) mit einbezogen werden. | Der Evaluator prüft das Vorhandensein und die Güte von zusätzlichen Informationen zur Bewertung eines Authentifizierungsvorgangs. Solche Informationen können beispielsweise über die Invalidierung/Löschung von Schlüsseln bei Änderung von Merkmalen biometrischer Systeme oder eine Prüfung auf Änderung von biometrischen Metadaten umgesetzt werden. Eine Prüfung auf Konformität zum Datenschutz der erhobenen Informationen ist im Rahmen der TR nicht erforderlich, eine zusätzliche Prüfung ist daher empfehlenswert. Werden keine zusätzlichen Informationen zur Bewertung verwendet, prüft der Evaluator die Abwägungen des Herstellers. Diese sind in der Risikobewertung zu berücksichtigen. | EXAMINE |
If the registered biometric features get changed (within system settings), private keys for alternate authentication are deleted. For privacy reasons, neither the FD nor the application gather or store user data that is not crutial, e.g. the current WiFi.
Key invalidates on changes of registered
Sources/IDP/PrivateKeyContainer.swift:L150// [REQ:gemSpec_IDP_Frontend:A_21586] invalidates biometry after changes
// [REQ:BSI-eRp-ePA:O.Auth_5#2] Key invalidates on changes of registered
// biometric features
.biometryCurrentSet], &error) else {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Auth_6 | Information des Benutzers über ungewöhnliche Anmeldeversuche. | Dem Nutzer SOLL eine Möglichkeit gegeben werden, sich über ungewöhnliche Anmeldevorgänge informieren zu lassen. | Der Evaluator prüft, ob dem Nutzer leicht zugänglich die Möglichkeit gegeben wird, Informationen zu Anmeldevorgängen nachzuvollziehen. Ist das nicht der Fall, sind die Abwägungen des Herstellers zu prüfen und in der Risikobewertung zu berücksichtigen. | CHECK |
We increment a counter whenever the application is opened and an attempt to unlock the application fails. If the counter is greater than 0, the user is informed about that in a hint on the password/unlock screen. For remote logins, an Audit Log for every FD access is available in each user profile.
Actual Button to open the audit events
Sources/eRpApp/Screens/Settings/Profiles/Edit/EditProfileView.swift:L499// [REQ:gemSpec_eRp_FdV:A_19177#2,A_19185#3] Actual Button to open the audit events
// [REQ:BSI-eRp-ePA:O.Auth_6#2] Actual Button to open the audit events
Button {
View displaying the audit events
Sources/eRpApp/Screens/Settings/Profiles/Protocol/AuditEventsView.swift:L30// [REQ:gemSpec_eRp_FdV:A_19177#1,A_19185#2] View displaying the audit events
// [REQ:BSI-eRp-ePA:O.Auth_6#3] View displaying the audit events
struct AuditEventsView: View {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Auth_7 | Verhinderung des Ausprobierens von Login-Parametern. | Die Anwendung MUSS Maßnahmen umsetzen, die ein Ausprobieren von Login-Parametern (z. B. Passwörter) erschweren. | Der Evaluator validiert, dass ein Ausprobieren von Login- Parametern verhindert wird. Dies kann beispielsweise durch Verzögerung nachfolgender Login- Versuche oder den Einsatz von sogenannten Captchas erreicht werden. | CHECK |
If passwords are used for app login, we introduce and increase a delay after 5 wrong attempts. This delay is capped, because a device restart would needs such amount of time and would reset the delay anyway.
Domain handling App Authentication
Sources/eRpApp/Screens/AppAuthentication/AppAuthenticationPassword/AppAuthenticationPasswordDomain.swift:L27// [REQ:BSI-eRp-ePA:O.Auth_7#2] Domain handling App Authentication
@Reducer
Delay sequence
Sources/eRpApp/Session/Helper/AppSecurityManager.swift:L116// Fibonacci sequence for delay steps * 5 seconds multiplier.
// First 5 tries don't come with a delay penalty.
// [REQ:BSI-eRp-ePA:O.Auth_7#4|1] Delay sequence
private static let delaySequence: [TimeInterval] = [0, 0, 0, 0, 0, 5, 5, 10, 15, 25, 40]
A delay is implemented according to its current delay status.
Sources/eRpApp/Session/Helper/AppSecurityManager.swift:L170-L204// [REQ:BSI-eRp-ePA:O.Auth_7#5|35] A delay is implemented according to its current delay status.
// The calculationbasis is the devices uptime, because there is no meddling possible for a non-root user.
func currentPasswordDelay() throws -> TimeInterval {
// The calculationbasis is the devices uptime, because there is no meddling possible for a non-root user.
func currentPasswordDelay() throws -> TimeInterval {
do {
let delayStartUptimeData: Data = try keychainAccess
.genericPasswordData(for: Self.passwordDelayStartTimeIdentifier) ?? Self.zeroTimeIntervalData
let delayStartUptime: TimeInterval = delayStartUptimeData.withUnsafeBytes { $0.load(as: TimeInterval.self) }
let failedAttemptsData: Data = try keychainAccess
.genericPasswordData(for: Self.passwordFailedAttemptsCountIdentifier) ?? Self.zeroIntegerData
let failedAttempts: Int = failedAttemptsData.withUnsafeBytes { $0.load(as: Int.self) }
let delayDuration: TimeInterval = Self.delaySequence[min(failedAttempts, Self.delaySequence.count - 1)]
let currentSystemUptime = DefaultAppSecurityManager.uptime() ?? 0
// If device rebooted, reset delay
if currentSystemUptime < delayStartUptime {
_ = try keychainAccess.setGenericPassword(
Self.zeroTimeIntervalData,
for: Self.passwordDelayStartTimeIdentifier
)
return 0
}
// Else calculate remaining delay
let remaining = (delayStartUptime + delayDuration) - currentSystemUptime
if remaining <= 0 {
_ = try keychainAccess.setGenericPassword(
Self.zeroTimeIntervalData,
for: Self.passwordDelayStartTimeIdentifier
)
return 0
}
return remaining
} catch {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Auth_8 | Erneute Authentifizierung bei unterbrochener Anwendung. | Wurde die Anwendung unterbrochen (in den Hintergrundbetrieb versetzt), MUSS nach Ablauf einer angemessenen Frist (Grace Period) eine erneute Authentisierung durchgeführt werden. | Der Evaluator validiert, dass nach einer der Anwendung angemessenen Zeit, in der sie in den Hintergrundmodus versetzt wurde, eine erneute Authentifizierung erfolgen muss. Die Güte der geforderten Authentifizierung muss dem Vertrauensniveau angemessen sein (vgl. O.Auth_3). | CHECK |
The SceneDelegate exchanges the active window with an authentication window, every time the app gains focus.
Present the authentication window
Sources/eRpApp/SceneDelegate.swift:L196// [REQ:BSI-eRp-ePA:O.Auth_8#2] Present the authentication window
// [REQ:gemSpec_eRp_FdV:A_24857#2] Present the authentication window upon every startup
// dispatching necessary to prevents keyboard not showing on iOS 16
DispatchQueue.main.async { [weak self] in
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Auth_9 | Erneute Authentifizierung nach angemessenen Zeit in der die Anwendung nicht aktiv verwendet wurde. | Die Anwendung MUSS nach einer angemessenen Zeit in der sie nicht aktiv verwendet wurde (idle time) eine erneute Authentisierung fordern. | Der Evaluator validiert, dass nach einer der Anwendung angemessenen Zeit, in der sie nicht aktiv verwendet wurde, eine erneute Authentifizierung erfolgen muss. Die Güte der geforderten Authentifizierung muss dem Vertrauensniveau angemessen sein (vgl. O.Auth_3). | CHECK |
A Timer is used to measure the time a user is inactive. Every user interaction resets the timer.
The timer used to determine inactivity
Sources/eRpApp/SceneDelegate.swift:L359// [REQ:BSI-eRp-ePA:O.Auth_9#2] The timer used to determine inactivity
self?.presentAppAuthenticationDomain(scene: scene)
The timer is reset on user interaction
Sources/eRpApp/SceneDelegate.swift:L340// [REQ:BSI-eRp-ePA:O.Auth_9#3] The timer is reset on user interaction
self?.setupTimer(scene: scene)
User interaction is determined by using a higher order reducer watching all
Sources/eRpApp/SceneDelegate.swift:L368// [REQ:BSI-eRp-ePA:O.Auth_9#4] User interaction is determined by using a higher order reducer watching all
// actions
NotificationCenter.default.post(name: .userInteractionDetected, object: nil, userInfo: nil)
Concat the user interaction reducer to the normal application reducer
Sources/eRpApp/SceneDelegate.swift:L66// [REQ:BSI-eRp-ePA:O.Auth_9#5] Concat the user interaction reducer to the normal application reducer
reducer: AppStartDomain().analytics().notifyUserInteraction().prepareUITestsDependencies(),
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Auth_10 | Erneute Authentifizierung nach angemessenen Zeit in der die Anwendung dauerhaft aktiv verwendet wurde. | Die Anwendung MUSS nach einer angemessenen Zeit in der sie aktiv verwendet wurde (active time) eine erneute Authentisierung zur Reaktivierung der Serversitzung fordern. | Der Evaluator validiert, dass nach einer der Anwendung angemessenen Zeit, in der sie dauerhaft aktiv verwendet wurde, eine erneute Authentifizierung erfolgen muss. Die Güte der geforderten Authentifizierung muss dem Vertrauensniveau angemessen sein (vgl. O.Auth_3). | EXAMINE |
Token invalidation happens after 12 hours. If a user is still active, a re-authentication via eGK, Biometrics or Insurance App is necessary. Each meaning the possession and or knowledge of the needed user input.
The application is also checking for Access-Token expiration
Sources/IDPLive/DefaultIDPSession.swift:L793// [REQ:BSI-eRp-ePA:O.Auth_10#2] The application is also checking for Access-Token expiration
guard token.expires > time() else {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Auth_11 | Ausreichende Authentifizierung des Nutzers für Änderung der Authentisierungsdaten. | Die Authentisierungsdaten DÜRFEN NICHT ohne eine erneute Authentifizierung des Nutzers geändert werden. | Der Evaluator prüft, ob er ohne angemessene Authentifizierung die Authentisierungsdaten verändern kann. Dies betrifft auch einen Ablauf zum Passwort zurücksetzen. Beruht dieser Ablauf bspw. auf Sicherheitsabfragen, darf die Antwort nicht einfach zu erraten oder gar aus möglicherweise öffentlichen Informationen ermittelbar sein (z.B. Mädchenname der Mutter). | EXAMINE |
Authentication via eGK cannot be altered, as the physical card cannot be modified without authentication (e.g. PIN change). See gemSpec_COS for details. Adding a authentication key that is secured via biometrics (labeled as “save login” within the card wall) enforces a new authentication via eGK on server side. There is no other way to change existing login “credentials”, as there is no “password”.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Auth_12 | Authentifizierung an der Schnittstelle zwischen Anwendung und Hintergrundsystem. | Die Anwendung MUSS für die Anbindung eines Hintergrundsystems eine dem Stand der Technik entsprechende Authentifizierung verwenden. | Der Evaluator prüft, ob die Anwendung eine Authentifizierung des Hintergrundsystems unterstützt. | CHECK |
We use TI Certificate Pinning and a Trust Store for VAU communication. See TrustStore and VAU Module for implementation.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Auth_13 | Schutz von Authentisierungsdaten. | Authentisierungsdaten, wie bspw. Session- Identifier bzw. Authentisierungstoken, MÜSSEN als sensible Daten geschützt werden. | Der Evaluator prüft, ob Authentisierungsdaten als sensible Daten gemäß den Anforderungen der TR behandelt werden. | CHECK |
Session tokens and related data are stored within the keychain. We embrace a protocol specifically made for storing data that needs to be secured.
The protocol for storing secured data
Sources/eRpKit/SecureUserDataStore.swift:L30-L40/// Interface to access user specific data that should be kept private
/// sourcery: StreamWrapped
/// [REQ:BSI-eRp-ePA:O.Auth_13#2|11] The protocol for storing secured data
public protocol SecureUserDataStore: IDPStorage, SecureEGKCertificateStorage {
public protocol SecureUserDataStore: IDPStorage, SecureEGKCertificateStorage {
/// Keep track of the latest CAN kept by the DataStore
var can: AnyPublisher { get }
/// Set the CAN
///
/// - Parameter can: the CAN to set and save
func set(can: String?)
/// Wipe the whole storage and delete all user information
func wipe()
Implementation of data storage that is persisted via keychain
Sources/eRpApp/Session/KeychainStorage.swift:L36// [REQ:gemSpec_eRp_FdV:A_19186]
// [REQ:gemSpec_eRp_FdV:A_19188] Deletion of data saved here is managed by the OS.
// [REQ:gemSpec_IDP_Frontend:A_21322] Storage implementation uses iOS Keychain
// [REQ:gemSpec_IDP_Frontend:A_21595] Storage Implementation
// [REQ:BSI-eRp-ePA:O.Purp_8#1,O.Arch_4#3] Implementation of data storage that is persisted via keychain
// [REQ:BSI-eRp-ePA:O.Source_7#2,O.Data_2#2,O.Auth_13#3] Implementation of data storage that is persisted via keychain
class KeychainStorage: SecureUserDataStore, IDPStorage, SecureEGKCertificateStorage {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Auth_14 | Invalidierung von Authentisierungsdaten durch den Anwender. | Die Anwendung MUSS es dem Nutzer ermöglichen einen oder alle zuvor ausgestellten Session-Identifier bzw. Authentisierungstoken zu invalidieren. | Der Evaluator prüft, ob die Anwendung dem Nutzer ermöglicht, ein oder alle zuvor ausgestellten Authentisierungsdaten ungültig zu machen. | CHECK |
Our Authentication Tokens cannot be invalidated effectivley as they are stateless and no server stores active/valid tokens anywhere. Invalidating Authentication Tokens in our context means deleting them on client side. The client side invalidation can thus be done by manual logout or profile deletion. Logout is accessible within the Settings -> Specific User Profile -> Logout.
The user may use the logout button within each profile
Sources/eRpApp/Screens/Settings/Profiles/Edit/EditProfileView.swift:L237-L241// [REQ:BSI-eRp-ePA:O.Auth_14#2|5] The user may use the logout button within each profile
Button {
Button {
store.send(.delegate(.logout))
} label: {
Text(L10n.stgBtnEditProfileLogout)
The domain accepts the intent and wipes tokens and other login related data
Sources/eRpApp/Screens/Settings/Profiles/Edit/EditProfileDomain.swift:L329-L334// [REQ:BSI-eRp-ePA:O.Auth_14#3|6] The domain accepts the intent and wipes tokens and other login related data
case .delegate(.logout):
case .delegate(.logout):
state.token = nil
// [REQ:gemSpec_IDP_Frontend:A_20499-01#1] Call the SSO_TOKEN removal upon manual logout
return .run { [profileId = state.profileId] _ in
try await profileSecureDataWiper.wipeSecureData(of: profileId).async()
Deletion of SSO_TOKEN, ID_TOKEN, AUTH_TOKEN
Sources/eRpApp/Session/ProfileSecureDataWiper.swift:L56// [REQ:gemSpec_IDP_Frontend:A_20499,A_20499-01#2] Deletion of SSO_TOKEN, ID_TOKEN, AUTH_TOKEN
// [REQ:gemSpec_eRp_FdV:A_20186] Deletion of SSO_TOKEN, ID_TOKEN, AUTH_TOKEN
// [REQ:gemSpec_IDP_Frontend:A_21603] Certificate
// [REQ:BSI-eRp-ePA:O.Auth_14#4] Deletion of SSO_TOKEN, ID_TOKEN, AUTH_TOKEN
storage.wipe()
Deletion of CAN
Sources/Profiles/SecureUserDataStoreClient.swift:L71-L81// [REQ:BSI-eRp-ePA:O.Auth_14#5|11] Deletion of CAN
do {
do {
_ = try keychainHelper.unsetGenericPassword(for: egkPasswordIdentifier(for: profileId))
} catch {
// Handle error silently like KeychainStorage does
}
}
)
}
public static let testValue = SecureUserDataStoreClient()
Deletion of SSO_TOKEN, ID_TOKEN, AUTH_TOKEN
Sources/eRpApp/Session/KeychainStorage.swift:L263-L273// [REQ:BSI-eRp-ePA:O.Auth_14#5|11] Deletion of SSO_TOKEN, ID_TOKEN, AUTH_TOKEN
func wipe() {
func wipe() {
// [REQ:gemSpec_IDP_Frontend:A_20499,A_20499-1#3] Deletion of SSO_TOKEN, ID_TOKEN, AUTH_TOKEN
// [REQ:gemSpec_eRp_FdV:A_20186] Deletion of SSO_TOKEN, ID_TOKEN, AUTH_TOKEN
set(can: nil)
set(token: nil)
set(discovery: nil)
// [REQ:gemSpec_IDP_Frontend:A_21603] Certificate
set(certificate: nil)
// `keyIdentifier` is not wiped here because it's deletion is done asynchronously
// together with the secure enclave representative in `ProfileSecureDataWiper`
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Auth_15 | Benachrichtigung des Hintergrundsystems über beendete Anwendungssitzungen durch die Anwendung | Wird eine Anwendungssitzung ordnungsgemäß beendet, MUSS die Anwendung das Hintergrundsystem darüber informieren, sodass Session-Identifier bzw. Authentisierungstoken sicher gelöscht werden. Dies gilt sowohl für das aktive Beenden durch den Benutzer (log-out), als auch für das automatische Beenden durch die Anwendung (vgl. O.Arch_9 und O.Auth_10). | Der Evaluator prüft, ob das Hintergrundsystem bei einer ordnungsgemäßen Beendigung der Anwendungssitzung durch die Anwendung informiert wird. | CHECK |
Our Authentication Tokens cannot be invalidated effectivley as they are stateless and no server stores active/valid tokens anywhere. Invalidating Authentication Tokens in our context means deleting them on client side. The client side invalidation can thus be done by manual logout or profile deletion. Logout is accessible within the Settings -> Specific User Profile -> Logout.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Cryp_1 | Keine fest einprogrammierten Schlüssel oder anderweitige Geheimnisse. | Beim Einsatz von Verschlüsselung in der Anwendung DÜRFEN KEINE fest einprogrammierten geheimen, bzw. privaten Schlüssel eingesetzt werden. | Der Evaluator prüft, ob fest einprogrammierte geheime, bzw. private Schlüssel eingesetzt werden. Ausgenommen sind Techniken, die den verwendeten Schlüssel stark vor Reverse Engineering nach aktuellem Stand der Technik verbergen (Stichwort: „White Box Cryptography“). Wird eine kaskadierte Verschlüsselung eingesetzt, soll mindestens eine Verschlüsselungsebene stark gegen Reverse Engineering geschützt sein und mindestens ein nicht-statischer Schlüssel eingesetzt werden. | EXAMINE |
We use API-Keys for FD and APOVZD communication for legal reasons, not for security reasons. Besides that, private keys for encryption are either created and stored within the secure enclave or stored within the eGK. As encryption for Server communication is done ephemeral via ECDH-ES, no static private keys on client side are necessary. Usages of encryption include the following code pieces.
Signature via ecdh ephemeral-static
Sources/IDPLive/DefaultIDPSession.swift:L834// [REQ:BSI-eRp-ePA:O.Cryp_1#2] Signature via ecdh ephemeral-static
// [REQ:BSI-eRp-ePA:O.Cryp_4#5] one time usage for JWE ECDH-ES Encryption
let algorithm = JWE.Algorithm.ecdh_es(JWE.Algorithm.KeyExchangeContext.bpp256r1(
Signature via ecdh ephemeral-static
Sources/IDPLive/DefaultIDPSession.swift:L871// [REQ:BSI-eRp-ePA:O.Cryp_1#3] Signature via ecdh ephemeral-static
// [REQ:BSI-eRp-ePA:O.Cryp_4#4] one time usage for JWE ECDH-ES Encryption
let algorithm = JWE.Algorithm.ecdh_es(JWE.Algorithm.KeyExchangeContext.bpp256r1(
Signature via ecdh ephemeral-static
Sources/IDPLive/DefaultIDPSession.swift:L912// [REQ:BSI-eRp-ePA:O.Cryp_1#4] Signature via ecdh ephemeral-static
// [REQ:BSI-eRp-ePA:O.Cryp_4#3] one time usage for JWE ECDH-ES Encryption
let algorithm = JWE.Algorithm.ecdh_es(JWE.Algorithm.KeyExchangeContext.bpp256r1(
Signature via ecdh ephemeral-static
Sources/IDP/internal/JWT/JWE+Encryption.swift:L43// [REQ:BSI-eRp-ePA:O.Cryp_1#5] Signature via ecdh ephemeral-static
// [REQ:BSI-eRp-ePA:O.Cryp_4#6] one time usage for JWE ECDH-ES Encryption
let algorithm = JWE.Algorithm.ecdh_es(JWE.Algorithm.KeyExchangeContext.bpp256r1(
Signature via ecdh ephemeral-static
Sources/IDP/internal/TokenPayload.swift:L222// [REQ:BSI-eRp-ePA:O.Cryp_1#6] Signature via ecdh ephemeral-static
// [REQ:BSI-eRp-ePA:O.Cryp_4#2] one time usage for JWE ECDH-ES Encryption
guard let jweHeader = try? JWE.Header(algorithm: JWE.Algorithm.ecdh_es(keyExchangeContext),
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Cryp_2 | Nur bewährte Implementierungen bei kryptographischen Primitiven. | Die Anwendung MUSS auf bewährte Implementierungen zur Umsetzung kryptographischer Primitive und Protokolle zurückgreifen (vgl. [TR02102-2]). | Der Evaluator prüft die Liste der verwendeten Krypto- Implementierungen gegen den aktuellen Stand der Technik (vgl. [TR02102-2]). | EXAMINE |
All cryptographic requirements are defined within gemSpec_Krypt. The document was created together with BSI.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Cryp_3 | Passende Wahl der kryptographischen Primitive. | Die Wahl kryptographischer Primitive MUSS passend zum Anwendungsfall sein und dem aktuellen Stand der Technik (siehe [TR02102-1]) entsprechen. | Der Evaluator prüft die Abwägungen des Herstellers zur Wahl der kryptographischen Primitive und prüft, ob diese dem aktuellen Stand der Technik entsprechen (vgl. [TR02102-1]). | EXAMINE |
All cryptographic requirements are defined within gemSpec_Krypt. The document was created together with BSI.
Secure Enclave Key generation
Sources/IDP/PrivateKeyContainer.swift:L80// Keychain Query
// [REQ:BSI-eRp-ePA:O.Cryp_3#2,O.Cryp_6#2] Secure Enclave Key generation
let query: [String: Any] = [kSecClass as String: kSecClassKey,
Brainpool key generator
Sources/IDP/internal/IDPCrypto.swift:L70// [REQ:gemSpec_eRp_FdV:A_19179#2] Key pair generation delegated to OpenSSL with BrainpoolP256r1 parameters
// [REQ:BSI-eRp-ePA:O.Cryp_3#3] Brainpool key generator
try BrainpoolP256r1.KeyExchange.generateKey()
Brainpool key generator
Sources/IDP/internal/JWT/JWE+KDF.swift:L54// [REQ:BSI-eRp-ePA:O.Cryp_3#4] Brainpool key generator
// [REQ:gemSpec_eRp_FdV:A_19179#4] Key pair generation delegated to OpenSSL
= { try BrainpoolP256r1.KeyExchange.generateKey() })
Brainpool key generator
Sources/VAUClient/internal/VAUCrypto.swift:L114// [REQ:gemSpec_Krypt:GS-A_4357] Key pair generation delegated to OpenSSL with BrainpoolP256r1 parameters
// [REQ:gemSpec_Krypt:GS-A_4367] Key pair generation delegated to OpenSSL with BrainpoolP256r1 parameters
// [REQ:BSI-eRp-ePA:O.Cryp_3#5] Brainpool key generator
// [REQ:gemSpec_eRp_FdV:A_19179#5] Key pair generation delegated to OpenSSL with BrainpoolP256r1 parameters
let keyPairGenerator = { try BrainpoolP256r1.KeyExchange.generateKey() }
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Cryp_4 | Zweckbindung kryptographischer Schlüssel. | Kryptographische Schlüssel DÜRFEN NICHT für mehr als genau einen Zweck eingesetzt werden. | Der Evaluator prüft die verwendeten kryptographischen Schlüssel auf ihre Zweckgebundenheit. Es wird der Zweck nach Schutz durch Verschlüsselung und Authentisierung unterschieden. | EXAMINE |
All cryptographic requirements are defined within gemSpec_Krypt. The document was created together with BSI.
one time usage for JWE ECDH-ES Encryption
Sources/IDP/internal/TokenPayload.swift:L223// [REQ:BSI-eRp-ePA:O.Cryp_1#6] Signature via ecdh ephemeral-static
// [REQ:BSI-eRp-ePA:O.Cryp_4#2] one time usage for JWE ECDH-ES Encryption
guard let jweHeader = try? JWE.Header(algorithm: JWE.Algorithm.ecdh_es(keyExchangeContext),
one time usage for JWE ECDH-ES Encryption
Sources/IDPLive/DefaultIDPSession.swift:L913// [REQ:BSI-eRp-ePA:O.Cryp_1#4] Signature via ecdh ephemeral-static
// [REQ:BSI-eRp-ePA:O.Cryp_4#3] one time usage for JWE ECDH-ES Encryption
let algorithm = JWE.Algorithm.ecdh_es(JWE.Algorithm.KeyExchangeContext.bpp256r1(
one time usage for JWE ECDH-ES Encryption
Sources/IDPLive/DefaultIDPSession.swift:L872// [REQ:BSI-eRp-ePA:O.Cryp_1#3] Signature via ecdh ephemeral-static
// [REQ:BSI-eRp-ePA:O.Cryp_4#4] one time usage for JWE ECDH-ES Encryption
let algorithm = JWE.Algorithm.ecdh_es(JWE.Algorithm.KeyExchangeContext.bpp256r1(
one time usage for JWE ECDH-ES Encryption
Sources/IDPLive/DefaultIDPSession.swift:L835// [REQ:BSI-eRp-ePA:O.Cryp_1#2] Signature via ecdh ephemeral-static
// [REQ:BSI-eRp-ePA:O.Cryp_4#5] one time usage for JWE ECDH-ES Encryption
let algorithm = JWE.Algorithm.ecdh_es(JWE.Algorithm.KeyExchangeContext.bpp256r1(
one time usage for JWE ECDH-ES Encryption
Sources/IDP/internal/JWT/JWE+Encryption.swift:L44// [REQ:BSI-eRp-ePA:O.Cryp_1#5] Signature via ecdh ephemeral-static
// [REQ:BSI-eRp-ePA:O.Cryp_4#6] one time usage for JWE ECDH-ES Encryption
let algorithm = JWE.Algorithm.ecdh_es(JWE.Algorithm.KeyExchangeContext.bpp256r1(
Signature creation with eGK with dedicated C.CH.AUT
Sources/FeatureCardWall/ReadCard/NFCSignatureProvider.swift:L322-L333// [REQ:BSI-eRp-ePA:O.Cryp_4#7|12] Signature creation with eGK with dedicated C.CH.AUT
func sign(message: Data) async throws -> Data {
func sign(message: Data) async throws -> Data {
// [REQ:gemSpec_IDP_Frontend:A_20700-07] perform signature with OpenHealthCardKit
let response = try await card.signAsync(data: message)
if response.responseStatus == ResponseStatus.success, let signature = response.data {
return signature
} else {
throw NFCSignatureProviderError.signingFailure(.responseStatus(response.responseStatus))
}
}
}
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Cryp_5 | Nutzung von starken kryptographischen Schlüsseln. | Die Stärke der kryptographischen Schlüssel MUSS dem aktuellen Stand der Technik entsprechen (siehe [TR02102-1]). | Der Evaluator prüft die Stärke der verwendeten Schlüssel gegen den aktuellen Stand der Technik (vgl. [TR02102-1]). | EXAMINE |
We use Brainpool256R1 and ECSECPrimeRandom 256, see usages in O.Cryp_1 to O.Cryp_4
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Cryp_6 | Manipulationsschutz kryptographischer Schlüssel durch Umgebung. | Alle kryptographischen Schlüssel SOLLEN in einer vor Manipulation und Offenlegung geschützten Umgebung liegen. | Der Evaluator prüft die Umgebung für die Ablage kryptographischer Schlüssel. Als sichere Umgebung gelten beispielsweise Secure Enclave, embedded Secure Element, Trusted Execution Environment etc. Hierbei ist der Betrieb auf allen zugelassenen Hardware-Plattformen zu berücksichtigen. Bei Nichteinhaltung prüft der Evaluator die Abwägungen des Herstellers zu den Auswirkungen auf die Sicherheit der Anwendungen bzw. diskutiert einen fehlenden Schutz in der Risikobewertung. | EXAMINE |
Persisted cryptographic keys are created within the devices secure enclave. Temporal keys are discarded as soon as usage is no longer needed.
Secure Enclave Key generation
Sources/IDP/PrivateKeyContainer.swift:L80// Keychain Query
// [REQ:BSI-eRp-ePA:O.Cryp_3#2,O.Cryp_6#2] Secure Enclave Key generation
let query: [String: Any] = [kSecClass as String: kSecClassKey,
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Cryp_7 | Manipulationsschutz kryptographischer Operationen durch Umgebung. | Alle kryptographischen Operationen SOLLEN in einer vor Manipulation und Offenlegung geschützten Umgebung stattfinden. | Der Evaluator prüft die Umgebung für die Durchführung kryptographischer Operationen analog zu O.Cryp_6. Der Betrieb auf allen zugelassenen Hardware- Plattformen ist dabei zur berücksichtigen. | EXAMINE |
As Brainpool256R1 is not available within secure enclave but enforced by BSI where possible, we use secure enclave encryption only for biometric authentication. Everywhere else, cryptographic operations are ephemeral or use the eGK as a secure execution environment.
Container for private key operations using secure enclave private keys
Sources/IDP/PrivateKeyContainer.swift:L33/// Represents a (SecureEnclave) private key, namely `PrK_SE_AUT`, secured by iOS Biometrics.
///
/// [REQ:gemSpec_IDP_Frontend:A_21590] This is the container to represent biometric keys. Usage is limited to
/// authorization purposes
/// [REQ:BSI-eRp-ePA:O.Cryp_7#2] Container for private key operations using secure enclave private keys
public struct PrivateKeyContainer {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Data_1 | Maximale Sicherheit bei Werkseinstellung. | Die Werkseinstellung der Anwendung MUSS die maximale Sicherheit bieten. | Der Evaluator prüft die Standardeinstellungen der Anwendung bei ihrer Installation. Das umfasst unter anderem die Berechtigungen des Betriebssystems, welche die Anwendung einfordert. Die Berechtigungen müssen dem Zweck der Anwendung dienen und dürfen erst angefragt werden, sobald sie Verwendung finden. | CHECK |
User preferences are asked without discrimination within the onboarding process. Application permissions are asked, whenever they are needed, e.g. location permission is only asked when the user is about to search for a pharmacy (see O.Plat_2). If a user chooses to not give the permission, features are still available, if possible.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Data_2 | Verschlüsselung aller sensiblen Daten. | Die Anwendung MUSS sensible Daten verschlüsselt speichern. Die betriebssystemeigene Verschlüsselung des Dateisystems genügt nicht. Das Schlüsselmaterial für diese Verschlüsselung DARF NICHT unverschlüsselt persistiert werden. Dies gilt sowohl für flüchtiges Ablegen (z. B. im Arbeitsspeicher), als auch für dauerhaftes Speichern (z. B. in einer Cloud- Umgebung). Eine hardwareunterstützte Schlüsselverwaltung der Plattform SOLL bevorzugt verwendet werden. | Der Evaluator validiert, dass sensible Daten (s. Anhang A) von der Anwendung nur verschlüsselt gespeichert werden können. Der Evaluator prüft weiterhin, ob eine hardwaregestützte Schlüsselverwaltung des Betriebssystems für die Speicherung der hierfür notwendigen Schlüssel verwendet wird. Ist ein hinreichender Schutz der Schlüssel durch die Plattform sichergestellt (z. B. in einem embedded Secure Element/Trusted Execution Environment), muss die Anwendung diese Schlüssel wirksam gegen Offenlegung schützen. Der Evaluator nimmt die Wirksamkeit gegenüber Reverse Engineering in die Risikobewertung auf. | EXAMINE |
We use the OS Keychain to persist sensitive data. The keychain either stores or encrypts via SecureEnclave. Encrypting the database has disadvanteges that we discussed and decided to not yet implement additional database encryption. We are periodically evaluating solutions for this requirement.
Implementation of data storage that is persisted via keychain
Sources/eRpApp/Session/KeychainStorage.swift:L36// [REQ:gemSpec_eRp_FdV:A_19186]
// [REQ:gemSpec_eRp_FdV:A_19188] Deletion of data saved here is managed by the OS.
// [REQ:gemSpec_IDP_Frontend:A_21322] Storage implementation uses iOS Keychain
// [REQ:gemSpec_IDP_Frontend:A_21595] Storage Implementation
// [REQ:BSI-eRp-ePA:O.Purp_8#1,O.Arch_4#3] Implementation of data storage that is persisted via keychain
// [REQ:BSI-eRp-ePA:O.Source_7#2,O.Data_2#2,O.Auth_13#3] Implementation of data storage that is persisted via keychain
class KeychainStorage: SecureUserDataStore, IDPStorage, SecureEGKCertificateStorage {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Data_3 | Ablage sensibler Daten. | Die Anwendung SOLL sensible Daten in einem vor Einsicht und Manipulation besonders geschützten Bereich ablegen. | Der Evaluator prüft, ob hardwaregestützte Maßnahmen (wie z.B. Trusted Execution Environment) zur Speicherung sensibler Daten verwendet werden. Sollte dies nicht der Fall sein, nimmt der Evaluator die Abwägungen der Wirksamkeit gegenüber Reverse Engineering in die Risikobewertung auf. | EXAMINE |
Currently it is not possible to store data within the secure enclave on iOS. We store all data on the encrypted application container on the device. See eRpApp.entitlements for NSFileProtectionCompleteUnlessOpen usage.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Data_4 | Zugriff auf sensible Daten durch Dritte. | Die Anwendung DARF Ressourcen, die einen Zugriff auf sensible Daten ermöglichen, gegenüber Dritten NICHT verfügbar machen. | Der Evaluator prüft, ob die Anwendung Ressourcen zur Verfügung stellt, über die Dritte Zugriff auf sensible Daten erhalten können. Dies umfasst Daten in geteilten Speicherbereichen, Dienste oder Interfaces über die sensible Daten bereitgestellt werden. | EXAMINE |
Everything we store, safe or send anywhere is both verified as in O.Resi_6 and or encrypted, such as Keychain or the application container.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Data_5 | Löschung aller erhobenen sensiblen Daten nach Abschluss der Verwendung durch die Anwendung. | A Alle erhobenen sensiblen Daten DÜRFEN NICHT über die Dauer ihrer jeweiligen Verarbeitung hinaus in der Anwendung gehalten werden. | Der Evaluator prüft, ob Daten über den Zeitraum ihrer Verarbeitung hinaus in der Anwendung gehalten werden. Daten, die nicht mehr genutzt werden, müssen sicher gelöscht werden. | CHECK |
Ephemeral private keys are released as soon as they are no longer needed (see O.Source_5).
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Data_6 | Erhebung, Speicherung und Verarbeitung von ausschließlich für den Zweck der Anwendung notwendigen Daten. | Die Anwendung MUSS die Grundsätze der Datensparsamkeit und Zweckbindung berücksichtigen. | Der Evaluator prüft, welche Daten von der Anwendung erhoben, gespeichert und verarbeitet werden und stellt diese dem Zweck der Anwendung gegenüber. | CHECK |
Collected data is sparse and use case related as required. An exhaustive description can be found in our Datenschutzfolgeabschätzung [https://www.das-e-rezept-fuer-deutschland.de/faq/faq-detail/wie-steht-es-um-den-datenschutz].
CAN is used for eGK connection
Sources/FeatureCardWall/CAN/CardWallCANView.swift:L120// [REQ:BSI-eRp-ePA:O.Purp_2#2,O.Data_6#2] CAN is used for eGK connection
CardWallCANInputView(
Scanning tasks contains purpose related data input
Sources/eRpApp/Screens/CameraView/ErxTaskScannerView.swift:L37// [REQ:BSI-eRp-ePA:O.Purp_2#1,O.Data_6#3] Scanning tasks contains purpose related data input
// [REQ:BSI-eRp-ePA:O.Source_1#1] Scanning tasks starts with scanner callback
store.send(.analyse(scanOutput: $0))
PIN is used for eGK Connection
Sources/FeatureCardWall/PIN/CardWallPINView.swift:L37// [REQ:BSI-eRp-ePA:O.Purp_2#3,O.Data_6#4] PIN is used for eGK Connection
PINView(store: store).padding()
Contact information is collected when needed for redeeming
Sources/eRpApp/Screens/Pharmacy/Redeem/PharmacyContactView.swift:L28// [REQ:BSI-eRp-ePA:O.Purp_2#6,O.Data_6#5] Contact information is collected when needed for redeeming
struct PharmacyContactView: View {
User interaction analytics trigger …
Sources/eRpApp/Tracking/AnalyticsReducer.swift:L33// [REQ:BSI-eRp-ePA:O.Purp_2#4,O.Purp_4#1,O.Data_6#6] User interaction analytics trigger ...
struct AnalyticsReducer: Reducer
… records data only if user opt-in is given.
Sources/eRpApp/Tracking/ContentSquareAnalyticsAdapter.swift:L119// [REQ:BSI-eRp-ePA:O.Purp_2#5,O.Purp_4#2,O.Data_6#7] ... records data only if user opt-in is given.
if optIn {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Data_7 | Speicherung und Verarbeitung von sensiblen Daten. | Sofern die Anwendung an ein Hintergrundsystem angebunden ist, SOLL die Speicherung und Verarbeitung von sensiblen Daten im Hintergrundsystem erfolgen. | Der Evaluator prüft, welche Daten die Anwendung permanent speichert bzw. verarbeitet. Er ermittelt das Risiko, das durch eine solche Speicherung und Verarbeitung in der Anwendung entsteht und nimmt es in die Risikobewertung mit auf. | CHECK |
Private data is not initially created by the application. Only additional information, such as redeeming or deleting prescriptions create data. The created data is kept on the FD.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Data_8 | Entfernung von Metadaten mit Datenschutzrelevanz. | Bei der Verwendung von Aufnahmegeräten (z. B. Kamera) MÜSSEN sämtliche Metadaten mit Datenschutz-Relevanz, wie etwa Rückschlüsse auf die GPS-Koordinaten des Aufnahmeorts, eingesetzte Hardware etc., entfernt werden. | Der Evaluator prüft, ob die Anwendung Daten erheben kann, die Metadaten enthalten. In diesem Fall prüft der Evaluator, ob Metadaten mit Datenschutzrelevanz vor der Weiterverarbeitung, wie beispielsweise dem Transfer an das Hintergrundsystem, entfernt werden. | CHECK |
The device camera is used optional for scanning prescriptions and for setting a profile avatar. Avatar image data never leaves the device.
This controller uses the camera as an input device. Frames are processed but never
Sources/eRpApp/Screens/CameraView/AVScannerView.swift:L58// [REQ:BSI-eRp-ePA:O.Data_8#2] This controller uses the camera as an input device. Frames are processed but never
// stored, metadata is never created here.
class AVScannerViewController: UIViewController, AVCaptureMetadataOutputObjectsDelegate {
Meta data is completely removed by converting to jpeg
Sources/eRpApp/Screens/Main/Profile/ImagePicker/PhotoPicker.swift:L64// [REQ:BSI-eRp-ePA:O.Data_8#3,O.Data_9#2] Meta data is completely removed by converting to jpeg
guard let data = tempImage.jpegData(compressionQuality: 0.3) else {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Data_9 | Zugriffsbeschränkung bei der Erhebung von sensiblen Daten. | Bei der Erhebung von sensiblen Daten durch die Verwendung von Aufnahmegeräten (z. B. Kamera), MUSS vorgebeugt werden, dass andere Anwendungen darauf Zugriff erlangen könnten, etwa über eine Mediengalerie. | Der Evaluator prüft, ob erhobene sensible Daten anderen Anwendungen auf dem Gerät verfügbar gemacht werden oder Daten in öffentlichen Verzeichnissen gespeichert werden. | EXAMINE |
The device camera is used for scanning prescriptions and for setting a profile avatar. Neither use-cases export data to the device photo library or export in any other way.
Meta data is completely removed by converting to jpeg
Sources/eRpApp/Screens/Main/Profile/ImagePicker/PhotoPicker.swift:L64// [REQ:BSI-eRp-ePA:O.Data_8#3,O.Data_9#2] Meta data is completely removed by converting to jpeg
guard let data = tempImage.jpegData(compressionQuality: 0.3) else {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Data_10 | Keine Aufzeichnungen bei der Eingabe sensibler Daten über die Tastatur. | Bei der Eingabe sensibler Daten über die Tastatur SOLL die Anwendung unterbinden, dass Aufzeichnungen für Dritte erkennbar werden. | Der Evaluator prüft, ob sensible Daten über Softwaretastaturen des Betriebssystems oder von Drittanbietern eingegeben werden können. Dies schließt insbesondere Caches, Autokorrektur- und Autovervollständigungs-verfahren, Eingabegeräte von Drittanbietern und jegliche für Dritte auswertbare Speicherung, mit ein. Ist dies der Fall, prüft der Evaluator die Abwägungen des Herstellers und berücksichtigt diese in der Risikobewertung. | EXAMINE |
Password fields are marked as such and thus disallow autocorrections. Search for SecureField or SecureFieldWithReveal for all usages.
Keyboard extensions are disallowed
App/Sources/AppDelegate.swift:L52-L61// [REQ:BSI-eRp-ePA:O.Data_10#2|10] Keyboard extensions are disallowed
func application(
func application(
_: UIApplication,
shouldAllowExtensionPointIdentifier extensionPointIdentifier: UIApplication.ExtensionPointIdentifier
) -> Bool {
// Disallow 3rd party keyboards to prevent leaking sensitive data
if extensionPointIdentifier == .keyboard {
return false
}
return true
SecureFields are used for password input.
// [REQ:BSI-eRp-ePA:O.Data_10#3] `SecureFields` are used for password input.
SecureField(text: $text) {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Data_11 | Kein Export sensibler Daten in die Zwischenablage. | Bei der Eingabe sensibler Daten SOLL der Export in die Zwischenablage unterbunden werden. Die Anwendung KANN alternativ eine eigene Zwischenablage implementieren, welche vor dem Zugriff durch andere Anwendungen geschützt ist. | Falls die Anwendung einen Export sensibler Daten in die Zwischenablage des Betriebssystems erlaubt, muss der Abfluss dieser Daten in der Risikobewertung berücksichtigt werden. | CHECK |
We use default platform behavior for password fields. Pasting into password fields is allowed, copying is denied. In general the clipboard is only filled with any data, if the user triggers it.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Data_12 | Kein Export von sensiblen Daten aus der Quelle. | Sensible Daten wie biometrische Daten oder private Schlüssel DÜRFEN NICHT aus der Komponente, auf der sie erzeugt wurden, exportiert werden. | Der Evaluator prüft ob sensible Daten, bei denen keine Notwendigkeit für einen Export besteht, trotzdem exportierbar sind. Dies umfasst unter anderem biometrische Daten oder private kryptografische Schlüssel. | EXAMINE |
There is no API from Apple that allows extraction of biometric or private key data from the secure enclave. Non ephemeral keys are only created within the secure enclave.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Data_13 | Keine Speicherung des Bildschirminhaltes oder Zugriff Dritter bei Anzeige sensibler Daten. | Die Anwendung MUSS Funktionen des Betriebssystems zur Unterbindung der Anzeige sensibler Daten und des Zugriffs für Dritte und der Speicherung des Bildschirms (z. B. Screenshots und Anzeigen für das App- Switching) nutzen. | Der Evaluator prüft, ob die Anwendung das Erzeugen von Screenshots verbietet. Dies umfasst sowohl das aktive, als auch das passive Erzeugen von Screenshots wie es beispielsweise für die Vorschau im Task-Manager durchgeführt wird. Der Evaluator prüft außerdem, ob sensible Daten nicht länger als notwendig in der Anwendung angezeigt werden. Das Restrisiko der Anzeige sensibler Daten wird in der Risikobewertung berücksichtigt. | CHECK |
Suppressing Screenshots is not possible as of now.
Moving the application to the background blurs the application
Sources/eRpApp/SceneDelegate.swift:L264// [REQ:BSI-eRp-ePA:O.Data_13#2,O.Plat_9#2] Moving the application to the background blurs the application
// window.
addBlurOverlayToWindow()
Moving the application to the foreground removes the blur.
Sources/eRpApp/SceneDelegate.swift:L184// [REQ:BSI-eRp-ePA:O.Data_13#3,O.Plat_9#3] Moving the application to the foreground removes the blur.
removeBlurOverlayFromWindow()
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Data_14 | Verschlüsselung aller sensiblen Daten im gesperrten Zustand. | Die Anwendung MUSS sicherstellen, dass im gesperrten Zustand des Endgeräts alle sensiblen Daten verschlüsselt sind. | Ältere Plattformversionen erlauben teilweise die Speicherung der Anwendung auf externen Speichermedien, die nicht der Speicherverschlüsselung unterliegen. Der Evaluator prüft, ob die Anwendung solche oder vergleichbare Vorgehensweisen untersagt. | EXAMINE |
See eRpApp.entitlements for NSFileProtectionCompleteUnlessOpen usage.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Data_15 | Gerätebindung lokal gespeicherter Daten. | Die Anwendung MUSS lokal gespeicherte Daten verschlüsselt mit einer sicheren Gerätebindung versehen. | Der Evaluator prüft, ob Daten, die von der Anwendung gespeichert werden, auf anderen Geräten verarbeitet werden können. Von dieser Einschränkung ausgenommen sind Daten, die vom Nutzer explizit zur Verarbeitung auf anderen Geräten exportiert werden. | EXAMINE |
Biometric keys are always bound to the device and cannot leave the secure enclave. Actual user data is excluded from backups and cannot be exported.
Database backup exclusion
Sources/eRpLocalStorage/CoreDataController.swift:L100// [REQ:BSI-eRp-ePA:O.Purp_8#4,O.Arch_4#2,O.Data_15#1] Database backup exclusion
if excludeFromBackup, let storeUrl = store.url {
prevents migration to other devices
Sources/IDP/PrivateKeyContainer.swift:L144// [REQ:gemSpec_IDP_Frontend:A_21586] prevents migration to other devices
// [REQ:BSI-eRp-ePA:O.Data_15#2] prevents migration to other devices
kSecAttrAccessibleWhenPasscodeSetThisDeviceOnly,
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Data_16 | Enterfernen oder anderweitiges unzugänglich machen aller sensiblen Daten auf dem Endgerät bei Deinstallation der Anwendung. | Es MUSS vom Hersteller sichergestellt werden, dass bei der Deinstallation der Anwendung alle sensiblen Daten und anwendungsspezifischen Anmeldeinformationen auf dem Endgerät nicht mehr zugreifbar sind. | Der Evaluator prüft, ob nach der Deinstallation der Anwendung Daten auf dem Endgerät zurückbleiben. Ist dies der Fall, prüft der Evaluator weiterhin, ob diese Daten sensible Informationen beinhalten oder Rückschlüsse auf sensible Daten zulassen. | CHECK |
Deletion is completely handled by the OS. We have no means of doing anything while deinstallation is running. All sensitive keychain data is tied to the user profile id and cannot be accessed after deinstallation. though technically the information still persists for a short period of time (<24h) after some kind of daily cleanup routine by the OS it will be removed. The user may choose to manually logout or delete profiles before app deletion.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Data_17 | Möglichkeit zum Löschen oder anderweitigen unzugänglich machen aller sensiblen Daten der Anwendung. | Die Anwendung MUSS dem Nutzer die Möglichkeit geben, dass alle sensiblen Daten und anwendungsspezifischen Anmeldeinformationen vollständig gelöscht bzw. unzugänglich gemacht werden. | Der Evaluator validiert, dass dem Nutzer die Möglichkeit gegeben wird alle sensiblen Daten vollständig zu löschen oder unzugänglich zu machen. Darüber hinaus prüft er die Wirksamkeit der getroffenen Maßnahmen durch praktische Tests. | EXAMINE |
Deletion is completely handled by the OS. We have no means of doing anything while deinstallation is running. All sensitive keychain data is tied to the user profile id and cannot be accessed after deinstallation. though technically the information still persists for a short period of time (<24h) after some kind of daily cleanup routine by the OS it will be removed. The user may choose to manually logout or delete profiles before app deletion.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Data_18 | Sicheres Überschreiben von Nutzerdaten im Gerät, ausgelöst durch den Anwender. | Um dem Missbrauch von sensiblen Daten nach einem Geräteverlust entgegenzuwirken, KANN die Anwendung einen Kill-Switch realisieren, d. h. ein absichtliches, sicheres Überschreiben von Nutzerdaten im Gerät auf Anwendungsebene, ausgelöst durch das Hintergrundsystem. Der Hersteller MUSS die Auslösung des Kill-Switches durch den Anwender über das Hintergrundsystem durch starke Authentifizierungsmechanismen vor missbräuchlicher Nutzung schützen. | Der Evaluator führt eine Löschung der Daten über das Hintergrundsystem durch und validiert, dass keine Nutzerdaten mehr auf dem Gerät lesbar sind. | EXAMINE |
Not applicable: no kill switch realized.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Ntwk_1 | Netzwerkkommunikation durchgängig mit gegenseitiger Authentisierung verschlüsselt | Jegliche Netzwerkkommunikation der Anwendung MUSS durchgängig mit gegenseitiger Authentisierung verschlüsselt (zum Beispiel mittels mTLS) werden. | Der Evaluator validiert, dass ausschließlich mit gegenseitiger Authentisierung verschlüsselte Kommunikation zwischen der Anwendung und anderen Komponenten möglich ist. | EXAMINE |
No exceptions set in NSAppTransportSecurity, HTTP via TLS is enforced (see also: Requirements for Connecting Using ATS); Certificate transparency ensures authenticity of the server side. User access tokens ensures client side authenticity.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Ntwk_2 | Konfiguration der verschlüsselten Verbindung gemäß aktuellem Stand der Technik. | Die Konfiguration der verschlüsselten Verbindungen MUSS dem aktuellen Stand der Technik entsprechen (vgl. [TR02102-2]). | Der Evaluator validiert, dass die in O.Ntwk_1 beschriebene Kommunikation dem Stand der Technik (siehe [TR02102-2]) entspricht. | EXAMINE |
TLS is enforced by the platform for every HTTP connection. Certain domains can be excluded from this rule by listing them in a dedicated NSAppTransportSecurity exception list. This list is empty for our application, see also: Requirements for Connecting Using ATS. As a signature algorithm for the TLS handshake, SHA-1 is currently supported by Apple. Unfortunately, we have no influence on that. However, we don’t see a real attack vector here, because an attacker forging signatures would need an existing handshake between the Fachdienst server and the client, and SHA-1 is not supported by the Fachdienst. More information can be found in “Umsetzungshinweise zu A_21275” in gemSpec_Krypt.
URLSession is used as Network Framework
Sources/HTTPClientLive/DefaultHTTPClient.swift:L51// [REQ:gemSpec_Krypt:GS-A_4385,A_18467,A_18464,GS-A_4387]
// [REQ:gemSpec_IDP_Frontend:A_20606#2] Setup of minimum TLS Version to use.
// [REQ:gemSpec_eRp_FdV:A_20206]
// [REQ:BSI-eRp-ePA:O.Ntwk_2#2,O.Ntwk_3#2,O.Ntwk_7#2] URLSession is used as Network Framework
urlSessionConfiguration.tlsMinimumSupportedProtocolVersion = .TLSv12
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Ntwk_3 | Sichere Kommunikationskanäle nur mit Betriebssystem- Funktionen oder sicherheitsüberprüfter Drittsoftware. | Die Anwendung MUSS sicherheitsüberprüfte Drittanbieter-Software verwenden, um sichere Kommunikationskanäle aufzubauen. Dies schließt die im Betriebssystem mitgelieferte Bibliothek mit ein. | Der Evaluator prüft, wie ein sicherer Kommunikationskanal aufgebaut wird. Wenn keine Betriebssystem- Funktionen verwendet werden, validiert der Evaluator, dass die Drittanbieter-Software, welche zum Verbindungsabbau verwendet wird, den in Kapitel 5.5.4 beschriebenen Anforderungen genügt. Eigene Implementierungen zum Aufbau sicherer Kommunikationskanäle sind nicht zulässig. Gemäß A.OperatingSystem werden die Funktionen zum Aufbau von sicheren Kommunikationskanäle im Betriebssystem als sicher angenommen. Sicherheitsüberprüft bedeutet, dass alle sicherheitsrelevanten Bereiche der Software durch eine weitere Partei auf ihre Sicherheitseigenschaften hinuntersucht worden sind. | EXAMINE |
We use the system provided NSURLSession for network communication and no additional layer for TLS encryption. The iOS encryption is certified according to https://support.apple.com/de-de/guide/certifications/apc3fa917cb49/web
URLSession is used as Network Framework
Sources/HTTPClientLive/DefaultHTTPClient.swift:L51// [REQ:gemSpec_Krypt:GS-A_4385,A_18467,A_18464,GS-A_4387]
// [REQ:gemSpec_IDP_Frontend:A_20606#2] Setup of minimum TLS Version to use.
// [REQ:gemSpec_eRp_FdV:A_20206]
// [REQ:BSI-eRp-ePA:O.Ntwk_2#2,O.Ntwk_3#2,O.Ntwk_7#2] URLSession is used as Network Framework
urlSessionConfiguration.tlsMinimumSupportedProtocolVersion = .TLSv12
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Ntwk_4 | Unterstützung von Zertifikats- Pinning. | Die Anwendung MUSS Zertifikats-Pinning anwenden. | Der Evaluator validiert, dass die Anwendung Zertifikats-Pinning unterstützt und dieses wirksam umsetzt. | EXAMINE |
We do not pin TLS Certificates, instead we pin TI PKI Certificates for FD and IDP communication. Since we got an agreement with the BSI regarding the usage of pinning, (TI PKI Pinning is enough) we remove the TLS pinning itself, in favor of certificate transparency + our second layer of TI Certificate pinning. If accessing the APOVZD, we don’t have such pinning. However, the need for pinning is due to high protection demand of the medical data. But the APOVZD does not hold such data, thus we interpret that pinning is not necessary there at all. Furthermore, we don’t see attack vectors regarding the APOVZD. It only required an API Key, but no authentication. Redeeming prescriptions directly with pharmacies, we encrypt the payload with an encryption certificate, that again is checked to be within TI PKI.
Gematik Root CA 3 as a trust anchor has to be set in the program code
Sources/Settings/AppConfiguration.swift:L153-L168// [REQ:gemSpec_Krypt:A_21218] Gematik Root CA 3 as a trust anchor has to be set in the program code
// [REQ:gemSpec_Krypt:A_24469] Gematik Root CA 3 as a trust anchor has to be set in the program code
// [REQ:BSI-eRp-ePA:O.Ntwk_4#2|16] Gematik Root CA 3 as a trust anchor has to be set in the program code
// swiftlint:disable:next force_try
let TRUSTANCHOR_GemRootCa3 = try! TrustAnchor(withPEM: """
// swiftlint:disable:next force_try
let TRUSTANCHOR_GemRootCa3 = try! TrustAnchor(withPEM: """
-----BEGIN CERTIFICATE-----
MIICaTCCAg+gAwIBAgIBATAKBggqhkjOPQQDAjBtMQswCQYDVQQGEwJERTEVMBMG
A1UECgwMZ2VtYXRpayBHbWJIMTQwMgYDVQQLDCtaZW50cmFsZSBSb290LUNBIGRl
ciBUZWxlbWF0aWtpbmZyYXN0cnVrdHVyMREwDwYDVQQDDAhHRU0uUkNBMzAeFw0x
NzEwMTcwNzEzMDNaFw0yNzEwMTUwNzEzMDNaMG0xCzAJBgNVBAYTAkRFMRUwEwYD
VQQKDAxnZW1hdGlrIEdtYkgxNDAyBgNVBAsMK1plbnRyYWxlIFJvb3QtQ0EgZGVy
IFRlbGVtYXRpa2luZnJhc3RydWt0dXIxETAPBgNVBAMMCEdFTS5SQ0EzMFowFAYH
KoZIzj0CAQYJKyQDAwIIAQEHA0IABFhZKSE0xvaeHzZB0A7sRYwIphEWYk/+uFw4
kOLnBt2kbP4P7L0lFOQfp6W0a2lCcmKk+k25VHrj7PCMyV/AVdqjgZ4wgZswHQYD
VR0OBBYEFN/DvnW+JesTMjAup1CFCJ83ENDoMEIGCCsGAQUFBwEBBDYwNDAyBggr
BgEFBQcwAYYmaHR0cDovL29jc3Aucm9vdC1jYS50aS1kaWVuc3RlLmRlL29jc3Aw
DwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwFQYDVR0gBA4wDDAKBggq
ghQATASBIzAKBggqhkjOPQQDAgNIADBFAiEAnOlHsQ5tQ2HPoKVngVQnbvVGteLy
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Ntwk_5 | Validierung des Server-Zertifikats des Hintergrundsystems. | Die Anwendung MUSS das Server-Zertifikat des Hintergrundsystems überprüfen. | Der Evaluator prüft, wie die Anwendung das Zertifikat des Hintergrundsystems validiert. | EXAMINE |
We use NSURLSession as the base for all our network requests. NSURLSession uses ATS (App Transport Security) that enforces rules for TLS Certificates, such as authenticity. See https://support.apple.com/en-us/103214 and https://developer.apple.com/documentation/bundleresources/information_property_list/nsrequirescertificatetransparency# for additional information.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Ntwk_6 | Validierung der Integrität und Authentizität der Antworten des Hintergrundsystems. | Die Anwendung MUSS die Integrität und Authentizität der Antworten des Hintergrundsystems validieren. | Der Evaluator bestätigt, dass die Integrität und Authentizität der Nachrichten des Hintergrundsystems von der Anwendung validiert werden. | EXAMINE |
The server uses extended validation certificates to ensure maximum authenticity. On top of TLS we also implement message authenticity by validating checksums and signatures. For IDP Communication see O.Resi_6, for FD communication see the following code.
Interceptor implementing request and response encryption.
Sources/VAUClient/VAUInterceptor.swift:L30/// The VAU (trusted execution environment) http Interceptor to encrypt HTTP-Requests before sending them
/// and decrypting the received encrypted responses.
/// [REQ:BSI-eRp-ePA:O.Ntwk_6#2] Interceptor implementing request and response encryption.
public class VAUInterceptor: Interceptor {
Decrypting and verifying FD server messages
Sources/VAUClient/internal/VAUCrypto.swift:L127-L147// [REQ:BSI-eRp-ePA:O.Ntwk_6#3|21] Decrypting and verifying FD server messages
func decrypt(data: Data) throws -> String {
func decrypt(data: Data) throws -> String {
// Steps according to gemSpec_Krypt A_20174
// [REQ:gemSpec_Krypt:A_20174#13] 3: Decrypt using AES symmetric key
guard let sealed = try? AES.GCM.SealedBox(combined: data),
let decrypted = try? AES.GCM.open(sealed, using: symmetricKey),
let utf8 = String(data: decrypted, encoding: .utf8)
else {
throw VAUError.responseValidation
}
// [REQ:gemSpec_Krypt:A_20174#14] 4+5: Verify decrypted message. Expect: "1 "
let separated = utf8.split(separator: " ", maxSplits: 2).map { String($0) }
guard separated.count == 3,
separated[0] == "1",
separated[1] == requestId
else {
throw VAUError.responseValidation
}
return separated[2]
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Ntwk_7 | Verwendung plattformspezifischer Optionen. | Plattformspezifische Optionen, wie beispielsweise „Cleartext Traffic Opt-out“ und „In-App Transport Security“ MÜSSEN verwendet werden. | Der Evaluator bestätigt, dass die plattformspezifischen Optionen zur Gewährleistung einer sicheren Kommunikation umgesetzt wurden. | EXAMINE |
The system enforces ATS App Transport Security since the app uses the standard URL Loading System URLSession which automatically negotiate the most secure connection available from the server. Also there are no exceptions configured in the eRpApp/Resources/Info.plist thus insecure networt connections are disabled by default.
URLSession is used as Network Framework
Sources/HTTPClientLive/DefaultHTTPClient.swift:L51// [REQ:gemSpec_Krypt:GS-A_4385,A_18467,A_18464,GS-A_4387]
// [REQ:gemSpec_IDP_Frontend:A_20606#2] Setup of minimum TLS Version to use.
// [REQ:gemSpec_eRp_FdV:A_20206]
// [REQ:BSI-eRp-ePA:O.Ntwk_2#2,O.Ntwk_3#2,O.Ntwk_7#2] URLSession is used as Network Framework
urlSessionConfiguration.tlsMinimumSupportedProtocolVersion = .TLSv12
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Ntwk_8 | Vorhaltung von vollständigen Log-Dateien für alle aufgebauten Verbindungen. | Die Anwendung MUSS für alle Verbindungen Log-Dateien vorhalten. Diese SOLLEN an das Hintergrundsystem übermittelt werden. | Der Evaluator überprüft die von dem Hersteller bereitgestellten Log- Dateien und validiert, dass die HTTP-Header vollständig miterfasst sind. Wenn kein Logging sicherheitsrelevanter Ereignisse auf dem Hintergrundsystem stattfindet, muss dieser Aspekt in der Risikobewertung berücksichtigt werden. | CHECK |
Logging does not take place in the FdV for reasons of data minimization. Furthermore, it is not entirely clear who this log would be for. We have separate responsibilities divided between two different operators of the IDP and the specialized service, and gematik as the manufacturer of the e-prescription app. None of the backend systems have such a required endpoint. Moreover, the aforementioned questions would still arise.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Paid_1 | Anzeige kostenpflichtiger Leistungen und Ressourcen. | Die Anwendung MUSS für den Nutzer kenntlich machen, welche kostenpflichtigen Leistungen (z.B. Zusatzfunktionalitäten oder Premiumzugriffe) und welche kostenpflichtigen Ressourcen (z.B. SMS, Telefonate, mobile Daten) von der Anwendung angeboten oder verwendet werden. | Der Evaluator validiert, dass alle kostenpflichtigen Leistungen und Ressourcen eindeutig als solche erkennbar sind. | CHECK |
The app does not offer any purchases. The only paid service, that is used by the app in some extent can be mobile data. The terms of use in the app states, that costs might occur using mobile data.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Paid_2 | Einverständnis des Nutzers vor dem Ausführen kostenpflichtiger Leistungen. | Die Anwendung MUSS vor der Verwendung kostenpflichtiger Leistungen das Einverständnis des Nutzers einholen. | Der Evaluator validiert, dass alle kostenpflichtigen Leistungen ausschließlich nach Bestätigung durch den Nutzer erbracht werden können. | CHECK |
The app does not offer any purchases.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Paid_3 | Einverständnis des Nutzers vor einer Zugriffsanforderung auf kostenpflichtige Ressourcen. | Die Anwendung MUSS vor einer Zugriffsanforderung (z. B. Android- Berechtigungen) auf kostenpflichtige Ressourcen, das Einverständnis des Nutzers einholen. | Der Evaluator validiert, dass die Nutzung von Diensten, die zusätzliche Kosten für den Nutzer verursachen können (z.B. das Versenden von SMS), ausschließlich nach Abgabe einer Einverständniserklärung des Nutzers möglich ist. | CHECK |
The app does not offer any purchases.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Paid_4 | Dauerhaftes Einverständnis des Nutzers auf häufig verwendete, kostenpflichtige Leistungen oder Ressourcen. | Die Anwendung KANN für den Zugriff auf häufig verwendete, kostenpflichtige Ressourcen oder kostenpflichtige Leistungen ein dauerhaftes Einverständnis des Nutzers einholen. | Falls die Anwendung ein dauerhaftes Einverständnis des Nutzers für den Zugriff auf kostenpflichtige Ressourcen fordert, prüft der Evaluator, ob dies für den primären Zweck der Anwendung erforderlich ist (vgl. O.Purp_1). | CHECK |
The app does not offer any purchases.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Paid_5 | Entzug des Einverständnisses ermöglichen. | Die Anwendung MUSS den Nutzer in die Lage versetzen zuvor erteilte Einverständnisse zurückzuziehen. | Der Evaluator prüft, ob die Anwendung eine Liste mit allen vom Nutzer gegebenen Einverständniserklärungen anzeigt und diese nachträglich geändert werden kann. | CHECK |
The app does not offer any purchases.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Paid_6 | Ablage der sensiblen Transaktionshistorie im Hintergrundsystem. | Die Anwendung SOLL die Transaktionshistorie von kostenpflichtigen Leistungen im Hintergrundsystem ablegen. Die Transaktionshistorie, einschließlich der Metadaten, MUSS als sensibles Datum gemäß O.Purp_8 behandelt werden. | Der Evaluator prüft über praktische Tests und Quelltextanalyse, ob eine Transaktionshistorie in der Anwendung vorgehalten wird. Die Transaktionshistorie sollte im Hintergrundsystem sicher gespeichert werden und aus der Anwendung einsehbar sein. Wenn die Transaktionshistorie in der Anwendung selber gespeichert wird, ist in einer Risikobewertung darzustellen, inwieweit die Sicherheit der gespeicherten Daten gewährleistet werden kann. | EXAMINE |
The app does not offer any purchases.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Paid_7 | Profilbildung durch Nachverfolgung der Zahlungsströme durch Dritte. | Falls die Anwendung kostenpflichtige Leistungen anbietet, MUSS der Hersteller ein Konzept vorlegen, welches vorbeugt, dass Dritte die Zahlungsströme zur Nutzung von Anwendungsfunktionen zurückverfolgen können. | Der Evaluator prüft, ob über die Nachverfolgung von Zahlungsströmen Rückschlüsse auf die Eigenschaften oder das Verhalten des Nutzers möglich sind. Die Abwägungen des Herstellers bei potenziellen Rückschlüssen sind in der Risikobewertung zu berücksichtigen. | CHECK |
The app does not offer any purchases.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Paid_8 | Anzeige der Übersicht der entstandenen Kosten. | Die Anwendung MUSS dem Nutzer eine Übersicht der entstandenen Kosten anbieten. Falls die Kosten aufgrund einzelner Zugriffe erfolgt sind, MUSS die Anwendung einen Überblick der Zugriffe aufführen. | Der Evaluator prüft, ob die Anwendung dem Nutzer eine Übersicht der entstandenen Kosten anbietet. Falls die Kosten aufgrund einzelner Zugriffe erfolgt sind, prüft der Evaluator, ob die Anwendung einen Überblick der Zugriffe aufführt. | CHECK |
The app does not offer any purchases.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Paid_9 | Validierung von getätigten Bezahlvorgängen im Hintergrundsystem. | Die Validierung von getätigten Bezahlvorgängen SOLL im Hintergrundsystem vorgenommen werden. | Der Evaluator prüft durch Quelltextanalyse und praktische Tests, ob die Anwendung eigenständig Bezahlungen validiert und beispielsweise kostenpflichtige Funktionen freischalten kann. | EXAMINE |
The app does not offer any purchases.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Paid_10 | Anforderungen bei Zahlverfahren von Drittanbietern. | Zahlverfahren von Drittanbietern MÜSSEN die Anforderungen an Drittanbieter-Software erfüllen (vgl. Kapitel 5.5.4). | Der Evaluator prüft die Zahlverfahren durch Drittanbieter. Sowohl bei Drittanbieter-Software, als auch bei Web-Diensten wird geprüft, dass keine sensiblen Nutzerdaten an den Zahlungsdienstleister abfließen (z.B., dass der Titel der gebuchten Leistung keine sensiblen Informationen enthält). | CHECK |
The app does not offer any purchases.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Pass_1 | Durchsetzung starker Passwortrichtlinien. | Bei einer Authentisierung mittels Benutzername und Passwort MÜSSEN starke Passwortrichtlinien existieren. Diese SOLLEN sich am aktuellen Stand gängiger „Best- Practices“ orientieren. | Der Evaluator prüft, ob Passwortrichtlinien, welche dem aktuellen Stand der Technik entsprechen, eingesetzt werden. Andernfalls sind die Abwägungen des Herstellers zu prüfen und in der Risikobewertung zu berücksichtigen. | CHECK |
We assessed the topic of password quality holistically, weighing in recommendations and best practices. Please see document ‘Local Password Security’ for more details. As indicator and enforcer of our policy, we use zxcvbn-ios. It uses catalogues - that we enrich with a german dictionary to cover german words and names - as well as entropy-based estimation.
We use an additional german word list to check against common passwords
Sources/eRpApp/Helper/PasswordStrengthTester.swift:L54// [REQ:BSI-eRp-ePA:O.Pass_1#2,O.Pass_2#2] We use an additional german word list to check against common passwords
private(set) lazy var wordList: [String] = {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Pass_2 | Anzeige der Stärke des verwendeten Passworts. | Für die Einrichtung der Authentisierung mittels Benutzername und Passwort KANN die Stärke des verwendeten Passworts dem Nutzer angezeigt werden. Informationen über die Stärke des gewählten Passworts DÜRFEN NICHT gespeichert werden. | Der Evaluator prüft, ob dem Nutzer die Stärke des verwendeten Passworts angezeigt wird. Ist dies der Fall, prüft er durch Quelltextanalyse und praktische Tests, ob dadurch Informationen über das Password oder dessen Güte im Anwendungsspeicher verbleiben. | EXAMINE |
We assessed the topic of password quality holistically, weighing in recommendations and best practices. Please see document ‘Local Password Security’ for more details. As indicator and enforcer of our policy, we use zxcvbn-ios. It uses catalogues - that we enrich with a german dictionary to cover german words and names - as well as entropy-based estimation.
We use an additional german word list to check against common passwords
Sources/eRpApp/Helper/PasswordStrengthTester.swift:L54// [REQ:BSI-eRp-ePA:O.Pass_1#2,O.Pass_2#2] We use an additional german word list to check against common passwords
private(set) lazy var wordList: [String] = {
Password strength view within onboarding.
Sources/eRpApp/Screens/Onboarding/OnboardingRegisterPasswordView.swift:L110// [REQ:BSI-eRp-ePA:O.Pass_2#2] Password strength view within onboarding.
PasswordStrengthView(
Testing the actual password strength
Sources/eRpApp/Screens/Onboarding/RegisterPasswordDomain.swift:L90// [REQ:BSI-eRp-ePA:O.Pass_2#3] Testing the actual password strength
state.passwordStrength = passwordStrengthTester.passwordStrength(for: state.passwordA)
Password strength view within settings.
Sources/eRpApp/Screens/Settings/AppSecurity/CreatePasswordView.swift:L94// [REQ:BSI-eRp-ePA:O.Pass_2#4] Password strength view within settings.
PasswordStrengthView(strength: store.passwordStrength)
Testing the actual password strength while updating within settings
Sources/eRpApp/Screens/Settings/AppSecurity/CreatePasswordDomain.swift:L109// [REQ:BSI-eRp-ePA:O.Pass_2#5] Testing the actual password strength while updating within settings
state.passwordStrength = passwordStrengthTester.passwordStrength(for: state.passwordA)
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Pass_3 | Möglichkeit zur Änderung des Passwortes. | Der Nutzer MUSS die Möglichkeit haben, sein Passwort zu ändern. | Der Evaluator prüft, ob der Nutzer die Möglichkeit hat, sein Passwort zu ändern und verifiziert, dass diese Funktionalität nicht zweckentfremdet werden kann. | CHECK |
The user may change the app passwords within the settings.
View for changing the user password
Sources/eRpApp/Screens/Settings/AppSecurity/CreatePasswordView.swift:L27// [REQ:BSI-eRp-ePA:O.Pass_3#2] View for changing the user password
struct CreatePasswordView: View {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Pass_4 | Protokollierung und Information über Änderungen und Zurücksetzen von Passwörtern. | Wird die Anwendung zusammen mit einem Hintergrundsystem genutzt, MUSS das Ändern und Zurücksetzen von Passwörtern protokolliert werden. Das Hintergrundsystem SOLL den Nutzer über das Ändern und Zurücksetzen von Passwörtern informieren, dabei MUSS ein separater Kanal genutzt werden. | Der Evaluator prüft das Vorhandensein und die Güte von zusätzlichen Informationen zur Protokollierung von Änderungen und dem Zurücksetzen von Passwörtern. | CHECK |
The application password is not used within the backend, it is not aware of passwords. That’s why we think, this requirement does not apply here. Furthermore, we do not have local logs, that could be used for that.
Display of failed login attempts counter
Sources/eRpApp/Screens/AppAuthentication/AppAuthenticationView.swift:L42// [REQ:BSI-eRp-ePA:O.Pass_4#2] Display of failed login attempts counter
if store.failedAuthenticationsCount != 0 {
Increase failed attempts count on failed verification
Sources/eRpApp/Screens/AppAuthentication/AppAuthenticationDomain.swift:L138// [REQ:BSI-eRp-ePA:O.Pass_4#3] Increase failed attempts count on failed verification
state.failedAuthenticationsCount += 1
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Pass_5 | Verwendung von kryptographisch sicheren Hashing-Algorithmen und Salts zur Speicherung der Passwörter. | Werden Passwörter gespeichert, MÜSSEN diese mit einer den aktuellen Sicherheitsstandards entsprechenden Hash-Funktion und unter Verwendung geeigneter Salts gehasht werden. | Der Evaluator prüft, ob Passwörter in der Anwendung gespeichert werden. Er verifiziert, dass die verwendeten Schutzmechanismen dem aktuellen Stand der Technik und den Anforderungen an Hash- Funktionen, Anzahl an Iterationen und Salts genügen (vgl. [TR02102-1]). In der Risikobewertung werden Maßnahmen, die Brute-Force- Angriffe verlangsamen, berücksichtigt. | EXAMINE |
We use the keychain to persist the hashed app password and the corresponding salt. The salt is regenerated, whenever a new password is stored.
The salt is regenerated, whenever a new password is stored.
Sources/eRpApp/Session/Helper/AppSecurityManager.swift:L79-L82// [REQ:BSI-eRp-ePA:O.Pass_5#2|4] The salt is regenerated, whenever a new password is stored.
guard let data = password.data(using: .utf8),
guard let data = password.data(using: .utf8),
let salt = try? randomGenerator(32) else {
throw AppSecurityManagerError.savePasswordFailed
Password is stored alongside hash within keychain.
Sources/eRpApp/Session/Helper/AppSecurityManager.swift:L85-L92// [REQ:BSI-eRp-ePA:O.Pass_5#3|8] Password is stored alongside hash within keychain.
do {
do {
let hashedPassword = hash(data + salt)
guard try keychainAccess.setGenericPassword(salt, for: Self.passwordSaltIdentifier),
try keychainAccess.setGenericPassword(hashedPassword, for: Self.passwordHashIdentifier) else {
throw AppSecurityManagerError.savePasswordFailed
}
return true
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Plat_1 | Geräteschutz für die Nutzung der Anwendung erforderlich. | Für die Nutzung der Anwendung SOLL das Endgerät über einen aktivierten Geräteschutz (Passwort, Mustersperre, o. ä.) verfügen. Im Fall eines nicht aktivierten Geräteschutzes MUSS der Hersteller den Nutzer über die damit verbundenen Risiken aufklären. | Der Evaluator prüft, ob der Hersteller eine Nutzung ohne aktivierten Geräteschutz zulässt. Ist das der Fall, prüft der Evaluator, ob der Nutzer angemessen über die daraus resultierenden Risiken aufgeklärt wird, und er berücksichtigt die Abwägungen des Herstellers in der Risikobewertung. Gemäß A.OperatingSystem wird insbesondere angenommen, dass das Betriebssystem über Funktionen verfügt, die es der Anwendung ermöglichen, die Einstellung des Geräteschutzes abzufragen. | CHECK |
We test for device pincode at startup and show a dialog if no pin is set.
trigger device security check
Sources/eRpApp/Screens/Main/MainView.swift:L105// [REQ:BSI-eRp-ePA:O.Arch_6#2,O.Resi_2#2,O.Plat_1#2] trigger device security check
store.send(.loadDeviceSecurityView)
calculate system risk for jailbreak and missing device pin
Sources/eRpApp/Session/Helper/DeviceSecurityManager.swift:L66// [REQ:BSI-eRp-ePA:O.Arch_6#3,O.Resi_2#3,O.Plat_1#3] calculate system risk for jailbreak and missing device pin
var showSystemSecurityWarning: AnyPublisher {
Missing system pin detection
Sources/eRpApp/Session/Helper/DeviceSecurityManager.swift:L76// [REQ:BSI-eRp-ePA:O.Plat_1#4] Missing system pin detection
var informMissingSystemPin: AnyPublisher {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Plat_2 | Nur Anforderung der für den primären Zweck notwendigen Berechtigungen. | Die Anwendung DARF Berechtigungen, die für die Erfüllung ihres primären Zwecks nicht notwendig sind, NICHT einfordern. | Der Evaluator prüft die von der Anwendung geforderten Berechtigungen und bestätigt, dass diese für die Erfüllung des primären Zwecks der Anwendung (O.Purp_1) erforderlich sind. | CHECK |
The app ony configures entitlements that are used for it’s primary purpose. All configured entitlements are configured in eRpApp/Resources/Info.plist and in eRpApp/Resources/eRpApp.entitlements.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Plat_3 | Hinweis auf Zweck der Berechtigungen und Auswirkungen bei Nichterteilung. | Die Anwendung MUSS den Nutzer auf den Zweck der anzufragenden Berechtigungen und auf die Auswirkungen hinweisen, die eintreten, falls der Nutzer diese nicht gewährt. | Der Evaluator prüft, ob die Anwendung auf den Zweck der geforderten Berechtigungen hinweist. | CHECK |
The platform enforces dialogs whenever accessing private data or sensors and user permission is not already given. Localizations can be found within InfoPlist.strings
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Plat_4 | Keine sensiblen Daten in Meldungen oder Benachrichtigungen. | Die Anwendung DARF KEINE sensiblen Daten in Meldungen oder Benachrichtigungen, die nicht vom Benutzer explizit eingeschaltet wurden (siehe O.Plat_5), schreiben. | Der Evaluator prüft anhand von Quelltextanalyse und generierten Log-Nachrichten, ob die Anwendung sensible Daten in diese Nachrichten schreibt. Sollten die geloggten Daten Rückschlüsse auf den Nutzer zulassen, muss dieser Datenabfluss in der Risikobewertung berücksichtigt werden. | EXAMINE |
We never show sensitive data as all errors are localized with custom descriptions (See LocalizedError implementations). Some errors have localized parameters such as a failed PIN counter. Some errors are sent from the server, these messages show only generic information what went wrong. See O.Source_3 for reference.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Plat_5 | Option zur Anzeige von Meldungen/Benachrichtigungen mit sensiblen Daten. | Die Anwendung KANN dem Nutzer die Optionen bieten, Meldungen und Benachrichtigungen, ggf. auch mit sensiblen Daten, anzuzeigen. Bei Werkseinstellung MUSS diese deaktiviert sein. | Falls die Anwendung die Möglichkeit zur Anzeige von Meldungen mit sensiblen Daten bietet, prüft der Evaluator, ob diese standardmäßig deaktiviert sind. Weiterhin prüft er, ob der Nutzer bei Aktivierung dieser Option angemessen über die daraus resultierenden Risiken aufgeklärt wird. Die Abwägungen des Herstellers, solche Optionen anzubieten, sind in der Risikobewertung zu berücksichtigen. | CHECK |
Not applicable: displaying of messages not realized.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Plat_6 | Zugriffsbeschränkungen auf sensible Daten. | Die Anwendung MUSS Zugriffsbeschränkungen auf sensible Daten realisieren. | Der Evaluator prüft, ob die Anwendung den Zugriff auf sämtliche Daten beschränkt, solange sie unter der Kontrolle der Anwendung sind. Dies schließt eine Beschränkung des Zugriffs auf vorgesehene Dateipfade zum Schutz sensibler Daten durch automatisches Speichern oder unbeabsichtigtes Speichern durch den Nutzer mit ein. Darüber hinaus ist zu validieren, dass die Anwendung keine Broadcast-Nachrichten verschicken kann, die von allen auf dem Gerät installierten Anwendungen gelesen werden können. Die Anwendung darf Nachrichten ausschließlich an autorisierte Anwendungen verschicken. Wenn die Anwendung diese Vorgabe nicht umsetzt, müssen die Abwägungen des Herstellers in die Risikobewertung mitaufgenommen werden. Gemäß A.OperatingSystem wird angenommen, dass das Betriebssystem über wirksame Funktionen verfügt, die einzelne Anwendungen untereinander und gegenüber dem Betriebssystem isolieren. Die Isolation muss durchgängig sein und mindestens die Prozessebene, | EXAMINE |
Implemented by the OS Sandboxing.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Plat_7 | Nutzung von sensiblen Funktionalitäten über Interprozesskommunikation. | Die plattformspezifischen Mechanismen zu Interprozesskommunikation DÜRFEN NICHT zum Austausch von sensiblen Daten genutzt werden, sofern sie nicht zur Erfüllung des primären Zwecks der Anwendung erforderlich sind. | Bietet die Anwendung Schnittstellen an, berücksichtigt der TR-Prüfer deren Ausnutzbarkeit in der Risikoanalyse. Gemäß A.OperatingSystem wird insbesondere angenommen, dass für das Betriebssystem Funktionen zur Interprozesskommunikation bereitstehen, für die Regeln zur Isolation der Kommunikation gesetzt werden können. | CHECK |
The only method we use for inter process communication is universal linking. Current outgoing use-cases are limited to login with insurance company apps. No sensitive data is transferred, the actual payload is decided by the server, as the universal links are created server side.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Plat_8 | Nutzung von Rendering Engines zum Nachladen aktiver Inhalte. | Verwendet die Anwendung für die Erfüllung ihres primären Zwecks eine Rendering Engine, MUSS sie diese so konfigurieren, dass aktive Inhalte nicht ausgeführt werden. Falls aktive Inhalte für die Realisierung der Anwendung unabdingbar sind, MUSS die Anwendung das Nachladen von Inhalten auf Quellen beschränken, die unter der Kontrolle des Herstellers sind oder durch den Hersteller autorisiert wurden. | Wenn die Anwendung Rendering Engines einsetzt, prüft der Evaluator, ob die Komponenten das Nachladen aktiver Inhalte unterbinden oder auf Quellen unter der Kontrolle des Herstellers beschränken. Die Auswahl der zugelassenen Quellen wird in der Risikoanalyse berücksichtigt. | CHECK |
We only use native code and do not rely on any rendering engine, besides rendering some static HTML Pages (e.g. OSS-Licenses, Data Privacy, Terms of Use) that do not contain any scripts.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Plat_9 | Entfernung von sensiblen Daten bei Wechsel in den Hintergrundbetrieb. | Wechselt die Anwendung in den Hintergrundbetrieb, MUSS diese alle sensiblen Daten aus der aktuellen Ansicht („Views“ in iOS bzw. „Activities“ in Android) entfernen. | Der Evaluator prüft, ob die Anwendung sensible Daten aus den entsprechenden Anzeigeelementen der Anwendung entfernt. | EXAMINE |
The content window is blurred upon leaving the application to not expose content to the system multitasking switcher. However, we cannot blur the content when opening the app switcher, because the application is not left then. To implement this fully would disturb the user experience in other cases, where the user does not expect the contents to be blurred, e.g. the sharing functionality. We assess the risk as acceptable, because the user needs to be logged in into the application before opening the app switcher and expose sensitive information.
Moving the application to the background blurs the application
Sources/eRpApp/SceneDelegate.swift:L264// [REQ:BSI-eRp-ePA:O.Data_13#2,O.Plat_9#2] Moving the application to the background blurs the application
// window.
addBlurOverlayToWindow()
Moving the application to the foreground removes the blur.
Sources/eRpApp/SceneDelegate.swift:L184// [REQ:BSI-eRp-ePA:O.Data_13#3,O.Plat_9#3] Moving the application to the foreground removes the blur.
removeBlurOverlayFromWindow()
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Plat_10 | Deaktivierung nicht benötigter Protokoll-Handler in Rendering Engines. | Die Anwendung MUSS alle nicht benötigten Protokoll-Handler in Rendering-Engines deaktivieren. | Wenn die Anwendung Rendering Engines einsetzt, prüft der Evaluator, ob die Komponenten nicht benötigte Protokoll-Handler deaktivieren. | CHECK |
Implemented using a WKWebViewDelegate.
Start login via gID
Sources/FeatureCardWall/ExtAuth/CardWallExtAuthConfirmationDomain.swift:L109// [REQ:gemSpec_IDP_Frontend:A_22294-01] Start login via gID
// [REQ:BSI-eRp-ePA:O.Auth_4#9,O.Plat_10#2] Start login via gID
return .publisher(
Delegate disables unused schemes
Sources/eRpApp/Screens/Settings/DataPrivacyTermsOfUseNavigationDelegate.swift:L26// [REQ:BSI-eRp-ePA:O.Plat_10#2] Delegate disables unused schemes
class DataPrivacyTermsOfUseNavigationDelegate: NSObject, WKNavigationDelegate {
Usage of the delegate
Sources/eRpApp/Screens/Settings/DataPrivacy/DataPrivacyView.swift:L40// swiftlint:disable:next weak_delegate
// [REQ:BSI-eRp-ePA:O.Plat_10#3] Usage of the delegate
let navigationDelegate = DataPrivacyTermsOfUseNavigationDelegate()
Follow redirect
Sources/FeatureCardWall/ExtAuth/CardWallExtAuthConfirmationDomain.swift:L124// [REQ:gemSpec_IDP_Frontend:A_22299-01] Follow redirect
// [REQ:BSI-eRp-ePA:O.Plat_10#3] Follow redirect
guard await openURLHandler.canOpenURL(url) else {
Follow redirect
Sources/FeatureCardWall/Introduction/CardWallIntroductionDomain.swift:L266// [REQ:gemSpec_IDP_Sek:A_22299] Follow redirect
// [REQ:BSI-eRp-ePA:O.Plat_10#3] Follow redirect
guard await openURLHandler.canOpenURL(url) else {
Usage of the delegate
Sources/eRpApp/Screens/Settings/FOSS/FOSSView.swift:L37// swiftlint:disable:next weak_delegate
// [REQ:BSI-eRp-ePA:O.Plat_10#4] Usage of the delegate
let navigationDelegate = DataPrivacyTermsOfUseNavigationDelegate()
Usage of the delegate
Sources/eRpApp/Screens/Settings/TermsOfUse/TermsOfUseView.swift:L39// swiftlint:disable:next weak_delegate
// [REQ:BSI-eRp-ePA:O.Plat_10#5] Usage of the delegate
let navigationDelegate = DataPrivacyTermsOfUseNavigationDelegate()
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Plat_11 | Löschen anwendungsspezifischer Cookies beim Beenden der Anwendung. | Die Anwendung MUSS vor dem ordnungsgemäßen Beenden das Löschen aller anwendungsspezifischen Sitzungsdaten (bspw. Cookies) bei der genutzten Rendering Engine anfordern. | Wenn die Anwendung Rendering Engines oder andere Arten zur Darstellung von Webinhalten einsetzt, prüft der Evaluator, ob anwendungsspezifische Sitzungsdaten nach Beenden der Anwendung gelöscht werden. | EXAMINE |
WebViews only display local content that is delivered together with the application. Javascript is disabled, linking and loading other content is disabled. All other links to websites open the system browser. No cookies are created within the application or any webview that the application hosts.
disabled javascript
Sources/eRpApp/Screens/Settings/DataPrivacy/DataPrivacyView.swift:L45// [REQ:BSI-eRp-ePA:O.Plat_11#2] disabled javascript
wkWebView.configuration.defaultWebpagePreferences.allowsContentJavaScript = false
disabled javascript
Sources/eRpApp/Screens/Settings/TermsOfUse/TermsOfUseView.swift:L44// [REQ:BSI-eRp-ePA:O.Plat_11#3] disabled javascript
wkWebView.configuration.defaultWebpagePreferences.allowsContentJavaScript = false
disabled javascript
Sources/eRpApp/Screens/Settings/FOSS/FOSSView.swift:L42// [REQ:BSI-eRp-ePA:O.Plat_11#4] disabled javascript
wkWebView.configuration.defaultWebpagePreferences.allowsContentJavaScript = false
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Plat_12 | Überschreiben aller nutzerspezifischen Daten beim Beenden der Anwendung. | Die Anwendung SOLL nach Beenden alle nutzerspezifischen Daten im Arbeitsspeicher sicher überschrieben haben. | Die Anwendung darf sich bei der Beendigung nicht rein auf das Betriebssystem und den Garbage Collector der Laufzeitumgebung verlassen. Sensible Daten müssen aktiv gelöscht bzw. überschrieben werden. Der Evaluator ermittelt die Risiken für die einzelnen betroffenen Daten und berücksichtigt diese in der Risikobewertung. | EXAMINE |
The app’s memory is subject to the operating system’s memory and therefore it has no control over the used memory. There is no technique known to overwrite memory in swift in a safe way, so that value types are deleted safely. The platform promises safety at process boundaries.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Plat_13 | Information des Nutzers über erforderliche Sicherheitsmaßnahmen zur Anwendung, Drittanbieter- Software und Plattformen. | Der Nutzer MUSS über Sicherheitsmaßnahmen informiert werden, sofern diese durch den Nutzer umsetzbar sind. | Der Evaluator prüft, ob der Nutzer über selbst durchführbare Sicherheitsmaßnahmen informiert und ggf. angeleitet wird. Der Evaluator bewertet, ob die Maßnahmen ausreichend sind, um Restrisiken zu begrenzen. | CHECK |
During the onboarding process the user is forced to secure the access to the app either via a biometric trait or a strong password (or both). There is no additional security setting the user cannot set within the onbording.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Plat_14 | Protokollierung bestimmter Sicherheitsereignisse. | Ein abgebrochener Start SOLL als Sicherheitsereignis protokolliert werden. Die Protokollierung SOLL im Hintergrundsystem stattfinden. | Der Evaluator überprüft die von dem Hersteller bereitgestellten Logdateien und validiert, dass ein abgebrochener Start und andere Sicherheitsereignisse der Anwendung protokolliert werden. Die Informationen dienen der Post- Mortem-Analyse von Sicherheitsvorfällen und sollten daher Informationen über alle ausgehenden Verbindungen enthalten, unter anderem Metainformationen über verwendete Proxys und überprüfte Server-Zertifikate. | CHECK |
We do not log within the application. Though, logging is in place on FD and IDP and user data related events are logged into the audit events, that can be displayed within the application.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Purp_1 | Informationspflicht des Herstellers zum rechtmäßigen Zweck und Verarbeitung von personenbezogenen Daten. | Der Hersteller MUSS die rechtmäßigen Zwecke der Anwendung und die Verarbeitung von personenbezogenen Daten vor der Installation offenlegen (etwa in der Beschreibung des App- Stores; vgl. Anhang A) und den Nutzer mindestens bei der erstmaligen Inbetriebnahme darüber informieren. | Der Evaluator prüft, ob eine Beschreibung vorhanden ist und diese den rechtmäßigen Zwecken der Anwendung entspricht. Dabei werden die vom Hersteller definierten rechtmäßige Zwecke als Grundlage genutzt. Eine juristische Prüfung der Rechtmäßigkeit ist nicht erforderlich. | CHECK |
The purpose is displayed as part of the Onboarding and can later be viewed from the settings.
Actual View driving the display of DataPrivacy.html
// [REQ:BSI-eRp-ePA:O.Purp_1#2] Actual View driving the display of `DataPrivacy.html`
// [REQ:BSI-eRp-ePA:O.Arch_8#3] Webview containing local html without javascript
// [REQ:gemSpec_eRp_FdV:A_19980#2] Actual View driving the display of `DataPrivacy.html`
struct DataPrivacyView: View {
DataPrivacy display within Settings
Sources/eRpApp/Screens/Settings/SettingsLegalInfoView.swift:L48// [REQ:BSI-eRp-ePA:O.Arch_9#3,O.Purp_1#4] DataPrivacy display within Settings
Button {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Purp_2 | Zweckgebundene Erhebung und Verarbeitung der Daten. | Die Anwendung DARF KEINE Daten erheben und verarbeiten, die nicht dem rechtmäßigen Zweck der Anwendung dienen. | Die Nutzung von Sensordaten ist nur soweit zulässig, wie sie etwa zur Erhebung des Seeds dient. Der Evaluator prüft anhand der Permisison-Policy, welche Daten in der Anwendung verarbeitet werden und ob diese den rechtmäßigen Zwecken der Anwendung entsprechen. Dabei werden die vom Hersteller definierten rechtmäßige Zwecke als Grundlage genutzt. Eine juristische Prüfung der Rechtmäßigkeit ist nicht erforderlich. | CHECK |
Scanning tasks contains purpose related data input
Sources/eRpApp/Screens/CameraView/ErxTaskScannerView.swift:L37// [REQ:BSI-eRp-ePA:O.Purp_2#1,O.Data_6#3] Scanning tasks contains purpose related data input
// [REQ:BSI-eRp-ePA:O.Source_1#1] Scanning tasks starts with scanner callback
store.send(.analyse(scanOutput: $0))
CAN is used for eGK connection
Sources/FeatureCardWall/CAN/CardWallCANView.swift:L120// [REQ:BSI-eRp-ePA:O.Purp_2#2,O.Data_6#2] CAN is used for eGK connection
CardWallCANInputView(
PIN is used for eGK Connection
Sources/FeatureCardWall/PIN/CardWallPINView.swift:L37// [REQ:BSI-eRp-ePA:O.Purp_2#3,O.Data_6#4] PIN is used for eGK Connection
PINView(store: store).padding()
User interaction analytics trigger …
Sources/eRpApp/Tracking/AnalyticsReducer.swift:L33// [REQ:BSI-eRp-ePA:O.Purp_2#4,O.Purp_4#1,O.Data_6#6] User interaction analytics trigger ...
struct AnalyticsReducer: Reducer
… records data only if user opt-in is given.
Sources/eRpApp/Tracking/ContentSquareAnalyticsAdapter.swift:L119// [REQ:BSI-eRp-ePA:O.Purp_2#5,O.Purp_4#2,O.Data_6#7] ... records data only if user opt-in is given.
if optIn {
Contact information is collected when needed for redeeming
Sources/eRpApp/Screens/Pharmacy/Redeem/PharmacyContactView.swift:L28// [REQ:BSI-eRp-ePA:O.Purp_2#6,O.Data_6#5] Contact information is collected when needed for redeeming
struct PharmacyContactView: View {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Purp_3 | Einholung einer Einwilligungserklärung des Nutzers. | Die Anwendung MUSS vor jeglicher Erfassung oder Verarbeitung personenbezogener Daten eine aktive und eindeutige Einwilligungserklärung des Nutzers einholen. | Der Evaluator prüft, ob ohne Zustimmung des Nutzers personenbezogene Daten verarbeitet werden können. | CHECK |
Terms of Use display is part of the onboarding
Sources/eRpApp/Screens/Onboarding/OnboardingLegalInfoView.swift:L108// [REQ:BSI-eRp-ePA:O.Purp_3#1] Terms of Use display is part of the onboarding
.sheet(isPresented: $store.showTermsOfUse.sending(\.setShowUse)) {
Terms of Use acceptance is required as part of the Onboarding.
Actual view for the Terms of Use display
Sources/eRpApp/Screens/Settings/TermsOfUse/TermsOfUseView.swift:L28// [REQ:BSI-eRp-ePA:O.Purp_3#2] Actual view for the Terms of Use display
// [REQ:BSI-eRp-ePA:O.Arch_8#1] Webview containing local html without javascript
struct TermsOfUseView: View {
Button allows tracking
Sources/eRpApp/Screens/Onboarding/OnboardingAnalyticsView.swift:L84// [REQ:BSI-eRp-ePA:O.Purp_3#4] Button allows tracking
Button(action: {
Button denies tracking
Sources/eRpApp/Screens/Onboarding/OnboardingAnalyticsView.swift:L98// [REQ:BSI-eRp-ePA:O.Purp_3#4] Button denies tracking
Button(action: {
Button denies tracking
Sources/eRpApp/Screens/Onboarding/OnboardingAnalyticsDetailView.swift:L88// [REQ:BSI-eRp-ePA:O.Purp_3#4] Button denies tracking
Button(action: {
Button allows tracking
Sources/eRpApp/Screens/Onboarding/OnboardingAnalyticsDetailView.swift:L74// [REQ:BSI-eRp-ePA:O.Purp_3#4] Button allows tracking
Button(action: {
Show comply route to display analytics usage within onboarding
Sources/eRpApp/Screens/Onboarding/OnboardingDomain.swift:L129// [REQ:gemSpec_eRp_FdV:A_19088,A_19091-01#1,A_19092-01#2] Show comply route to display analytics usage within
// onboarding
// [REQ:BSI-eRp-ePA:O.Purp_3#5] Show comply route to display analytics usage within onboarding
// [REQ:gemSpec_eRp_FdV:A_19089-01#2] Show comply route to display analytics usage within onboarding
case .showAnalytics:
Accept usage analytics
Sources/eRpApp/Screens/Onboarding/OnboardingDomain.swift:L135// [REQ:gemSpec_eRp_FdV:A_19090-01,A_19091-01#2] User confirms the opt in within settings
// [REQ:BSI-eRp-ePA:O.Purp_3#6] Accept usage analytics
case .allowTracking:
Deny usage analytics
Sources/eRpApp/Screens/Onboarding/OnboardingDomain.swift:L140// [REQ:gemSpec_eRp_FdV:A_19092-01#3] User may choose to not accept analytics, onboarding will still continue
// [REQ:BSI-eRp-ePA:O.Purp_3#7] Deny usage analytics
case .denyTracking:
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Purp_4 | Nutzung ausschließlich zugestimmter Daten. | Daten, deren Verarbeitung der Nutzer nicht ausdrücklich zugestimmt hat, DÜRFEN NICHT von der Anwendung oder dem Hintergrundsystem erfasst, erhalten oder genutzt werden. | Der Evaluator gleicht die in O.Purp_2 gewonnen Erkenntnisse mit den erteilten Zustimmungen ab. | CHECK |
User interaction analytics trigger …
Sources/eRpApp/Tracking/AnalyticsReducer.swift:L33// [REQ:BSI-eRp-ePA:O.Purp_2#4,O.Purp_4#1,O.Data_6#6] User interaction analytics trigger ...
struct AnalyticsReducer: Reducer
… records data only if user opt-in is given.
Sources/eRpApp/Tracking/ContentSquareAnalyticsAdapter.swift:L119// [REQ:BSI-eRp-ePA:O.Purp_2#5,O.Purp_4#2,O.Data_6#7] ... records data only if user opt-in is given.
if optIn {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Purp_5 | Entzug der Einwilligung ermöglichen. | Die Anwendung MUSS ermöglichen, dass der Nutzer eine bereits erteilte Einwilligung wieder entziehen kann. Der Nutzer MUSS vor der Einwilligung über die Möglichkeit des Widerrufs und die sich daraus ergebenden Veränderungen im Verhalten der Anwendung informiert werden. | Der Evaluator prüft, ob dem Nutzer die Möglichkeit gegeben wird erteilte Einwilligungen wieder zu entziehen. Darüber hinaus validiert er, dass der Nutzer beim Entzug von Einwilligungen auf die daraus resultierenden Konsequenzen hingewiesen wird. | CHECK |
Toggle within Settings to enable and disable usage analytics
Sources/eRpApp/Screens/Settings/SettingsView.swift:L130// [REQ:gemSpec_eRp_FdV:A_19097-01#2] Toggle within Settings to enable and disable usage analytics
// [REQ:BSI-eRp-ePA:O.Purp_5#1] Toggle within Settings to enable and disable usage analytics
// [REQ:BSI-eRp-ePA:O.Purp_6#1] Current Analytics state is inspectable by the user
// [REQ:gemSpec_eRp_FdV:A_19982#4] Opt out of analytics
Toggle(isOn: $store.trackerOptIn.sending(\.toggleTrackingTapped).animation()) {
Actual disabling of analytics
Sources/eRpApp/Screens/Settings/SettingsDomain.swift:L176// Tracking
// [REQ:gemSpec_eRp_FdV:A_19088, A_19089-01#5, A_19092-01#4, A_19097-01#1] React to later opt-in or deactivation
// of usage analytics
// [REQ:BSI-eRp-ePA:O.Purp_5#2] Actual disabling of analytics
// [REQ:gemSpec_eRp_FdV:A_19982#2] Opt out of analytics
case let .toggleTrackingTapped(optIn):
Show comply view for settings triggered analytics enabling
Sources/eRpApp/Screens/Settings/SettingsView.swift:L60// Tracking comply sheet presentation
// [REQ:BSI-eRp-ePA:O.Purp_5#3] Show comply view for settings triggered analytics enabling
// [REQ:gemSpec_eRp_FdV:A_19982#3,A_19089-01#3] Show information dialog for analytics usage
Rectangle()
User confirms the opt in within settings
Sources/eRpApp/Screens/Settings/SettingsDomain.swift:L189// [REQ:gemSpec_eRp_FdV:A_19090-01,A_19091-01#4] User confirms the opt in within settings
// [REQ:BSI-eRp-ePA:O.Purp_5#4] User confirms the opt in within settings
case .confirmedOptInTracking:
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Purp_6 | Führen eines Verzeichnisses der Nutzereinwilligungen. | Der Hersteller MUSS ein Verzeichnis führen, welches erkennen lässt, welche Nutzereinwilligungen vorliegen. Der nutzerspezifische Teil des Verzeichnisses MUSS für den Nutzer automatisiert einsehbar sein. Es SOLL eine Historie dieses Verzeichnisses angefordert werden können. | Der Evaluator prüft das Vorhandensein, die Aktualität und die Vollständigkeit des Verzeichnisses. | CHECK |
Current Analytics state is inspectable by the user
Sources/eRpApp/Screens/Settings/SettingsView.swift:L131// [REQ:gemSpec_eRp_FdV:A_19097-01#2] Toggle within Settings to enable and disable usage analytics
// [REQ:BSI-eRp-ePA:O.Purp_5#1] Toggle within Settings to enable and disable usage analytics
// [REQ:BSI-eRp-ePA:O.Purp_6#1] Current Analytics state is inspectable by the user
// [REQ:gemSpec_eRp_FdV:A_19982#4] Opt out of analytics
Toggle(isOn: $store.trackerOptIn.sending(\.toggleTrackingTapped).animation()) {
As most of the user decisions are client side no history is available. Only the current state can be inspected.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Purp_7 | Nutzung nur erforderlicher Drittanbieter-Software. | Setzt die Anwendung Drittanbieter-Software ein, MÜSSEN alle verwendeten Funktionen für die rechtmäßigen Zwecke der Anwendung erforderlich sein. Die Anwendung SOLL anderweitige Funktionen sicher deaktivieren. Wird nur eine einzige oder sehr wenige Funktionen der Drittanbieter-Software benötigt, MUSS abgewogen werden, ob die Einbindung der gesamten Drittanbieter-Software im Verhältnis zur Vergrößerung der Angriffsoberfläche durch die verwendete Drittanbieter-Software steht. | Der Evaluator prüft die Abwägungen des Herstellers bei Funktionen, die nicht dem rechtmäßigen Zweck für die Anwendung dienen. So dürfte beispielsweise eine API für soziale Netzwerke nur verwendet werden, wenn dies mit dem rechtmäßigen Zweck der Anwendung vereinbar ist. Die Risikobewertung erfasst die Auswirkungen auf den Schutz der Gesundheitsdaten, beispielsweise bei dem für Dritte erkennbaren Nutzungsverhalten in Logging Frameworks. | CHECK |
Most libraries are self written and cover only what is needed. Dependencies are only included if really necessary. We think about including only sub packages, but as most dependencies are very small, this is hardly used. Besides that, no means of removing unused dependency functionality is available for libraries of the platform.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Purp_8 | Weitergabe von sensiblen Daten nur für den primären oder rechtmäßigen Zweck. | Sofern es nicht für den vorgesehenen primären oder rechtmäßigen Zweck einer Anwendung erforderlich ist, DÜRFEN sensible Daten NICHT mit Dritten geteilt werden. Dies betrifft auch die Ablage dieser Daten in Teilen des Dateisystems, auf die auch andere Anwendungen Zugriff haben. Die Anwendung MUSS den Nutzer über die Konsequenzen einer eventuellen Weitergabe von Anwendungsdaten, die dem primären oder rechtmäßigen Zweck dienen, vollumfänglich informieren und sein Einverständnis einholen (OPT-IN). | Der Evaluator prüft die Abwägungen des Herstellers, ob die Weitergabe von sensiblen Daten an Dritte dem primären oder rechtmäßigen Zweck für die Anwendung dient. Darüber hinaus prüft er, ob die Weitergabe immer explizit durch den Nutzer erlaubt werden muss (Opt-In). Die Weitergabe an Dienste, deren primärer Zweck die Verarbeitung von Daten für Werbezwecke ist, ist generell verboten. Die Risikobewertung berücksichtigt, wie die Weitergabe von Daten an Dritte im Verhältnis zum Schutzbedarf der weitergeleiteten Informationen (Daten) und der daraus resultierenden Gefahr der Preisgabe von Informationen steht. | CHECK |
Sharing of data is only for the primary purpose of the application e.g. sending presriptions to a pharmacy or sharing a prescription with a family member. We do not store data in shared containers in any way.
Implementation of data storage that is persisted via keychain
Sources/eRpApp/Session/KeychainStorage.swift:L35// [REQ:gemSpec_eRp_FdV:A_19186]
// [REQ:gemSpec_eRp_FdV:A_19188] Deletion of data saved here is managed by the OS.
// [REQ:gemSpec_IDP_Frontend:A_21322] Storage implementation uses iOS Keychain
// [REQ:gemSpec_IDP_Frontend:A_21595] Storage Implementation
// [REQ:BSI-eRp-ePA:O.Purp_8#1,O.Arch_4#3] Implementation of data storage that is persisted via keychain
// [REQ:BSI-eRp-ePA:O.Source_7#2,O.Data_2#2,O.Auth_13#3] Implementation of data storage that is persisted via keychain
class KeychainStorage: SecureUserDataStore, IDPStorage, SecureEGKCertificateStorage {
actual protection setting on file system level
Sources/eRpLocalStorage/CoreDataController.swift:L76-L79// [REQ:BSI-eRp-ePA:O.Purp_8#3|4] actual protection setting on file system level
protectedStoreDescription.setOption(
protectedStoreDescription.setOption(
fileProtectionType as NSObject,
forKey: NSPersistentStoreFileProtectionKey
Database backup exclusion
Sources/eRpLocalStorage/CoreDataController.swift:L100// [REQ:BSI-eRp-ePA:O.Purp_8#4,O.Arch_4#2,O.Data_15#1] Database backup exclusion
if excludeFromBackup, let storeUrl = store.url {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Purp_9 | Nur zweckgebundene Darstellung sensibler Daten auf dem Bildschirm. | Die Anwendung DARF sensible Daten NICHT auf dem Bildschirm darstellen, außer dies ist für den primären Zweck der Anwendung erforderlich. | Der Evaluator prüft die Abwägungen des Herstellers, ob die Darstellung von sensiblen Daten zum gegebenen Zeitpunkt für die Erfüllung des Zwecks der Anwendung erforderlich ist. Für die Risikobewertung ist zu berücksichtigen, wie die Anwendung den Nutzer davor schützt, sensible Daten anzuzeigen (vergleiche T.VisibleAsset). | CHECK |
Sensitive data is only shown for the purpose of this application. This includes display of prescriptions, personal data and health data.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Rand_1 | Erzeugung von Zufallswerten durch sicheren Zufallszahlengenerator. | Alle Zufallswerte MÜSSEN über einen starken kryptographischen Zufallszahlengenerator erzeugt werden, welcher mit ausreichend Entropie geseedet wurde (vgl. [TR02102-1]). | Der Evaluator prüft durch Quelltextanalyse und praktische Tests die Güte des kryptographischen Zufallszahlengenerators. Informationen zu ausreichend sicheren Zufallszahlengeneratoren sind [TR02102-1] Kapitel 10 zu entnehmen. Für die Nachbearbeitung der Zufallszahlen sind die vom BSI als ausreichend sicher angesehen Algorithmen (s.[AIS20], [TR03107-1] und [TR03116-4]) zu verwenden. | EXAMINE |
We use the platform provided secure random generator. iOS is FIPS 140-2 certified. The operating system uses an entropy pool with different sources, including a true random number generator from the secure enclave, that is present on every device. Security certifcates can be found https://support.apple.com/de-li/guide/certifications/apc3fa917cb49/web, including FIPS 140-2 und Common Criteria.
Secure Random generator.
Sources/IDP/internal/SecKeyRandom.swift:L29/// Generate random Data with given length
///
/// [REQ:gemSpec_Krypt:GS-A_4367]
/// [REQ:BSI-eRp-ePA:O.Rand_1#2] Secure Random generator.
///
/// - Parameters:
/// - length: the number of bytes to generate
/// - randomizer: the randomizer to be used. Default: kSecRandomDefault
/// - Returns: the random initialized Data
/// - Throws: `IDPError`
public func generateSecureRandom(length: Int, randomizer: SecRandomRef? = kSecRandomDefault) throws -> Data {
Secure Random generator.
Sources/VAUClient/internal/VAURandom.swift:L30/// Generate random Data with given length
///
/// [REQ:gemSpec_Krypt:GS-A_4367]
/// [REQ:BSI-eRp-ePA:O.Rand_1#3] Secure Random generator.
///
/// - Parameters:
/// - length: the number of bytes to generate
/// - randomizer: the randomizer to be used. Default: kSecRandomDefault
/// - Returns: the random initialized Data
/// - Throws: `VAUError`
static func generateSecureRandom(length: Int, randomizer: SecRandomRef? = kSecRandomDefault) throws -> Data {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Resi_1 | Informationen zum sicheren Umgang mit der Anwendung. | Die Anwendung MUSS dem Nutzer barrierearme Best-Practice-Empfehlungen zum sicheren Umgang mit der Anwendung und ihrer Konfiguration bereitstellen. | Der Evaluator prüft, ob die Anwendung „Best-Practices“ bereitstellt. Er bestätigt, dass vorhandene „Best-Practices“ dem aktuellen Stand der Technik entsprechen. | CHECK |
The onboarding contains defaults that are best practices, such as using biometrics for authentication. While using the Cardwall, selecting the “save login” option results in an dialog with additional information, to let the user make informed decisions. A missing device passcode results in a dialog that is recommending the setup of a device passcode.
View containing onboarding authentication
Sources/eRpApp/Screens/Onboarding/OnboardingRegisterAuthenticationView.swift:L28// [REQ:BSI-eRp-ePA:O.Resi_1#2] View containing onboarding authentication
struct OnboardingRegisterAuthenticationView: View, KeyboardReadable {
View containing information regarding the login options.
Sources/FeatureCardWall/Login/CardWallLoginOptionView.swift:L110// [REQ:gemSpec_IDP_Frontend:A_21574] Actual view
// [REQ:BSI-eRp-ePA:O.Resi_1#3] View containing information regarding the login options.
struct PrivacyWarningViewContainer: View {
View containing the “no system pin” message.
Sources/eRpApp/Screens/Main/DeviceSecurity/DeviceSecurityNoSystemPin/DeviceSecuritySystemPinView.swift:L27// [REQ:BSI-eRp-ePA:O.Resi_1#4] View containing the "no system pin" message.
struct DeviceSecuritySystemPinView: View {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Resi_2 | Erkennung vom Betriebszustand des verwendeten Endgerätes. | Die Anwendung MUSS mittels Betriebssystem- Funktion abfragen, ob sich das Betriebssystem in einem Betriebszustand befindet, der den Anforderungen des Betriebssystemherstellers entspricht. Befindet sich das Betriebssystem in keinem vom Betriebssystemhersteller vorgesehenen Zustand, MUSS die Anwendung angemessen darauf reagieren. Die Anwendung MUSS dem Nutzer darstellen, welche Risiken für die Daten des Nutzers bei einer Fortsetzung der Anwendung bestehen (z. B., dass diese offengelegt werden könnten) oder die Fortsetzung unterbinden. | Der Evaluator überprüft durch praktische Tests die Wirksamkeit der Maßnahmen zur Erkennung, ob sich das Betriebssystem außerhalb eines Betriebszustand befindet, der den Anforderungen des Betriebssystemherstellers entspricht (z.B. Root-/Jailbreak-Erkennung). Weiterhin prüft er, ob die Anwendung angemessen auf das Erkennen reagiert. Dies kann beispielsweise eine Terminierung der Anwendung sein (vergleiche O.Resi_5). Gemäß A.OperatingSystem wird angenommen, dass das Betriebssystem Funktionen bereitstellt, mit denen eine Anwendung die Konformität des Betriebszustandes bezüglich der Anforderungen des Betriebssystemherstellers an das Betriebssystem abfragen kann. | EXAMINE |
Jailbreak detection is done on startup of the application after the app authentication. If a jailbreak is detected, a information dialog is presented to the user.
trigger device security check
Sources/eRpApp/Screens/Main/MainView.swift:L105// [REQ:BSI-eRp-ePA:O.Arch_6#2,O.Resi_2#2,O.Plat_1#2] trigger device security check
store.send(.loadDeviceSecurityView)
calculate system risk for jailbreak and missing device pin
Sources/eRpApp/Session/Helper/DeviceSecurityManager.swift:L66// [REQ:BSI-eRp-ePA:O.Arch_6#3,O.Resi_2#3,O.Plat_1#3] calculate system risk for jailbreak and missing device pin
var showSystemSecurityWarning: AnyPublisher {
Jailbreak detection
Sources/eRpApp/Session/Helper/DeviceSecurityManager.swift:L120// [REQ:BSI-eRp-ePA:O.Arch_6#4,O.Resi_2#4] Jailbreak detection
func informJailbreakDetected() -> Bool {
Jailbreak information view
Sources/eRpApp/Screens/Main/DeviceSecurity/DeviceSecurityRootedDevice/DeviceSecurityRootedDeviceView.swift:L26// [REQ:BSI-eRp-ePA:O.Arch_6#5,O.Resi_2#5] Jailbreak information view
struct DeviceSecurityRootedDeviceView: View {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Resi_3 | Erkennung und Unterbindung des Starts in einer Entwicklungs- /Debug-Umgebung. | Die Anwendung MUSS eigene Prüfmechanismen implementieren, die beim Start der Anwendung feststellen, ob sie in einer Entwicklungs-/Debug-Umgebung ausgeführt wird. Wenn die Anwendung feststellt, dass sie in einer Entwicklungs-/Debug-Umgebung ausgeführt wird, MUSS sie sich sofort beenden. | Der Evaluator prüft die Wirksamkeit der Debug-Erkennung durch praktische Tests. (vergleiche O.Resi_5). | CHECK |
Starting within a debug environment is only possible on rooted/jailbroken devices. If that is the case, the user sees a dialog and can choose to continue or cancel using the application. See O.Resi_2 for jailbreak detection details.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Resi_4 | Abbruch des Starts der Anwendung bei ungewöhnlichen Benutzerrechten. | Die Anwendung MUSS eigene Prüfmechanismen implementieren, die beim Start der Anwendung feststellen, ob sie unter ungewöhnlichen Benutzerrechten gestartet ist. Wenn die Anwendung feststellt, dass dies der Fall ist, MUSS sie sich sofort beenden. | Der Evaluator prüft die Wirksamkeit der Erkennung durch praktische Tests (vergleiche O.Resi_5). | CHECK |
Starting with unusal app rights is only possible on rooted/jailbroken devices. If that is the case, the user sees a dialog and can choose to continue or cancel using the application. See O.Resi_2 for jailbreak detection details.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Resi_5 | Überprüfung der Integrität des Endgeräts vor Verarbeitung sensibler Daten. | Die Anwendung SOLL die Integrität des Endgeräts sicherstellen , bevor sensible Daten verarbeitet werden. | Der Evaluator untersucht, welche Integritätsprüfung durch die Anwendung vorgenommen wird. Wenn die Prüfung durch externe Tools durchgeführt wird, zu dem der Evaluator keinen Quelltext besitzt, führt er einen Penetrationstest durch (vergleiche O.Resi_2 bis O.Resi_4). Ein Integritätscheck muss mindestens folgende Aspekte abdecken: • Einsatz von „custom firmware“. • Aktualität der Betriebssystemversion. • Vorhandensein von verdächtigen Werkzeugen oder Anwendungen auf dem Gerät. | EXAMINE |
Device Integrity may only be compromised on jailbroken devices. If that is the case, the user sees a dialog and can choose to continue or cancel using the application. See O.Resi_2 for jailbreak detection details. We exclude very old and unsecure devices, by restricting the application to modern iOS Versions. That restriction is automatically restricting the range of devices it can run on. See options.deploymentTarget.iOS path within project.yml or the generated IPHONEOS_DEPLOYMENT_TARGET within the project.pbxproj file for the iOS Version restriction.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Resi_6 | Überprüfung der Authentizität des Hintergrundsystems vor Zugriff. | Die Anwendung MUSS vor dem Zugriff auf das Hintergrundsystem dessen Integrität überprüfen (siehe auch O.Ntwk_4). | Der Evaluator prüft die Wirksamkeit der Authentizitätsprüfung (beispielsweise Zertifikats-Pinning) durch praktische Tests. | EXAMINE |
IDP Communication is secured by using TLS with pinned Certificates as well as JWEs with keys that are pinned using a TI specific trust anchor as well as OCSP. FD Communication is secured by using TLS and VAU encryption, again with pinned Certificates for both methods. APOVZD communication uses TLS with pinned certificates. The Pinned certificates fingerprints can be found within Sources/eRpApp/Resources/Info.plist.
Implementation of loading the discovery document for fetching signature and
Sources/IDPLive/DefaultIDPSession.swift:L277// [REQ:BSI-eRp-ePA:O.Resi_6#2] Implementation of loading the discovery document for fetching signature and
// encryption keys.
// [REQ:gemSpec_Krypt:A_21222#3] DiscoveryDocument is validated with the active trustStoreSession
private func loadDiscoveryDocument() -> AnyPublisher {
Discovery Document signature verification
Sources/IDPLive/DefaultIDPSession.swift:L438// [REQ:gemSpec_IDP_Frontend:A_22296-01] Signature verification
// [REQ:gemSpec_IDP_Frontend:A_23082#3] Signature verification
// [REQ:BSI-eRp-ePA:O.Resi_6#3] Discovery Document signature verification
guard try jwtContainer.verify(with: document.discKey) == true else {
Discovery Document signature verification
Sources/IDPLive/DefaultIDPSession.swift:L304// Validate JWT/DiscoveryDocument signature
// [REQ:gemSpec_Krypt:A_17207] Only implemented for brainpoolP256r1
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02] Assure that brainpoolP256r1 is used
// [REQ:gemSpec_Krypt:GS-A_4361-02] Assure that brainpoolP256r1 is used
// [REQ:BSI-eRp-ePA:O.Resi_6#4] Discovery Document signature verification
guard (try? fetchedDocument.backing.verify(with: fetchedDocument.discKey)) ?? false else {
Discovery Document signature verification
Sources/IDPLive/DefaultIDPSession.swift:L766-L771// [REQ:BSI-eRp-ePA:O.Resi_6#5|6] Discovery Document signature verification
guard try await self.validate(eeCertificate: discoveryDocument.discKey)
guard try await self.validate(eeCertificate: discoveryDocument.discKey)
else { return false }
// [REQ:gemSpec_IDP_Frontend:A_20625#3|4] `C.FD.SIG`-Certificate verification
return try await self.validate(eeCertificate: discoveryDocument.signingCert)
}
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Resi_7 | Integration von Härtungsmaßnahmen vor Verarbeitung sensibler Daten. | Die Anwendung SOLL Härtungsmaßnahmen, wie etwa eine Integritätsprüfung vor jeder Verarbeitung sensibler Daten innerhalb des Programmablaufs, realisieren. | Der Evaluator prüft, ob die Anwendung eine Integritätsprüfung bei jedem Programmstart oder bei sensiblen Operationen durchführt. Andernfalls werden die daraus resultierenden Restrisiken in der Risikobewertung berücksichtigt. | EXAMINE |
Recent Jailbreaks force a reboot or restart of springboard. Thus the application will also be restarted in these cases. The check for hardening is done on app startup and should be sufficient.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Resi_8 | Umsetzung von Maßnahmen gegen Reverse Engineering. | Die Applikation MUSS starke Maßnahmen gegen Reverse Engineering umsetzen. | Der Evaluator prüft, ob starke Maßnehmen gegen Reverse Engineering getroffen werden. „Starke Maßnahmen“ müssen sämtliche Strings, Dateinamen und interne Namen von Klassen und Methoden innerhalb der Anwendung, die einem Angreifer Hinweise auf den Programmablauf geben können, verschleiern. Die Anwendung kann hierfür weitere Verschleierungsmaßnahmen, wie beispielsweise White-Box- Kryptographie oder den Einsatz von virtuellen Maschinen zurückgreifen. Der Evaluator prüft die Wirksamkeit des Schutzes vor Reverse Engineering durch praktische Tests und dokumentiert den Prozess. Der Evaluator bewertet die bestehenden Restrisiken der Implementierung unter anderem in Bezug auf T.MemoryStructures, T.InfoDisclosure und T.SensitiveData. | EXAMINE |
The application source is available on github. Any measure of preventing reverse engineering would be pointless.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Resi_9 | Berücksichtigung von Plattformen und Versionen bei Zugriffskontrollmechanismen. | Die Anwendung MUSS unterschiedliche Ausprägungen einer Plattform (bspw. Android) bei unterschiedlichen Herstellern berücksichtigen. Sie muss so gebaut sein, dass solche unterschiedlichen Plattformen bzw. unterschiedliche Plattformversionen zu keinem Fehlverhalten führt. Insbesondere MUSS ein missbräuchlicher Zugriff auf Ressourcen durch unterschiedliche Ausprägungen einer Plattform ausgeschlossen werden. | Der Evaluator bestätigt, dass sich die Implementierung der Zugriffsmaßnahmen nicht allein auf das Betriebssystem verlässt und damit evtl. durch einen Downgrade- Angriff auf das Betriebssystem verwundbar ist. | EXAMINE |
Data is not stored while moving between platforms or devices. Private keys are stored within the secure enclave an cannot leave the device. Downgrades are prohibited by the operating system and update mechanisms.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Resi_10 | Robustheit gegenüber Störungen. | Die Anwendung MUSS robust gegenüber Störungen sein. | Der Evaluator prüft durch Quelltextanalyse und praktischen Tests, ob Störungen (z.B. in der Stromversorgung, Internetverbindung) oder Fehlbedienung zu einem Verlust der Daten führen können. | EXAMINE |
Missing internet connection or other means of disruption use the same error mechanisms as every part of the app uses for normal errors. Data is only deleted where appropriate, e.g. invalid tokens are deleted. User Data is not deleted unless explicitly confirmed by the user.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Source_1 | Prüfung von Eingaben vor Verwendung. | Die Anwendung MUSS alle Eingaben vor deren Verarbeitung prüfen, um potenziell bösartige Werte vor der Verarbeitung herauszufiltern. | Der Evaluator prüft, ob für alle Eingaben aus nicht vertrauenswürdigen Quellen Sicherheitsfunktionen gemäß O.Arch_5 vorhanden sind. Eingaben meinen jegliche Art von Daten, die in die Anwendung hineinfließen. Das sind zum Beispiel Nutzereingaben, Eingaben aus Drittanbieterkomponenten etc. | CHECK |
Scanning tasks starts with scanner callback
Sources/eRpApp/Screens/CameraView/ErxTaskScannerView.swift:L38// [REQ:BSI-eRp-ePA:O.Purp_2#1,O.Data_6#3] Scanning tasks contains purpose related data input
// [REQ:BSI-eRp-ePA:O.Source_1#1] Scanning tasks starts with scanner callback
store.send(.analyse(scanOutput: $0))
We have two potential unknown inputs, one being the scanner, that scanns QR Codes or Data Matrix Codes. External interactions are managed through Universal Linking, with thorough validation of URL parameters to ensure only predefined variables are accepted.
analyse the input
Sources/eRpApp/Screens/CameraView/ScannerDomain.swift:L147// [REQ:BSI-eRp-ePA:O.Source_1#2] analyse the input
let result = try CodeAnalyser.analyse(scanOutput: scanOutput, with: state.acceptedTaskBatches)
validation
Sources/eRpApp/Screens/CameraView/ScannerDomain+Helper.swift:L35// [REQ:BSI-eRp-ePA:O.Source_1#3] validation
static func analyse(scanOutput: [ScanOutput],
actual validation by decoding into predefined structure
Sources/eRpKit/ScannedErxTask.swift:L121// [REQ:gemSpec_eRp_FdV:A_19984] validate data matrix code structure
// [REQ:BSI-eRp-ePA:O.Source_1#4] actual validation by decoding into predefined structure
erxToken = try jsonDecoder.decode(ErxToken.self, from: jsonData)
External application calls via Universal Linking
Sources/eRpApp/SceneDelegate.swift:L269// [REQ:BSI-eRp-ePA:O.Source_1#5] External application calls via Universal Linking
func scene(_: UIScene, continue userActivity: NSUserActivity) {
External application calls via Universal Linking
Sources/eRpApp/Screens/AppStartDomain.swift:L248// [REQ:BSI-eRp-ePA:O.Source_1#6] External application calls via Universal Linking
case let .universalLink(url):
redirect into correct domain
Sources/eRpApp/Screens/Main/MainDomain.swift:L321// [REQ:BSI-eRp-ePA:O.Source_1#7] redirect into correct domain
// [REQ:gemSpec_IDP_Frontend:A_22301-01#6|3] Redirect into ExtAuthPendingDomain
return .run { send in
Validate data by parsing url and only allowing predefined variables as String
Sources/eRpApp/Screens/Main/ExtAuth/ExtAuthPendingDomain.swift:L164// [REQ:BSI-eRp-ePA:O.Source_1#8] Validate data by parsing url and only allowing predefined variables as String
// [REQ:gemSpec_IDP_Frontend:A_22301-01#7] Actual handling of the universal link, user feedback via dialogs e.g.
case let .externalLogin(url),
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Source_2 | Nutzung einer Escape-Syntax bei strukturierten Daten. | Die Anwendung MUSS eingehende und ausgehende Daten maskieren beziehungsweise von potenziell schadhaften Zeichen bereinigen oder deren Verarbeitung ablehnen. | Der Evaluator prüft, ob eine Escape- Syntax von strukturierten Daten für alle Eingaben gemäß O.Arch_5 vorhanden ist. Schadhafte Zeichen sind kontextabhängig zu betrachten. Im Datenbank-Kontext sind beispielsweise Hochkommata oder Prozentzeichen gegebenenfalls schadhaft, während im Web/HTML Kontext eher Tag-Klammern (<) schadhaft sind. Grundsätzlich muss die Input-Validierung daher kontextbezogen stattfinden. Wird eine potenziell schädliche Eingabe erkannt, muss sie entweder bereinigt/maskiert oder abgelehnt/verworfen werden. Das Verwerfen sollte dem Bereinigen vorgezogen werden. Sofern vorher maskierte oder bereinigte Eingaben weitergegeben werden, müssen diese so maskiert oder enkodiert werden, dass sie im Kontext der Weitergabe keine schädlichen Effekte haben. | CHECK |
Data escaping is managed by the operating system frameworks. We do not create SQL queries manually; instead, we utilize CoreData as an ORM. Queries are constructed using NSFetchRequests and NSPredicates, which automatically escape all manual input. Additionally, actual user data is transmitted via FHIR, with the escaping process handled by Apple’s provided FHIR library.
CoreDataStore adapter for PharmacyLocations
/// Store for fetching, creating, updating or deleting `PharmacyLocation`s on the provided `CoreDataController`
/// [REQ:BSI-eRp-ePA:O.Source_2#2] CoreDataStore adapter for `PharmacyLocation`s
public class PharmacyCoreDataStore: PharmacyLocalDataStore, CoreDataCrudable {
CoreDataStore adapter for ErxTasks
// tag::ErxTaskCoreDataStoreDescription[]
/// Store for fetching, creating, updating or deleting `ErxTask`s and it‘s underlying types. Access to most entities is
/// tied to the given profileId.
/// [REQ:BSI-eRp-ePA:O.Source_2#3] CoreDataStore adapter for `ErxTask`s
public class DefaultErxTaskCoreDataStore: ErxTaskCoreDataStore {
CoreDataStore adapter for Profiles
/// Store for fetching, creating, updating or deleting `Profile`s on the provided `CoreDataController`
/// [REQ:BSI-eRp-ePA:O.Source_2#4] CoreDataStore adapter for `Profile`s
public class ProfileCoreDataStore: ProfileDataStore, CoreDataCrudable {
CoreDataStore adapter for ShipmentInfoEntitys
/// Store for fetching, creating, updating or deleting `ShipmentInfoEntity`s on the provided `CoreDataController`
/// [REQ:BSI-eRp-ePA:O.Source_2#5] CoreDataStore adapter for `ShipmentInfoEntity`s
public class ShipmentInfoCoreDataStore: ShipmentInfoDataStore, CoreDataCrudable {
CoreDataStore adapter for AVSTransactionEntitys
/// Store for fetching, creating, updating or deleting `AVSTransactionEntity`s on the provided `CoreDataController`
/// [REQ:BSI-eRp-ePA:O.Source_2#6] CoreDataStore adapter for `AVSTransactionEntity`s
public class AVSTransactionCoreDataStore: AVSTransactionDataStore, CoreDataCrudable {
See all files named ModelsR4.Bundles+<TypeName> within eRpRemoteStorage Package to find all references for FD related FHIR parsing. All other files within the Module are either helpers or provide support for creating FHIR objects that may be sent to the FD.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Source_3 | Keine sensiblen Daten in Meldungen. | Fehlermeldungen und Log-Dateien DÜRFEN KEINE sensiblen Daten (z. B. User Identifier) enthalten. | Der Evaluator prüft, ob sensible Daten über Fehlermeldungen oder Benachrichtigungen einsehbar werden. | CHECK |
Error messages are localized using the Foundation.LocalizedError protocol. Search for LocalizedError to see all instances. Most errors are localized with static text, some errors contain server side error messages. User data is never used for error messages. Logging is only active on debug builds. See O.Plat_4 for reference.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Source_4 | Kontrollierte Behandlung und Dokumentation von Ausnahmen (Exceptions). | Potenzielle Ausnahmen im Programmablauf (Exceptions) MÜSSEN abgefangen, kontrolliert behandelt und dokumentiert werden. Technische Fehlerbeschreibungen (z.B. Stack Traces) DÜRFEN dem Nutzer NICHT angezeigt werden. | Der Evaluator prüft durch Quelltextanalyse und praktische Tests die kontrollierte Behandlung und Dokumentation von Exceptions. | EXAMINE |
Exception handling in swift uses Errors to represent the exception. We use a custom protocol CodedError that is autogenerated for all error messages. Together with LocalizedError we create error messages that contain a user readable description as well as some technical identifiers to easily identify specific error scenarios and give better support. See CodedError.swift and CodedError.generated.swift for the protocol and the autogenerated implementations of it.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Source_5 | Abbruch des Zugriffs auf sensible Daten bei Exceptions. | Bei Ausnahmen im Programmablauf (Exceptions) SOLL die Anwendung Zugriffe auf sensible Daten abbrechen und diese im Speicher sicher löschen. | Der Evaluator prüft den Zugriff auf sensible Daten bei Ausnahmen im Programmablauf. Jeglicher identifizierte Zugriff muss in der Risikobewertung betrachtet werden. | EXAMINE |
As exceptions and errors are kind of the same construct in swift, this aspect is hard to answer. If a server responds with 401/403 we delete tokens or other security measures, because they are no longer valid anyways. While logging in via biometrics we create temporary data containers for the user certificate and key identifier, that are deleted if the process is not completed properly and kept if the process completes.
invalidate/delete unauthorized token
Sources/IDPLive/IDPInterceptor.swift:L63// [REQ:gemSpec_eRp_FdV:A_20167-02#5] invalidate/delete unauthorized token
// [REQ:BSI-eRp-ePA:O.Source_5#2] invalidate/delete unauthorized token
session.invalidateAccessToken()
Invalidation means deleting the token
Sources/IDPLive/DefaultIDPSession.swift:L124// [REQ:BSI-eRp-ePA:O.Source_5#3] Invalidation means deleting the token
storage.set(token: nil)
Creation of the pairing session
Sources/FeatureCardWall/ReadCard/CardWallReadCardDomain.Environment+Biometrics.swift:L82// [REQ:BSI-eRp-ePA:O.Source_5#4] Creation of the pairing session
pairingSession = try sessionProvider.signatureProvider(profileID).createPairingSession()
Failure will delete paring data
Sources/FeatureCardWall/ReadCard/CardWallReadCardDomain.Environment+Biometrics.swift:L106// [REQ:gemSpec_IDP_Frontend:A_21598,A_21595] Failure will delete paring data
// [REQ:BSI-eRp-ePA:O.Source_5#5] Failure will delete paring data
_ = try? sessionProvider.signatureProvider(profileID).abort(pairingSession: pairingSession)
Failure will delete paring data
Sources/FeatureCardWall/ReadCard/CardWallReadCardDomain.Environment+Biometrics.swift:L150// [REQ:gemSpec_IDP_Frontend:A_21598,A_21595] Failure will delete paring data
// [REQ:BSI-eRp-ePA:O.Source_5#5] Failure will delete paring data
_ = try? sessionProvider.signatureProvider(profileID).abort(pairingSession: pairingSession)
Failure will delete paring data
Sources/FeatureCardWall/ReadCard/CardWallReadCardDomain.Environment+Biometrics.swift:L166// [REQ:gemSpec_IDP_Frontend:A_21598,A_21595] Failure will delete paring data
// [REQ:BSI-eRp-ePA:O.Source_5#5] Failure will delete paring data
_ = try? sessionProvider.signatureProvider(profileID).abort(pairingSession: pairingSession)
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Source_6 | Nutzung von sicheren Funktionsalternativen beim Zugriff auf Speichersegmente. | Bei Programmumgebungen mit manueller Speicherverwaltung (d.h., die Anwendung kann selbst exakt festlegen, wann und wo Speicher gelesen und beschrieben wird) MUSS die Anwendung für lesende und schreibende Zugriffe auf Speichersegmente auf sichere Funktionsalternativen (z. B. printf_s statt printf) zurückgreifen. | Der Evaluator prüft durch Quelltextanalyse, ob die Anwendung auf unsichere Funktionen zum Zugriff auf den Speicher zurückgreift. Die Prüfung umfasst sämtlichen vom Hersteller implementierten Quelltext. Externe Drittanbieter-Software wird in den O.TrdP Testcharakteristiken behandelt. | EXAMINE |
Swift uses Automatic Reference Counting that does not require active memory management. Raw memory access is possible but only used for swift-OpenSSL dependency that wraps the c library.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Source_7 | Sicheres Löschen von sensiblen Daten nach ihrer Verarbeitung. | Die Anwendung MUSS sicherstellen, dass alle sensiblen Daten unverzüglich nach der Erfüllung ihres Verarbeitungszwecks sicher gelöscht werden. | Der Evaluator prüft durch Quelltextanalyse und praktische Tests, ob alle sensiblen Daten, welche nicht durch O.Data_2 geschützt sind, unverzüglich nach ihrer Verarbeitung sicher gelöscht werden. „Sicheres Löschen“ erfordert ein Überschreiben der Daten im Speicher. Hier ist auch auf eventuelle Kopien der Daten zu achten. Dies beinhaltet bei Programmiersprachen ohne manuelle Speicherverwaltung unter anderem das Ersetzen von Strings durch Byte-Arrays. | EXAMINE |
All sensitive data is handled via value types. After usage the swift runtime handles deletion of the in memory representation. There is no method known to securely overwrite value types. Security is ensured by operating system and process boundaries. Secure enclave encryption keys can never leave the secure enclave by design.
Implementation of data storage that is persisted via keychain
Sources/eRpApp/Session/KeychainStorage.swift:L36// [REQ:gemSpec_eRp_FdV:A_19186]
// [REQ:gemSpec_eRp_FdV:A_19188] Deletion of data saved here is managed by the OS.
// [REQ:gemSpec_IDP_Frontend:A_21322] Storage implementation uses iOS Keychain
// [REQ:gemSpec_IDP_Frontend:A_21595] Storage Implementation
// [REQ:BSI-eRp-ePA:O.Purp_8#1,O.Arch_4#3] Implementation of data storage that is persisted via keychain
// [REQ:BSI-eRp-ePA:O.Source_7#2,O.Data_2#2,O.Auth_13#3] Implementation of data storage that is persisted via keychain
class KeychainStorage: SecureUserDataStore, IDPStorage, SecureEGKCertificateStorage {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Source_8 | Vollständige Entfernung von unterstützenden Entwicklungsoptionen und Debugmechanismen in der Produktiv-Version. | Alle Optionen zur Unterstützung der Entwicklung (z. B. Entwickler-URLs, Testmethoden, Überreste von Debugmechanismen etc.) MÜSSEN in der Produktiv-Version vollständig entfernt sein. | Der Evaluator überprüft die produktive Anwendung auf Rückstände von Optionen zur Unterstützung der Entwicklung sowie Rückstände von Zeichenketten, Debugmechanismen und Debuginformationen. | EXAMINE |
We use swift macros to remove development code. Configuration of server Environments is done within AppConfiguration.swift. A debug menu is available within settings, rooted within SettingsView.swift. UI-Test Scenarios are placed within the application, but exclude for production builds.
Debug menu is only visible on debug builds
Sources/eRpApp/Screens/Settings/SettingsView.swift:L37// [REQ:BSI-eRp-ePA:O.Source_8#3] Debug menu is only visible on debug builds
#if ENABLE_DEBUG_VIEW
DebugSectionView is only available on debug builds
Sources/eRpApp/Screens/Settings/SettingsView.swift:L161// [REQ:BSI-eRp-ePA:O.Source_8#4] DebugSectionView is only available on debug builds
private struct DebugSectionView: View {
DebugView is only available on debug builds
Sources/eRpApp/Screens/DebugView/DebugView.swift:L32// [REQ:BSI-eRp-ePA:O.Source_8#5] DebugView is only available on debug builds
struct DebugView: View {
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Source_9 | Aktivierung von modernen Sicherheitsmechanismen der Entwicklungsumgebung. | Für den Bau der Anwendung SOLLEN moderne Sicherheitsmechanismen, wie beispielsweise Obfuskation und Stack-Protection aktiviert werden. | Der Evaluator prüft, ob auf moderne Sicherheitsmechanismen der Entwicklungsumgebungen zurückgegriffen wurde. Sollten entsprechende Sicherheitsmechanismen nicht umgesetzt werden können, muss dies in der Risikobewertung betrachtet werden. | CHECK |
We use common defaults for all compiler security related settings. See Xcode build configuration for eRpApp Target using current Xcode for actual settings.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.Source_10 | Verwendung von Werkzeugen zur statischen Codeanalyse. | Für die Entwicklung der Anwendung SOLLEN Werkzeuge zur statischen Codeanalyse eingesetzt werden. | Der Evaluator prüft durch Quelltextanalyse und Befragung des Herstellers, ob bei der Entwicklung Werkzeuge zur statischen Codeanalyse eingesetzt wurden. Wurden keine Werkzeuge zur statischen Codeanalyse verwendet, muss dies in der Risikobewertung betrachtet werden. | CHECK |
We use an external SAST and SCA tool that is run at least on every release build. See Jenkinsfile_SAST for technical details. There is additional integration into our merge-reqeuest tooling.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.TrdP_1 | Abhängigkeiten durch Drittanbieter-Software. | Der Anbieter MUSS eine zentrale und vollständige Liste von Abhängigkeiten durch Drittanbieter-Software führen. | Der Hersteller stellt eine Liste der eingesetzten Drittanbieter-Software inkl. der verwendeten Versionen bereit. Der Evaluator prüft die bereitgestellte Liste auf Vollständigkeit. | CHECK |
Dependencies are handled with SPM. A technical description of all dependencies can be found within dependencies.yml. In the future, a generated SBOM will replace the Package.resolved for this purpose.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.TrdP_2 | Verwendung der aktuellen Version bei Drittanbieter- Software. | Drittanbieter-Software MUSS in der neusten oder der ihr vorhergehenden, für die Veröffentlichung vorgesehenen Version verwendet werden | Der Evaluator prüft die in O.TrdP_1 bereitgestellte Liste auf Aktualität der verwendeten Drittanbieter- Software-Versionen. Diese Abwägungen zu den gewählten Versionen werden in der Risikobewertung berücksichtigt. | CHECK |
Dependencies are updated regulary by an organizational process. Our release process contains a step ‘compile_foss’ which checks for old versions and highlightens them. If updates to the latest or previous version cannot be done, it should be documented in the merge request. Any dependency security issues raised by automatic checking are handled immediately. A list of all compiled dependencies can be found within dependencies.yml.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.TrdP_3 | Herstellerprüfung Drittanbieter- Software auf Schwachstellen. | Drittanbieter-Software MUSS durch den Hersteller regelmäßig (durch Auswertung öffentlich verfügbarer Informationen oder durch statische/dynamische Testmethoden) auf Schwachstellen überprüft werden. Überreste von Optionen zur Unterstützung der Entwicklung (vgl. O.Source_8) sind hierbei als Schwachstelle zu werten. Der Hersteller MUSS für alle öffentlich bekannten Schwachstellen analysieren, inwieweit die Schwachstelle die Sicherheit des Gesamtsystems beeinträchtigt. Software, bzw. Funktionen aus Drittanbieter- Software DARF bei bekannten Schwachstellen, die die Sicherheit des Gesamtsystems betreffen NICHT eingesetzt werden. | Der Hersteller stellt eine Übersicht der letzten Schwachstellenanalyse der eingesetzten Drittanbieter- Softwarebereit. Diese wird vom Evaluator geprüft und in der Risikobewertung berücksichtigt. Zusätzlich prüft der Evaluator, ob der Hersteller bei Auftreten von Schwachstellen eine Mitigationsstrategie im Rahmen einer angemessenen Grace-Period bereitstellt. | CHECK |
SCA Scans are part of our release pipeline, see O.Source_10.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.TrdP_4 | Sicherheitskonzept für zeitnahes Einspielen von Sicherheitsupdates für Drittanbieter-Software. | Sicherheitsupdates für Drittanbieter-Software MUSS zeitnah integriert und per Update dem Nutzer zur Verfügung gestellt werden. Der Hersteller MUSS ein Sicherheitskonzept vorlegen, das anhand der Kritikalität ausnutzbarer Schwachstellen die geduldete Weiternutzung für die Anwendung, bzw. das Hintergrundsystem festlegt. Nachdem die Übergangsfrist (Grace Period) abgelaufen ist, MUSS die Anwendung den Betrieb verweigern. | Der Evaluator prüft das Vorhandensein eines solchen Konzeptes. Eine inhaltliche Prüfung ist im Rahmen der TR nicht erforderlich. Zusätzlich prüft der Evaluator, ob der Hersteller eine Mitigationsstrategie bereitstellt. | CHECK |
Library updates are done by a manual periodic process. If any security issues arise and no fix is expected to be provided, a manual fork of external libraries is implemented. In our documentation [D5. Festlegung der Quality Gates und Bug Bars], [R3. Bewertung und Behandlung der bekanntgewordenen Schwachstellen], we define a bug bar and a grace period depending on the criticality of the vulnerability. Our bug bar is set to “Low”, see scripts/sast, lines including severity-threshold=low.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.TrdP_5 | Prüfung auf Vertrauenswürdigkeit der Quelle von Drittanbieter-Software. | Vor der Verwendung von Drittanbieter- Software MUSS deren Quelle auf Vertrauenswürdigkeit geprüft werden. | Der Evaluator prüft die Maßnahmen des Herstellers zur Verifikation der Vertrauenswürdigkeit von Drittanbietern. | CHECK |
Actual dependencies can be found within eRp-App.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved, containing pinned versions with corresponding hashes. Library updates always require manual interaction to update the *.resolved files. We use very few providers of libraries and try to avoid any unnecessary dependency. Each providing party/dependency is evaluated by looking at GitHub metrics like open issues, stars and activity in general. For more information, see [E2. Dritthersteller Komponenten]
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.TrdP_6 | Keine Weitergabe von sensiblen Daten an Drittanbieter-Software. | Die Anwendung SOLL sensible Daten nicht an Drittanbieter-Software weitergeben. | Der Evaluator prüft durch eine Quelltextanalyse und praktische Tests, dass keine Weitergabe von sensiblen Daten an Drittanbieter- Software vorgenommen wird. Eine Ausnahme hierzu bietet die Weitergabe von Daten, die für den primären oder rechtmäßigen Zweck der Anwendung erforderlich ist (beispielsweise Drittanbieter- Software zur Transportverschlüsselung). Risiken, die aus einer Nichteinhaltung resultieren, sind in der Risikobewertung zu berücksichtigen. | EXAMINE |
We do not share sensitive data with third parties. See data usages within O.Purp_8 and O.Arch_2.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.TrdP_7 | Validierung eingehender Daten über Drittanbieter-Software. | Über Drittanbieter-Software eingehende Daten MÜSSEN validiert werden. | Der Evaluator prüft, ob eingehende Daten über Drittanbieter-Software gemäß O.Source_1 behandelt werden und Sicherheitsfunktionen gemäß O.Arch_5 vorhanden sind. | CHECK |
See O.Source_1 and O.Arch_5.
| Prüfaspekt | Kurzfassung des Prüfaspekts | Prüfaspekt | Anmerkungen für den Prüfer | Prüftiefe |
|---|---|---|---|---|
| O.TrdP_8 | Prüfung der Wartung von verwendeter Drittanbieter- Software. | Drittanbieter-Software, die nicht mehr gewartet wird, DARF NICHT verwendet werden. | Der Evaluator prüft, ob die verwendete Drittanbieter-Software vom Hersteller aktiv gepflegt wird. Eine Software gilt als nicht mehr gewartet, sofern sicherheitskritische Verwundbarkeiten bekannt sind, jedoch nicht innerhalb einer angemessenen Frist repariert worden sind. | CHECK |
As most libraries are source code dependencies, these scans are part of Software Composition Analysis, which is run for every release. Libraries that are not source code dependencies are the precompiled OpenSSL and OpenHealthCardKit (own library but different repository). All third party libraries are mirrored into internal repositories. If necessary we fork libraries to apply fixes. Additional information can be found here [E2. Dritthersteller Komponenten].
A_19937 - Fehlermeldungen des Token-Endpunktes Anzeige
Das Anwendungsfrontend MUSS, wenn es eine Authentifizierung über den Smartcard-IDP unterstützt, in der Lage sein, die vom Token-Endpunkt übertragenen Fehlermeldungen anzuzeigen. [<=]
Localized description of server errors
Sources/IDP/Models/IDPError.swift:L447// [REQ:gemSpec_IDP_Frontend:A_19937#1,A_20605,A_20085] Localized description of server errors
case let .internal(error: error): return error.localizedDescription
Decoding server errors
Sources/IDPLive/RealIDPClient.swift:L522// [REQ:gemSpec_IDP_Frontend:A_19937#2,A_20605] Decoding server errors
private static func responseError(for body: Data) -> IDPError {
Error formatting
Sources/IDP/Models/IDPError.swift:L110// [REQ:gemSpec_IDP_Frontend:A_19937#3,A_20605,A_20085] Error formatting
public var description: String {
A_19938-01 - Annahme des ID_TOKEN
Das Anwendungsfrontend MUSS, wenn es eine Authentifizierung über den Smartcard-IDP unterstützt, das vom Token-Endpunkt ausgegebene ID_TOKEN als HTTP/1.1-Statusmeldung 200 verarbeiten und mittels "Token-Key" entschlüsseln.
Das Anwendungsfrontend MUSS das ID_TOKEN ablehnen, wenn dieses außerhalb der mit dem Token-Endpunkt etablierten TLS-Verbindung übertragen wird oder nicht mit dem vorher übermittelten "Token-Key" verschlüsselt war.
[<=]
We support the smartcard idp.
2xx HTTPCodes are treated as tokens
Sources/IDPLive/RealIDPClient.swift:L260-L262// [REQ:gemSpec_IDP_Frontend:A_19938-01#2|3] 2xx HTTPCodes are treated as tokens
if status.isSuccessful {
if status.isSuccessful {
return try JSONDecoder().decode(TokenPayload.self, from: body)
Decrypt, fails if wrong aes key
Sources/IDPLive/DefaultIDPSession.swift:L221-L223// [REQ:gemSpec_IDP_Frontend:A_19938-01#3|3,A_20283-01|3] Decrypt, fails if wrong aes key
guard let decrypted = try? token.decrypted(with: self.cryptoBox.aesKey) else {
guard let decrypted = try? token.decrypted(with: self.cryptoBox.aesKey) else {
return Fail(error: IDPError.decryption).eraseToAnyPublisher()
Usage
Sources/IDPLive/DefaultIDPSession.swift:L244idToken: decrypted.idToken, // [REQ:gemSpec_IDP_Frontend:A_19938-01#4] Usage
ssoToken: exchange.sso,
A_20079 - Ausfall der Fehlermeldung des Token-Endpunktes
Das Anwendungsfrontend MUSS, wenn es eine Authentifizierung über den Smartcard-IDP unterstützt, im Falle eines Timeout selbständig eine Fehlermeldung generieren, wenn eine Fehlermeldung durch den Token-Endpunkt ausbleibt. [<=]
Network timeouts will traverse the queue as HTTPErrors.
// [REQ:gemSpec_IDP_Frontend:A_20079] Network timeouts will traverse the queue as `HTTPError`s.
$0.asIDPError()
A_20085 - Fehlermeldungen des Anwendungsfrontends
Das Anwendungsfrontend MUSS, wenn es eine Authentifizierung über den Smartcard-IDP unterstützt, leicht verständliche Fehlermeldungen ausgeben. Eine exakte Form der Fehlermeldung ist nicht vorgegeben [RFC6749 # section-1.7]. [<=]
Error formatting
Sources/IDP/Models/IDPError.swift:L110// [REQ:gemSpec_IDP_Frontend:A_19937#3,A_20605,A_20085] Error formatting
public var description: String {
Error localization is not done yet, this is the place to localize
Sources/IDP/Models/IDPError.swift:L436// [REQ:gemSpec_IDP_Frontend:A_20085] Error localization is not done yet, this is the place to localize
// accordingly.
switch self {
Localized description of server errors
Sources/IDP/Models/IDPError.swift:L447// [REQ:gemSpec_IDP_Frontend:A_19937#1,A_20605,A_20085] Localized description of server errors
case let .internal(error: error): return error.localizedDescription
A_20283-01 - Annahme des "ACCESS_TOKEN"
Das Anwendungsfrontend MUSS, wenn es eine Authentifizierung über den Smartcard-IDP unterstützt, das vom Token-Endpunkt ausgegebene ACCESS_TOKEN in der HTTP/1.1-Statusmeldung 200 verarbeiten und mittels "Token-Key" entschlüsseln.
Das Anwendungsfrontend MUSS das ACCESS_TOKEN ablehnen, wenn dieses außerhalb der mit dem Token-Endpunkt etablierten TLS-Verbindung übertragen wird oder nicht mit dem vorher übermittelten "Token-Key" verschlüsselt war.
[<=]
Usage
Sources/IDPLive/DefaultIDPSession.swift:L242accessToken: decrypted.accessToken, // [REQ:gemSpec_IDP_Frontend:A_20283-01] Usage
expires: self.time().addingTimeInterval(TimeInterval(token.expiresIn)),
A_20309 - Bildung von "CODE_VERIFIER" und "CODE_CHALLENGE"
Das Anwendungsfrontend MUSS, wenn es eine Authentifizierung über den Smartcard-IDP unterstützt, zur Laufzeit einen CODE_VERIFIER (Zufallswert) gemäß [RFC7636 # section-4.1] bilden. Der CODE_VERIFIER muss eine Entropie von mindestens 43 und maximal 128 Zeichen enthalten. Das Anwendungsfrontend MUSS über den CODE_VERIFIER einen HASH-Wert, die sogenannte CODE_CHALLENGE, gemäß [RFC7636 # section-4.2] bilden. [<=]
verifierLength is 32 bytes, encoded to base64 this results in 43 chars
Sources/IDP/internal/IDPCrypto.swift:L96// [REQ:gemSpec_IDP_Frontend:A_20309] verifierLength is 32 bytes, encoded to base64 this results in 43 chars
// (32 * 4 / 3 = 42,6)
guard let encoded = try randomGenerator(verifierLength).encodeBase64UrlSafe() else {
generation and hashing for codeChallenge
Sources/IDPLive/DefaultIDPSession.swift:L618// Generate a verifierCode
// [REQ:gemSpec_IDP_Frontend:A_20309] generation and hashing for codeChallenge
guard let verifierCode = try? self.cryptoBox.generateRandomVerifier(),
Requesting the challange for the session
Sources/IDPLive/DefaultIDPSession.swift:L628-L635// [REQ:gemSpec_IDP_Frontend:A_20483#2|8] Requesting the challange for the session
return self.client.requestChallenge(
return self.client.requestChallenge(
codeChallenge: codeChallenge,
method: .sha256,
state: state,
nonce: nonce,
using: document,
redirect: redirect
Fill all the values into the GET Request
Sources/IDPLive/RealIDPClient.swift:L93-L107// [REQ:gemSpec_IDP_Frontend:A_20483#3|15] Fill all the values into the GET Request
let queryItems = [
let queryItems = [
// [REQ:gemSpec_IDP_Frontend:A_20603,A_20601,A_20601-01] Transfer
URLQueryItem(name: "client_id", value: clientConfig.clientId.urlPercentEscapedString()),
URLQueryItem(name: "code_challenge", value: codeChallenge.urlPercentEscapedString()),
URLQueryItem(name: "code_challenge_method", value: method.rawValue.urlPercentEscapedString()),
URLQueryItem(name: "state", value: state.urlPercentEscapedString()),
URLQueryItem(name: "scope", value: clientConfig.scopes.joined(separator: " ").urlPercentEscapedString()),
URLQueryItem(name: "response_type", value: "code"),
URLQueryItem(name: "nonce", value: nonce.urlPercentEscapedString()),
URLQueryItem(
// [REQ:gemSpec_IDP_Frontend:A_20740] transfer
name: "redirect_uri",
value: (redirect ?? clientConfig.redirectURI.absoluteString).urlPercentEscapedString()
),
A_20512 - Regelmäßiges Einlesen des Discovery Document
Das Anwendungsfrontend MUSS das Discovery Document [RFC8414] löschen, wenn dieses 24 Stunden alt oder älter ist. Das Anwendungsfrontend MUSS das Discovery Document neu herunterladen, einlesen und auswerten und danach die darin aufgeführten URI zu den benötigten öffentlichen Schlüsseln (PUKs) und Diensten verwenden, wenn kein aktuelles Discovery Document vorliegt. [<=]
Validation by expiration date checking + maximum of 24h window
Sources/IDP/Models/DiscoveryDocument.swift:L198-L202// [REQ:gemSpec_IDP_Frontend:A_20512#2|5] Validation by expiration date checking + maximum of 24h window
/// Check if the discovery document is valid on the given date
/// - Parameter date: Date to check validity against
/// - Returns: Boolean indicating if the document is valid
public func isValid(on date: Date) -> Bool {
/// Check if the discovery document is valid on the given date
/// - Parameter date: Date to check validity against
/// - Returns: Boolean indicating if the document is valid
public func isValid(on date: Date) -> Bool {
Reset expired documents before loading a new one
Sources/IDPLive/DefaultIDPSession.swift:L295// [REQ:gemSpec_IDP_Frontend:A_20512#3] Reset expired documents before loading a new one
self.storage.set(discovery: nil)
Testing the implementation
Tests/IDPLiveTests/DefaultIDPSessionTests.swift:L137// [REQ:gemSpec_IDP_Frontend:A_20617-01]
// [REQ:gemSpec_IDP_Frontend:A_20623]
// [REQ:gemSpec_IDP_Frontend:A_20512#10] Testing the implementation
@MainActor func testLoadDiscoveryDocumentFromStorageOnInitFailesWhenTrustStoreFailsValidation() async {
Testing the implementation
Tests/IDPLiveTests/DefaultIDPSessionTests.swift:L163// [REQ:gemSpec_IDP_Frontend:A_20617-01]
// [REQ:gemSpec_IDP_Frontend:A_20623]
// [REQ:gemSpec_IDP_Frontend:A_20512#11] Testing the implementation
func testLoadDiscoveryDocumentFromRemoteOnInitFailesWhenTrustStoreFailsValidation() {
Testing the implementation
Tests/IDPLiveTests/DefaultIDPSessionTests.swift:L187// [REQ:gemSpec_IDP_Frontend:A_20617-01]
// [REQ:gemSpec_IDP_Frontend:A_20623]
// [REQ:gemSpec_IDP_Frontend:A_20512#12] Testing the implementation
func testLoadDiscoveryDocumentFromStorageOnInitFailesWhenTrustStoreThrows() {
Testing the implementation
Tests/IDPLiveTests/DefaultIDPSessionTests.swift:L213// [REQ:gemSpec_IDP_Frontend:A_20617-01]
// [REQ:gemSpec_IDP_Frontend:A_20623]
// [REQ:gemSpec_IDP_Frontend:A_20512#13] Testing the implementation
@MainActor func testLoadDiscoveryDocumentFromRemoteOnInitFailesWhenTrustStoreThrows() async {
Testing the implementation
Tests/IDPLiveTests/DefaultIDPSessionTests.swift:L239// [REQ:gemSpec_IDP_Frontend:A_20617-01]
// [REQ:gemSpec_IDP_Frontend:A_20623]
// [REQ:gemSpec_IDP_Frontend:A_20512#14] Testing the implementation
func testLoadDiscoveryDocumentFromStorageOnInit() {
Testing the implementation
Tests/IDPLiveTests/DefaultIDPSessionTests.swift:L263// [REQ:gemSpec_IDP_Frontend:A_20617-01]
// [REQ:gemSpec_IDP_Frontend:A_20623]
// [REQ:gemSpec_IDP_Frontend:A_20512#15] Testing the implementation
@MainActor func testLoadDiscoveryDocumentFromRemoteOnInit() async {
A_20529-01 - Senden von "AUTHORIZATION_CODE" und "KEY_VERIFIER" an den Token-Endpunkt
Das Anwendungsfrontend MUSS, wenn es eine Authentifizierung über den Smartcard-IDP unterstützt, den KEY_VERIFIER mittels JWE (JSON Web Encryption (JWE) [RFC7516 # section-3]) und PuK_IDP_ENC verschlüsseln und zusammen mit dem AUTHORIZATION_CODE TLS-gesichert als HTTP/1.1 POST Request an den Token-Endpunkt senden.
[<=]
We support the smartcard idp.
Encrypting the KEY_VERIFIER
// [REQ:gemSpec_IDP_Frontend:A_20529-01#2|6] Encrypting the `KEY_VERIFIER`
// [REQ:gemSpec_IDP_Frontend:A_21323,A_21324#1|6] Crypto box contains `Token-Key`
guard let encryptedKeyVerifier = try? KeyVerifier(
// [REQ:gemSpec_IDP_Frontend:A_21323,A_21324#1|6] Crypto box contains `Token-Key`
guard let encryptedKeyVerifier = try? KeyVerifier(
with: self.cryptoBox.aesKey,
codeVerifier: challengeSession.verifierCode
).encrypted(with: document.encryptionPublicKey, using: self.cryptoBox) else {
Sending encrypted KEY_VERIFIER and AUTHORIZATION_CODE.
// [REQ:gemSpec_IDP_Frontend:A_20529-01#3|7] Sending encrypted `KEY_VERIFIER` and `AUTHORIZATION_CODE`.
return self.client.exchange(
return self.client.exchange(
token: exchange,
verifier: challengeSession.verifierCode,
redirectURI: exchange.redirect,
encryptedKeyVerifier: encryptedKeyVerifier,
using: document
Putting all parameters into the HTTP body
Sources/IDPLive/RealIDPClient.swift:L242-L251// [REQ:gemSpec_IDP_Frontend:A_20529-01#4|10] Putting all parameters into the HTTP body
let parameters = [
let parameters = [
"key_verifier": keyVerifierJWEString,
"code": token.code,
"grant_type": "authorization_code",
// [REQ:gemSpec_IDP_Frontend:A_20740] transfer
"redirect_uri": redirectURI ?? clientConfig.redirectURI.absoluteString,
"code_verifier": verifier,
// [REQ:gemSpec_IDP_Frontend:A_20603] transfer
"client_id": clientConfig.clientId,
Sending the Request with the default HTTPClient via TLS.
Sources/IDPLive/RealIDPClient.swift:L255// [REQ:gemSpec_IDP_Frontend:A_20529-01#5] Sending the Request with the default HTTPClient via TLS.
return Future { [httpClient] in
Transfer
Sources/IDPLive/RealIDPClient.swift:L95// [REQ:gemSpec_IDP_Frontend:A_20603,A_20601,A_20601-01] Transfer
URLQueryItem(name: "client_id", value: clientConfig.clientId.urlPercentEscapedString()),
A_20602 - Einreichen des "ACCESS_TOKEN" beim Fachdienst
Das Anwendungsfrontend MUSS das ACCESS_TOKEN im Rahmen des entsprechenden fachlichen Aufrufs beim Fachdienst einreichen, um Zugang zu den angeforderten Daten zu erhalten. [<=]
Authorization-Header setup of HTTP requests is done via interceptor pattern for every request.
Setup Authorization-Header.
// [REQ:gemSpec_IDP_Frontend:A_20602#2,A_21325#1] Setup `Authorization-Header`.
request.setValue("\(token.tokenType) \(token.accessToken)", forHTTPHeaderField: "Authorization")
A_20605 - Fehlermeldung des Token-Endpunktes Formatierung
Das Anwendungsfrontend MUSS, wenn es eine Authentifizierung über den Smartcard-IDP unterstützt, den Inhalt der Fehlermeldungen sowie mögliche Hinweise zur Fehlervermeidung vom Token-Endpunkt übernehmen. [<=]
Error formatting
Sources/IDP/Models/IDPError.swift:L110// [REQ:gemSpec_IDP_Frontend:A_19937#3,A_20605,A_20085] Error formatting
public var description: String {
Localized description of server errors
Sources/IDP/Models/IDPError.swift:L447// [REQ:gemSpec_IDP_Frontend:A_19937#1,A_20605,A_20085] Localized description of server errors
case let .internal(error: error): return error.localizedDescription
Decoding server errors
Sources/IDPLive/RealIDPClient.swift:L522// [REQ:gemSpec_IDP_Frontend:A_19937#2,A_20605] Decoding server errors
private static func responseError(for body: Data) -> IDPError {
A_20606 - Anwendungsfrontend: Kommunikation über TLS-Verbindung
Das Anwendungsfrontend MUSS mit dem IDP-Dienst über TLS kommunizieren. [<=]
TLS is enforced by the platform for every HTTP connection. Certain domains can be excluded from this rule by listing them in a dedicated NSAppTransportSecurity exception list. This list is empty for our application.
Setup of minimum TLS Version to use.
Sources/HTTPClientLive/DefaultHTTPClient.swift:L49// [REQ:gemSpec_Krypt:GS-A_4385,A_18467,A_18464,GS-A_4387]
// [REQ:gemSpec_IDP_Frontend:A_20606#2] Setup of minimum TLS Version to use.
// [REQ:gemSpec_eRp_FdV:A_20206]
// [REQ:BSI-eRp-ePA:O.Ntwk_2#2,O.Ntwk_3#2,O.Ntwk_7#2] URLSession is used as Network Framework
urlSessionConfiguration.tlsMinimumSupportedProtocolVersion = .TLSv12
A_20623 - Anwendungsfrontend: Prüfung der Signatur des Discovery Document
Das Anwendungsfrontend MUSS, wenn es eine Authentifizierung über den Smartcard-IDP unterstützt, die Signatur des Discovery Document mathematisch prüfen und auf ein zeitlich gültiges C.FD.SIG-Zertifikat mit der Rollen-OID oid_idpd zurückführen können, welches rückführbar ist auf ein CA-Zertifikat aus einer authentischen, integren und zeitlich gültigen TSL. [<=]
Tests/IDPLiveTests/DefaultIDPSessionTests.swift:L262
// [REQ:gemSpec_IDP_Frontend:A_20617-01]
// [REQ:gemSpec_IDP_Frontend:A_20623]
// [REQ:gemSpec_IDP_Frontend:A_20512#15] Testing the implementation
@MainActor func testLoadDiscoveryDocumentFromRemoteOnInit() async {
Sources/IDPLive/DefaultIDPSession.swift:L316
// [REQ:gemSpec_IDP_Frontend:A_20617-01,A_20623]
.validate(with: self.trustStoreSession, timeProvider: self.time)
Sources/IDPLive/DefaultIDPSession.swift:L697
/// Returns a Publisher that validates the input streams discoveryDocument against the given trustStoreSession. If
/// the validity cannot be verified, the publisher fails with an `IDPError.trustStore` error.
///
/// [REQ:gemSpec_IDP_Frontend:A_20617-01]
/// [REQ:gemSpec_IDP_Frontend:A_20623]
///
/// - Parameter trustStoreSession: `TrustStoreSession` that is used to check the validity and trust of the
/// discoveryDocument.
/// - Returns: An AnyPublisher of `DiscoveryDocument`and `IDPError`
func validate(with trustStoreSession: TrustStoreSession,
Validation call
Sources/IDPLive/DefaultIDPSession.swift:L708// [REQ:gemSpec_IDP_Frontend:A_20623] Validation call
return trustStoreSession.validate(discoveryDocument: document)
Sources/IDPLive/DefaultIDPSession.swift:L728
/// Returns a Publisher that validates the input streams discoveryDocument and returns nil if validity cannot be
/// checked. All Errors are caught and result in an empty discoveryDocument.
///
/// [REQ:gemSpec_IDP_Frontend:A_20617-01,A_20623]
///
/// - Parameters:
/// - trustStoreSession: `TrustStoreSession` that is used to check the validity and trust of the disoveryDocument.
/// - time: Time provider to check the discovery document against.
/// - Returns: An AnyPublisher of `DiscoveryDocument`and `Never`.
func validateOrNil(with trustStoreSession: TrustStoreSession,
Validation
Sources/IDPLive/DefaultIDPSession.swift:L759/// Returns a publisher that checks a discoveryDocument against the trust store. The Stream contains an output
/// boolean for the plain check or an TrustStoreError in case the TrustStoreSession sub streams failed.
///
/// [REQ:gemSpec_IDP_Frontend:A_20623] Validation
///
/// - Parameter discoveryDocument: The DiscoveryDocument that needs to be checked.
/// - Returns: A publisher that contains an output with the check value or an failure if the check failed
/// due to an underlying error.
func validate(discoveryDocument: DiscoveryDocument) -> AnyPublisher {
oid check
Sources/TrustStore/X509TrustStore.swift:L308} else if eeCert.contains(oidBytes: .oidIdpd) { // [REQ:gemSpec_IDP_Frontend:A_20623,A_20625#4] oid check
return (vauCerts, idpCerts + [eeCert])
IDP oid
Sources/TrustStore/X509TrustStore.swift:L320case oidErpVau // 1.2.276.0.76.4.258 == 0x06082A8214004C048202
// [REQ:gemSpec_IDP_Frontend:A_20623] IDP oid
case oidIdpd // 1.2.276.0.76.4.260 == 0x06082A8214004C048204
}
Tests/IDPLiveTests/DefaultIDPSessionTests.swift:L136
// [REQ:gemSpec_IDP_Frontend:A_20617-01]
// [REQ:gemSpec_IDP_Frontend:A_20623]
// [REQ:gemSpec_IDP_Frontend:A_20512#10] Testing the implementation
@MainActor func testLoadDiscoveryDocumentFromStorageOnInitFailesWhenTrustStoreFailsValidation() async {
Tests/IDPLiveTests/DefaultIDPSessionTests.swift:L162
// [REQ:gemSpec_IDP_Frontend:A_20617-01]
// [REQ:gemSpec_IDP_Frontend:A_20623]
// [REQ:gemSpec_IDP_Frontend:A_20512#11] Testing the implementation
func testLoadDiscoveryDocumentFromRemoteOnInitFailesWhenTrustStoreFailsValidation() {
Tests/IDPLiveTests/DefaultIDPSessionTests.swift:L186
// [REQ:gemSpec_IDP_Frontend:A_20617-01]
// [REQ:gemSpec_IDP_Frontend:A_20623]
// [REQ:gemSpec_IDP_Frontend:A_20512#12] Testing the implementation
func testLoadDiscoveryDocumentFromStorageOnInitFailesWhenTrustStoreThrows() {
Tests/IDPLiveTests/DefaultIDPSessionTests.swift:L212
// [REQ:gemSpec_IDP_Frontend:A_20617-01]
// [REQ:gemSpec_IDP_Frontend:A_20623]
// [REQ:gemSpec_IDP_Frontend:A_20512#13] Testing the implementation
@MainActor func testLoadDiscoveryDocumentFromRemoteOnInitFailesWhenTrustStoreThrows() async {
Tests/IDPLiveTests/DefaultIDPSessionTests.swift:L238
// [REQ:gemSpec_IDP_Frontend:A_20617-01]
// [REQ:gemSpec_IDP_Frontend:A_20623]
// [REQ:gemSpec_IDP_Frontend:A_20512#14] Testing the implementation
func testLoadDiscoveryDocumentFromStorageOnInit() {
Sources/IDPLive/DefaultIDPSession.swift:L283
// [REQ:gemSpec_IDP_Frontend:A_20617-01,A_20623,A_20614]
.validateOrNil(with: trustStoreSession, timeProvider: time)
A_20625 - Anwendungsfrontend: Prüfung der Signatur des ID_TOKEN
Das Anwendungsfrontend MUSS, wenn es eine Authentifizierung über den Smartcard-IDP unterstützt, die Signatur des ID_TOKEN mathematisch prüfen und auf ein zeitlich gültiges C.FD.SIG-Zertifikat mit der Rollen-OID oid_idpd zurückführen können, welches rückführbar ist auf ein CA-Zertifikat aus einer authentischen, integren und zeitlich gültigen TSL. [<=]
These checks are part of the DefaultIDPSession as part for the response parsing. If they fail, an error will be thrown.
Validate ID_TOKEN signature with C.FD.SIG.
// [REQ:gemSpec_IDP_Frontend:A_20625#2|4] Validate `ID_TOKEN` signature with `C.FD.SIG`.
guard let jwt = try? JWT(from: decrypted.idToken),
guard let jwt = try? JWT(from: decrypted.idToken),
(try? jwt.verify(with: document.signingCert)) ?? false else {
return Fail(error: IDPError.invalidSignature("ID_TOKEN")).eraseToAnyPublisher()
C.FD.SIG-Certificate verification
// [REQ:gemSpec_IDP_Frontend:A_20625#3|4] `C.FD.SIG`-Certificate verification
return try await self.validate(eeCertificate: discoveryDocument.signingCert)
return try await self.validate(eeCertificate: discoveryDocument.signingCert)
}
.mapError { $0.asTrustStoreError() }
oid check
Sources/TrustStore/X509TrustStore.swift:L308} else if eeCert.contains(oidBytes: .oidIdpd) { // [REQ:gemSpec_IDP_Frontend:A_20623,A_20625#4] oid check
return (vauCerts, idpCerts + [eeCert])
A_20740 - Bekanntgabe der Redirect-URI des Anwendungsfrontend
Das Anwendungsfrontend MUSS, wenn es eine Authentifizierung über den Smartcard-IDP unterstützt, beim IdP-Dienst bei der Registrierung eine redirect_uri hinterlegen. [<=]
transfer
Sources/IDPLive/RealIDPClient.swift:L104// [REQ:gemSpec_IDP_Frontend:A_20740] transfer
name: "redirect_uri",
transfer
Sources/IDPLive/RealIDPClient.swift:L247// [REQ:gemSpec_IDP_Frontend:A_20740] transfer
"redirect_uri": redirectURI ?? clientConfig.redirectURI.absoluteString,
Actual redirect uri
Sources/Settings/AppConfiguration.swift:L110// [REQ:gemSpec_IDP_Frontend:A_20740] Actual redirect uri
public let redirectUri =
A_20741 - Speicherung des Downloadpunktes des Discovery Document im Anwendungsfrontend
Das Anwendungsfrontend MUSS, wenn es eine Authentifizierung über den Smartcard-IDP unterstützt, den vom IdP-Dienst bei der Registrierung bekanntgegebenen Downloadpunkt des Discovery Document als konfigurierbaren Parameter speichern. [<=]
Configuration within app-configuration.json, organizational process as in A_20603
A_21323 - Erzeugung des "Token-Key"
Das Anwendungsfrontend MUSS, wenn es eine Authentifizierung über den Smartcard-IDP unterstützt, vor dem Abrufen von ID_TOKEN und ACCESS_TOKEN einen zufälligen 256 Bit AES-Schlüssel ("Token-Key“) erzeugen. [<=]
Crypto box contains Token-Key
// [REQ:gemSpec_IDP_Frontend:A_20529-01#2|6] Encrypting the `KEY_VERIFIER`
// [REQ:gemSpec_IDP_Frontend:A_21323,A_21324#1|6] Crypto box contains `Token-Key`
guard let encryptedKeyVerifier = try? KeyVerifier(
guard let encryptedKeyVerifier = try? KeyVerifier(
with: self.cryptoBox.aesKey,
codeVerifier: challengeSession.verifierCode
).encrypted(with: document.encryptionPublicKey, using: self.cryptoBox) else {
return Fail(error: IDPError.encryption).eraseToAnyPublisher()
Encode into JSON object
Sources/IDP/internal/TokenPayload.swift:L211// [REQ:gemSpec_IDP_Frontend:A_21323#2] Encode into JSON object
// [REQ:gemSpec_IDP_Frontend:A_21324#3] Encode into JSON object
guard let keyVerifierEncoded = try? KeyVerifier.jsonEncoder.encode(self) else {
AES key generation via CryptoKit
Sources/IDP/internal/IDPCrypto.swift:L80// [REQ:gemSpec_Krypt:GS-A_4389:1] 256bit GCM symmetric key
// [REQ:gemSpec_eRp_FdV:A_19179#3] AES key generation via CryptoKit
// [REQ:gemSpec_Krypt:GS-A_4368] AES key generation via CryptoKit
// [REQ:gemSpec_IDP_Frontend:A_21323#4] AES key generation via CryptoKit
aesKey: SymmetricKey = SymmetricKey(size: SymmetricKeySize(bitCount: 256))
A_21324 - Erzeugen des "KEY_VERIFIER"
Das Anwendungsfrontend MUSS, wenn es eine Authentifizierung über den Smartcard-IDP unterstützt, dem KEY_VERIFIER bilden, indem "Token-Key" und CODE_VERIFIER in einem JSON-Objekt kodiert werden.
[<=]
Token-key and code-verifier are encoded into an JSON object.
Crypto box contains Token-Key
// [REQ:gemSpec_IDP_Frontend:A_20529-01#2|6] Encrypting the `KEY_VERIFIER`
// [REQ:gemSpec_IDP_Frontend:A_21323,A_21324#1|6] Crypto box contains `Token-Key`
guard let encryptedKeyVerifier = try? KeyVerifier(
guard let encryptedKeyVerifier = try? KeyVerifier(
with: self.cryptoBox.aesKey,
codeVerifier: challengeSession.verifierCode
).encrypted(with: document.encryptionPublicKey, using: self.cryptoBox) else {
return Fail(error: IDPError.encryption).eraseToAnyPublisher()
Token-key and code-verifier are encoded into KeyVerifier.
Sources/IDP/internal/TokenPayload.swift:L182// [REQ:gemSpec_IDP_Frontend:A_21324#2] Token-key and code-verifier are encoded into KeyVerifier.
public struct KeyVerifier: Codable {
Encode into JSON object
Sources/IDP/internal/TokenPayload.swift:L212// [REQ:gemSpec_IDP_Frontend:A_21323#2] Encode into JSON object
// [REQ:gemSpec_IDP_Frontend:A_21324#3] Encode into JSON object
guard let keyVerifierEncoded = try? KeyVerifier.jsonEncoder.encode(self) else {
A_21326 - Löschung von "ACCESS_TOKEN"
Das Anwendungsfrontend MUSS ACCESS_TOKEN beim Beenden sowie nach Ablauf ihrer Gültigkeit sicher löschen. [<=]
ACCESS_TOKEN information is managed by IDPToken structure. See O.Plat_12 regarding secure deletion.
Structure holding ACCESS_TOKEN and ID_TOKEN information
Sources/IDP/Models/IDPToken.swift:L27/// IDPToken
///
/// [REQ:gemSpec_IDP_Frontend:A_21326#2,A_21327#2] Structure holding ACCESS_TOKEN and ID_TOKEN information
public struct IDPToken: Codable {
Triggered at every app start, profile change, pull to refresh
Sources/IDPLive/DefaultIDPSession.swift:L116// [REQ:gemSpec_IDP_Frontend:A_21326#3,A_21327#3] Triggered at every app start, profile change, pull to refresh
autoRefreshedToken.map { token in
Triggered at every app start, profile change, pull to refresh
Sources/IDPLive/DefaultIDPSession.swift:L784// [REQ:gemSpec_IDP_Frontend:A_21326#4,A_21327#4] Triggered at every app start, profile change, pull to refresh
func refreshIfExpired(session: DefaultIDPSession,
Either return a refreshed IDPToken
Sources/IDPLive/DefaultIDPSession.swift:L795// [REQ:gemSpec_IDP_Frontend:A_21326#5,A_21327#5] Either return a refreshed IDPToken
// (or nil in case of error) to overwrite the current one
guard let session = session else {
A_21327 - Löschung von "ID_TOKEN"
Das Anwendungsfrontend MUSS ID_TOKEN beim Beenden sowie nach Ablauf ihrer Gültigkeit sicher löschen. [<=]
ID_TOKEN information is managed by IDPToken structure. See O.Plat_12 regarding secure deletion.
Structure holding ACCESS_TOKEN and ID_TOKEN information
Sources/IDP/Models/IDPToken.swift:L27/// IDPToken
///
/// [REQ:gemSpec_IDP_Frontend:A_21326#2,A_21327#2] Structure holding ACCESS_TOKEN and ID_TOKEN information
public struct IDPToken: Codable {
Triggered at every app start, profile change, pull to refresh
Sources/IDPLive/DefaultIDPSession.swift:L116// [REQ:gemSpec_IDP_Frontend:A_21326#3,A_21327#3] Triggered at every app start, profile change, pull to refresh
autoRefreshedToken.map { token in
Triggered at every app start, profile change, pull to refresh
Sources/IDPLive/DefaultIDPSession.swift:L784// [REQ:gemSpec_IDP_Frontend:A_21326#4,A_21327#4] Triggered at every app start, profile change, pull to refresh
func refreshIfExpired(session: DefaultIDPSession,
Either return a refreshed IDPToken
Sources/IDPLive/DefaultIDPSession.swift:L795// [REQ:gemSpec_IDP_Frontend:A_21326#5,A_21327#5] Either return a refreshed IDPToken
// (or nil in case of error) to overwrite the current one
guard let session = session else {
A_21328 - Sichere Speicherung der Token
Das Anwendungsfrontend MUSS empfangene ID_TOKEN und ACCESS_TOKEN gegen unberechtigten Zugriff schützen. [<=]
Keychain storage encrypts session tokens.
Keychain storage encrypts session tokens
Sources/eRpApp/Dependencies+FhirClient.swift:L151// [REQ:gemSpec_IDP_Frontend:A_21328#2] Keychain storage encrypts session tokens
// [REQ:gemSpec_eRp_FdV:A_20184] Keychain storage encrypts session/ssl tokens
storage: secureUserStore,
Keychain storage encrypts session tokens
Sources/eRpApp/Session/StandardSessionContainer.swift:L104// [REQ:gemSpec_IDP_Frontend:A_21328#2] Keychain storage encrypts session tokens
// [REQ:gemSpec_eRp_FdV:A_20184] Keychain storage encrypts session/ssl tokens
storage: secureUserStore,
KeychainStorage implementation
Sources/eRpApp/Session/KeychainStorage.swift:L142// [REQ:gemSpec_eRp_FdV:A_20184]
// [REQ:gemSpec_IDP_Frontend:A_21328#3] KeychainStorage implementation
let success: Bool
A_21585 - Beschränkung der Nutzung des PrK_SE_AUT auf das Authenticator-Modul
Das Authenticator-Modul MUSS, wenn es eine Authentifizierung über den Smartcard-IDP unterstützt, die Parameter für die Erzeugung des Schlüsselpaars PrK_SE_AUT/PuK_SE_AUT so setzen, dass sichergestellt ist, dass der Schlüssel PrK_SE_AUT ausschließlich über das Authenticator-Modul auf Daten anwendbar ist. Eine App-übergreifende Nutzung MUSS ausgeschlossen werden. [<=]
Default behavior for all apps when using private access group (https://developer.apple.com/documentation/security/keychain_services/keychain_items/sharing_access_to_keychain_items_among_a_collection_of_apps)
A_21590 - Beschränkung der Nutzung des PrK_SE_AUT auf Authentisierung gegenüber dem IdP-Dienst
Das Authenticator-Modul MUSS, wenn es eine Authentifizierung über den Smartcard-IDP unterstützt, den Schlüssel PrK_SE_AUT ausschließlich zum Zweck der Authentifizierung gegenüber dem IdP-Dienst verwenden. Es darf dem Nutzer keine andere Option anbieten oder den Schlüssel anderweitig verwenden. [<=]
References of SecureEnclaveSignatureProvider is limited to registration and altVerify usage.
This is the container to represent biometric keys. Usage is limited to
Sources/IDP/PrivateKeyContainer.swift:L31/// Represents a (SecureEnclave) private key, namely `PrK_SE_AUT`, secured by iOS Biometrics.
///
/// [REQ:gemSpec_IDP_Frontend:A_21590] This is the container to represent biometric keys. Usage is limited to
/// authorization purposes
/// [REQ:BSI-eRp-ePA:O.Cryp_7#2] Container for private key operations using secure enclave private keys
public struct PrivateKeyContainer {
If app needs reauthentication routing starts here.
Sources/eRpApp/SceneDelegate.swift:L246// [REQ:gemSpec_IDP_Frontend:A_22301-01#2] If app needs reauthentication routing starts here.
self.routeTo(.universalLink(url))
If app is already started, routing starts here.
Sources/eRpApp/SceneDelegate.swift:L279// [REQ:gemSpec_IDP_Frontend:A_22301-01#3] If app is already started, routing starts here.
routeTo(.universalLink(url))
App2App gID will trigger this case
Sources/eRpApp/Screens/AppStartDomain.swift:L251// [REQ:gemSpec_IDP_Frontend:A_22301-01#4] App2App gID will trigger this case
case "/extauth":
set actual destination in main tab
Sources/eRpApp/Screens/AppStartDomain.swift:L261// // [REQ:gemSpec_IDP_Frontend:A_22301-01#5] set actual destination in main tab
await send(.destination(.app(.main(action: .externalLogin(url)))))
Redirect into ExtAuthPendingDomain
Sources/eRpApp/Screens/Main/MainDomain.swift:L322-L324// [REQ:BSI-eRp-ePA:O.Source_1#7] redirect into correct domain
// [REQ:gemSpec_IDP_Frontend:A_22301-01#6|3] Redirect into ExtAuthPendingDomain
return .run { send in
return .run { send in
await send(.extAuthPending(action: .externalLogin(url)))
Actual handling of the universal link, user feedback via dialogs e.g.
Sources/eRpApp/Screens/Main/ExtAuth/ExtAuthPendingDomain.swift:L165// [REQ:BSI-eRp-ePA:O.Source_1#8] Validate data by parsing url and only allowing predefined variables as String
// [REQ:gemSpec_IDP_Frontend:A_22301-01#7] Actual handling of the universal link, user feedback via dialogs e.g.
case let .externalLogin(url),
Login part is handled by idpSesson
Sources/eRpApp/Screens/Main/ExtAuth/ExtAuthPendingDomain.swift:L177-L181// [REQ:gemSpec_IDP_Frontend:A_22301-01#8|5] Login part is handled by idpSesson
idpSession
idpSession
.extAuthVerifyAndExchange(
url,
idTokenValidator: idTokenValidator.validate(idToken:)
Extract the components.
Sources/IDPLive/DefaultIDPSession.swift:L497-L503// [REQ:gemSpec_IDP_Frontend:A_22301-01#9|7] Extract the components.
guard let components = URLComponents(url: url, resolvingAgainstBaseURL: true),
guard let components = URLComponents(url: url, resolvingAgainstBaseURL: true),
let code = components.queryItemWithName("code")?.value,
let state = components.queryItemWithName("state")?.value else {
return Fail(
error: IDPError.internal(error: .extAuthVerifyAndExchangeMissingQueryItem)
).eraseToAnyPublisher()
Send authorization request
Sources/IDPLive/DefaultIDPSession.swift:L508// [REQ:gemSpec_IDP_Frontend:A_22301-01#10] Send authorization request
return extAuthVerify(verify)
Check for existing challenge session
Sources/IDPLive/DefaultIDPSession.swift:L517// [REQ:gemSpec_IDP_Frontend:A_22301-01#11] Check for existing challenge session
guard let challengeSession = extAuthRequestStorage.getExtAuthRequest(for: token.state) else {
The challenge session has been set here.
Sources/IDPLive/DefaultIDPSession.swift:L484// [REQ:gemSpec_IDP_Frontend:A_22301-01#12] The challenge session has been set here.
self.extAuthRequestStorage.setExtAuthRequest(challengeSession, for: storageIdentifier)
Negative Test
Tests/IDPLiveTests/DefaultIDPSessionTests.swift:L1074// [REQ:gemSpec_IDP_Frontend:A_22301-01#20] Negative Test
func testExtAuthVerifyAndExchangeFailesWithoutReferenceStateGID() throws {
A_22302-01 - Weiterleitung des Authorization Code an den IDP-Dienst
Das Anwendungsfrontend MUSS, wenn es eine Authentifizierung über den sektoralen IDP unterstützt, den empfangenen Authorization Code AUTHORIZATION_CODE_IDP abhängig vom für den ausgehenden Request gespeicherten Parameter verarbeiten:
As of now idp_sek_2 can only be true, as the false case is no longer allowed. Thus only the true case is implemented in the following code places.
Sending the required data as POST to the backend.
Sources/IDPLive/RealIDPClient.swift:L475// [REQ:gemSpec_IDP_Frontend:A_22302-01#2] Sending the required data as POST to the backend.
func extAuthVerify(_ verify: IDPExtAuthVerify,
A_22313-01 - Absicherung des Aufrufs zu Authenticator-Modulen von sektoralen Identity Providern
Das Anwendungsfrontend MUSS, wenn es eine Authentifizierung über den sektoralen IDP unterstützt, für Aufrufe zu Authenticator-Modulen sektoraler Identity Provider die Verifikationsmechanismen des Betriebssystems verwenden. Die folgenden Parameter müssen gesetzt sein:
Android: Keine weiteren.
iOS: .universalLinksOnly:false [<=]
Universal link options
Sources/FeatureCardWall/ExtAuth/CardWallExtAuthConfirmationDomain.swift:L129// [REQ:gemSpec_IDP_Frontend:A_22313-01] Universal link options
await openURLHandler.openWithOptions(url, [.universalLinksOnly: false])
A_23082 - Abruf und Anzeige der IDP Liste
Das Anwendungsfrontend MUSS, wenn es eine Authentifizierung über den sektoralen IDP unterstützt, sofern nicht anderweitig ein sektoraler Identity Provider zuvor gemerkt oder festgelegt wurde, die IDP-Liste vom Authorization-Server herunterladen, auf Integrität prüfen und (bei erfolgreicher Prüfung) dem Benutzer zur Auswahl anzeigen. [<=]
Load available apps
Sources/FeatureCardWall/ExtAuth/CardWallExtAuthSelectionDomain.swift:L124// [REQ:gemSpec_IDP_Frontend:A_22296-01] Load available apps
// [REQ:gemSpec_IDP_Frontend:A_23082#2] Load available apps
return .publisher(
Signature verification
Sources/IDPLive/DefaultIDPSession.swift:L437// [REQ:gemSpec_IDP_Frontend:A_22296-01] Signature verification
// [REQ:gemSpec_IDP_Frontend:A_23082#3] Signature verification
// [REQ:BSI-eRp-ePA:O.Resi_6#3] Discovery Document signature verification
guard try jwtContainer.verify(with: document.discKey) == true else {
Test
Tests/IDPLiveTests/DefaultIDPSessionTests.swift:L980// [REQ:gemSpec_IDP_Frontend:A_22296-01] Test
// [REQ:gemSpec_IDP_Frontend:A_23082#4] Test
func testLoadDirectoryKKAppsInvalidSignature() throws {
Display of KK apps
Sources/FeatureCardWall/ExtAuth/CardWallExtAuthSelectionView.swift:L62// [REQ:gemSpec_IDP_Frontend:A_23082#5] Display of KK apps
if !store.filteredKKList.apps.isEmpty {
A_22313-01 - Absicherung des Aufrufs zu Authenticator-Modulen von sektoralen Identity Providern
Das Anwendungsfrontend MUSS, wenn es eine Authentifizierung über den sektoralen IDP unterstützt, für Aufrufe zu Authenticator-Modulen sektoraler Identity Provider die Verifikationsmechanismen des Betriebssystems verwenden. Die folgenden Parameter müssen gesetzt sein:
Android: Keine weiteren.
iOS: .universalLinksOnly:false [<=]
Remember State parameter for later verification
Sources/FeatureCardWall/Introduction/CardWallIntroductionDomain.swift:L272// [REQ:gemSpec_IDP_Sek:A_22313-01] Remember State parameter for later verification
await openURLHandler.open(url)
A_17205 - Signatur der TSL: Signieren und Prüfen (ECC-Migration)
Alle Produkttypen, die die TSL(ECC-RSA) signieren oder prüfen, MÜSSEN dafür das Signaturverfahren ECDSA [BSI-TR-03111] auf Basis der Domainparameter brainpoolP256r1 verwenden mit dem XMLDSig-Identifier „ http://www.w3.org/2001/04/xmldsig-more#ecdsa-sha256“ [XMLDSig]. Als Hashfunktion (Messagedigest) MUSS SHA-256 [FIPS-180-4] verwendet werden.
[<=]
The app does not use the TSL. All TSL related parts are handled within the eRp-FD.
A_17207 - Signaturen binärer Daten (ECC-Migration)
Alle Produkttypen, die (nicht-XML-)Signaturen von Daten auf Basis eines ECC-Schlüssels erzeugen oder prüfen, MÜSSEN dafür das Signaturverfahren ECDSA [BSI-TR-03111] auf Basis der Domainparameter brainpoolP256r1 verwenden (vgl. [RFC-5753] und [RFC-6090]). Als Hashfunktion (Messagedigest) MÜSSEN sie SHA-256 [FIPS-180-4] verwenden.
[<=]
Sources/IDPLive/IDPDirectoryKKApps+JWTSignatureVerifier.swift:L49
// [REQ:gemSpec_Krypt:A_17207]
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02,GS-A_4361-02]
public func verify(signature raw: Data, message: Data) throws -> Bool {
Assure only brainpoolP256r1 is used
Sources/FeatureCardWall/ReadCard/NFCSignatureProvider.swift:L335// [REQ:gemSpec_Krypt:A_17207] Assure only brainpoolP256r1 is used
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02,GS-A_4361-02] Assure that brainpoolP256r1 is used
var alg: JWT.Algorithm? {
Assure only brainpoolP256r1 is used
Sources/FeatureCardWall/ReadCard/NFCSignatureProvider.swift:L587// [REQ:gemSpec_Krypt:A_17207] Assure only brainpoolP256r1 is used
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02,GS-A_4361-02] Assure that brainpoolP256r1 is used
let alg: JWT.Algorithm = .bp256r1
Assure only brainpoolP256r1 is used
Sources/FeatureCardWall/ReadCard/NFCSignatureProvider.swift:L636// [REQ:gemSpec_Krypt:A_17207] Assure only brainpoolP256r1 is used
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02,GS-A_4361-02] Assure that brainpoolP256r1 is used
guard let alg = autCertificateResponse.info.algorithm.alg
Only implemented for brainpoolP256r1
Sources/IDPLive/DefaultIDPSession.swift:L301// Validate JWT/DiscoveryDocument signature
// [REQ:gemSpec_Krypt:A_17207] Only implemented for brainpoolP256r1
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02] Assure that brainpoolP256r1 is used
// [REQ:gemSpec_Krypt:GS-A_4361-02] Assure that brainpoolP256r1 is used
// [REQ:BSI-eRp-ePA:O.Resi_6#4] Discovery Document signature verification
guard (try? fetchedDocument.backing.verify(with: fetchedDocument.discKey)) ?? false else {
Only implemented for brainpoolP256r1
Sources/IDPLive/DefaultIDPSession.swift:L639// [REQ:gemSpec_Krypt:A_17207] Only implemented for brainpoolP256r1
// [REQ:gemSpec_IDP_Frontend:A_19908-01] Signature check
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02,GS-A_4361-02] Assure that brainpoolP256r1 is used
guard let verified = try? challenge.challenge.verify(with: document.authentication.cert),
Sources/IDPLive/IDPDirectoryKKApps+JWTSignatureVerifier.swift:L39
// [REQ:gemSpec_Krypt:A_17207]
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02,GS-A_4361-02] Assure that brainpoolP256r1 is used
guard let key = brainpoolP256r1VerifyPublicKey() else {
BrainpoolP256r1 parameter spec is used for creating/verifying key for signature usage; exception: Biometric use case uses secp256r1 (This is considered in its respective specification.)
A_17359 - Signaturen binärer Daten (Dokumente) (ECC-Migration)
Alle Produkttypen, die (nicht-XML-)Signaturen von Dokumenten auf Basis eines ECC-Schlüssels erzeugen oder prüfen, MÜSSEN dabei die Vorgaben aus A_17207 umsetzen und die Signatur nach [ETSI-CAdES] (interoperables Container-Format) bei der Erzeugung kodieren bzw. bei der Prüfung auswerten.
[<=]
Not applicable, since there is no exchange of CAdES-encoded documents signed by a ECC key in our system. Generally the created signatures adhere to A_17207 if not stated otherwise in the respective specifications.
A_20161-01 - E-Rezept-Client, Request-Erstellung
Ein E-Rezept-Client MUSS, falls ihm noch kein gültiges E-Rezept-VAU-Zertifikat vorliegt, ein solches nach den fachlichen Vorgaben von A_20160-* beziehen (/VAUCertificate).
Ein E-Rezept-Client MUSS sicherstellen, dass gültige Sperrinformation (OCSP-Response mit Sperrstatus "good") für das Zertifikat vorliegen, die maximal 12 Stunden alt sind. Liegen diese nicht vor so MUSS der Client ein Verbindungsaufbau auf VAU-Protokoll-Ebene ablehnen/unterbinden.
Ein E-Rezept-Client MUSS bei der Request-Erstellung folgende Schritte durchführen.
Encryption interface
Sources/VAUClient/internal/VAUCrypto.swift:L36/// Perform encryption of the data that the implementing instance has been initialized with
/// in order to send it to a VAU service endpoint. See: gemSpec_Krypt A_20161-01
///
/// [REQ:gemSpec_Krypt:A_20161-01#2] Encryption interface
///
/// - Returns: Encrypted HTTPRequest as specified to be sent to a VAU endpoint
/// - Throws: `VAUError` in case of encryption failure
func encrypt() throws -> Data
Encapsulate “real” HTTPRequest into VAU envelop
Sources/VAUClient/VAUInterceptor.swift:L63// Prepare outer request (encrypt original request and embed it into a new one)
// [REQ:gemSpec_Krypt:A_20161-01#3] Encapsulate "real" HTTPRequest into VAU envelop
(vauCrypto, vauRequest) = try VAUInterceptor.processToVauRequest(
Encapsulate “real” HTTPRequest into VAU envelop
Sources/VAUClient/VAUInterceptor.swift:L98// Prepare outer request (encrypt original request and embed it into a new one)
// [REQ:gemSpec_Krypt:A_20161-01#4] Encapsulate "real" HTTPRequest into VAU envelop
func processToVauRequest(
1:
Sources/VAUClient/internal/URLRequest+Serialize.swift:L29/// Serialize the request into a String that can be interpreted by the VAU server
/// - Note: A HTTP body is only included into the string representation when it is UTF-8 encoded.
/// [REQ:gemSpec_Krypt:A_20161-01#11] 1:
func encodeToRawString() throws -> String {
2: Request-ID Generator
Sources/VAUClient/internal/VAUCrypto.swift:L61// [REQ:gemSpec_Krypt:A_20161-01#12] 2: Request-ID Generator
let requestIdGenerator = { try VAURandom.generateSecureRandom(length: 16).hexStringLowerCase }
3: AES-Key Generator
Sources/VAUClient/internal/VAUCrypto.swift:L63// [REQ:gemSpec_Krypt:A_20161-01#13] 3: AES-Key Generator
let symmetricKeyGenerator = { SymmetricKey(size: SymmetricKeySize(bitCount: 128)) }
4: vauCrypto is generating new entity and thus a new request/id everytime
Sources/VAUClient/VAUInterceptor.swift:L126-L130// [REQ:gemSpec_Krypt:A_20161-01#14|5] 4: vauCrypto is generating new entity and thus a new request/id everytime
let vauCrypto = try vauCryptoProvider.provide(
let vauCrypto = try vauCryptoProvider.provide(
for: stringEncodedRequest,
vauCertificate: vauCertificate,
bearerToken: bearerToken
5:
Sources/VAUClient/internal/VAUCrypto.swift:L106// [REQ:gemSpec_Krypt:A_20161-01#15] 5:
guard let payload = "1 \(bearerToken) \(requestId) \(symKeyHex) \(message)".data(using: .utf8) else {
6a-g
Sources/VAUClient/internal/VAUCrypto.swift:L153/// Perform Elliptic Curve Integrated Encryption Scheme [SEC1-2009] on some payload
/// [REQ:gemSpec_Krypt:A_20161-01#16] 6a-g
static func encrypt(
7: VAU-Endpoint respects userpseudonym if present
Sources/VAUClient/internal/VAUEndpointHandler.swift:L34-L43// [REQ:gemSpec_Krypt:A_20161-01#17|10] 7: VAU-Endpoint respects userpseudonym if present
var vauEndpoint: AnyPublisher {
var vauEndpoint: AnyPublisher {
vauStorage.userPseudonym
.map { userPseudonym in
// If the client has yet not been assigned a user pseudonym, then default to "0".
let userPseudonymPathComponent = userPseudonym ?? "0"
return self.vauEndpoint(withLastComponent: userPseudonymPathComponent)
}
.setFailureType(to: VAUError.self)
.eraseToAnyPublisher()
A_20174 - E-Rezept-Client, Response-Auswertung
Ein E-Rezept-Client MUSS bei der Response-Auswertung (vgl. vorgehenden Client-Request aus A_20161-*) folgende Schritte durchführen. Dabei MUSS der Client bei Fehlschlagens im Folgenden aufgeführten Prüfungen die Analyse der Response abbrechen, und er MUSS die Request-ID und den AES-Antwortschlüssel sicher löschen.
1: Check Content-Type
Sources/VAUClient/VAUInterceptor.swift:L166-L177// Process VAU server response (validate and extract+decrypt inner FHIR service response)
// [REQ:gemSpec_Krypt:A_20174#11|12] 1: Check Content-Type
static func processVauResponse(httpResponse: HTTPResponse, vauCrypto: VAUCrypto, originalUrl: URL) throws
static func processVauResponse(httpResponse: HTTPResponse, vauCrypto: VAUCrypto, originalUrl: URL) throws
-> HTTPResponse {
guard httpResponse.status == .ok,
httpResponse.response.value(forHTTPHeaderField: "Content-Type") == "application/octet-stream"
else {
return httpResponse
}
let extracted = httpResponse.data
let decrypted = try vauCrypto.decrypt(data: extracted)
let decoded = try decrypted.decodeToHTTPResponse(url: originalUrl)
return decoded
2: Handle userpseudonym
Sources/VAUClient/VAUInterceptor.swift:L77// Process VAU server response (validate and extract+decrypt inner FHIR service response)
// [REQ:gemSpec_Krypt:A_20174#12] 2: Handle userpseudonym
vauEndpointHandler.didReceiveUserPseudonym(in: vauResponse)
2:
Sources/VAUClient/internal/VAUEndpointHandler.swift:L51// [REQ:gemSpec_Krypt:A_20174#12] 2:
if let pseudonym = httpResponse.response.value(forHTTPHeaderField: "userpseudonym") {
3: Decrypt using AES symmetric key
Sources/VAUClient/internal/VAUCrypto.swift:L130// Steps according to gemSpec_Krypt A_20174
// [REQ:gemSpec_Krypt:A_20174#13] 3: Decrypt using AES symmetric key
guard let sealed = try? AES.GCM.SealedBox(combined: data),
4+5: Verify decrypted message. Expect: “1
// [REQ:gemSpec_Krypt:A_20174#14] 4+5: Verify decrypted message. Expect: "1 "
let separated = utf8.split(separator: " ", maxSplits: 2).map { String($0) }
6: Remove the envelop
Sources/VAUClient/VAUInterceptor.swift:L82// [REQ:gemSpec_Krypt:A_20174#16] 6: Remove the envelop
processedVauResponse = try VAUInterceptor.processVauResponse(
A_20175 - E-Rezept-Client, Speicherung Nutzerpseudonym
Ein E-Rezept-Client MUSS das im Request verwendete Nutzerpseudonym (NP) in Software speichern (kein HSM/TPM/SE) und das NP ausschließlich für seinen Einsatzzweck der E-Rezept-VAU-Kommunikation verwenden. Insbesondere MUSS der Client die Vertraulichkeit des NP wahren (bspw. nicht unnötig in Protokolleinträgen und Fehlermeldungen aufführen). [<=]
VAUStorage provides a getter and a setter for user pseudonym
Sources/VAUClient/VAUStorage.swift:L27-L33/// VAU Storage protocol
/// [REQ:gemSpec_Krypt:A_20175#1|7] VAUStorage provides a getter and a setter for user pseudonym
public protocol VAUStorage {
public protocol VAUStorage {
/// Retrieve a previously saved UserPseudonym
var userPseudonym: AnyPublisher { get }
/// Set and save a user pseudonym
/// - Parameter userPseudonym: value to save. Pass in nil to unset
Implementation of VAUStorage is using the Filesystem
Sources/VAUClient/VAUStorage.swift:L37-L38// [REQ:gemSpec_Krypt:A_20175#2|2] Implementation of VAUStorage is using the Filesystem
public class FileVAUStorage: VAUStorage {
public class FileVAUStorage: VAUStorage {
Initialization of the VAUStorage at a predefined location in the filesystem
Sources/eRpApp/Session/StandardSessionContainer.swift:L147-L156// Local VAU storage configuration
// [REQ:gemSpec_Krypt:A_20175#3|10] Initialization of the VAUStorage at a predefined location in the filesystem
lazy var vauStorage: VAUStorage = {
lazy var vauStorage: VAUStorage = {
guard let vauStorageFilePath = try? FileManager.default.url(
for: .documentDirectory,
in: .userDomainMask,
appropriateFor: nil,
create: false
)
.appendingPathComponent("VauStorage") else {
preconditionFailure("Could not create a filePath for the vau storage.")
A_21218 - E-Rezept-Client, Zertifikatsprüfung auf Basis der X.509-Root
Das E-Rezept-FdV MUSS die RCA3 (das Zertifikat der Version 3 der X.509-Root der TI) als Vertrauensanker im Programm-Code bzw. mit dem Programm-Code fest assoziiert enthalten und als Basis für die Prüfung von TI-Zertifikat verwenden.
Das FdV MUSS einen TI-Zertifikate-Truststore enthalten und pflegen, wie folgend definiert.
Der Truststore MUSS Prüfschlüssel/Zertifikat aufgeteilt in folgende vier Kategorien enthalten: (A) Root-Schlüssel, (B) CA-Zertifikate, (C) E-Rezept-VAU-Zertifikat, (D) IDP-Zertifikat(e). Initial kann dieser Truststore nur RCA3 enthalten oder die Zertifikate die mittels Tab_KRYPT_ERP_FD_Zertifikatsliste_erstellen ermittelt werden.
Falls im Truststore keine Zertifikate für Kategorie (C) und (D) vorliegen, so MUSS das FdV den Truststore aktualisieren indem es über den FD (URL /CertList) die Zertifikatsliste lädt und diese mittels des Algorithmus Tab_KRYPT_ERP_FdV_Truststore_aktualisieren prüft und ggf. in den Truststore lädt.
Das E-Rezept-FdV MUSS über den FD (URL /OCSPList) OCSP-Responses für die Zertifikate (C) und (D) beziehen, wenn aktuell keine OCSP-Responses für diese Zertifikate im FdV vorliegen, die jünger als 12 Stunden sind.
Falls in der OCSP-Liste OCSP-Responses enthalten sind die zu keinem der Zertifikate (C) und (D) passen, so MUSS das FdV den Truststore aktualisieren (s. o.).
Zertifikate aus (C) und (D) MÜSSEN OCSP-Responses, die jünger als 12 Stunden sind besitzen, damit diese Zertifikate in fachliche Use-Cases im FdV verwendet werden können.
Die OCSP-Responder-Zertifikate MÜSSEN per Signaturprüfung auf ein Zertifikat der Kategorie (B) rückführbar sein, ansonsten MÜSSEN die entsprechenden OCSP-Responses verworfen werden.
Das FdV MUSS bei der Prüfung der TI-Zertifikate in fachlichen Use-Cases im FdV, prüfen ob das Zertifikat im oben beschriebenen Truststore enthalten ist und eine gültige OCSP-Response enthält die jünger als 12 Stunden ist. Falls dies nicht so ist, so ist das Ergebnis der Prüfung des TI-Zertifikats FAIL.
[<=]
OCSP responder certificates must be verifiable by the trust store
Tests/TrustStoreTests/X509TrustStoreTests.swift:L432// [REQ:gemSpec_Krypt:A_21218] OCSP responder certificates must be verifiable by the trust store
func testCheckEeCertificatesStatus_failWhenResponsesCannotBeVerifiedByTrustStore() throws {
Gematik Root CA 3 as a trust anchor has to be set in the program code
Sources/Settings/AppConfiguration.swift:L151// [REQ:gemSpec_Krypt:A_21218] Gematik Root CA 3 as a trust anchor has to be set in the program code
// [REQ:gemSpec_Krypt:A_24469] Gematik Root CA 3 as a trust anchor has to be set in the program code
// [REQ:BSI-eRp-ePA:O.Ntwk_4#2|16] Gematik Root CA 3 as a trust anchor has to be set in the program code
// swiftlint:disable:next force_try
let TRUSTANCHOR_GemRootCa3 = try! TrustAnchor(withPEM: """
DefaultTrustStoreSession coordinates loading and validity checking
// [REQ:gemSpec_Krypt:A_21218,A_21222#2] `DefaultTrustStoreSession` coordinates loading and validity checking
extension DefaultTrustStoreSession: TrustStoreSession {
If only OCSP responses >12h available, we must request new ones
Sources/TrustStore/DefaultTrustStoreSession.swift:L290// [REQ:gemSpec_Krypt:A_21218] If only OCSP responses >12h available, we must request new ones
func allSatisfyNotProducedBefore(date: Date) -> Bool {
Sources/TrustStore/TrustStoreSession.swift:L28
/// TrustStoreSession acts as an interactor/mediator for the TrustStoreClient and TrustStoreStorage
///
/// [REQ:gemSpec_Krypt:A_21218,A_21222]
public protocol TrustStoreSession {
Tests/TrustStoreTests/X509TrustStoreTests.swift:L351
// [REQ:gemSpec_Krypt:A_21218]
func testCheckCertificateStatus_FdEnc() throws {
Tests/TrustStoreTests/X509TrustStoreTests.swift:L371
// [REQ:gemSpec_Krypt:A_21218]
func testCheckCertificateStatus_FdEncIdpSig1IdpSig3() throws {
For every EE certificate there must be a matching OCSP response
Tests/TrustStoreTests/X509TrustStoreTests.swift:L392// [REQ:gemSpec_Krypt:A_21218] For every EE certificate there must be a matching OCSP response
func testCheckCertificateStatus_failWhenOneEeCertHasNoMatchingResponse() throws {
For every OCSP response there must be a matching EE certificate
Tests/TrustStoreTests/X509TrustStoreTests.swift:L412// [REQ:gemSpec_Krypt:A_21218] For every OCSP response there must be a matching EE certificate
func testCheckCertificateStatus_failWhenOneResponseHasNoMatchingEeCert() throws {
Note: grace period for OCSP responses is 12h
A_21222 - E-Rezept-Client, allgemein Zertifikatsprüfung
Ein E-Rezept-Client MUSS bevor er TI-X.509-Zertifikate in fachlichen Abläufen (bspw. VAU-Kanal) verwendet, diese Zertifikate prüfen (vgl. A_21216 und A_21218). [<=]
Sources/TrustStore/TrustStoreSession.swift:L28
/// TrustStoreSession acts as an interactor/mediator for the TrustStoreClient and TrustStoreStorage
///
/// [REQ:gemSpec_Krypt:A_21218,A_21222]
public protocol TrustStoreSession {
The TrustStoreSession protocol and the implementation DefaultTrustStoreSession provide interfaces for validating certificates. Validity of the IDP Certificates is always checked, as the discovery document is only available as a stream, and each access will trigger a validity check. FD Certificates
DefaultTrustStoreSession coordinates loading and validity checking
// [REQ:gemSpec_Krypt:A_21218,A_21222#2] `DefaultTrustStoreSession` coordinates loading and validity checking
extension DefaultTrustStoreSession: TrustStoreSession {
DiscoveryDocument is validated with the active trustStoreSession
Sources/IDPLive/DefaultIDPSession.swift:L279// [REQ:BSI-eRp-ePA:O.Resi_6#2] Implementation of loading the discovery document for fetching signature and
// encryption keys.
// [REQ:gemSpec_Krypt:A_21222#3] DiscoveryDocument is validated with the active trustStoreSession
private func loadDiscoveryDocument() -> AnyPublisher {
Vau Certificate provider
Sources/VAUClient/VAUCertificate.swift:L38-L44// [REQ:gemSpec_Krypt:A_21222#4|7] Vau Certificate provider
func loadAndVerifyVauCertificate() -> AnyPublisher {
func loadAndVerifyVauCertificate() -> AnyPublisher {
Future {
let vauCertificate = try await self.trustStoreSession.vauCertificate()
return X509VAUCertificate(x509: vauCertificate)
}
.mapError { $0.asVAUError() }
Gematik Root CA 3 as a trust anchor has to be set in the program code
Sources/Settings/AppConfiguration.swift:L152// [REQ:gemSpec_Krypt:A_21218] Gematik Root CA 3 as a trust anchor has to be set in the program code
// [REQ:gemSpec_Krypt:A_24469] Gematik Root CA 3 as a trust anchor has to be set in the program code
// [REQ:BSI-eRp-ePA:O.Ntwk_4#2|16] Gematik Root CA 3 as a trust anchor has to be set in the program code
// swiftlint:disable:next force_try
let TRUSTANCHOR_GemRootCa3 = try! TrustAnchor(withPEM: """
We do use certificates from categories A to D, but we have no use case for category E. This category is only meant for verification of ‘Abrechnungsdaten’ for the PKV.
Sources/TrustStore/X509TrustStore.swift:L27
// [REQ:gemSpec_Krypt:A_24470]
// [REQ:gemSpec_eRp_FdV:A_20032-01]
// [REQ:gemSpec_eRp_FdV:A_25063]
// Category A: Cross root certificates
let rootCa: X509
Initial TrustStore creation
Sources/TrustStore/DefaultTrustStoreSession.swift:L188// [REQ:gemSpec_Krypt:A_25058] Initial TrustStore creation
// [REQ:gemSpec_Krypt:A_25063] Re-init TrustStore if certificate validation has failed, then validate it again
// Reset all locally saved data
reset()
OCSPResponse not older than OCSP-Graceperiod=12h else decline
Sources/TrustStore/DefaultTrustStoreSession.swift:L275// [REQ:gemSpec_Krypt:A_21216#3] OCSPResponse not older than OCSP-Graceperiod=12h else decline
// [REQ:gemSpec_Krypt:A_25059] OCSPResponse not older than OCSP-Graceperiod=12h else decline
ocspResponse.notProducedBefore(date: time().addingTimeInterval(-Self.ocspResponseExpiration))
OCSPResponse must be validated by current TrustStore (“Kategorie (B)”)
Sources/TrustStore/DefaultTrustStoreSession.swift:L176// [REQ:gemSpec_Krypt:A_25060#1] OCSPResponse must be validated by current TrustStore ("Kategorie (B)")
// [REQ:gemSpec_Krypt:A_25061] Check VAU Certificate ("Kategorie (C)") with OCSPResponse
if let ocspValid = try? ocspUncheckedTrustStore.checkEeCertificatesStatus(with: [vauCertOCSPResponse]),
OCSPResponse must be validated by current TrustStore (“Kategorie (B)”)
Sources/TrustStore/DefaultTrustStoreSession.swift:L218// [REQ:gemSpec_Krypt:A_25060#2] OCSPResponse must be validated by current TrustStore ("Kategorie (B)")
// [REQ:gemSpec_Krypt:A_25061] Check VAU Certificate ("Kategorie (C)") with OCSPResponse
guard let ocspValid = try? ocspUncheckedTrustStore.checkEeCertificatesStatus(with: [vauCertOCSPResponse]),
OCSP responder certificates must be verifiable by the TrustStore
Sources/TrustStore/X509TrustStore.swift:L166// [REQ:gemSpec_Krypt:A_25060#3] OCSP responder certificates must be verifiable by the TrustStore
// 1) Response must be successful
guard ocspResponse.status() == .successful else { return false }
OCSP responder certificates must be verifiable by the TrustStore
Sources/TrustStore/X509TrustStore.swift:L203// [REQ:gemSpec_Krypt:A_25063] OCSP responder certificates must be verifiable by the TrustStore
// [REQ:gemSpec_Krypt:A_25060#3] OCSP responder certificates must be verifiable by the TrustStore
let verifiedOCSPResponses = basicVerifyFilter(ocspResponses: ocspResponses)
OCSP responder certificates must be verifiable by the TrustStore
Sources/TrustStore/X509TrustStore.swift:L235// [REQ:gemSpec_Krypt:A_25063] OCSP responder certificates must be verifiable by the TrustStore
// [REQ:gemSpec_Krypt:A_25060#4] OCSP responder certificates must be verifiable by the TrustStore
private func basicVerifyFilter(ocspResponses: [OCSPResponse]) -> [OCSPResponse] {
Check VAU Certificate (“Kategorie (C)”) with OCSPResponse
Sources/TrustStore/DefaultTrustStoreSession.swift:L177// [REQ:gemSpec_Krypt:A_25060#1] OCSPResponse must be validated by current TrustStore ("Kategorie (B)")
// [REQ:gemSpec_Krypt:A_25061] Check VAU Certificate ("Kategorie (C)") with OCSPResponse
if let ocspValid = try? ocspUncheckedTrustStore.checkEeCertificatesStatus(with: [vauCertOCSPResponse]),
Check VAU Certificate (“Kategorie (C)”) with OCSPResponse
Sources/TrustStore/DefaultTrustStoreSession.swift:L219// [REQ:gemSpec_Krypt:A_25060#2] OCSPResponse must be validated by current TrustStore ("Kategorie (B)")
// [REQ:gemSpec_Krypt:A_25061] Check VAU Certificate ("Kategorie (C)") with OCSPResponse
guard let ocspValid = try? ocspUncheckedTrustStore.checkEeCertificatesStatus(with: [vauCertOCSPResponse]),
Since we don’t use category E certificates, this requirement does not apply to us.
Check ee_certs against category A+B certificates
Sources/TrustStore/X509TrustStore.swift:L289// [REQ:gemSpec_Krypt:A_25063:(4)] Check ee_certs against category A+B certificates
// [REQ:gemSpec_Krypt:A_A_25061] Check ee_certs against category A+B certificates
typealias VauAndIpdCerts = (vauCerts: [X509], idpCerts: [X509])
Check add_roots against category A certificates
Sources/TrustStore/X509TrustStore.swift:L56// Category A:
// Before adding an addRoot we check if it can be validated by the currently potential trust store.
// We expect the incoming addRoots to be chronically ordered (i.e. ["RCA3->RCA4", "RCA4->RCA5", ...])
// so a simple forEach loop is already sufficient here. See also gemSpec_Krypt A_21216.
// [REQ:gemSpec_Krypt:A_25063] Check add_roots against category A certificates
var validatedAddRoots: [X509] = []
Sources/TrustStore/X509TrustStore.swift:L195
/// Match a collection of `OCSPResponse`s with the end entity certificates of this `X509TrustStore`.
/// Checks response status, revocation status for each certificate and validates the signer certificates of
/// the responses itself.
///
/// [REQ:gemSpec_Krypt:A_25063]
/// [REQ:gemSpec_eRp_FdV:A_20032-01]
///
/// - Note: This function assumes that up-to-dateness of the responses itself has already been checked.
///
/// - Returns: true on successful matching/validation, false if not successful or error
func checkEeCertificatesStatus(with ocspResponses: [OCSPResponse]) throws -> Bool {
OCSP responder certificates must be verifiable by the TrustStore
Sources/TrustStore/X509TrustStore.swift:L202// [REQ:gemSpec_Krypt:A_25063] OCSP responder certificates must be verifiable by the TrustStore
// [REQ:gemSpec_Krypt:A_25060#3] OCSP responder certificates must be verifiable by the TrustStore
let verifiedOCSPResponses = basicVerifyFilter(ocspResponses: ocspResponses)
For every EE certificate there must be a matching OCSP response
Sources/TrustStore/X509TrustStore.swift:L214// [REQ:gemSpec_Krypt:A_25063] For every EE certificate there must be a matching OCSP response
let matchedResponses = try eeCertAndSignerTuple.map { eeCertificate, signer in
For every OCSP response there must be a matching EE certificate
Sources/TrustStore/X509TrustStore.swift:L223// [REQ:gemSpec_Krypt:A_25063] For every OCSP response there must be a matching EE certificate
let matchedEeCerts = try ocspResponses.map { response in
OCSP responder certificates must be verifiable by the TrustStore
Sources/TrustStore/X509TrustStore.swift:L234// [REQ:gemSpec_Krypt:A_25063] OCSP responder certificates must be verifiable by the TrustStore
// [REQ:gemSpec_Krypt:A_25060#4] OCSP responder certificates must be verifiable by the TrustStore
private func basicVerifyFilter(ocspResponses: [OCSPResponse]) -> [OCSPResponse] {
Check add_roots against category A certificates
Sources/TrustStore/X509TrustStore.swift:L258try! NSRegularExpression(pattern: "CN=GEM\\.RCA\\d+") // swiftlint:disable:this force_try
// [REQ:gemSpec_Krypt:A_25063:(2)] Check add_roots against category A certificates
static func checkRcaRegex(certificate: X509) -> Bool {
Check ca_certs against category A certificates
Sources/TrustStore/X509TrustStore.swift:L269// [REQ:gemSpec_Krypt:A_25063:(3)] Check ca_certs against category A certificates
private static let caCertRegex =
Re-init TrustStore if certificate validation has failed, then validate it again
Sources/TrustStore/DefaultTrustStoreSession.swift:L189// [REQ:gemSpec_Krypt:A_25058] Initial TrustStore creation
// [REQ:gemSpec_Krypt:A_25063] Re-init TrustStore if certificate validation has failed, then validate it again
// Reset all locally saved data
reset()
GS-A_4357-02 - X.509-Identitäten für die Erstellung und Prüfung digitaler nicht-qualifizierter elektronischer Signaturen
Alle Produkttypen, die X.509-Identitäten bei der Erstellung oder Prüfung digitaler nicht-qualifizierter elektronischer Signaturen verwenden, MÜSSEN die in Tab_KRYPT_002 aufgeführten Algorithmen unterstützen und die Tabellenvorgaben erfüllen.
Produkttypen, die Zertifikate (X.509-Identitäten) auf Basis der Schlüsselgeneration „ECDSA“ ausstellen (vgl. Abschnitt 5.1) oder verwenden, MÜSSEN die in Tab_KRYPT_002a aufgeführten Algorithmen und die Tabellenvorgaben erfüllen.
[<=]
Assure that brainpoolP256r1 is used
Sources/FeatureCardWall/ReadCard/NFCSignatureProvider.swift:L336// [REQ:gemSpec_Krypt:A_17207] Assure only brainpoolP256r1 is used
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02,GS-A_4361-02] Assure that brainpoolP256r1 is used
var alg: JWT.Algorithm? {
Assure that brainpoolP256r1 is used
Sources/FeatureCardWall/ReadCard/NFCSignatureProvider.swift:L588// [REQ:gemSpec_Krypt:A_17207] Assure only brainpoolP256r1 is used
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02,GS-A_4361-02] Assure that brainpoolP256r1 is used
let alg: JWT.Algorithm = .bp256r1
Assure that brainpoolP256r1 is used
Sources/FeatureCardWall/ReadCard/NFCSignatureProvider.swift:L637// [REQ:gemSpec_Krypt:A_17207] Assure only brainpoolP256r1 is used
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02,GS-A_4361-02] Assure that brainpoolP256r1 is used
guard let alg = autCertificateResponse.info.algorithm.alg
Assure that brainpoolP256r1 is used
Sources/IDPLive/DefaultIDPSession.swift:L302// Validate JWT/DiscoveryDocument signature
// [REQ:gemSpec_Krypt:A_17207] Only implemented for brainpoolP256r1
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02] Assure that brainpoolP256r1 is used
// [REQ:gemSpec_Krypt:GS-A_4361-02] Assure that brainpoolP256r1 is used
// [REQ:BSI-eRp-ePA:O.Resi_6#4] Discovery Document signature verification
guard (try? fetchedDocument.backing.verify(with: fetchedDocument.discKey)) ?? false else {
Assure that brainpoolP256r1 is used
Sources/IDPLive/DefaultIDPSession.swift:L641// [REQ:gemSpec_Krypt:A_17207] Only implemented for brainpoolP256r1
// [REQ:gemSpec_IDP_Frontend:A_19908-01] Signature check
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02,GS-A_4361-02] Assure that brainpoolP256r1 is used
guard let verified = try? challenge.challenge.verify(with: document.authentication.cert),
Assure that brainpoolP256r1 is used
Sources/IDPLive/IDPDirectoryKKApps+JWTSignatureVerifier.swift:L40// [REQ:gemSpec_Krypt:A_17207]
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02,GS-A_4361-02] Assure that brainpoolP256r1 is used
guard let key = brainpoolP256r1VerifyPublicKey() else {
Sources/IDPLive/IDPDirectoryKKApps+JWTSignatureVerifier.swift:L50
// [REQ:gemSpec_Krypt:A_17207]
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02,GS-A_4361-02]
public func verify(signature raw: Data, message: Data) throws -> Bool {
GS-A_4361-02 - X.509-Identitäten für die Erstellung und Prüfung digitaler Signaturen
Alle Produkttypen, die X.509-Identitäten verwenden, die zur Erstellung und Prüfung digitaler Signaturen in Bezug auf TI-Komponenten (technische X.509-Zertifikate) genutzt werden, MÜSSEN alle in Tab_KRYPT_002 aufgeführten Algorithmen unterstützen und die Tabellenanforderungen erfüllen.
Produkttypen die Zertifikate (X.509-Identitäten) auf Basis der Schlüsselgeneration „ECDSA“ ausstellen (vgl. Abschnitt 5.1) oder verwenden, MÜSSEN die in Tab_KRYPT_002a aufgeführten Algorithmen und die Tabellenvorgaben erfüllen. [<=]
Assure that brainpoolP256r1 is used
Sources/FeatureCardWall/ReadCard/NFCSignatureProvider.swift:L336// [REQ:gemSpec_Krypt:A_17207] Assure only brainpoolP256r1 is used
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02,GS-A_4361-02] Assure that brainpoolP256r1 is used
var alg: JWT.Algorithm? {
Assure that brainpoolP256r1 is used
Sources/FeatureCardWall/ReadCard/NFCSignatureProvider.swift:L588// [REQ:gemSpec_Krypt:A_17207] Assure only brainpoolP256r1 is used
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02,GS-A_4361-02] Assure that brainpoolP256r1 is used
let alg: JWT.Algorithm = .bp256r1
Assure that brainpoolP256r1 is used
Sources/FeatureCardWall/ReadCard/NFCSignatureProvider.swift:L637// [REQ:gemSpec_Krypt:A_17207] Assure only brainpoolP256r1 is used
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02,GS-A_4361-02] Assure that brainpoolP256r1 is used
guard let alg = autCertificateResponse.info.algorithm.alg
Assure that brainpoolP256r1 is used
Sources/IDPLive/DefaultIDPSession.swift:L303// Validate JWT/DiscoveryDocument signature
// [REQ:gemSpec_Krypt:A_17207] Only implemented for brainpoolP256r1
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02] Assure that brainpoolP256r1 is used
// [REQ:gemSpec_Krypt:GS-A_4361-02] Assure that brainpoolP256r1 is used
// [REQ:BSI-eRp-ePA:O.Resi_6#4] Discovery Document signature verification
guard (try? fetchedDocument.backing.verify(with: fetchedDocument.discKey)) ?? false else {
Assure that brainpoolP256r1 is used
Sources/IDPLive/DefaultIDPSession.swift:L641// [REQ:gemSpec_Krypt:A_17207] Only implemented for brainpoolP256r1
// [REQ:gemSpec_IDP_Frontend:A_19908-01] Signature check
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02,GS-A_4361-02] Assure that brainpoolP256r1 is used
guard let verified = try? challenge.challenge.verify(with: document.authentication.cert),
Assure that brainpoolP256r1 is used
Sources/IDPLive/IDPDirectoryKKApps+JWTSignatureVerifier.swift:L40// [REQ:gemSpec_Krypt:A_17207]
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02,GS-A_4361-02] Assure that brainpoolP256r1 is used
guard let key = brainpoolP256r1VerifyPublicKey() else {
Sources/IDPLive/IDPDirectoryKKApps+JWTSignatureVerifier.swift:L50
// [REQ:gemSpec_Krypt:A_17207]
// [REQ:gemSpec_Krypt:GS-A_4357-01,GS-A_4357-02,GS-A_4361-02]
public func verify(signature raw: Data, message: Data) throws -> Bool {
GS-A_4367 - Zufallszahlengenerator
Alle Produkttypen, die Zufallszahlen generieren, MÜSSEN die Anforderungen aus [BSI-TR-03116-1#3.8 Erzeugung von Zufallszahlen] erfüllen.
[<=]
Key pair generation delegated to OpenSSL with BrainpoolP256r1 parameters
Sources/IDP/internal/IDPCrypto.swift:L30/// Key-pair generator type based on BrainpoolP256r1
///
/// [REQ:gemSpec_Krypt:GS-A_4357,GS-A_4367] Key pair generation delegated to OpenSSL with BrainpoolP256r1 parameters
public typealias BrainpoolKeyGenerator = () throws -> BrainpoolP256r1.KeyExchange.PrivateKey
Key pair generation delegated to OpenSSL with BrainpoolP256r1 parameters
Sources/IDP/internal/JWT/JWE+KDF.swift:L50// [REQ:gemSpec_Krypt:GS-A_4357] Key pair generation delegated to OpenSSL with BrainpoolP256r1 parameters
// [REQ:gemSpec_Krypt:GS-A_4367] Key pair generation delegated to OpenSSL with BrainpoolP256r1 parameters
/// BrainpoolP256r1 key exchange context
case bpp256r1(BrainpoolP256r1.KeyExchange.PublicKey,
Sources/IDP/internal/SecKeyRandom.swift:L28
/// Generate random Data with given length
///
/// [REQ:gemSpec_Krypt:GS-A_4367]
/// [REQ:BSI-eRp-ePA:O.Rand_1#2] Secure Random generator.
///
/// - Parameters:
/// - length: the number of bytes to generate
/// - randomizer: the randomizer to be used. Default: kSecRandomDefault
/// - Returns: the random initialized Data
/// - Throws: `IDPError`
public func generateSecureRandom(length: Int, randomizer: SecRandomRef? = kSecRandomDefault) throws -> Data {
Key pair generation delegated to OpenSSL with BrainpoolP256r1 parameters
Sources/VAUClient/internal/VAUCrypto.swift:L113// [REQ:gemSpec_Krypt:GS-A_4357] Key pair generation delegated to OpenSSL with BrainpoolP256r1 parameters
// [REQ:gemSpec_Krypt:GS-A_4367] Key pair generation delegated to OpenSSL with BrainpoolP256r1 parameters
// [REQ:BSI-eRp-ePA:O.Cryp_3#5] Brainpool key generator
// [REQ:gemSpec_eRp_FdV:A_19179#5] Key pair generation delegated to OpenSSL with BrainpoolP256r1 parameters
let keyPairGenerator = { try BrainpoolP256r1.KeyExchange.generateKey() }
Sources/VAUClient/internal/VAURandom.swift:L29
/// Generate random Data with given length
///
/// [REQ:gemSpec_Krypt:GS-A_4367]
/// [REQ:BSI-eRp-ePA:O.Rand_1#3] Secure Random generator.
///
/// - Parameters:
/// - length: the number of bytes to generate
/// - randomizer: the randomizer to be used. Default: kSecRandomDefault
/// - Returns: the random initialized Data
/// - Throws: `VAUError`
static func generateSecureRandom(length: Int, randomizer: SecRandomRef? = kSecRandomDefault) throws -> Data {
We use the platform provided secure random generator. iOS is FIPS 140-2 certified. The operating system uses an entropy pool with different sources, including a true random number generator from the secure enclave, that is present on every device. Security certifcates can be found https://support.apple.com/de-li/guide/certifications/apc3fa917cb49/web, including FIPS 140-2 und Common Criteria.
GS-A_4368 - Schlüsselerzeugung
Alle Produkttypen, die Schlüssel erzeugen, MÜSSEN die Anforderungen aus [BSI-TR-03116-1#3.9 Schlüsselerzeugung] erfüllen. [<=]
AES key generation via CryptoKit
Sources/IDP/internal/IDPCrypto.swift:L79// [REQ:gemSpec_Krypt:GS-A_4389:1] 256bit GCM symmetric key
// [REQ:gemSpec_eRp_FdV:A_19179#3] AES key generation via CryptoKit
// [REQ:gemSpec_Krypt:GS-A_4368] AES key generation via CryptoKit
// [REQ:gemSpec_IDP_Frontend:A_21323#4] AES key generation via CryptoKit
aesKey: SymmetricKey = SymmetricKey(size: SymmetricKeySize(bitCount: 256))
AES key generation via CryptoKit
Sources/VAUClient/internal/VAUCrypto.swift:L166// [REQ:gemSpec_Krypt:GS-A_4389:2] 256bit GCM symmetric key
// [REQ:gemSpec_eRp_FdV:A_19179#6] AES key generation via CryptoKit
// [REQ:gemSpec_Krypt:GS-A_4368] AES key generation via CryptoKit
let secretKey = SymmetricKey(data: sharedSecret)
We use the platform provided secure random generator. iOS is FIPS 140-2 certified. The operating system uses an entropy pool with different sources, including a true random number generator from the secure enclave, that is present on every device. Security certifcates can be found https://support.apple.com/de-li/guide/certifications/apc3fa917cb49/web, including FIPS 140-2 und Common Criteria.
GS-A_4389 - Symmetrischer Anteil der hybriden Verschlüsselung binärer Daten
Produkttypen, die die hybride Verschlüsselung binärer Daten durchführen, MÜSSEN für den symmetrischen Anteil der Verschlüsselung die folgenden Vorgaben berücksichtigen:
Als symmetrische Block-Chiffre muss AES [FIPS-197] mit einer Schlüssellänge von 256 Bit im Galois/Counter Mode (GCM) gemäß [NIST-SP-800-38D] mit der Tag-Länge von 128 Bit verwendet werden.
Die IVs dürfen sich bei gleichem Schlüssel nicht wiederholen (vgl. [NIST-SP-800-38D#S.25] und [BSI-TR-02102-1#S.24]). Der IV soll eine Bitlänge von 96 Bit besitzen, seine Länge muss mindestens 96 Bit sein. Es wird empfohlen den IV zufällig zu wählen (vgl. [gemSpec_Krypt#GS-A_4367]).
Hinweis: Im Normalfall ist davon auszugehen, dass für die Sicherung der Integrität und Authentizität der zu verschlüsselnden Daten zudem noch eine Signatur dieser Daten notwendig ist.
IVs must not be reused, IVs bit length must be larger or equal to 96
Sources/IDP/internal/IDPCrypto.swift:L74// [REQ:gemSpec_Krypt:GS-A_4389:2] IVs must not be reused, IVs bit length must be larger or equal to 96
try generateSecureRandom(length: IDPCrypto.AES256GCMSpec.nonceBytes)
256bit GCM symmetric key
Sources/IDP/internal/IDPCrypto.swift:L77// [REQ:gemSpec_Krypt:GS-A_4389:1] 256bit GCM symmetric key
// [REQ:gemSpec_eRp_FdV:A_19179#3] AES key generation via CryptoKit
// [REQ:gemSpec_Krypt:GS-A_4368] AES key generation via CryptoKit
// [REQ:gemSpec_IDP_Frontend:A_21323#4] AES key generation via CryptoKit
aesKey: SymmetricKey = SymmetricKey(size: SymmetricKeySize(bitCount: 256))
256bit GCM symmetric key
Sources/VAUClient/internal/VAUCrypto.swift:L164// [REQ:gemSpec_Krypt:GS-A_4389:2] 256bit GCM symmetric key
// [REQ:gemSpec_eRp_FdV:A_19179#6] AES key generation via CryptoKit
// [REQ:gemSpec_Krypt:GS-A_4368] AES key generation via CryptoKit
let secretKey = SymmetricKey(data: sharedSecret)
256bit GCM symmetric key
Sources/VAUClient/internal/VAUCrypto.swift:L179// f) Encrypt
// [REQ:gemSpec_Krypt:GS-A_4389:1] 256bit GCM symmetric key
let sealedBox = try AES.GCM.seal(payload, using: cek, nonce: nonce)
GS-A_4390 - Asymmetrischer Anteil der hybriden Verschlüsselung binärer Daten
Produkttypen, die die hybride Verschlüsselung binärer Daten durchführen, MÜSSEN für den asymmetrischen Anteil der Verschlüsselung die folgenden Vorgaben berücksichtigen:
RSAES-OAEP with MGF1 implemented in sub-framework OpenSSL-swift
Sources/AVS/AVSCmsEncrypter.swift:L33// [REQ:gemSpec_Krypt:GS-A_4390] RSAES-OAEP with MGF1 implemented in sub-framework OpenSSL-swift
// [REQ:gemSpec_eRp_FdV:A_22778-01#3] Encryption of message to the Pharmacy is done with all provided
// certificates
// [REQ:gemSpec_eRp_FdV:A_22779-01#3] Encrypted message is of form of a PKCS#7 container (CMS)
// https://github.com/gematik/OpenSSL-Swift/blob/3c1ea91ba5abfefecfe3588815cb928d777e29ad/Sources/OpenSSL/CMS/CMSContentInfo.swift#L88
// swiftlint:disable:previous line_length
let cms = try CMSContentInfo.encryptPartial(data: data)
A_19086 - E-Rezept-FdV: Verbot von Werbe-Tracking
Das E-Rezept-FdV DARF ein Werbe-Tracking NICHT verwenden. [<=]
Tracking is only implemented for the purpose of Usability-Tracking. Sessions are not persisted, session ids are recreated each app startup.
A_19089-01 - E-Rezept-FdV: Informationen zur Einwilligung
Das E-Rezept-FdV MUSS, falls es Tracking-Funktionen implementiert, die Tracking-Daten mehrerer Nutzersessions verknüpfen, den Versicherten vor der Einwilligung in die Aktivierung dieser Tracking-Funktion in verständlicher und leicht zugänglicher Form sowie in einer klaren und einfachen Sprache folgende Einwilligungsinformationen anzeigen:
We do not link user session of multiple app starts, we forcefully regenerate a new user-id. Nevertheless the following still applies: Opt-In for Analytics will be asked while the app onboarding runs. After the onboarding ran, the user may change the analytics settings in the settings menu.
Show comply route to display analytics usage within onboarding
Sources/eRpApp/Screens/Onboarding/OnboardingDomain.swift:L130// [REQ:gemSpec_eRp_FdV:A_19088,A_19091-01#1,A_19092-01#2] Show comply route to display analytics usage within
// onboarding
// [REQ:BSI-eRp-ePA:O.Purp_3#5] Show comply route to display analytics usage within onboarding
// [REQ:gemSpec_eRp_FdV:A_19089-01#2] Show comply route to display analytics usage within onboarding
case .showAnalytics:
Show information dialog for analytics usage
Sources/eRpApp/Screens/Settings/SettingsView.swift:L61// Tracking comply sheet presentation
// [REQ:BSI-eRp-ePA:O.Purp_5#3] Show comply view for settings triggered analytics enabling
// [REQ:gemSpec_eRp_FdV:A_19982#3,A_19089-01#3] Show information dialog for analytics usage
Rectangle()
User info for usage analytics
Sources/eRpApp/Screens/Settings/SettingsView.swift:L151// [REQ:gemSpec_eRp_FdV:A_19089-01#4] User info for usage analytics
Label(title: { Text(L10n.stgTrkTxtExplanation) }, icon: {})
A_19090-01 - E-Rezept-FdV: Aktivierung erst nach Lesebestätigung der Einwilligungsinformationen
Das E-Rezept-FdV MUSS sicherstellen, falls es Tracking-Funktionen implementiert, die Tracking-Daten mehrerer Nutzersessions verknüpfen, dass die Einwilligung des Nutzers in die Aktivierung dieser Tracking-Funktionen erst erfolgt, wenn der Nutzer bestätigt, die angezeigten Einwilligungsinformationen gelesen zu haben. [<=]
activate after optIn is granted
Sources/eRpApp/SceneDelegate.swift:L319// [REQ:gemSpec_eRp_FdV:A_19090-01] activate after optIn is granted
tracker.stopTracking()
User confirms the opt in within settings
Sources/eRpApp/Screens/Onboarding/OnboardingDomain.swift:L134// [REQ:gemSpec_eRp_FdV:A_19090-01,A_19091-01#2] User confirms the opt in within settings
// [REQ:BSI-eRp-ePA:O.Purp_3#6] Accept usage analytics
case .allowTracking:
User confirms the opt in within settings
Sources/eRpApp/Screens/Settings/SettingsDomain.swift:L188// [REQ:gemSpec_eRp_FdV:A_19090-01,A_19091-01#4] User confirms the opt in within settings
// [REQ:BSI-eRp-ePA:O.Purp_5#4] User confirms the opt in within settings
case .confirmedOptInTracking:
activate after optIn is granted
Sources/eRpApp/Tracking/ContentSquareAnalyticsAdapter.swift:L61// [REQ:gemSpec_eRp_FdV:A_19090-01] activate after optIn is granted
Contentsquare.start()
We do not link user session of multiple app starts, we forcefully regenerate a new user-id. Nevertheless the following still applies: Opt-In for Analytics will be asked while the app onboarding runs. After the onboarding ran, the user may change the analytics settings in the settings menu.
A_19091-01 - E-Rezept-FdV: Verbot von mehrmaligen Einwilligungsabfragen
Das E-Rezept-FdV MUSS, falls es Tracking-Funktionen implementiert, die Tracking-Daten mehrerer Nutzersessions verknüpfen, technisch sicherstellen, dass der Benutzer der App maximal einmal eine Abfrage zur Einwilligung in das Tracking angezeigt bekommt. [<=]
We do not link user session of multiple app starts, we forcefully regenerate a new user-id. Nevertheless the following still applies: Opt-In for Analytics will be asked while the app onboarding runs. After the onboarding ran, the user may change the analytics settings in the settings menu.
Show comply route to display analytics usage within
Sources/eRpApp/Screens/Onboarding/OnboardingDomain.swift:L127// [REQ:gemSpec_eRp_FdV:A_19088,A_19091-01#1,A_19092-01#2] Show comply route to display analytics usage within
// onboarding
// [REQ:BSI-eRp-ePA:O.Purp_3#5] Show comply route to display analytics usage within onboarding
// [REQ:gemSpec_eRp_FdV:A_19089-01#2] Show comply route to display analytics usage within onboarding
case .showAnalytics:
User confirms the opt in within settings
Sources/eRpApp/Screens/Onboarding/OnboardingDomain.swift:L134// [REQ:gemSpec_eRp_FdV:A_19090-01,A_19091-01#2] User confirms the opt in within settings
// [REQ:BSI-eRp-ePA:O.Purp_3#6] Accept usage analytics
case .allowTracking:
Show comply route to display analytics usage within settings
Sources/eRpApp/Screens/Settings/SettingsDomain.swift:L180// [REQ:gemSpec_eRp_FdV:A_19091-01#3] Show comply route to display analytics usage within settings
state.destination = .complyTracking(.init())
User confirms the opt in within settings
Sources/eRpApp/Screens/Settings/SettingsDomain.swift:L188// [REQ:gemSpec_eRp_FdV:A_19090-01,A_19091-01#4] User confirms the opt in within settings
// [REQ:BSI-eRp-ePA:O.Purp_5#4] User confirms the opt in within settings
case .confirmedOptInTracking:
A_19092-01 - E-Rezept-FdV: Kopplungsverbot
Das E-Rezept-FdV DARF, falls es Tracking-Funktionen implementiert, die Tracking-Daten mehrerer Nutzersessions verknüpfen, die Nutzung des E-Rezept-FdV NICHT an die Aktivierung des Session-übergreifenden Tracking koppeln. [<=]
We do not link user session of multiple app starts, we forcefully regenerate a new user-id. Nevertheless the following still applies: Opt-In for Analytics will be asked while the app onboarding runs. After the onboarding ran, the user may change the analytics settings in the settings menu.
Show comply route to display analytics usage within
Sources/eRpApp/Screens/Onboarding/OnboardingDomain.swift:L127// [REQ:gemSpec_eRp_FdV:A_19088,A_19091-01#1,A_19092-01#2] Show comply route to display analytics usage within
// onboarding
// [REQ:BSI-eRp-ePA:O.Purp_3#5] Show comply route to display analytics usage within onboarding
// [REQ:gemSpec_eRp_FdV:A_19089-01#2] Show comply route to display analytics usage within onboarding
case .showAnalytics:
User may choose to not accept analytics, onboarding will still continue
Sources/eRpApp/Screens/Onboarding/OnboardingDomain.swift:L139// [REQ:gemSpec_eRp_FdV:A_19092-01#3] User may choose to not accept analytics, onboarding will still continue
// [REQ:BSI-eRp-ePA:O.Purp_3#7] Deny usage analytics
case .denyTracking:
A_19093-01 - E-Rezept-FdV: Keine direkt identifizierenden personenbezogenen Daten
Das E-Rezept-FdV MUSS sicherstellen, falls es Tracking-Funktionen implementiert, dass die Tracking-Informationen keine Daten enthalten, die natürliche Personen direkt identifizieren. [<=]
Usage Tracking is called very sparse and boils down to one place where all visited screens are recorded. See usage of @Dependency(\.tracker) for all cases where the actual analytics framework is used.
Very sparse usage of actual tracking boils down to this call where
Sources/eRpApp/Tracking/AnalyticsReducer.swift:L54// [REQ:gemSpec_eRp_FdV:A_19093-01#2] Very sparse usage of actual tracking boils down to this call where
// only displayed screens are tracked
tracker.track(screen: newRoute)
A_19094-01 - E-Rezept-FdV: Keine Weitergabe von Sicherheitsmerkmalen
Das E-Rezept-FdV MUSS sicherstellen, falls es Tracking-Funktionen implementiert, dass in den übermittelten Tracking-Informationen keine Sicherheitsmerkmale enthalten sind. [<=]
Usage Tracking is called very sparse and boils down to one place where all visited screens are recorded. See usage of @Dependency(\.tracker) for all cases where the actual analytics framework is used.
A_19096-01 - E-Rezept-FdV: Jederzeit neue Generierung der Pseudonyme
Das E-Rezept-FdV MUSS, falls es Tracking-Funktionen implementiert, die Tracking-Daten mehrerer Nutzersessions verknüpfen, technisch sicherstellen, dass eine neue Generierung der pseudonymen Identifier jederzeit durch den Nutzer des FdVs veranlasst werden kann. [<=]
We do not link user session of multiple app starts, we forcefully regenerate a new user-id. Nevertheless the following still applies.
Remove existing sessions while starting the framework, tracking is
Sources/eRpApp/Tracking/ContentSquareAnalyticsAdapter.swift:L80// [REQ:gemSpec_eRp_FdV:A_19096-01#1] Remove existing sessions while starting the framework, tracking is
// never cross session.
Contentsquare.start()
A_19097-01 - E-Rezept-FdV: Deaktivierung zu jeder Zeit
Das E-Rezept-FdV MUSS technisch sicherstellen, falls es Tracking-Funktionen implementiert, die Tracking-Daten mehrerer Nutzersessions verknüpfen, dass aktivierte Tracking-Funktionen jederzeit durch den Nutzer des FdVs deaktiviert werden können. [<=]
We do not link user session of multiple app starts, we forcefully regenerate a new user-id. Nevertheless the following still applies.
Toggle within Settings to enable and disable usage analytics
Sources/eRpApp/Screens/Settings/SettingsView.swift:L129// [REQ:gemSpec_eRp_FdV:A_19097-01#2] Toggle within Settings to enable and disable usage analytics
// [REQ:BSI-eRp-ePA:O.Purp_5#1] Toggle within Settings to enable and disable usage analytics
// [REQ:BSI-eRp-ePA:O.Purp_6#1] Current Analytics state is inspectable by the user
// [REQ:gemSpec_eRp_FdV:A_19982#4] Opt out of analytics
Toggle(isOn: $store.trackerOptIn.sending(\.toggleTrackingTapped).animation()) {
A_19177 - E-Rezept-FdV – Anzeige von Protokolldaten
Das E-Rezept-FdV MUSS es den Versicherten ermöglichen, die für die Fachanwendung für ihn erzeugten Protokolleinträge anzeigen zu können. [<=]
An Audit Log for every FD access is available in each user profile.
View displaying the audit events
Sources/eRpApp/Screens/Settings/Profiles/Protocol/AuditEventsView.swift:L29// [REQ:gemSpec_eRp_FdV:A_19177#1,A_19185#2] View displaying the audit events
// [REQ:BSI-eRp-ePA:O.Auth_6#3] View displaying the audit events
struct AuditEventsView: View {
Actual Button to open the audit events
Sources/eRpApp/Screens/Settings/Profiles/Edit/EditProfileView.swift:L498// [REQ:gemSpec_eRp_FdV:A_19177#2,A_19185#3] Actual Button to open the audit events
// [REQ:BSI-eRp-ePA:O.Auth_6#2] Actual Button to open the audit events
Button {
A_19178 - E-Rezept-FdV – Schutzmaßnahmen gegen die OWASP-Mobile-Top-10-Risiken
Das E-Rezept-FdV MUSS Maßnahmen zum Schutz vor den in der jeweils aktuellen Version genannten OWASP-Mobile-Top-10-Risiken [OWASPMobileTop10] umsetzen. [<=]
Is covered by our MSTG.
A_19229-01 - E-Rezept-FdV: E-Rezept lokal löschen - Löschen aller verknüpfter Daten
Das E-Rezept-FdV MUSS, wenn es ein E-Rezept lokal im E-Rezept-FdV löscht, auch alle mit dem E-Rezept verknüpften Daten im E-Rezept-FdV löschen. [<=]
Audit events will be deleted when the referencing task is deleted. Cascading relationship “task -> audit event” is defined in Sources/eRpLocalStorage/Prescriptions/ErxTask.xcdatamodeld/ErxTask.xcdatamodel/contents
Deletion button is tapped -> delete confirmation dialog shows
Sources/eRpApp/Screens/Main/PrescriptionDetail/PrescriptionDetailDomain.swift:L239// Delete
// [REQ:gemSpec_eRp_FdV:A_19229-01#2] Deletion button is tapped -> delete confirmation dialog shows
case .delete:
Confirmation dialog was confirmed, deletion is triggered
Sources/eRpApp/Screens/Main/PrescriptionDetail/PrescriptionDetailDomain.swift:L250// [REQ:gemSpec_eRp_FdV:A_19229-01#3] Confirmation dialog was confirmed, deletion is triggered
case .destination(.presented(.alert(.confirmedDelete))):
A_20033 - E-Rezept-FdV: Prüfung Internet-Zertifikate
Das E-Rezept-FdV MUSS für die Prüfung des internetseitigen Zertifikats von Diensten der TI das Zertifikat auf ein CA-Zertifikat einer CA, die die "CA/Browser Forum Baseline Requirements for the Issuance and Management of Publicly-Trusted Certificates" (https://cabforum.org/baseline-requirements-documents/) erfüllt, kryptographisch (Signaturprüfung) zurückführen können. Ansonsten MUSS es das Zertifikat als "ungültig" bewerten.
Das E-Rezept-FdV MUSS die zeitliche Gültigkeit des Zertifikats prüfen. Falls diese Prüfung negativ ausfällt, muss es das Zertifikat als "ungültig" bewerten. [<=]
For TLS certificates, this is implemented by not deactivating ATS within Info.plist, path: NSAppTransportSecurity. For TI Certificates, this is implemented within the TrustStore module.
A_20167-02 - E-Rezept-FdV: Authentisierung E-Rezept-Fachdienst - IDP-Dienst - Rolle Anwendungsfrontend und optional Authenticator-Modul
Das E-Rezept-FdV MUSS, wenn es eine Authentifizierung des Nutzers über den IDP-Dienst, in seiner Rolle als Authorization-Server, unterstützt, entweder als anfragendes Anwendungsfrontend und Authenticator-Modul oder, wenn ein Authenticator-Modul in einer anderen für die TI zugelassene App genutzt wird, als anfragendes Anwendungsfrontend agieren. [<=]
no token/not authorized, show authenticator module
Sources/eRpApp/Data/PrescriptionRepository.swift:L177// [REQ:gemSpec_eRp_FdV:A_20167-02#2,A_20172] no token/not authorized, show authenticator module
if Result.success(false) == isAuthenticated {
no token/not authorized, show authenticator module
Sources/eRpApp/Screens/Pharmacy/RedeemService/RedeemService.swift:L193// [REQ:gemSpec_eRp_FdV:A_20167-02#3,A_20172] no token/not authorized, show authenticator module
if Result.success(false) == authenticated {
no token/not authorized, show authenticator module
Sources/eRpApp/Screens/Pharmacy/RedeemService/RedeemService.swift:L214// [REQ:gemSpec_eRp_FdV:A_20167-02#3,A_20172] no token/not authorized, show authenticator module
if Result.success(false) == authenticated {
no token available, bailout
Sources/IDPLive/IDPInterceptor.swift:L56// [REQ:gemSpec_eRp_FdV:A_20167-02#4] no token available, bailout
throw HTTPClientError.authentication(error)
invalidate/delete unauthorized token
Sources/IDPLive/IDPInterceptor.swift:L62// [REQ:gemSpec_eRp_FdV:A_20167-02#5] invalidate/delete unauthorized token
// [REQ:BSI-eRp-ePA:O.Source_5#2] invalidate/delete unauthorized token
session.invalidateAccessToken()
A_20181-01 - E-Rezept-FdV: E-Rezept-Token als 2D-Code anzeigen - personenbezogene Daten
Das E-Rezept-FdV DARF NICHT im Anwendungsfall "E-Rezept-Token als 2D-Code anzeigen" personenbezogene Daten zusammen mit der Anzeige des 2D-Codes anzeigen. [<=]
Screen that presents the DataMatrix code for redeeming a prescription only contains some static texts and the image of the code.
Screen that presents the DataMatrix code for redeeming a prescription only
Sources/eRpApp/Screens/MatrixCode/MatrixCodeView.swift:L38// [REQ:gemSpec_eRp_FdV:A_20181-01#2] Screen that presents the DataMatrix code for redeeming a prescription only
// contains some static texts and the image of the code.
struct MatrixCodeView: View {
A_20182 - E-Rezept-FdV - Makelverbot
Das E-Rezept-FdV DARF NICHT zusätzliche Funktionalitäten enthalten, die die berufs- oder gewerbsmäßige Zuweisung und das Makeln von E-Rezepten unterstützen oder den Nutzer in seiner Entscheidung beeinflussen, welche elektronischen Verordnungen in welcher Apotheke eingelöst werden. [<=]
No advertisement or similar is presented in the app. Assigning a prescription to an pharmacy in only possible via the app’s pharmacy search. Pharmacy search results are only based on search term and filter criteria set by the user.
A_20285 - E-Rezept-FdV: Wettbewerbsneutralität für Darstellung Apotheken
Das E-Rezept-FdV MUSS Apotheken wettbewerbsneutral darstellen (bspw. Sortierung nach Alphabet oder Entfernung vom aktuellen Standort des Nutzers). [<=]
pharmacy order is resolved on server side
Sources/eRpApp/Screens/Pharmacy/Search/PharmacySearchDomain.swift:L411// [REQ:gemSpec_eRp_FdV:A_20285] pharmacy order is resolved on server side
state.pharmacies = pharmacies
pharmacy order is resolved on server side
Sources/eRpApp/Screens/Pharmacy/Search/PharmacySearchMapDomain.swift:L252// [REQ:gemSpec_eRp_FdV:A_20285] pharmacy order is resolved on server side
state.pharmacies = pharmacies.map {
Encryption of message to the Pharmacy is done with/for all provided certificates/recipients.
Encryption of message to the Pharmacy is done for all provided recipients
Sources/AVS/AVSCmsEncrypter.swift:L27// [REQ:gemSpec_eRp_FdV:A_22778-01#2] Encryption of message to the Pharmacy is done for all provided recipients
func cmsEncrypt(_ data: Data, recipients: [X509]) throws -> Data
Encryption of message to the Pharmacy is done with all provided
Sources/AVS/AVSCmsEncrypter.swift:L34// [REQ:gemSpec_Krypt:GS-A_4390] RSAES-OAEP with MGF1 implemented in sub-framework OpenSSL-swift
// [REQ:gemSpec_eRp_FdV:A_22778-01#3] Encryption of message to the Pharmacy is done with all provided
// certificates
// [REQ:gemSpec_eRp_FdV:A_22779-01#3] Encrypted message is of form of a PKCS#7 container (CMS)
// https://github.com/gematik/OpenSSL-Swift/blob/3c1ea91ba5abfefecfe3588815cb928d777e29ad/Sources/OpenSSL/CMS/CMSContentInfo.swift#L88
// swiftlint:disable:previous line_length
let cms = try CMSContentInfo.encryptPartial(data: data)
Encrypted message is of form of a PKCS#7 container (CMS)
Encrypted message is of form of a PKCS#7 container (CMS)
Sources/AVS/AVSMessageConverter.swift:L48// [REQ:gemSpec_eRp_FdV:A_22779-01#2] Encrypted message is of form of a PKCS#7 container (CMS)
// 1. Create a CMS AuthenticatedEnvelopedData structure with help from OpenSSL-swift
let cmsAuthEnvelopedData = try avsCmsEncrypter.cmsEncrypt(data, recipients: recipients)
Encrypted message is of form of a PKCS#7 container (CMS)
Sources/AVS/AVSCmsEncrypter.swift:L36// [REQ:gemSpec_Krypt:GS-A_4390] RSAES-OAEP with MGF1 implemented in sub-framework OpenSSL-swift
// [REQ:gemSpec_eRp_FdV:A_22778-01#3] Encryption of message to the Pharmacy is done with all provided
// certificates
// [REQ:gemSpec_eRp_FdV:A_22779-01#3] Encrypted message is of form of a PKCS#7 container (CMS)
// https://github.com/gematik/OpenSSL-Swift/blob/3c1ea91ba5abfefecfe3588815cb928d777e29ad/Sources/OpenSSL/CMS/CMSContentInfo.swift#L88
// swiftlint:disable:previous line_length
let cms = try CMSContentInfo.encryptPartial(data: data)
A_24525 - E-Rezept-FdV Tracking-Funktionen als Opt-in
Das E-Rezept-FdV MUSS, falls es Tracking-Funktionen implementiert, die Tracking-Daten mehrerer Nutzersessions verknüpfen, technisch sicherstellen, dass diese Tracking-Funktionen bei der Installation des FdV standardmäßig deaktiviert sind und nur nach expliziter Einwilligung durch den Versicherten als Nutzer des FdV aktiviert werden (Opt-in). [<=]
Whether analytics are enabled or not is persisted using UserDefaults. As these usere Defaults are empty upon installation, any call to bool(for:) will return to false. Opt-In for Analytics will be asked while the app onboarding runs.
Calculate if analytics are enabled or not.
Sources/eRpApp/Tracking/ContentSquareAnalyticsAdapter.swift:L55// [REQ:gemSpec_eRp_FdV:A_24525#2] Calculate if analytics are enabled or not.
userDefaults.appTrackingAllowed
A_24579 - E-Rezept-FdV: Apotheke suchen: neutrale Darstellung der Optionen
Das E-Rezept-FdV MUSS im Anwendungsfall "Apotheke suchen" die Apothekensuche und die Suchergebnisse so darstellen, dass Belieferungsoptionen nicht hervorgehoben oder bevorzugt werden. [<=]
See snapshot test (e.g. ‘testPharmacySearch_searchResultSuccess.iPhone8-light.png’) or the actual app to verify.
A_24857 - E-Rezept-FdV: Authentifizierung des Nutzers am E-Rezept-FdV zum Start des E-Rezept-FdV
Das E-Rezept-FdV MUSS den Nutzer beim Starten des E-Rezept-FdV am E-Rezept-FdV authentisieren. [<=]
Present the authentication window upon every startup
Sources/eRpApp/SceneDelegate.swift:L197// [REQ:BSI-eRp-ePA:O.Auth_8#2] Present the authentication window
// [REQ:gemSpec_eRp_FdV:A_24857#2] Present the authentication window upon every startup
// dispatching necessary to prevents keyboard not showing on iOS 16
DispatchQueue.main.async { [weak self] in
Sources/TrustStore/X509TrustStore.swift:L29
// [REQ:gemSpec_Krypt:A_24470]
// [REQ:gemSpec_eRp_FdV:A_20032-01]
// [REQ:gemSpec_eRp_FdV:A_25063]
// Category A: Cross root certificates
let rootCa: X509