매크로를 사용하면 필요할 때마다 HTTP(S) 서버로 데이터를 보낼 수 있습니다. 어떤 데이터가 전송되고 어떻게 구성되는지를 제어할 수 있으며, 기존의 서비스에서 사용하기 위해 데이터를 쉽게 적용할 수 있습니다.

보안 조치:

  • HTTP(S) 클라이언트 요청 기능은 기본값으로 비활성화됩니다. 시스템 관리자는 HttpClient > 모드 를 켜기 ( xConfiguration HttpClient 모드: 에).

  • 시스템 관리자는 HttpClient > AllowHTTP 를 False ( xConfiguration HttpClient AllowHTTP: 거짓 ).

  • 시스템 관리자는 장치가 데이터를 보낼 수 있도록 HTTP(S) 서버의 목록을 지정할 수 있습니다. (참조: xCommand HttpClient Allow Hostname 명령어)

  • 동시 HTTP(S) 요청의 수는 제한됩니다.

이 문서에서 언급한 구성은 장치의 웹 인터페이스와 API에서 모두 사용할 수 있습니다. 명령어는 API를 통해 사용할 수 있습니다. 웹 인터페이스 에 액세스하고 API를 사용하는 방법에 대한 정보는 고급 설정 문서를 참조하십시오.

허용되는 HTTP(S) 서버의 목록

시스템 관리자는 다음 명령어를 사용하여 최대 10개 허용되는 HTTP(S) 서버(호스트) 목록을 설정하고 유지 관리할 수 있습니다.

  • xCommand HttpClient 호스트 이름 추가 표현 허용:

  • xCommand HttpClient에서 호스트 이름 지우기 허용

  • xCommand HttpClient에서 호스트 이름 목록을 허용 합니다.

  • xCommand HttpClient 호스트 이름 제거 Id 허용:

목록에 서버 항목이 포함된 경우 해당 서버에 HTTP(S) 요청만 보낼 수 있습니다. 그러나 목록이 비어 있는 경우 HTTP(S) 서버로 요청을 보낼 수 있습니다.

데이터의 비보안(HTTP) 및 보안(HTTPS) 전송을 사용할 때 허용되는 서버의 목록에 대한 검사는 모두 실행됩니다.

인증서 유효성 검증이 포함되지 않은 HTTPS

HTTPS를 통해 요청을 보낼 때 장치는 기본값으로 HTTPS 서버의 인증서를 확인합니다. HTTPS 서버 인증서가 유효하지 않은 경우, 오류 메시지를 수신합니다. 장치는 해당 서버로 데이터를 보내지 않습니다.

인증서 유효성 검증으로 HTTPS를 사용할 것이 좋습니다. 인증서 유효성을 검증할 수 없는 경우, 시스템 관리자는 HttpClient > AllowInsecureHTTPS 를 켜기 ( xConfiguration HttpClient AllowInsecureHTTPS: 에). 이를 통해 서버의 인증서를 검증하지 않고 HTTPS를 사용할 수 있습니다.

HTTP(S) 요청 보내는 중

HTTP(S) 클라이언트 요청 기능이 활성화되면 다음 명령어를 사용하여 HTTP(S) 서버로 요청을 보낼 수 있습니다. 은 Post, Put, Patch, Get 또는 Delete 입니다.

  • xCommand HttpClient [AllowInsecureHTTPS: ] [헤더: ] [ResponseSizeLimit: ] [ResultBody: ] [Timeout: ] Url:

헤더 필드 추가는 선택 사항이며, 최대 20개의 필드를 추가할 수 있습니다.

AllowInsecureHTTPS 파라미터는 시스템 관리자가 서버의 인증서를 검증하지 않고 HTTPS의 사용을 허용한 경우에만 적용됩니다. 이러한 경우, 파라미터가 True로 설정된 경우, 서버 인증서의 유효성을 검증하지 않고 서버로 데이터를 보낼 수 있습니다. 파라미터를 제외하거나 False로 설정하는 경우, 인증서 유효성 검증에 실패하면 데이터가 전송되지 않습니다.

