Users Guide

Table Of Contents
rest authentication token algorithm
Configures the token signing algorithm.
Syntax
rest authentication token algorithm[HS256 | RS256 | ES256]
Parameters hs256, rs256, es256 Enter the algorithm standard to be used to sign the tokens.
Default RS256
Command Mode CONFIGURATION
Usage
Information
This command updates the token signing algorithm. The no version of the command resets to the default
value.
Example
OS10(config)# rest authentication token algorithm es256
OS10(config)# rest authentication token algorithm rs256
Supported
Releases
10.4.1.0 or later
RESTCONF API tasks
Using the RESTCONF API, you can provision OS10 switches using HTTPS requests. The examples in this section show how to
access the OS10 RESTCONF API using curl commands. curl is a Linux shell command that generates HTTPS requests and is
executed on an external server.
curl Commands
curl command options include:
-X specifies the HTTPS request type; for example, POST , PATCH, or GET.
-u specifies the user name and password to use for server authentication.
-k specifies a text file to read curl arguments from. The command line arguments found in the text file will be used as if they
were provided on the command line. Use the IP address or URL of the OS10 switch when you access the OS10 RESTCONF
API from a remote orchestration system.
-H specifies an extra header to include in the request when sending HTTPS to a server. You can enter multiple extra
headers.
-d sends the specified data in an HTTPS request.
In curl commands, use %2F to represent a backslash (/); for example, enter ethernet1/2/3 as ethernet1%2F1%2F3.
Usage Information
Consider the following when accessing OS10 RESTCONF API using curl commands:
Dell EMC recommends using a specific URI of the target resource for GET queries in a scaled system. For example,
curl -X GET -k -u admin:admin -H "accept:application/json" https://$TARGET/restconf/data/
interfaces/interface/port-channel10
OS10 does not support REST queries on the root resource of the RESTCONF datastore. For example, the GET query, curl
-X GET -k -u admin:admin https://$TARGET/restconf/data returns an error.
When a RESTCONF query is in progress, you cannot configure any CLI commands until a RESTCONF query is complete.
1518
RESTCONF API