Adding the Endpoint Actor Configuration to the Director

There are several ways you can add the Actor configuration to the Director:

• Use the Add Endpoint Actors option in the Director UI
• Create a bulk registration token for use during registration
• Use the API, discussed in Adding the Actor Configuration - API

Add a Windows, Mac, or Unix Actor as an Endpoint Actor Configuration in the Director

1. Launch the Director.
2. Select Environment > Actors.
3. Click Add Endpoint Actors and fill out the new Actor form.

   1. Name: Label for the Actor.

      Best practice is to include the security zone as part of the name, which makes it easier when assigning Actors to Jobs.

   2. Description: Free text description for the Actor

   3. User Tags: Select existing user-created tags or add new ones to label this Actor.

      NOTE: User tags are used for running bulk Actions. See Running Bulk Actions for more information.

   4. Security Zone: The area of your network where the Actor will live.

      Security zones are added to the Director after the Director is installed (see Adding Security Zones in your Director Install guide if there are no security zones listed).

   5. Comm Mode: The communications mode by which the Director and Actor communicate. This must be Pull mode, which means the Actor initiates communication with the Director.

   6. Proxy Through Actor: Specifies the Actor to use as a proxy to communicate with the Director.

      IMPORTANT:  Only Actors that are in Push communication mode can proxy through another Actor. Therefore, Actors installed as endpoint Actors or Protected Theater Actors cannot proxy through another Actor.

      An Actor can be used as an intermediate proxy in cases of network segmentation policies, where an Actor would not otherwise be reachable by the Director.

      For example, given Actor A, which is connected to the Director, and Actor B, which is in a remote network segment, when setting up Actor B, select Actor A in the Proxy Through Actor field.

   7. Location [Local/Cloud]: The Actor's location; specified as local or within the Cloud (Amazon Web Services or Azure).
   8. Pull Interval: The time interval (in seconds) between pull attempts between the Actor and the Director.

4. Click Submit.

   The Actor is added to the Pending Actors list and a code is generated. This code must be used for registration and is only valid for 15 minutes.

Add Endpoint Actor Form

After the Actor is registered, you can review and update the Actor details and capabilities. For more details, see Editing an Actor.

Create a Bulk Registration Token

1. Launch the Director and sign in.
2. Select Environment > Actors.
3. Click Add Bulk Registration Token.
4. Fill out the form and click Submit.
   1. Name: This value is used in the name of the Actors. The Actor name has the following format:

      <token_name>-#-<Actor IP address>.

      Actor names can be changed. Names must start and end with an alphanumeric character and be no more than 69 characters. Hyphens and periods are allowed but may not be next to each other. Spaces are not allowed.

   2. Security Zone: The security zone for the Actors.
   3. Expiration Date: The date the token is no longer valid.
   4. Max Uses: The number of times the token can be used. This value cannot exceed the number of available Actors allowed by your license.

5. The token is created and is listed in the table. The token can be used for the easy install process or for registering Actors after they are installed.