Create a feed name: Request

Prev Next

To create a feed name, send the following request:

POST https://<IA_IP_address>:<port_number>/threatintelservice/v1/feedname/<feed_name>

Note

To use this request, your user account must have admin privileges.

Required headers:

X-Username: <user> 
X-Role: <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.

  • user—The user ID.

  • role—The user's role.

Parameters

feed_name—(string) The name of the new feed. Must be a unique string.

Example

POST https://xxx.xxx.xxx.xxx:443/threatintelservice/v1/feedname/mynewfeed

Required headers:

Cookie: px=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx > 
X-Username: wheel 
X-Role: wheel

Create a feed name: Response

HTTP/1.1 200 OK				
Date: [Date]				
Content-Type: [Content Type]
{
  "payload": "message",
  "status": "status"
}
Response fields
  • Response Code—A standard HTTP response code.

    • 200—Request successful; the feed names was created.

  • Response Message—A standard HTTP response message.

    • OK—Request successful; the feed names were returned.

  • Date—Standard HTML date format.

  • Content Type—The response format.

  • payload—Can be one of:

    • Feed name already exists in the system

    • Feed name added

    • Only admin can add a feed name

  • status—Can be failed or OK.

Example
HTTP/1.1 [Response Code] [Response Message]				
Date: [Date]				
Content-Type: [Content Type]
{
  "payload": "Feed name added.",
  "status": "OK"
}

cURL code sample: Create a feed name

curl -k -X POST --cookie "px=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -H "X-Username: wheel" -H "X-Role: wheel" https://xxx.xxx.xxx.xxx:443/threatintelservice/v1/feedname/mynewfeed

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.

  • -X POST—Specifies using the POST method.

  • --cookie "px=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"—This option specifies the authentication token for this session.

  • -H "X-Username: wheel"—User name.

  • -H "X-Role: wheel"—User role.

  • https://xxx.xxx.xxx.xxx:443/threatintelservice/v1/feedname/mynewfeed—The feed name request URL. Replace xxx.xxx.xxx.xxx with the IP address of your NDR appliance, and mynewfeed with the name you want to create.

Results

This example creates a new feed name.