Site icon MapYourTech

RESTful Configuration Protocol (RESTCONF)

MapYourTech

RESTCONF (RESTful Configuration Protocol) is a network management protocol designed to provide a simplified, REST-based interface for managing network devices using HTTP methods. RESTCONF builds on the capabilities of NETCONF by making network device configuration and operational data accessible over the ubiquitous HTTP/HTTPS protocol, allowing for easy integration with web-based tools and services. It leverages the YANG data modeling language to represent configuration and operational data, providing a modern, API-driven approach to managing network infrastructure. Lets explore the fundamentals of RESTCONF, its architecture, how it compares with NETCONF, the use cases it serves, and the benefits and drawbacks of adopting it in your network.

What Is RESTCONF?

RESTCONF (Representational State Transfer  Configuration) is defined in RFC 8040 and provides a RESTful API that enables network operators to access, configure, and manage network devices using HTTP methods such as GET, POST, PUT, PATCH, and DELETE. Unlike NETCONF, which uses a more complex XML-based communication, RESTCONF adopts a simple REST architecture, making it easier to work with in web-based environments and for integration with modern network automation tools.

Key Features:

How RESTCONF Works

RESTCONF operates as a client-server model, where the RESTCONF client (typically a web application or automation tool) communicates with a RESTCONF server (a network device) using HTTP. The protocol leverages HTTP methods to interact with the data represented by YANG models.

HTTP Methods in RESTCONF:

RESTCONF provides access to various network data through a well-defined URI structure, where each part of the network’s configuration or operational data is treated as a unique resource. This resource-centric model allows for easy manipulation and retrieval of network data.

RESTCONF URI Structure and Example

RESTCONF URIs provide access to different parts of a device’s configuration or operational data. The general structure of a RESTCONF URI is as follows:

/restconf/<resource-type>/<data-store>/<module>/<container>/<leaf>

Example: If you want to retrieve the current configuration of interfaces on a network device, the RESTCONF URI might look like this:

GET /restconf/data/ietf-interfaces:interfaces

This request retrieves all the interfaces on the device, as defined in the ietf-interfaces YANG model.

RESTCONF Data Formats

RESTCONF supports two primary data formats for representing configuration and operational data:

Most modern implementations prefer JSON due to its simplicity and efficiency, particularly in web-based environments.

RESTCONF and YANG

Like NETCONF, RESTCONF relies on YANG models to define the structure and hierarchy of configuration and operational data. Each network device’s configuration is represented using a specific YANG model, which RESTCONF interacts with using HTTP methods. The combination of RESTCONF and YANG provides a standardized, programmable interface for managing network devices.

Example YANG Model Structure in JSON:

{
"ietf-interfaces:interface": {
"name": "GigabitEthernet0/1",
"description": "Uplink Interface",
"type": "iana-if-type:ethernetCsmacd",
"enabled": true
}
}

This JSON example represents a network interface configuration based on the ietf-interfaces YANG model.

Security in RESTCONF

RESTCONF leverages the underlying HTTPS (SSL/TLS) for secure communication between the client and server. It supports basic authentication, OAuth, or client certificates for verifying user identity and controlling access. This level of security is similar to what you would expect from any RESTful API that operates over the web, ensuring confidentiality, integrity, and authentication in the network management process.

Advantages of RESTCONF

RESTCONF offers several distinct advantages, especially in modern networks that require integration with web-based tools and automation platforms:

Disadvantages of RESTCONF

While RESTCONF brings many advantages, it also has some limitations:

When to Use RESTCONF

RESTCONF is ideal for environments that prioritize simplicity, programmability, and integration with modern web tools. Common use cases include:

RESTCONF vs. NETCONF: A Quick Comparison

RESTCONF Implementation Steps

To implement RESTCONF, follow these general steps:

Step 1: Enable RESTCONF on Devices

Ensure your devices support RESTCONF and enable it. For example, on Cisco IOS XE, you can enable RESTCONF with:

 

restconf

Step 2: Send RESTCONF Requests

Once RESTCONF is enabled, you can interact with the device using curl or tools like Postman. For example, to retrieve the configuration of interfaces, you can use:

curl -k -u admin:admin "https://192.168.1.1:443/restconf/data/ietf-interfaces:interfaces"

Step 3: Parse JSON/XML Responses

RESTCONF responses will return data in JSON or XML format. If you’re using automation scripts (e.g., Python), you can parse this data to retrieve or modify configurations.

Summary

RESTCONF is a powerful, lightweight, and flexible protocol for managing network devices in a programmable way. Its use of HTTP/HTTPS, JSON, and YANG makes it a natural fit for web-based network automation tools and DevOps environments. While it lacks the transactional features of NETCONF, its simplicity and compatibility with modern APIs make it ideal for managing cloud-based and automated networks.