Skip to content

Infisical is the open-source platform for securing secrets, certificates, access, and AI Agents.

Improve pki policies/profile custom extension docs

Carlos Monastyrskib205380e768e
diff --git a/docs/documentation/platform/pki/settings/policies.mdx b/docs/documentation/platform/pki/settings/policies.mdx
index 6e75ec2f00..cd7aa33e55 100644
--- a/docs/documentation/platform/pki/settings/policies.mdx
+++ b/docs/documentation/platform/pki/settings/policies.mdx
@@ -211,6 +211,8 @@ If you configure Custom Extensions, only the OIDs you list are permitted. Any ot
Infisical manages some extensions itself, so you can't set any OID under `2.5.29.` or authority information access here.
+Custom extensions need a certificate authority that can emit them: an internal CA, Microsoft ADCS, or AWS Private CA. A [certificate profile](/documentation/platform/pki/settings/profiles) built on any other certificate authority can't declare them. AWS Private CA also caps a certificate at three custom extensions.
+
## Next steps
diff --git a/docs/documentation/platform/pki/settings/profiles.mdx b/docs/documentation/platform/pki/settings/profiles.mdx
index 2ae1f2fc14..a428efd35e 100644
--- a/docs/documentation/platform/pki/settings/profiles.mdx
+++ b/docs/documentation/platform/pki/settings/profiles.mdx
@@ -68,6 +68,8 @@ Set default values for custom X.509 extensions. The [certificate policy](/docume
Set a value and Infisical uses it whenever the request doesn't supply one. Leave the value empty and the request supplies it, which suits a per-principal value such as an Active Directory security identifier. Either way, Infisical checks the value against the policy's rule for that OID.
+Mark an extension **Critical** when a client that can't process it must reject the certificate rather than ignore it. Leave it clear otherwise, which is the usual choice. Where an extension's own specification fixes criticality, or the certificate policy pins it for that OID, the checkbox is read only.
+
Enter the value as you want it read and Infisical encodes it. A few well-known extensions have a shape their specification fixes, so Infisical checks those as you type:
| Extension | Value to enter |