Sending Http(S) Post And Put Requests - Cisco TelePresence SX10 Quick Set Administrator's Manual

Cisco TelePresence SX10 Quick Set

Introduction
Customization

Sending HTTP(S) Post and Put requests

API
xCommand HttpClient Post/Put
Video system, HTTP(S) client
This feature makes it possible to send arbitrary HTTP(S)
Post and Put requests from a video system to an HTTP(S)
server.
You can send data to an HTTP(S) server whenever you
want. You can choose what data to send, and structure
them as you like. This way you can adapt the data to an
already established service.
Security measures:
• The HTTP(S) Post/Put feature is disabled by default. A
system administrator must explicitly enable the feature
by setting HttpClient > Mode to On.
• The system administrator can prevent the use of HTTP
by setting HttpClient > AllowHTTP to False.
• The system administrator can specify a list of HTTP(S)
servers that the device is allowed to send data to.
• The number of concurrent Post and Put requests is
limited.
D15330.14 SX10 Administrator Guide CE9.7, APRIL 2019.
Configuration Peripherals
Network
Third-party service
HTTP(S) server
List of Allowed HTTP(S) Servers
The system administrator can use these commands to set
up and maintain a list of up to ten allowed HTTP(S) servers
(hosts):
xCommand HttpClient Allow Hostname Add
•
Expression: <Regular expression that matches
the host name or IP address of the HTTP(S)
server>
xCommand HttpClient Allow Hostname Clear
•
xCommand HttpClient Allow Hostname List
•
xCommand HttpClient Allow Hostname Remove Id:
•
<id of an entry in the list>
If the list is not empty, you can send HTTP(S) requests only
to the servers in the list. If the list is empty, you can send
the requests to any HTTP(S) server.
The check against the list of allowed servers is performed
both when using insecure (HTTP) and secure (HTTPS)
transfer of data.
Maintenance
www.cisco.com — Copyright © 2019 Cisco Systems, Inc. All rights reserved.
178
Administrator Guide
System settings Appendices Appendices
Allowing HTTPS without certificate
validation
When sending requests over HTTPS, the video system
checks the certificate of the HTTPS server by default. If
the HTTPS server certificate is not found to be valid, you
get an error message. The video system doesn't send
any data to that server.
We recommend using HTTPS with certificate validation.
If this is not possible, the system administrator can set
HttpClient > AllowInsecureHTTPS to On, which allows the
use of HTTPS without validating the server's certificate.
Sending HTTP(S) Requests
Once the HTTP(S) Client Post feature is enabled, you
can use the following commands to send Post and Put
requests to an HTTP(S) server:
xCommand HttpClient Post [AllowInsecureHTTPS:
•
<True/False>] [Header: <Header text>]
Url: <URL to send the request to>
xCommand HttpClient Put [AllowInsecureHTTPS:
•
<True/False>] [Header: <Header text>]
Url: <URL to send the request to>
These are multiline commands. Read the API guide to find
out how to use multiline commands, and also to find a
detailed description of the command parameters.
Further Information
Find more information about HTTP(S) Post requests in the
Customization guide. Go to:
► https://www.cisco.com/go/in-room-control-docs