a2aproject / a2aproject/A2A

Need Guidance on Notification Message Security OR Negotiation Protocol

Offen
#123 1 Kommentar 0 Reaktionen 1 zugewiesene Person Beansprucht von @kthota-g Auf GitHub ansehen
Backlog
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

Beitragsleitfaden öffnen

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

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.