--- title: "Configure Endpoint Security (HX) integration: Request" slug: "configure-endpoint-security-hx-integration-request" tags: ["Reference", "NDRC 4.x", "Customer", "Network Security", "NDR 4.x"] updated: 2026-09-09T18:07:45Z published: 2026-09-09T18:07:45Z canonical: "docs.trellix.com/configure-endpoint-security-hx-integration-request" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Configure Endpoint Security (HX) integration: Request To configure Endpoint Security (HX) integration with the NDR appliance, send the following request: ``` POST https://:/config/v1/device ``` Required header: ``` Cookie: px= ``` > [!NOTE] > Note > > To use this request, your user account must be assigned to the Admin role. ### Options - IA_IP_address—The IP address of the NDR appliance running the NDR API. - port_number—The port number of the NDR appliance running the NDR API. - token—This token authenticates the session. By default, the session times out after 24 hours. Request body: ``` {  "type": "HX",  "ip": "1.1.1.1",  "port": "3000",  "username": "iaanalyst",  "password": "somepassword" } ``` ### Example ``` POST https://xxx.xxx.xxx.xxx:443/config/v1/device ``` Required header: ``` Cookie: px=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ``` ### Configure Endpoint Security integration: Response ``` HTTP/1.1 [Response Code] [Response Message] Date: [Date] Content-Type: [Content Type] ``` ###### Response fields - Response Code—A standard HTTP response code. - 200—Request successful; the configuration was added. - Response Message—A standard HTTP response message. - OK—Request successful; the configuration was added. - Date—Standard HTML date format. ###### Example ``` HTTP/1.1 200 OK Date: Fri, 16 Aug 2019 10:31:41 GMT ``` ### cURL code sample: Configure Endpoint Security integration ``` curl -k --cookie "px=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -X POST https://xxx.xxx.xxx.xxx:443/config/v1/device -d '{ "type": "HX", "ip": "1.1.1.1", "port": "3000", "username": "iaanalyst", "password": "somepassword" }' ``` This cURL sample includes the following options: - `-k`—This option explicitly allows cURL to perform insecure SSL connections and transfers, which allows you to test your SSL connection without installing a CA certificate. - `--cookie "px=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"`—This option specifies the authentication token for this session. - `-X POST`—This option specifies using the POST method. - `https://xxx.xxx.xxx.xxx:443/config/v1/device`—The integration request URL. Replace `xxx.xxx.xxx.xxx` with the IP address of your NDR appliance. - `-d -d '{ "type": "HX", "ip": "1.1.1.1", "port": "3000", "username": "iaanalyst", "password": "somepassword" }'`—Specifies the new configuration. Replace the values with your own. ###### Results This example configures Endpoint Security (HX) integration.