Trusted Hosts

A trusted host group can be created with a set of trusted hosts, which can be associated with the service to enforce action for the trusted hosts.

For more information on trusted hosts, see How to Configure Trusted Hosts .

Creating a Trusted Host Group

Parameter Name	Data Type	Mandatory	Description
URL: /v1/ trusted_host_groups
Method: POST
Description: Creates a trusted host group with the given name.
Input Parameters:
name	Alphanumeric	Yes	A name for the trusted host group that needs to be created.

Example:

Request:

curl http://192.168.0.1:8000/restapi/v1/trusted_host_groups -u 'eyJldCI6mFkbWluIn0=\n:' -X POST -H Content-Type:application/json -d '{"name":"Group1"}'

Response:

{"id":"Group1","token":"eyJldCWluIn0=\n"}

Deleting a Trusted Host Group

URL: /v1/ trusted_host_groups/{trusted_host_group_name}

Method: DELETE

Description: Deletes the given service group

Example:

Request:

curl http://192.168.0.1:8000/restapi/v1/trusted_host_groups/Group1 -u 'eyJldkbWluIn0=\n:' -X DELETE

Response:

{"msg":"Successfully deleted","token":"eyJldbWluIn0=\n"}

Adding a Trusted Host Group

Parameter Name	Data Type	Mandatory	Description
URL: /v1/ trusted_host_groups/{trusted_host_group_name}/trusted_hosts
Method: POST
Description: Creates a trusted host with the given name.
Input Parameters:
name	Alphanumeric	Yes	Name for the trusted host.
address_version	Enumeration	Yes	Internet protocol version for the trusted host.
ip_address	Alphanumeric	Yes	IP address of the trusted host.
mask	Alphanumeric	Yes	Associated subnet mask.
comments	Alphanumeric	Optional	Description about the trusted host.

Example:

Request:

curl http://192.168.0.1:8000/restapi/v1/trusted_host_groups/Group1/trusted_hosts -u 'eyJldCluIn0=\n:' -X POST -H Content-Type:application/json -d '{"name":"Host1", "ip_address":"99.99.124.56", "address_version":"ipv4", "mask":"255.255.255.255", "comments":"raj"}'

Response:

{"id":"Host1","token":"eyJldWluIn0=\n"}

Updating a Trusted Host

Parameter Name	Data Type	Mandatory	Description
URL: /v1/ trusted_host_groups/{trusted_host_group_name}/trusted_hosts/(trusted_host_name)
Method: PUT
Description: Updates the values of given parameters.
Input Parameters:
ip_address	Alphanumeric	Optional	IP address of the trusted host.
mask	Alphanumeric	Optional	Associated subnet mask.
comments	Alphanumeric	Optional	Description about the trusted host.

Example:

Request:

curl http://192.168.0.1:8000/restapi/v1/trusted_host_groups/Group1/trusted_hosts/Host1 -u 'eyJldCIn0=\n:' -X PUT -H Content-Type:application/json -d '{"ip_address":"99.99.107.69", "mask":"255.255.0.0"}'

Response:

{"id":"Host1","token":"eyJldCWluIn0=\n"}

Deleting a Trusted Host

Parameter Name	Data Type	Mandatory	Description
URL: /v1/ trusted_host_groups/{trusted_host_group_name}/trusted_hosts/(trusted_host_name)
Method: DELETE
Description: Deletes the given trusted host.
Input Parameters:
ip_address	Alphanumeric	Optional	IP address of the trusted host.
mask	Alphanumeric	Optional	Associated subnet mask.
comments	Alphanumeric	Optional	Description about the trusted host.