NMX Manager (NMX-M) Documentation v85.1.0009: PS Level

Mutual TLS (mTLS) Configuration

Mutual TLS ( mTLS) , is a security protocol that ensures both the client and server in a network communication authenticate each other using certificates before establishing a connection. This is an enhancement over standard Transport Layer Security (TLS), where only the server is authenticated by the client.

Note

In this release, mTLS is enabled by default in NMX-M. NMX-M communicates with both NMX-T and NMX-C using mTLS over gRPC, therefore, please make sure that mTLS is also configured on both NMX-T and NMX-C.

The procedures below must be performed after the NMX-M deployment.

Note

Make sure to generate and provide the location of the certificates when scripts prompt for it before running the following script.

Note

Ensure that the certificates used by NMX-M, NMX-T, and NMX-C are either issued by the same CA or signed by a CA that is trusted and approved.

  1. From the Ansible folder run the following command.

    Copy
    Copied!
                

    #update_certs.sh <ip of the VM>

  2. Select 'yes' when prompted to reboot the southbound-gateway.

The below is an output sample. Please ensure to provide the certificate path specific to your environment.

image-2024-8-23_12-22-0-version-1-modificationdate-1741555963357-api-v2.png

Note

This step is required only if authentication is failing due to a SAN header check.

  1. To bypass the SAN header check, use the following script to update the mTLS configuration and skip SAN validation.

    Copy
    Copied!
                

    #update_mtls_config.sh <ip of the VM>

  2. Select 'enable' when prompted to enable mTLS.

  3. Select 'yes' when prompted to skip SAN validation in mTLS configuration.

  4. Select 'yes' when prompted to reboot the southbound-gateway.

The below is an output sample.

image-2024-8-23_12-33-22-version-1-modificationdate-1741555963107-api-v2.png

© Copyright 2025, NVIDIA. Last updated on Mar 10, 2025.