kalix-jvm-sdk icon indicating copy to clipboard operation
kalix-jvm-sdk copied to clipboard

Spring ACLs documentation on accessing principle confusing

Open jroper opened this issue 1 year ago • 1 comments

The documentation on accessing principals in ACLs is confusing. There are two separate sections on it, one that says you can access it through the _kalix-src-svc and _kalix-src header, and the other that says you can access it through Metadata.principals(). It's not clear at all that these are referring to the same thing, moreover, the headers we shouldn't really be documenting at all. We should just describe how to access the principal using the Metadata.principals() call. All _kalix-* prefixed headers should be considered internal implementation details, there should always be a corresponding API to work with them, they should never need to be documented directly.

jroper avatar Oct 23 '23 00:10 jroper

For the record, the Protobuf docs as well. https://docs.kalix.io/java-protobuf/access-control.html#_programmatically_accessing_principals

octonato avatar Oct 23 '23 11:10 octonato