Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document KMS policy options #1283

Open
marktheunissen opened this issue Jul 25, 2024 · 2 comments
Open

Document KMS policy options #1283

marktheunissen opened this issue Jul 25, 2024 · 2 comments
Labels
investigating triage Needs triage and scheduling

Comments

@marktheunissen
Copy link
Contributor

These actions:

  • admin:KMSCreateKey
  • admin:KMSKeyStatus

... are documented on this page, however it's missing the kms actions from here: https://github.com/minio/pkg/blob/main/policy/kms-action.go

The MinIO server currently obeys the following:

  • KMSStatusAction kms:Status
  • KMSMetricsAction kms:Metrics
  • KMSAPIAction kms:API
  • KMSVersionAction kms:Version
  • KMSCreateKeyAction kms:CreateKey
  • KMSListKeysAction kms:ListKeys
  • KMSKeyStatusAction kms:KeyStatus

This PR: minio/minio#20079 added the ability for those KMS actions to be restricted by resource name (with wildcard support). There is an example policy on the PR description.

There is a bit of "overlap" of functionality here between the two "admin" kms actions and the "kms" actions, I believe they are separate API endpoints but it might be worth double checking the history of these.

This ticket is to document the kms actions and how they can be used, since these are MinIO specific.

@marktheunissen marktheunissen added the triage Needs triage and scheduling label Jul 25, 2024
@ravindk89
Copy link
Collaborator

Hm - are these perhaps related to MinKMS specifically @aead ?

If so we need to discuss if these envvars belong here or in the MinIO Enterprise docs, as the expectation is that MinKMS-related configs should apply only to Enterprise MinIO binary

@ravindk89
Copy link
Collaborator

@aead @zveinn ping on the above!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
investigating triage Needs triage and scheduling
Projects
None yet
Development

No branches or pull requests

2 participants