awslabs / aws-encryption-sdk-specification

AWS Encryption SDK Specification
Other
30 stars 27 forks source link

docs: add change doc to describe key namespaces, names, provider IDs, and provider info #135

Closed mattsb42-aws closed 4 years ago

mattsb42-aws commented 4 years ago

Issue #, if available: resolves: #21 resolves: #47

Description of changes:

This change introduces definitions of the terms "key namespace", "key name", "provider ID", and "provider info", as well as how they relate to each other.

NOTE: I have not yet altered the keyring spec doc. That needs to happen before this merges.

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

mattsb42-aws commented 4 years ago

Thinking this over again today, I've gone with "key name/namespace are always strings" and "provider ID/info are always bytes", and adjusted accordingly.