open-vault/website/content/docs/secrets/pki
Alexander Scheel 1e6730573c
Add proof possession revocation for PKI secrets engine (#16566)
* Allow Proof of Possession based revocation

Revocation by proof of possession ensures that we have a private key
matching the (provided or stored) certificate. This allows callers to
revoke certificate they own (as proven by holding the corresponding
private key), without having an admin create innumerable ACLs around
the serial_number parameter for every issuance/user.

We base this on Go TLS stack's verification of certificate<->key
matching, but extend it where applicable to ensure curves match, the
private key is indeed valid, and has the same structure as the
corresponding public key from the certificate.

This endpoint currently is authenticated, allowing operators to disable
the endpoint if it isn't desirable to use, via ACL policies.

Signed-off-by: Alexander Scheel <alex.scheel@hashicorp.com>

* Clarify error message on ParseDERKey

Signed-off-by: Alexander Scheel <alex.scheel@hashicorp.com>

* Add changelog entry

Signed-off-by: Alexander Scheel <alex.scheel@hashicorp.com>

* Leave revoke-with-key authenticated

After some discussion, given the potential for DoS (via submitting a lot
of keys/certs to validate, including invalid pairs), it seems best to
leave this as an authenticated endpoint. Presently in Vault, there's no
way to have an authenticated-but-unauthorized path (i.e., one which
bypasses ACL controls), so it is recommended (but not enforced) to make
this endpoint generally available by permissive ACL policies.

Signed-off-by: Alexander Scheel <alex.scheel@hashicorp.com>

* Add API documentation on PoP

Signed-off-by: Alexander Scheel <alex.scheel@hashicorp.com>

* Add acceptance tests for Proof of Possession

Signed-off-by: Alexander Scheel <alex.scheel@hashicorp.com>

* Exercise negative cases in PoP tests

Signed-off-by: Alexander Scheel <alex.scheel@hashicorp.com>

Signed-off-by: Alexander Scheel <alex.scheel@hashicorp.com>
2022-08-16 14:01:26 -04:00
..
considerations.mdx Add proof possession revocation for PKI secrets engine (#16566) 2022-08-16 14:01:26 -04:00
index.mdx Add note about X.509 SHA-1 deprecation to relevant plugins (#15672) 2022-06-01 12:41:11 -07:00
quick-start-intermediate-ca.mdx Fix Learn->Tutorial in internal PKI docs (#15531) 2022-05-23 11:53:13 -04:00
quick-start-root-ca.mdx Fix Learn->Tutorial in internal PKI docs (#15531) 2022-05-23 11:53:13 -04:00
rotation-primitives.mdx Fix Learn->Tutorial in internal PKI docs (#15531) 2022-05-23 11:53:13 -04:00
setup.mdx Fix Learn->Tutorial in internal PKI docs (#15531) 2022-05-23 11:53:13 -04:00