emqx_auth_ext_schema.hocon 1.8 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546
  1. emqx_auth_ext_schema {
  2. common_ssl_opts_schema_partial_chain.desc:
  3. """Enable or disable peer verification with partial_chain.
  4. When local verifies a peer certificate during the x509 path validation
  5. process, it constructs a certificate chain that starts with the peer
  6. certificate and ends with a trust anchor.
  7. By default, if it is set to `false`, the trust anchor is the
  8. Root CA, and the certificate chain must be complete.
  9. However, if the setting is set to `true` or `cacert_from_cacertfile`,
  10. the last certificate in `cacertfile` will be used as the trust anchor
  11. certificate (intermediate CA). This creates a partial chain
  12. in the path validation.
  13. Alternatively, if it is configured with `two_cacerts_from_cacertfile`,
  14. one of the last two certificates in `cacertfile` will be used as the
  15. trust anchor certificate, forming a partial chain. This option is
  16. particularly useful for intermediate CA certificate rotation.
  17. However, please note that it incurs some additional overhead, so it
  18. should only be used for certificate rotation purposes."""
  19. common_ssl_opts_schema_partial_chain.label:
  20. """Partial chain"""
  21. common_ssl_opts_verify_peer_ext_key_usage.desc:
  22. """Verify extended key usage in peer's certificate
  23. For additional peer certificate validation, the value defined here must present in the
  24. 'Extended Key Usage' of peer certificate defined in
  25. [rfc5280](https://www.rfc-editor.org/rfc/rfc5280#section-4.2.1.12).
  26. Allowed values are
  27. - `clientAuth`
  28. - `serverAuth`
  29. - `codeSigning`
  30. - `emailProtection`
  31. - `timeStamping`
  32. - `ocspSigning`
  33. - raw OID, for example: "OID:1.3.6.1.5.5.7.3.2" means `id-pk 2` which is equivalent to `clientAuth`
  34. Comma-separated string is also supported for validating more than one key usages.
  35. For example, `"serverAuth,OID:1.3.6.1.5.5.7.3.2"`"""
  36. common_ssl_opts_verify_peer_ext_key_usage.label:
  37. """Verify KeyUsage in cert"""
  38. }