Cisco Systems Comprehensive Cisco Configuration Guide for IOS XE REST API Management

Chapter 14 Configuring Support for Management Using the REST API

Enabling REST API Support Using the Cisco IOS XE CLI

Configuring HTTPS Support for the REST API Using the Cisco IOS XE CLI

The Cisco CSR 1000V REST API requires HTTPS server support. Beginning with Cisco IOS XE Release 3.11S, HTTPS server support is enabled by default and no additional configuration is required. However, if using Cisco IOS XE Release 3.10S, you must manually configure HTTPS support for the REST API in the following situations:

•If you did not specify the Enable HTTPS Server option when deploying the OVA.

•If you installed the Cisco CSR 1000V using the .iso file.

Note The HTTPS session must have an identity certificate. For more information, see the “HTTPS-HTTP Server and Client with SSL 3.0” section of the HTTP Services Configuration Guide, Cisco IOS XE Release 3S.

SUMMARY STEPS

1.enable

2.configure terminal

3.ip http secure-server

4.transport-map type persistent webui transport-map-name

5.secure-server

6.transport type persistent webui input transport-map-name

DETAILED STEPS

	Command or Action	Purpose
Step 1	enable	Enables privileged EXEC mode.
		• Enter your password if prompted.
	Example:
	router> enable
Step 2	configure terminal	Enters global configuration mode.
	Example:
	router# configure terminal
Step 3	ip http secure-server	Enables HTTPS on port 443 (the default HTTPS
		port). A self-signed identity certificate is
	Example:	automatically generated.
	router(config)# ip http secure-server
Step 4	transport-map type persistent webui transport-map-name	Creates and names a persistent web user interface
		transport map.
	Example:
	router(config)# transport-map type persistent webui
	https-webui

	Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide
14-6	OL-27477-07