ResposenSizeLimit 파라미터는 장치가 서버에서 응답으로 수락하는 최대 페이로드 크기(바이트)입니다. 응답 페이로드가 최대 크기보다 큰 경우, 명령어는 상태 오류를 반환합니다. 오류 메시지는 최대 파일 크기가 초과 않았다는 메시지가 나타납니다. 단, 이는 서버 측에 영향을주지 않습니다. 서버에서 요청을 올바르게 수신하고 처리했습니다.

ResultBody 파라미터를 사용하여 명령어 결과에서 서버의 HTTP 응답의 본문을 서식화하는 방법을 결정합니다. 다음 세 가지 옵션이 있습니다.

  • 없음 : 명령어 결과에는 HTTP 응답의 본문을 포함 하지 마십시오.

  • Base64 : 결과에 포함 하려면 먼저 Base64 인코드를 실행 하십시오.

  • 일반 텍스트: 결과에 본문을 일반 텍스트로 포함 합니다. 응답에 인쇄할 수 없는 문자가 포함 된 경우, 해당 명령어는 인쇄할 수 없는 데이터를 발견 했음을 알리는 메시지와 함께 상태 오류를 반환 합니다.

시간 초과 파라미터를 사용하여 시간 초과 기간(초)을 설정합니다. 이 기간 동안 요청이 완료되지 않은 경우, API에서 오류를 반환합니다.

명령어를 발행한 후 바로 페이로드(데이터)를 입력합니다. 줄 수를 포함하여 입력하는 모든 것은 페이로드의 일부입니다. 완료되면 마침을 마친 후 라인 분리("\n") 및 마침을 포함하는 개별 라인 그 후(".\n")를 포함하십시오. 이제 명령어가 실행되고 데이터가 서버로 발송됩니다.

예제

메시지의 본문은 두 예제 모두에 있는 JSON입니다. 메시지를 수신하는 서비스의 예상 형식에 따라 형식이 될 수 있습니다.

예 1: HTTP Post를 사용하여 IoT 장치 제어

필립스 색조 브리지에 연결된 밝게 켜는 매크로 기능은 다음과 같습니다.

 함수 hue_command(데이터) { var url = 'http://192.0.2.10/api/'ZXlU4tUtQ23Pjbdyl-kiyCjTs0i5ANDEu1ypJq0-/lights/1/state'; var 헤더 = '콘텐츠 유형: application/json '; var command = ' {"on": true} '; xapi. 명령 (' HttpClient Put ', {' Url ': url, ' 헤더 ': 헤더}, 명령어); }

API를 사용 하 여 명령줄에서 동일 하 게 실행할 수 있습니다.

 xcommand HttpClient Put 헤더: "콘텐츠 유형: application/json" URL: "http://192.0.2.10/api/'ZXlU4tUtQ23Pjbdyl-kiyCjTs0i5ANDEu1ypJq0-/lights/1/state" {"on":true} .

예 2: HTTP Post를 사용하여 모니터링 도구에 데이터 게시 

 xcommand HttpClient 게시물 헤더: "콘텐츠 유형: application/json" URL: "https://mymonitoringserver.com/service/devicemonitoring" {"Message":"사용자가 이 시스템과 관련된 문제를 보고했습니다","systemName":"BoardRoom 4th floor","softwareVersion":"ce9.6.0","softwareReleaseDate":"2018-12-13","videoMonitors":"Dual"} .

추가 정보

사용자 정의 안내서에서 HTTP 클라이언트 요청을 사용하는 방법에 대한 자세한 내용을 참조하십시오 . 최신 버전을 선택하십시오.

Cisco 지원(TAC)은 매크로를 포함하여 타사 코드의 디버깅을 지원하지 않습니다. https://roomos.cisco.com 매크로 및 타사 코드에 대해 도움이 필요하시면 확인하십시오.