Environments

The Environments screen enables you to add, modify or delete environments, or group them into different categories.  An environment is simply another word for your different networks or customers that are managed by the SOC. This is useful for SOCs who provide services to several different networks, customers or business units within the organization. You can search for a specific environment in the Search field, and click on that environment and then Edit details using 
The Platform comes with a predefined environment named Default Environment.

To add a new environment:

1. Click the plus icon on the top right of the screen. The new environment screen opens.
2. Fill out the relevant information. Make sure to click Add to Users and API Keys if you want to add this new environment directly to existing users and API keys. Make sure to add in an alias if the third party integration has a different tenant name defined.
3. If you have deselected the “Set Default Retention period of all environments” in the General screen, then define here the time period after which all information on closed cases for this environment is deleted.
   
4. Click Create. The new environment appears in the list of Environments.
   

To delete an environment:

1. Select the required environment.
2. Click the Edit icon.
3. Click the Delete button in the bottom left of the Edit window.
4. In the Delete screen, you will see all the configurations and utilities related to this environment. Note that once you delete this environment, you cannot undo this action.
   
5. Click Remove Environment.
   

Dynamic Parameters

Dynamic Parameters allows you to create “groups” or “categories” of environments to further help categorize and define environments. This can come in particularly useful when running Playbooks as you can use Custom Trigger/Actions or Conditions based on one of these new environment parameters. This provides greater customization for Playbooks and is useful for Enterprises or MSSPs with lots of tenants.

To add a dynamic parameter:

1. In the Environments screen, click on the Manage Environment Parameters button and select Add Dynamic Parameters.
   
2. In the Dynamic Parameters dialog box, click the plus icon to add a new parameter.
3. Choose a name for the parameter. For this example, let’s choose Service package.
4. You can choose to add a string and a default value. Note that the default value will be propagated to all existing environments.
5. Or you can choose to add a list with list content and the default value. In this example, we will choose List, and add values into the List Content. To add a value to the list content, enter the value and click Enter. Repeat till you have the list you need.
   
6. Choose the default value that you want from the drop down and save. The dynamic parameter with this default value are now passed on to all existing environments.
   Note that everything can be edited at a later date either one at a time, or as a bulk action using the Export/Import procedure described below.
7. The dynamic parameter is added to the main screen as shown in the screenshot below.
   

Editing in Bulk using Export / Import

In order to perform editing actions in bulk, it is recommended to edit in an exported Excel chart.

To edit parameters in bulk:

1. Click on the Manage Environment Parameters button and select Export Dynamic Parameters.
2. In the excel chart, perform bulk editing on the values. Note that you cannot change the Parameter Names or Environment names.
3. When done, click on Manage Environment Parameters button and select Import Dynamic Parameters.