Added description and aud as receiver supplied

1. With the OAuth decoupling, the transmitter would not know what should be the aud claim without receiver providing this information
2. Stream's description will help the admins of a multi stream transmitters distinguish between streams created for multiple receivers

Author: appsdesh

openid-sharedsignals-framework-1_0.md

@@ -806,7 +806,7 @@ iss
 
 aud
 
-> **Transmitter-Supplied**, A string or an array of strings containing an
+> **Receiver-Supplied**, A string or an array of strings containing an
   audience claim as defined in JSON Web Token (JWT){{RFC7519}} that identifies
   the Event Receiver(s) for the Event Stream. This property cannot be updated.
   If multiple Receivers are specified then the Transmitter SHOULD know that
@@ -865,6 +865,12 @@ min_verification_interval
   MAY respond with a 429 status code. An Event Transmitter SHOULD NOT respond
   with a 429 status code if an Event Receiver is not exceeding this frequency.
 
+description
+
+> **Receiver-Supplied**, An optinal string to describe the properties of the stream.
+  This is useful in multi stream systems to identify the stream for human actors. The
+  transmitter may truncate the string beyond allowed max length.
+
 TODO: consider adding a IANA Registry for stream configuration metadata, similar
 to Section 7.1.1 of {{RFC8414}}. This would allow other specs to add to
 the stream configuration.
@@ -904,6 +910,10 @@ Host: transmitter.example.com
 Authorization: Bearer eyJ0b2tlbiI6ImV4YW1wbGUifQo=
 
 {
+  "aud": [
+    "http://receiver.example.com/web",
+    "http://receiver.example.com/mobile"
+  ],
   "delivery": {
     "method": "urn:ietf:rfc:8935",
     "endpoint_url": "https://receiver.example.com/events"
@@ -912,7 +922,8 @@ Authorization: Bearer eyJ0b2tlbiI6ImV4YW1wbGUifQo=
     "urn:example:secevent:events:type_2",
     "urn:example:secevent:events:type_3",
     "urn:example:secevent:events:type_4"
-  ]
+  ],
+  "description" : "Stream for Receiver A using events type_2, type_3, type_4"
 }
 ~~~
 {: #figcreatestreamreq title="Example: Create Event Stream Request"}
@@ -947,7 +958,8 @@ Content-Type: application/json
   "events_delivered": [
     "urn:example:secevent:events:type_2",
     "urn:example:secevent:events:type_3"
-  ]
+  ],
+  "description" : "Stream for Receiver A using events type_2, type_3, type_4"
 }
 ~~~
 {: #figcreatestreamresp title="Example: Create Stream Response"}
@@ -1017,7 +1029,8 @@ Cache-Control: no-store
   "events_delivered": [
     "urn:example:secevent:events:type_2",
     "urn:example:secevent:events:type_3"
-  ]
+  ],
+  "description" : "Stream for Receiver A using events type_2, type_3, type_4"
 }
 ~~~
 {: title="Example: Read Stream Configuration Response" #figreadconfigresp}
@@ -1090,7 +1103,8 @@ Cache-Control: no-store
     "events_delivered": [
       "urn:example:secevent:events:type_2",
       "urn:example:secevent:events:type_3"
-    ]
+    ],
+    "description" : "Stream for Receiver A using events type_2, type_3, type_4"
   }
 ]
 ~~~
@@ -1192,6 +1206,7 @@ Authorization: Bearer eyJ0b2tlbiI6ImV4YW1wbGUifQo=
     "urn:example:secevent:events:type_3",
     "urn:example:secevent:events:type_4"
   ],
+  "description" : "Stream for Receiver B using events type_2, type_3, type_4"
 }
 ~~~
 {: title="Example: Update Stream Configuration Request" #figupdateconfigreq}
@@ -1227,7 +1242,8 @@ Cache-Control: no-store
   "events_delivered": [
     "urn:example:secevent:events:type_2",
     "urn:example:secevent:events:type_3"
-  ]
+  ],
+  "description" : "Stream for Receiver B using events type_2, type_3, type_4"
 }
 ~~~
 {: title="Example: Update Stream Configuration Response" #figupdateconfigresp}
@@ -1274,10 +1290,7 @@ Authorization: Bearer eyJ0b2tlbiI6ImV4YW1wbGUifQo=
 {
   "stream_id": "f67e39a0a4d34d56b3aa1bc4cff0069f",
   "iss": "https://tr.example.com",
-  "aud": [
-    "http://receiver.example.com/web",
-    "http://receiver.example.com/mobile"
-  ],
+  "aud": "http://receiver.example.com/stream",
   "delivery": {
     "method": "urn:ietf:rfc:8935",
     "endpoint_url": "https://receiver.example.com/events"
@@ -1286,7 +1299,8 @@ Authorization: Bearer eyJ0b2tlbiI6ImV4YW1wbGUifQo=
     "urn:example:secevent:events:type_2",
     "urn:example:secevent:events:type_3",
     "urn:example:secevent:events:type_4"
-  ]
+  ],
+  "description" : "Stream for Receiver C"
 }
 ~~~
 {: title="Example: Replace Stream Configuration Request" #figreplaceconfigreq}
@@ -1301,10 +1315,7 @@ Cache-Control: no-store
 {
   "stream_id": "f67e39a0a4d34d56b3aa1bc4cff0069f",
   "iss": "https://tr.example.com",
-  "aud": [
-    "http://receiver.example.com/web",
-    "http://receiver.example.com/mobile"
-  ],
+  "aud": "http://receiver.example.com/stream",
   "delivery": {
     "method": "urn:ietf:rfc:8935",
     "endpoint_url": "https://receiver.example.com/events"
@@ -1322,7 +1333,8 @@ Cache-Control: no-store
   "events_delivered": [
     "urn:example:secevent:events:type_2",
     "urn:example:secevent:events:type_3"
-  ]
+  ],
+  "description" : "Stream for Receiver C"
 }
 ~~~
 {: title="Example: Replace Stream Configuration Response" #figreplaceconfigresp}