Need Guidance on Notification Message Security OR Negotiation Protocol
- Vorherrschende Sprache
- Shell
- Sterne
- 25.7k
- Forks
- 2.6k
- Ø Merge
- 3 T. 6 Std.
- Gemergte PRs (30 T.)
- 16
Beschreibung
The guidance on notification security is overly broad - the protocol should either have very specific guidance, ie directly specifying a notification security mechanism, OR should have a clear mechanism for negotiating / signaling a notification security protocol (in the same way you have the general auth mechanism field ["bearer"]
> [Asymmetric keys](https://google.github.io/A2A/#/topics/push_notifications?id=asymmetric-keys)
> A pair of private and public keys can be generated using ECDSA, RSA etc. These can be generated by the notification server or the remote agent.
>
> If the key pair is generated by the notification server, (ex. APNS), the private key needs to be supplied to the agent. The notification server should keep the public key to verify incoming request payloads signed by the agent using the private key.
> If the key pair is generated by the agent. Then there can be two options:
> The public key is manually provided to the Notification Receiver.
> Or the public keys can be provided by the agent through JWKS protocol.
> Agents can sign request payload using the private key and provide the request signature as a header. Or they can use JWT protocol to generate a token and provide that as a signature. Benefit of JWT protocol would also be that it standardises common fields like keyId, request timestamp.
>
> [Symmetric keys](https://google.github.io/A2A/#/topics/push_notifications?id=symmetric-keys)
> A simpler method can be that both notification server and agents use the same shared key to sign and verify. The notification server verifies the signature by re-signing the payload with the key. Again JWT can be used to generate the signature token.
>
> Asymmetric keys have an advantage as only the agent knows the public key and hence less chances of the key being leaked.
Beitragsleitfaden
Rechercherichtung
The issue points to the push notifications documentation section on asymmetric and symmetric keys. Review the A2A protocol specification, particularly the notification security sections, to understand the current guidance. Determine whether to add specific security mechanisms or a negotiation protocol. Check for existing fields like the auth mechanism to see how signaling could be integrated.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Bereich
- documentation
- Issue-Typ
- Dokumentation
- Schwierigkeit
- 4/5
- Geschätzter Aufwand
- 3-5 Tage
- Aktivitätsstatus
- Veraltet
- Klarheit
- Muss geklärt werden
- Anfängerfreundlichkeit
- 35/100