Specify auth type property; clarify authorization property and make c…

…ase consistent; remove incorrect bearer prefix; remove non-normative S3 reference
International-Data-Spaces-Association · Feb 8, 2024 · 33655e5 · 33655e5
1 parent bffa740
commit 33655e5
Show file tree

Hide file tree

Showing 5 changed files with 46 additions and 16 deletions.
diff --git a/releases/v0.8/transfer/message/transfer-request-message.json b/releases/v0.8/transfer/message/transfer-request-message.json
@@ -3,16 +3,21 @@
   "@type": "dspace:TransferRequestMessage",
   "dspace:consumerPid": "urn:uuid:32541fe6-c580-409e-85a8-8a9a32fbe833",
   "dspace:agreementId": "urn:uuid:e8dc8655-44c2-46ef-b701-4cffdc2faa44",
-  "dct:format": "dspace:S3_AWS_PUSH",
+  "dct:format": "example:HTTP_PUSH",
   "dspace:dataAddress": {
     "@type": "dspace:DataAddress",
     "dspace:endpointType": "https://w3id.org/idsa/v4.1/HTTP",
     "dspace:endpoint": "http://example.com",
     "dspace:endpointProperties": [
       {
         "@type": "dspace:EndpointProperty",
-        "dspace:name": "Authorization",
-        "dspace:value": "Bearer TOKEN-ABCDEFG"
+        "dspace:name": "authorization",
+        "dspace:value": "TOKEN-ABCDEFG"
+      },
+      {
+        "@type": "dspace:EndpointProperty",
+        "dspace:name": "authType",
+        "dspace:value": "bearer"
       }
     ]
   },

diff --git a/transfer/message/example/transfer-request-message.json b/transfer/message/example/transfer-request-message.json
@@ -3,16 +3,21 @@
   "@type": "dspace:TransferRequestMessage",
   "dspace:consumerPid": "urn:uuid:32541fe6-c580-409e-85a8-8a9a32fbe833",
   "dspace:agreementId": "urn:uuid:e8dc8655-44c2-46ef-b701-4cffdc2faa44",
-  "dct:format": "dspace:S3_AWS_PUSH",
+  "dct:format": "example:HTTP_PUSH",
   "dspace:dataAddress": {
     "@type": "dspace:DataAddress",
     "dspace:endpointType": "https://w3id.org/idsa/v4.1/HTTP",
     "dspace:endpoint": "http://example.com",
     "dspace:endpointProperties": [
       {
         "@type": "dspace:EndpointProperty",
-        "dspace:name": "Authorization",
-        "dspace:value": "Bearer TOKEN-ABCDEFG"
+        "dspace:name": "authorization",
+        "dspace:value": "TOKEN-ABCDEFG"
+      },
+      {
+        "@type": "dspace:EndpointProperty",
+        "dspace:name": "authType",
+        "dspace:value": "bearer"
       }
     ]
   },

diff --git a/transfer/message/example/transfer-start-message.json b/transfer/message/example/transfer-start-message.json
@@ -10,8 +10,13 @@
     "dspace:endpointProperties": [
       {
         "@type": "dspace:EndpointProperty",
-        "dspace:name": "Authorization",
-        "dspace:value": "Bearer TOKEN-ABCDEFG"
+        "dspace:name": "authorization",
+        "dspace:value": "TOKEN-ABCDEFG"
+      },
+      {
+        "@type": "dspace:EndpointProperty",
+        "dspace:name": "authType",
+        "dspace:value": "bearer"
       }
     ]
   }

diff --git a/transfer/transfer.process.binding.https.md b/transfer/transfer.process.binding.https.md
@@ -110,16 +110,21 @@ Authorization: ...
   "@type": "dspace:TransferRequestMessage",
   "dspace:consumerPid": "urn:uuid:32541fe6-c580-409e-85a8-8a9a32fbe833",
   "dspace:agreementId": "urn:uuid:e8dc8655-44c2-46ef-b701-4cffdc2faa44",
-  "dct:format": "dspace:S3_AWS_PUSH",
+  "dct:format": "example:HTTP_PUSH",
   "dspace:dataAddress": {
     "@type": "dspace:DataAddress",
     "dspace:endpointType": "https://w3id.org/idsa/v4.1/HTTP",
     "dspace:endpoint": "http://example.com",
     "dspace:endpointProperties": [
       {
         "@type": "dspace:EndpointProperty",
-        "dspace:name": "Authorization",
-        "dspace:value": "Bearer TOKEN-ABCDEFG"
+        "dspace:name": "authorization",
+        "dspace:value": "TOKEN-ABCDEFG"
+      },
+      {
+        "@type": "dspace:EndpointProperty",
+        "dspace:name": "authType",
+        "dspace:value": "bearer"
       }
     ]
   },
@@ -170,8 +175,13 @@ Authorization: ...
     "dspace:endpointProperties": [
       {
         "@type": "dspace:EndpointProperty",
-        "dspace:name": "Authorization",
-        "dspace:value": "Bearer TOKEN-ABCDEFG"
+        "dspace:name": "authorization",
+        "dspace:value": "TOKEN-ABCDEFG"
+      },
+      {
+        "@type": "dspace:EndpointProperty",
+        "dspace:name": "authType",
+        "dspace:value": "bearer"
       }
     ]
   }
@@ -303,8 +313,13 @@ Authorization: ...
     "dspace:endpointProperties": [
       {
         "@type": "dspace:EndpointProperty",
-        "dspace:name": "Authorization",
-        "dspace:value": "Bearer TOKEN-ABCDEFG"
+        "dspace:name": "authorization",
+        "dspace:value": "TOKEN-ABCDEFG"
+      },
+      {
+        "@type": "dspace:EndpointProperty",
+        "dspace:name": "authType",
+        "dspace:value": "bearer"
       }
     ]
   }

diff --git a/transfer/transfer.process.protocol.md b/transfer/transfer.process.protocol.md
@@ -185,4 +185,4 @@ The Transfer Error is an object returned by a [Consumer](../model/terminology.md
 | `consumerPid` | UUID          | The TF unique id on [Consumer](../model/terminology.md#consumer) side. |
 | `providerPid` | UUID          | The TF unique id on [Provider](../model/terminology.md#provider) side. |
 | `code`        | string        | An optional implementation-specific error code.                        |
-| `reasons`     | Array[object] | An optional array of implementation-specific error objects.            |
+| `reasons`     | Array[object] | An optional array of implementation-specific error objects.            |