Postinstallation steps to enable JWT security and disable mTLS between
subsystems.
About this task
JWT security is an alternative to using mTLS to secure inter-subsystem communication. For more
information on JWT security and when to use it, see: Enable JWT security instead of mTLS.
If you disable mTLS then you must enable JWT.
Note: It is not possible to use JWT on the V5
compatible gateway to analytics message flow. This flow is secured by mTLS, which cannot be
disabled.
Procedure
-
Describe the management CR to get the JWKS URL:
oc describe mgmt
Status:
Endpoints:
- name: jwksUrl
secretName: api-endpoint
type: API
uri: https://api.apic.acme.com/api/cloud/oauth2/certs
- For each portal, gateway, and analytics subsystem where you want to
use JWT security, update the CR corresponding to that subsystem, and set
spec.mtlsValidateClient
to false
, and
spec.jwksUrl
to the JWKS URL you identified in step 1.
spec:
...
mtlsValidateClient: false
jwksUrl: <JWKS URL>
Note: If you are using the OpenShift® top-level CR deployment, edit your APIConnectCluster
CR instead. Updates should be made in appropriate the
spec.<subsystem name>
section.
- Enable JWT on the gateway to analytics communications flow.
Enable the Use JWT switch for the registered gateway in the
Topology page of the Cloud
Manager UI.