Hinweis auf Erforderlichkeit der Prüfung des Authentifizierungslevels und der...

Hinweis auf Erforderlichkeit der Prüfung des Authentifizierungslevels und der authentifizierten Felder ergänzt.

models/application/applicant-organization.json

@@ -22,7 +22,7 @@
         "additionalProperties": false,
         "properties": {
           "identityInfo": {
-            "$ref": "../common/eID-natural-person.json"
+            "$ref": "../common/natural-person.json"
           },
           "authentificationInfo": {
             "$ref": "../common/authentification-info.json"
@@ -110,4 +110,4 @@
   "required": [
     "type"
   ]
-}
\ No newline at end of file
+}

models/application/applicant-person.json

@@ -15,7 +15,7 @@
       "$ref": "../common/authentification-info.json"
     },
     "identityInfo": {
-      "$ref": "../common/eID-natural-person.json"
+      "$ref": "../common/natural-person.json"
     },
     "contactInfo": {
       "$ref": "./applicant-contact-info.json"
@@ -74,4 +74,4 @@
       }
     }
   }
-}
\ No newline at end of file
+}

models/common/authentification-info.json

@@ -2,6 +2,14 @@
   "type": "object",
   "title": "Authentifikation",
   "additionalProperties": false,
+  "description": "Informationen über die Authentifikation der Person.",
+  "x-examples": {
+    "example-1": {
+      "assuranceLevel": "high",
+      "authentificationMethod": "eID",
+      "timestamp": "2020-03-03T12:38:23Z"
+    }
+  },
   "properties": {
     "assuranceLevel": {
       "type": "string",
@@ -9,29 +17,46 @@
         "low",
         "substantial",
         "high"
-      ]
+      ],
+      "description": "Vertrauensniveau"
     },
     "authentificationMethod": {
-      "type": "string"
+      "type": "string",
+      "description": "Methode der Authentifikation"
     },
     "authentificationToken": {
       "type": "object"
     },
     "timestamp": {
       "type": "string",
-      "format": "date-time"
+      "format": "date-time",
+      "description": "Zeitstempel der Authentifikation"
+    },
+    "authenticatedFields": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "description": "Liste der authentifizierten Felder in `identityInfo`",
+      "items": {
+        "type": "string",
+        "enum": [
+          "placeOfBirth",
+          "dateOfBirth",
+          "gender",
+          "nationality",
+          "artisticName",
+          "doctoralDegrees",
+          "birthName",
+          "givenName",
+          "familyName",
+          "placeOfResidence"
+        ]
+      }
     }
   },
   "required": [
     "assuranceLevel",
-    "authentificationMethod"
-  ],
-  "description": "Informationen über die Authentifikation der Person.",
-  "x-examples": {
-    "example-1": {
-      "assuranceLevel": "high",
-      "authentificationMethod": "eID",
-      "timestamp": "2020-03-03T12:38:23Z"
-    }
-  }
+    "authentificationMethod",
+    "authenticatedFields"
+  ]
 }
\ No newline at end of file

models/common/eID-natural-person.json → models/common/natural-person.json

 {
   "title": "Identity Information",
-  "description": "Informationen aus dem eID Funktion des Personalausweises",
+  "description": "Informationen zu einer natürlichen Person. Wichtig: Wenn einzelne Felder für einen elektronischen Identitätsnachweis als Schriftform-Ersatz genutzt werden, MUSS geprüft werden, ob im Objekt `authentificationInfo` ein entsprechendes Authentifizierungslevel angegeben ist. Zusätzlich MUSS geprüft werden, ob die genutzten Felder im Object `authenticatedFields` enthalten sind.",
   "type": "object",
   "x-examples": {
     "example-1": {
@@ -64,4 +64,4 @@
       "$ref": "./address-national.json"
     }
   }
-}
\ No newline at end of file
+}