{"type":"doc","content":[{"type":"paragraph","content":[{"text":"The HTTP/2 functions are used to exchange data over HTTP/2 as a client. However, the functions can also be used for HTTP/1.","type":"text"}]},{"type":"paragraph","content":[{"text":"The client functions are used to exchange data with a HTTP server. There are specific functions for GET and POST as well as functions for general HTTP requests. Either plain text or encrypted communication can be used. Basic authentication is supported, as well as the use of a keystore, and if required a truststore, for the functions with an encrypted communication channel.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Note!","type":"text"}]},{"type":"paragraph","content":[{"text":"In all parameter descriptions below, \"HTTP\" may refer to both HTTP and HTTPS, and both HTTP/1 and HTTP/2.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"The following functions for HTTP/2 described here are:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"maxLevel":{"value":"1"}},"macroMetadata":{"macroId":{"value":"4718f75e-577c-4b03-8606-302fb077b929"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"63e86183-389d-4bdf-8ea9-64277551e58f"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"httpGet","type":"text"}]},{"type":"paragraph","content":[{"text":"This function uses the GET method to retrieve content from an HTTP server, see ","type":"text"},{"text":"Response(9.3)","type":"text","marks":[{"type":"link","attrs":{"href":"https://infozone.atlassian.net/wiki/spaces/MD93/pages/204739358/HTTP+2+UDRs#%5BinlineExtension%5DResponse"}}]},{"text":". ","type":"text"}]},{"type":"codeBlock","content":[{"text":"Response httpGet\n ( string host,\n string path,\n string protocol,\t\t\t //Optional\n int port, //Optional\n boolean secure, //Optional\n int requestTimeout, //Optional\n int connectionTimeout, //Optional\n string username, //Optional\n string password, //Optional\n map headers ) //Optional","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"table","attrs":{"layout":"align-start","width":1000.0,"localId":"f4131618-2a97-4997-8ffb-b9f4f47cd5cc"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[151.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[848.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[151.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"host","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[848.0]},"content":[{"type":"paragraph","content":[{"text":"The name or IP address of the HTTP server.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[151.0]},"content":[{"type":"paragraph","content":[{"text":"path","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[848.0]},"content":[{"type":"paragraph","content":[{"text":"The path.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Example - path","type":"text"}]},{"type":"codeBlock","content":[{"text":"/api/v2/doc","type":"text"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[151.0]},"content":[{"type":"paragraph","content":[{"text":"protocol","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[848.0]},"content":[{"type":"paragraph","content":[{"text":"The protocol used: HTTP/1 or HTTP/2. The default value is HTTP/1. To use HTTP/2, you must set this value to \"h2\".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[151.0]},"content":[{"type":"paragraph","content":[{"text":"port","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[848.0]},"content":[{"type":"paragraph","content":[{"text":"The port number to contact the HTTP server on. Port 80 is used for HTTP connection and 443 is used for HTTPS connection by default.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[151.0]},"content":[{"type":"paragraph","content":[{"text":"secure","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[848.0]},"content":[{"type":"paragraph","content":[{"text":"Indicates whether the data should be sent in secure mode or not.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[151.0]},"content":[{"type":"paragraph","content":[{"text":"requestTimeout","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[848.0]},"content":[{"type":"paragraph","content":[{"text":"The number of milliseconds to wait for a response. If the value is not specifically specified, the default timeout is used. The default value is 15000 milliseconds.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[151.0]},"content":[{"type":"paragraph","content":[{"text":"connectionTimeout","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[848.0]},"content":[{"type":"paragraph","content":[{"text":"The number of milliseconds to wait for a connection to be established. If the value is not specifically specified, the default timeout is used. The default value is 3000 milliseconds.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[151.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"username","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[848.0]},"content":[{"type":"paragraph","content":[{"text":"A username for an account on the HTTP server.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[151.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"password","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[848.0]},"content":[{"type":"paragraph","content":[{"text":"Password associated with the username.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[151.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"headers","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[848.0]},"content":[{"type":"paragraph","content":[{"text":"Custom HTTP request headers.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[151.0]},"content":[{"type":"paragraph","content":[{"text":"Returns","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[848.0]},"content":[{"type":"paragraph","content":[{"text":"A response from the HTTP server. It will be ","type":"text"},{"text":"null","type":"text","marks":[{"type":"code"}]},{"text":" if any part of the communication fails.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"httpPost","type":"text"}]},{"type":"paragraph","content":[{"text":"This function uses the POST method to send content to an HTTP/2 server and receives the response.","type":"text"}]},{"type":"codeBlock","content":[{"text":"Response httpPost\n ( string host, \n string path,\t\t\n bytearray content, \n string contentType,\n string protocol,\t\t\t //Optional\n int port, //Optional \n \t boolean secure, //Optional \n int requestTimeout, //Optional\n int connectionTimeout, //Optional \n string username, //Optional\n string password, //Optional\n map headers ) //Optional\n","type":"text"}]},{"type":"table","attrs":{"layout":"align-start","width":996.0,"localId":"20938d08-0237-449f-9344-6ddb52c8261e"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[810.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"host","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[810.0]},"content":[{"type":"paragraph","content":[{"text":"The name or IP address of the HTTP server. ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"path","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[810.0]},"content":[{"type":"paragraph","content":[{"text":"The path","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Example - path","type":"text"}]},{"type":"codeBlock","content":[{"text":"/api/v2/doc","type":"text"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"bytarray","type":"text","marks":[{"type":"em"}]},{"text":"content","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[810.0]},"content":[{"type":"paragraph","content":[{"text":"The body of the request in bytearray format.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"contentType","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[810.0]},"content":[{"type":"paragraph","content":[{"text":"The MIME type of the content.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Example - contentType","type":"text"}]},{"type":"codeBlock","content":[{"text":"application/json","type":"text"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"protocol","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[810.0]},"content":[{"type":"paragraph","content":[{"text":"The protocol used: HTTP/1 or HTTP/2. The default value is HTTP/1. To use HTTP/2, you must set this value to \"h2\".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"port","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[810.0]},"content":[{"type":"paragraph","content":[{"text":"The port number to contact the HTTP server on. Port 80 is used for HTTP connection and 443 is used for HTTPS connection by default.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"secure","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[810.0]},"content":[{"type":"paragraph","content":[{"text":"Indicates whether the data should be sent in secure mode or not.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"requestTimeout","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[810.0]},"content":[{"type":"paragraph","content":[{"text":"The number of milliseconds to wait for a response. If the value is not specifically specified, the default timeout is used. The default value is 15000 milliseconds.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"connectionTimeout","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[810.0]},"content":[{"type":"paragraph","content":[{"text":"The number of milliseconds to wait for a connection to be established. If the value is not specifically specified, the default timeout is used. The default value is 3000 milliseconds.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"username","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[810.0]},"content":[{"type":"paragraph","content":[{"text":"A username for an account on the HTTP server.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"password","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[810.0]},"content":[{"type":"paragraph","content":[{"text":"Password associated with the username.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"headers","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[810.0]},"content":[{"type":"paragraph","content":[{"text":"Custom HTTP request headers.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"Returns","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[810.0]},"content":[{"type":"paragraph","content":[{"text":"A response from the HTTP server. It will be ","type":"text"},{"text":"null","type":"text","marks":[{"type":"code"}]},{"text":" if any part of the communication fails.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"httpReq","type":"text"}]},{"type":"paragraph","content":[{"text":"This function makes an HTTP request and uses the specified method, for example GET, POST, and PUT.","type":"text"}]},{"type":"codeBlock","content":[{"text":"Response httpReq\n ( string method,\t\n\t string host,\t\n string path,\n bytearray content,\n string contentType, \n\t string protocol,\t\t\t //Optional\n\t int port,\t\t\t\t\t //Optional\n\t boolean secure,\t\t\t //Optional\n int requestTimeout,\t\t //Optional\n\t int connectionTimeout,\t //Optional\n\t string username,\t\t\t //Optional\n\t string password, \t\t\t //Optional\n map headers )//Optional","type":"text"}]},{"type":"table","attrs":{"layout":"align-start","width":1800.0,"localId":"a37077c2-5008-4409-be90-dc4517d3e17d"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[979.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"method","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[979.0]},"content":[{"type":"paragraph","content":[{"text":"The HTTP method.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"host","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[979.0]},"content":[{"type":"paragraph","content":[{"text":"The name or IP address of the HTTP server. ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"path","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[979.0]},"content":[{"type":"paragraph","content":[{"text":"The path","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Example - path","type":"text"}]},{"type":"codeBlock","content":[{"text":"/api/v2/doc","type":"text"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"content","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[979.0]},"content":[{"type":"paragraph","content":[{"text":"The body of the request in bytearray format.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"contentType","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[979.0]},"content":[{"type":"paragraph","content":[{"text":"The MIME type of the content.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Example - contentType","type":"text"}]},{"type":"codeBlock","content":[{"text":"application/json","type":"text"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"protocol","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[979.0]},"content":[{"type":"paragraph","content":[{"text":"The protocol used: HTTP/1 or HTTP/2. The default value is HTTP/1. To use HTTP/2, you must set this value to \"h2\".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"port","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[979.0]},"content":[{"type":"paragraph","content":[{"text":"The port number to contact the HTTP server on. Port 80 is used for HTTP connection and 443 is used for HTTPS connection by default.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"secure","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[979.0]},"content":[{"type":"paragraph","content":[{"text":"Indicates whether the data should be sent in secure mode or not.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"requestTimeout","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[979.0]},"content":[{"type":"paragraph","content":[{"text":"The number of milliseconds to wait for a response. If the value is not specifically specified, the default timeout is used. The default value is 15000 milliseconds.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"connectionTimeout","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[979.0]},"content":[{"type":"paragraph","content":[{"text":"The number of milliseconds to wait for a connection to be established. If the value is not specifically specified, the default timeout is used. The default value is 3000 milliseconds.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"username","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[979.0]},"content":[{"type":"paragraph","content":[{"text":"A username for an account on the HTTP server.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"password","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[979.0]},"content":[{"type":"paragraph","content":[{"text":"Password associated with the username.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"headers","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[979.0]},"content":[{"type":"paragraph","content":[{"text":"Custom HTTP request headers.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"Returns","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[979.0]},"content":[{"type":"paragraph","content":[{"text":"A response from the HTTP server. It will be ","type":"text"},{"text":"null","type":"text","marks":[{"type":"code"}]},{"text":" if any part of the communication fails.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"httpMultipartPost","type":"text"}]},{"type":"paragraph","content":[{"text":"This function uses the POST method to send multipart binary contents to an HTTP server and receives the response.","type":"text"}]},{"type":"codeBlock","content":[{"text":"Response httpMultipartPost\n ( string host,\n\t string path,\n\t list content,\n\t string protocol,\t\t\t //Optional\n \t int port, \t\t\t\t //Optional \n\t boolean secure,\t\t\t //Optional\n int requestTimeout,\t\t //Optional\n\t int connectionTimeout,\t //Optional\n string username, //Optional\n string password, //Optional\n map headers ) //Optional","type":"text"}]},{"type":"table","attrs":{"layout":"align-start","width":1001.0,"localId":"3fc6718e-3cea-4cc4-a6d8-6aa59798cd34"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[177.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[823.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[177.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"host","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[823.0]},"content":[{"type":"paragraph","content":[{"text":"The name or IP address of the HTTP server. ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[177.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"path","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[823.0]},"content":[{"type":"paragraph","content":[{"text":"The path on the server to which we should do the POST.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[177.0]},"content":[{"type":"paragraph","content":[{"text":"content","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[823.0]},"content":[{"type":"paragraph","content":[{"text":"The body of the the request.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[177.0]},"content":[{"type":"paragraph","content":[{"text":"protocol","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[823.0]},"content":[{"type":"paragraph","content":[{"text":"The protocol used: HTTP/1 or HTTP/2. The default value is HTTP/1. To use HTTP/2, you must set this value to \"h2\".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[177.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"port","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[823.0]},"content":[{"type":"paragraph","content":[{"text":"The port to be used for the HTTP server. Port 80 is used for HTTP connection and 443 is used for HTTPS connection by default.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[177.0]},"content":[{"type":"paragraph","content":[{"text":"secure","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[823.0]},"content":[{"type":"paragraph","content":[{"text":"Indicates whether the data should be sent in secure mode or not.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[177.0]},"content":[{"type":"paragraph","content":[{"text":"requestTimeout","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[823.0]},"content":[{"type":"paragraph","content":[{"text":"The number of milliseconds to wait for a response. If the value is not specifically specified, the default timeout is used. The default value is 15000 milliseconds.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[177.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"connectionTimeout","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[823.0]},"content":[{"type":"paragraph","content":[{"text":"The number of milliseconds to wait for a connection to be established. If the value is not specifically specified, the default timeout is used. The default value is 3000 milliseconds.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[177.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"username","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[823.0]},"content":[{"type":"paragraph","content":[{"text":"Username for the account to be used on the HTTP server.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[177.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"password","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[823.0]},"content":[{"type":"paragraph","content":[{"text":"Password associated with the username.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[177.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"headers","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[823.0]},"content":[{"type":"paragraph","content":[{"text":"Custom HTTP request headers.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[177.0]},"content":[{"type":"paragraph","content":[{"text":"Returns","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[823.0]},"content":[{"type":"paragraph","content":[{"text":"A response from the HTTP server. It will be null if any part of the communication fails.","type":"text"}]}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Note!","type":"text"}]},{"type":"paragraph","content":[{"text":"For optional parameters, you need to state null in case you supply subsequent optional parameters. If there are no subsequent parameters, you do not have to state anything.","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"Example

","block-inline":true,"nestedContent":{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"httpMultipartPostURL( \"mypath\", mybody, \"myhost\", 0, null, \"myusername\");","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}],"version":1}}}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"TLS/SSL Encryption","type":"text"}]},{"type":"paragraph","content":[{"text":"When selecting secure, a keystore is required. In this case, the use of a truststore is supported.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configure Java Keystore for Secure URL Functions","type":"text"}]},{"type":"paragraph","content":[{"text":"Keystore is used to store HTTP Client’s credential. This certificate is sent to a server for authentication if required.","type":"text"}]},{"type":"paragraph","content":[{"text":"To specify a Keystore file that you want to use, set the properties ","type":"text"},{"text":"https.apl.keystore_location","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"https.apl.keystore_passphrase","type":"text","marks":[{"type":"code"}]},{"text":" in the relevant ECs. See the example below for how to set these properties using the ","type":"text"},{"text":"mzsh topo","type":"text","marks":[{"type":"code"}]},{"text":" command.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Example - Setting Java keystore properties","type":"text"}]},{"type":"codeBlock","content":[{"text":"$ mzsh topo set topo://container:/pico:/val:config.properties.https.apl.keystore_location \n$ mzsh topo set topo://container:/pico:/val:config.properties.https.apl.keystore_passphrase ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"If the two properties above are not set in the relevant Execution Context ","type":"text"},{"text":".conf","type":"text","marks":[{"type":"code"}]},{"text":", MZ Default Keystore is used.","type":"text"}]},{"type":"paragraph","content":[{"text":"The property ","type":"text"},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"https.apl.keystore_location","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":" represents the location of the keystore and the property ","type":"text"},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"https.apl.keystore_passphrase","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":" represents the passphrase for that keystore.","type":"text"}]},{"type":"paragraph","content":[{"text":"The following command can be used to create a keystore with the Java keytool program.","type":"text"}]},{"type":"codeBlock","content":[{"text":"keytool -keystore /var/opt/mz/HttpdExec.keystore -genkey -keyalg RSA","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Note!","type":"text"}]},{"type":"paragraph","content":[{"text":"The Keystore passphrase must be the same as the passphrase used by the certificate.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"See the JVM product documentation for more information about how to use the keytool.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configure Java Truststore for Secure URL Functions ","type":"text"}]},{"type":"paragraph","content":[{"text":"A truststore is a keystore that is used when deciding what to trust - truststore stores certificates from third parties. If you receive data from an entity that you already trust, and if you can verify that the entity is what it claims to be, you can assume that the data does in fact come from that entity.","type":"text"}]},{"type":"paragraph","content":[{"text":"By Default, MediationZone uses its own truststore, which always trusts any server connection.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you want to use a specific truststore, use the ","type":"text"},{"text":"mzsh topo","type":"text","marks":[{"type":"code"}]},{"text":" command to add the property ","type":"text"},{"text":"https.apl.userdefined.truststore","type":"text","marks":[{"type":"code"}]},{"text":" to the required ECs and set the value to ","type":"text"},{"text":"true:","type":"text","marks":[{"type":"code"}]}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"$ mzsh topo set topo://container:/pico:/val:config.properties.https.apl.userdefined.truststore true","type":"text"}]},{"type":"paragraph","content":[{"text":"The default value of this property is ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"After setting the property ","type":"text"},{"text":"https.apl.userdefined.truststore","type":"text","marks":[{"type":"code"}]},{"text":" to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":", if you want to use a specific truststore, use the ","type":"text"},{"text":"mzsh topo","type":"text","marks":[{"type":"code"}]},{"text":" command to set the following properties in the relevant ECs:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"https.apl.truststore_location","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"https.apl.truststore_passphrase","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Example - Setting properties to use a specific truststore","type":"text"}]},{"type":"codeBlock","content":[{"text":"$ mzsh topo set topo://container:/pico:/val:config.properties.https.apl.truststore_location \n$ mzsh topo set topo://container:/pico:/val:config.properties.https.apl.truststore_passphrase ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"If you do not set these two properties, the Java Default Truststore is used.","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"scroll-pagebreak","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"ab6155df-1d8f-4922-ae26-b25ef8d19ff1"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://scroll-exporter-extensions.us.exporter.k15t.app/static/assets/images/macro-icons/scroll-pagebreak.svg"}}],"title":"Scroll Pagebreak"}},"localId":"8a300511-5416-4dbd-8c8b-0e685692d619"}},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported