Adding the Actor Configuration - API

You can either add the Actor Configuration or Create a Bulk Registration token. If you aren't comfortable using the platform API, you can Adding the Network Actor Configuration to Director Registering your Network Actor using the Director or Adding the Endpoint Actor Configuration to the Director instead.

NOTE: If you use the bulk registration token, your Actor will use Pull communication. You can edit Network Actors after the Actor is registered if you want it in Push.

To Use the Platform API to add the Actor Configuration

Create the  Actor Configuration in the Director by posting to the Director API.

  1. Create a JSON file, nodes.json (a sample JSON is shown below).

    network_request = { "node" : { "name": "test-network",
    "desc": "test network",
    "security_zone_id": 1,
    "location": "Local",
    "node_type": "network"
    "comm_mode": "Pull",
    "pull_interval": "30"},
    "proxy_node_id": "4"
    }
    • node_type options are network and endpoint.
    • When node_type is endpoint, comm_mode must be Pull.
    • comm_mode options are Pull and Push.
  2. Post nodes.json to the Director.

    $ https://director_ip/nodes.json

    Once it is posted, it will respond with the registration code, which expires in 15 minutes.

To Create Bulk Registration Tokens using the API

Create the Bulk Registration Token by posting to the Director API.

  1. Create a JSON file, save_bulk_token.json (a sample JSON is shown below).

    {
    "bulk_token": {
    "name": "test",
    "security_zone_id": 3,
    "expiration_date": "2020-12-30",
    "max_uses": "2"
    }
    }
  2. Post save_bulk_token.json to the Director.

    $ https://director_ip/save_bulk_token.json

    Once it is posted, it will respond with the bulk registration token code, which is valid through the expiration date.

  • June 5, 2022
  • August 3, 2023
In This Article