> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/rms/llms.txt.

# Switch TLS and Certificates


Install switch mTLS certificates and disable switch mTLS.

| RPC | Execution | Summary |
| --- | --- | --- |
| [`ConfigureSwitchCertificate`](#configureswitchcertificate) | Asynchronous, parent and child jobs | ConfigureSwitchCertificate initiates asynchronous RMS-configured TLS certificate installation on all supplied switches. |
| [`BatchDisableSwitchMtls`](#batchdisableswitchmtls) | Asynchronous, parent and child jobs | BatchDisableSwitchMtls asynchronously disables mTLS for selected services on caller-supplied switches. |

For definitions of execution modes and job polling, refer to [Async jobs](/rms/api-reference/async-jobs).

## ConfigureSwitchCertificate

`rack_manager.RackManager/ConfigureSwitchCertificate`

ConfigureSwitchCertificate initiates asynchronous RMS-configured TLS certificate installation on all supplied switches. Returns a parent job ID for tracking overall progress, along with individual child job IDs per switch.

| Property | Value |
| --- | --- |
| Execution | **Asynchronous, parent and child jobs.** The response returns a parent job ID and the work continues after the call returns. |
| Job tracking | Poll [`GetConfigureSwitchCertificateJobStatus`](/rms/api-reference/rpcs/utility-jobs#getconfigureswitchcertificatejobstatus) with the job ID in `response.job_id`. Per-node child job IDs are in `jobs`. |
| Target | **Caller-supplied nodes.** The request carries each node's endpoints and credentials, and RMS does not store them. |
| Behavior details | [Operations guide](/rms/documentation/operations/switch-management) |
| Protobuf reference | [`ConfigureSwitchCertificate`](/rms/api-reference/protobuf-reference/rack-manager/rack-manager/rack-manager-configure-switch-certificate) |

**Request:** [`ConfigureSwitchCertificateRequest`](/rms/api-reference/types/rack-manager#configureswitchcertificaterequest)

| Field | Type | Description |
| --- | --- | --- |
| `nodes` | [`NodeSet`](/rms/api-reference/types/rack-manager#nodeset) | Switch nodes to update |
| `services` | repeated [`SwitchService`](/rms/api-reference/types/rack-manager#switchservice) | Switch services to protect with the installed mTLS certificates |
| `test_hello` | `bool` | Test Hello Connection over mTLS |
| `domain` | optional `string` | Optional site selector; defaults to --default-switch-domain when unset. |

**Response:** [`ConfigureSwitchCertificateResponse`](/rms/api-reference/types/rack-manager#configureswitchcertificateresponse)

| Field | Type | Description |
| --- | --- | --- |
| `response` | [`NodeBatchResponse`](/rms/api-reference/types/rack-manager#nodebatchresponse) | response.job_id is parent job id |
| `jobs` | repeated [`ConfigureSwitchCertificateJobInfo`](/rms/api-reference/types/rack-manager#configureswitchcertificatejobinfo) | Individual child job ID per switch |

**Errors:** Refer to [Conventions](/rms/api-reference/conventions#error-handling) for how RMS reports failures.

<Accordion title="Example request">

Replace each `<placeholder>` with a real value. Define `RMS_GRPCURL_FLAGS` and `RMS_ADDR` as described in [Getting started](/rms/api-reference/getting-started#call-an-rpc-with-grpcurl).

```bash
grpcurl $RMS_GRPCURL_FLAGS \
  -d '{
  "nodes": {
    "nodes": [
      {
        "node_id": "<node_id>",
        "rack_id": "<rack_id>",
        "type": "COMPUTE_GB200_NVIDIA",
        "bmc_endpoint": {
          "interface": {
            "ip_address": "<ip_address>",
            "mac_address": "<mac_address>",
            "host_name": "<host_name>"
          },
          "port": 0,
          "credentials": {
            "user_pass": {
              "username": "<username>",
              "password": "<password>"
            }
          }
        },
        "host_endpoint": {
          "interface": {
            "ip_address": "<ip_address>",
            "mac_address": "<mac_address>",
            "host_name": "<host_name>"
          },
          "port": 0,
          "credentials": {
            "user_pass": {
              "username": "<username>",
              "password": "<password>"
            }
          }
        },
        "node_descriptor": {
          "attributes": {
            "<key>": "<attributes>"
          }
        },
        "additional_host_endpoints": [
          {
            "interface": {
              "ip_address": "<ip_address>",
              "mac_address": "<mac_address>",
              "host_name": "<host_name>"
            },
            "port": 0,
            "credentials": {
              "user_pass": {
                "username": "<username>",
                "password": "<password>"
              }
            }
          }
        ]
      }
    ]
  },
  "services": [
    "SWITCH_SERVICE_NVUE_API"
  ],
  "test_hello": false,
  "domain": "<domain>"
}' \
  "$RMS_ADDR" rack_manager.RackManager/ConfigureSwitchCertificate
```

The `rack_manager_client` test client offers an equivalent command:

```bash
rack_manager_client <host> <port> switch configure_certificate <switches.csv> --service <service>
```

</Accordion>

## BatchDisableSwitchMtls

`rack_manager.RackManager/BatchDisableSwitchMtls`

BatchDisableSwitchMtls asynchronously disables mTLS for selected services on caller-supplied switches. Returns a parent job ID for GetJobStatus.

| Property | Value |
| --- | --- |
| Execution | **Asynchronous, parent and child jobs.** The response returns a parent job ID and the work continues after the call returns. |
| Job tracking | Poll [`GetJobStatus`](/rms/api-reference/rpcs/utility-jobs#getjobstatus) with the job ID in `response.job_id`. Set `include_child_job_states` on `GetJobStatus` to read per-node child jobs. |
| Target | **Caller-supplied nodes.** The request carries each node's endpoints and credentials, and RMS does not store them. |
| Behavior details | [Operations guide](/rms/documentation/operations/switch-management) |
| Protobuf reference | [`BatchDisableSwitchMtls`](/rms/api-reference/protobuf-reference/rack-manager/rack-manager/rack-manager-batch-disable-switch-mtls) |

**Request:** [`BatchDisableSwitchMtlsRequest`](/rms/api-reference/types/rack-manager#batchdisableswitchmtlsrequest)

| Field | Type | Description |
| --- | --- | --- |
| `nodes` | [`NodeSet`](/rms/api-reference/types/rack-manager#nodeset) | Target switch identities and direct connection information |
| `services` | repeated [`SwitchService`](/rms/api-reference/types/rack-manager#switchservice) | Switch services that should stop requiring mTLS |

**Response:** [`BatchDisableSwitchMtlsResponse`](/rms/api-reference/types/rack-manager#batchdisableswitchmtlsresponse)

| Field | Type | Description |
| --- | --- | --- |
| `response` | [`NodeBatchResponse`](/rms/api-reference/types/rack-manager#nodebatchresponse) | response.job_id is the parent job ID for GetJobStatus |

**Errors:** Refer to [Conventions](/rms/api-reference/conventions#error-handling) for how RMS reports failures.

<Accordion title="Example request">

Replace each `<placeholder>` with a real value. Define `RMS_GRPCURL_FLAGS` and `RMS_ADDR` as described in [Getting started](/rms/api-reference/getting-started#call-an-rpc-with-grpcurl).

```bash
grpcurl $RMS_GRPCURL_FLAGS \
  -d '{
  "nodes": {
    "nodes": [
      {
        "node_id": "<node_id>",
        "rack_id": "<rack_id>",
        "type": "COMPUTE_GB200_NVIDIA",
        "bmc_endpoint": {
          "interface": {
            "ip_address": "<ip_address>",
            "mac_address": "<mac_address>",
            "host_name": "<host_name>"
          },
          "port": 0,
          "credentials": {
            "user_pass": {
              "username": "<username>",
              "password": "<password>"
            }
          }
        },
        "host_endpoint": {
          "interface": {
            "ip_address": "<ip_address>",
            "mac_address": "<mac_address>",
            "host_name": "<host_name>"
          },
          "port": 0,
          "credentials": {
            "user_pass": {
              "username": "<username>",
              "password": "<password>"
            }
          }
        },
        "node_descriptor": {
          "attributes": {
            "<key>": "<attributes>"
          }
        },
        "additional_host_endpoints": [
          {
            "interface": {
              "ip_address": "<ip_address>",
              "mac_address": "<mac_address>",
              "host_name": "<host_name>"
            },
            "port": 0,
            "credentials": {
              "user_pass": {
                "username": "<username>",
                "password": "<password>"
              }
            }
          }
        ]
      }
    ]
  },
  "services": [
    "SWITCH_SERVICE_NVUE_API"
  ]
}' \
  "$RMS_ADDR" rack_manager.RackManager/BatchDisableSwitchMtls
```

The `rack_manager_client` test client offers an equivalent command:

```bash
rack_manager_client <host> <port> switch disable_mtls <switches.csv> --service <service>
```

</Accordion>