Document JWK keys export/import with examples

[olegbespalov]

What?

This change documents the newly added support of jwk format for the webcrypto's keys export/import, which was done in grafana/xk6-webcrypto#61

It also adds examples that showcase the data tackling (static and base64 encoded) since we learned that it could not always be straightforward for our customers.

Checklist

• I have used a meaningful title for the PR.
• I have described the changes I've made in the "What?" section above.
• I have performed a self-review of my changes.
• I have run the make docs command locally and verified that the changes look good.
• I have made my changes in the docs/sources/next folder of the documentation.

Related PR(s)/Issue(s)

• JWK Implementation for import/export xk6-webcrypto#61
• Interoperability with javax.crypto xk6-webcrypto#63
• Import keys with the decryption examples xk6-webcrypto#65

[heitortsergent]

Some minor suggestions, overall it looks great! 🤓

[heitortsergent]

I don't think I understand the meaning here, could you expand a little bit on what you are trying to say here? 🤓 Is it that this data would not usually be transmitted?

[olegbespalov]

I was trying to point out that in this example, transmittedData is the data that you got from somewhere, let's say in a response body, etc

[heitortsergent]

Ooh I see. In that case, maybe we could reword it to: "this is data usually transmitted over the network".

Or include response body there as well as an example: "this is data usually transmitted over the network, such as a response body"

[olegbespalov]

Now, I'm wondering if we should drop that part 😅

Actually, doesn't matter how data is received, essential details (in this example) that transmitted data is a concatenation of an initialization vector and encrypted data; some people could use this approach, that's why I used it to bring examples more real-world close

[heitortsergent]

That's a fair point! Actually, what if we added this context on line 81? Something along the lines of:

"This example demonstrates how to import a static raw key and decrypt some transmitted data in base64. The transmitted data in this example represents an initialization vector and encoded data, and in a real-world scenario, it can be a response body or other data received from a request."

It would keep the code sample concise but still give context to users.

[olegbespalov]

Adjusted ✔️

[heitortsergent]

Left a comment to highlight the change we talked about in the other thread, everything else looks good! 🚢