Feedback on Encryption of Information in DWN.

Type

Content Issue

Feedback

Summary

The documentation for Decentralized Web Nodes (DWN) provides insightful details about their functionalities and specifications. However, there's a need to clarify and expand on the encryption aspect of the data sent to a DWN.

Feedback Details

In the section discussing the messaging structure for DWN communication, it is mentioned that messages include an "encryption" field with the value "jwe," indicating the use of JSON Web Encryption. While this is a positive security measure, it would be beneficial to users if the documentation elaborated on this aspect.

{ // Message

  // ....

    "encryption": "jwe",

 // ....

  }
}

Suggested Action

[ ] Clarify Encryption Details: Provide additional information in the documentation about the encryption methods used, explaining how JSON Web Encryption (JWE) is implemented in the context of DWN.
[ ] Highlight Security Benefits: Emphasize the significance of encryption in ensuring the confidentiality and integrity of data during transmission to and from a DWN. This could include any specific security protocols or algorithms used.
[ ] Cross-Reference to DWN Spec: Suggest users refer to the DWN specification for a more detailed explanation of encryption-related fields and mechanisms.

Expected Outcome:

Improved clarity on the encryption measures employed in DWN communication will enhance the user understanding of security practices within the decentralized system.

Screenshots

Paste relevant images or screenshots here

developer.tbd.website URL

https://developer.tbd.website/docs/web5/learn/decentralized-web-nodes

Browser

No response

Relevant log output

No response

TBD54566975 / developer.tbd.website