Merge branch 'adjust-hmac-headers-for-callbacks' into 'main'

Add missing HMAC headers for callbacks

See merge request fit-connect/api!118

spec/callbacks/new-events.yaml

@@ -3,6 +3,9 @@
     summary: Callback für neue Events im Event Log
     description: >
       Bei neuen Events im Event Log wird ein Zustellpunkt mit Hilfe dieses Callbacks benachrichtigt. Voraussetzung ist die vorherige Konfiguration der [Callback-URL](https://docs.fitko.de/fit-connect/getting-started/receiving/query#callback).
+    parameters:
+      - $ref: '../headers/hmac-cb-authentication.yaml'
+      - $ref: '../headers/hmac-cb-timestamp.yaml'
     requestBody:
       required: true
       content:

spec/callbacks/new-submissions.yaml

@@ -3,6 +3,9 @@
     summary: Callback für eine neue Einreichung
     description: >
       Bei neue eintreffenden Submissions wird ein Zustellpunkt mit Hilfe dieses Callbacks benachrichtigt. Voraussetzung ist die vorherige Konfiguration der [Callback-URL](https://docs.fitko.de/fit-connect/getting-started/receiving/query#callback).
+    parameters:
+      - $ref: '../headers/hmac-cb-authentication.yaml'
+      - $ref: '../headers/hmac-cb-timestamp.yaml'
     requestBody:
       required: true
       content:

spec/headers/hmac-cb-authentication.yaml

+in: header
+name: 'X-Callback-Authentication'
+required: true
+description: Der Message Authentication Code des übertragenen Callbacks
+schema:
+  type: string

spec/headers/hmac-cb-timestamp.yaml

+in: header
+name: 'X-Callback-Timestamp'
+required: true
+description: Der Timestamp des Message Authentication Code.
+schema:
+  type: integer

spec/submission-api.yaml

@@ -79,6 +79,10 @@ components:
       $ref: './parameters/pagination/limit.yaml'
     offset:
       $ref: './parameters/pagination/offset.yaml'
+    X-Callback-Authentication:
+      $ref: './headers/hmac-cb-authentication.yaml'
+    X-Callback-Timestamp:
+      $ref: './headers/hmac-cb-timestamp.yaml'
 
   schemas:
     Submission: