cisco IOS XE 17.16.x — OS Installation Service

// Response from the target about whether it can generate a CSR with the given // parameters. message CanGenerateCSRResponse { bool can_generate = 4; } Mutual Authentication Mutual authentication is a two-way authentication; two parties authenticate each other at the same time. To enable mutual-authentication, use the gnmi-yang secure-peer-verify-trustpoint command. If this command is not enabled, the authentication service validates the gNMI client against all the existing trustpoints and the contents of the trustpool. Rotation of the CA certificates for mutual authentication requires the client to present a new bundle to the target device, and the old bundle to be removed.

However, the CA certificates reside in a trustpool, and cannot be selectively deleted from the trustpool. Bootstrapping with Certificate Service After installing gNOI certificates, bootstrapping is used to configure or operate a target device. When a target device does not have any pre-existing certificates, bootstrapping allows the installing of certificates by using the gNOI Certificate Management Service. After the certificate installation, the device is capable of establishing secure gNOI or gNMI connections. This process assumes a pre-existing secure environment. To enable gNMI bootstrapping, use the gnxi secure-init command.

The gNOI Certificate Management Service must be installed before bootstapping. Note The gNOI Certificate Management Service has two states. These states are supported by both the gNOI service and the gNMI service. • Default/Encrypted: gNOI and gNMI on the device use a self-signed (default) certificate that the client does not verify; the certificate does not require authentication. In this state, only the gNOI certificate service is enabled on the target device. • Provisioned: gNOI and gNMI on the device use an installed certificate that is verified by the client, and the client presents its certificate, which the device verifies against its certificate store.

The device verifies the client certificate only if mutual authentication is enabled. OS Installation Service The OS installation service defines a gNOI API that is used for installation. The OS installation service is supported in the gNOI protocol. This service provides an interface for the installation of an OS on a device. It supports the following three RPCs: Model-Driven Programmability Mutual Authentication Programmability Configuration Guide, Cisco IOS XE 17.16.x 282