--- title: "Configure a Controller in the Manager" slug: "configure-a-controller-in-the-manager-1" tags: ["Product Usage", "vIPS 11.1x", "vIPS"] updated: 2026-09-11T20:53:11Z published: 2026-09-11T20:53:11Z canonical: "docs.trellix.com/configure-a-controller-in-the-manager-1" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Configure a Controller in the Manager ****Prerequisites:**** To create an External Controller in AWS, you require any one of the following information: - Information about the region of your cloud environment - The Access and Shared keys generated when your AWS account was created - Manager Instance assigned to the IAM Role with necessary policies configured. If the Manager is installed in the AWS environment, the IAM Role is used to authenticate the cloud access account details. The local Controller requires the IAM Role to access the cloud. For details on how to create an IAM Role, refer to the section [Requirements to deploy Trellix vIPS in AWS environment](/network-and-platform/docs/requirements-to-deploy-trellix-vips-aws-environment-probe-based-solution). To set up communication between the Manager and the Controller server you have to configure the **Controllers** in the Manager. You can either use the Local Controller that is bundled with the Manager or you can deploy an External Controller instance in the AWS environment. ****Steps:**** 1. In the Manager, go to **Devices** → **** → **Global** → **Device Manager**. The **Device Manager** page is displayed. 2. Select the **vIPS Controllers** tab. On the **vIPS Controllers** tab, all configured Controllers details are displayed. | Column | Definition | | --- | --- | | **Controller Name** | Displays the name of the Controller ![GUID-66D53A62-2818-4E40-A417-BA8481052EF2-low.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-426c7133-670c-390f-617f-365b9902d8fb.png?sv=2026-02-06&spr=https&st=2026-11-20T22%3A16%3A06Z&se=2026-11-20T23%3A16%3A06Z&sr=c&sp=r&sig=Cb5Qj0SnrFEiEVol%2BK3kiw6ErsSGY%2FeeGl1wXLjWVMM%3D) - This icon is displayed if the cloud details are not configured for the Local Controller. You need to enter Cloud account to make Controller configuration complete. In case the cloud account is incomplete, the invalid icon will be always displayed. | | **Description** | Displays additional information for the Controller | | **Instances** | | **Hostname (local IP address)** | Displays the name or the IP address of the Controller Server. The icon before the Controller IP address displays the status of the Controller. The status can be one of the following: ![GUID-85CA65B4-AFC0-4C4E-8FDE-C2EE568AB31B-low.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-3e497562-5271-693b-f5ea-86f10ab4d380.png?sv=2026-02-06&spr=https&st=2026-11-20T22%3A16%3A06Z&se=2026-11-20T23%3A16%3A06Z&sr=c&sp=r&sig=Cb5Qj0SnrFEiEVol%2BK3kiw6ErsSGY%2FeeGl1wXLjWVMM%3D) Online ![GUID-892707E8-C66C-4340-8E1B-D8BE9CBF317D-low.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-e30c5710-87ad-15dd-6e1f-859cb6ff312d.png?sv=2026-02-06&spr=https&st=2026-11-20T22%3A16%3A06Z&se=2026-11-20T23%3A16%3A06Z&sr=c&sp=r&sig=Cb5Qj0SnrFEiEVol%2BK3kiw6ErsSGY%2FeeGl1wXLjWVMM%3D) Disconnected | | **Controller/Probe Software** | Displays the software version of the Controller and the vIPS Probe | | **Cloud Access** | Displays the name of the cloud service provider | | **Last Updated** | | **Time** | Displays the time when the Controller was last updated | | **By** | Displays the user who modified the Controller | | ![GUID-0E47A2C8-D361-4090-B96C-F756BAC98E17-low.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-36cfcf5c-cac8-98ad-f4ac-c99e49a78932.png?sv=2026-02-06&spr=https&st=2026-11-20T22%3A16%3A06Z&se=2026-11-20T23%3A16%3A06Z&sr=c&sp=r&sig=Cb5Qj0SnrFEiEVol%2BK3kiw6ErsSGY%2FeeGl1wXLjWVMM%3D) | Refresh the status of all the Controllers. | | *Search* | Enter the keyword to search for the required Controller. | | ![GUID-B9B906D7-0A24-439D-9CCA-7E3B57735B45-low.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-b18eb240-17a1-974e-62ee-051dbdfb422d.png?sv=2026-02-06&spr=https&st=2026-11-20T22%3A16%3A06Z&se=2026-11-20T23%3A16%3A06Z&sr=c&sp=r&sig=Cb5Qj0SnrFEiEVol%2BK3kiw6ErsSGY%2FeeGl1wXLjWVMM%3D) | Create a new vIPS External Controller. | | ![GUID-DDEB30D1-8F15-44F5-A05F-3D3C59BD2E8F-low.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-082bb84f-15a8-3052-bc92-5010ec755a83.png?sv=2026-02-06&spr=https&st=2026-11-20T22%3A16%3A06Z&se=2026-11-20T23%3A16%3A06Z&sr=c&sp=r&sig=Cb5Qj0SnrFEiEVol%2BK3kiw6ErsSGY%2FeeGl1wXLjWVMM%3D) | Deletes a Controller | | **Save as CSV** | Creates a .csv list of the list of Controllers | | **Other Actions** | | **Download Controller Logs** | Downloads the logs for the Controller The Controller logs are downloaded in the form of a zip file. | | **View VMs** | To view the VMs managed by the Controller. | | **Configure a public Manager name or IP** | Assigns a public IP address or a domain name for the Manager Enable the **Use a Public Manager Name or IP** in the **Public Manager Name or IP** dialog box. Enter the public IP address or a domain name in the **Public Manager Name or IP** text box and click **Save**. | | ** Controllers** | Displays the total number of Controllers available in the Manager | > [!NOTE] > Note > > For AWS, the elastic IP address assigned to the Controller is displayed. If an elastic IP address is not assigned in case of a standalone Controller, the private IP address of the Controller is displayed. vIPS Controllers![vIPS Controllers](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-335519af-71ff-1d4a-1d01-243f6921047d.png?sv=2026-02-06&spr=https&st=2026-11-20T22%3A16%3A06Z&se=2026-11-20T23%3A16%3A06Z&sr=c&sp=r&sig=Cb5Qj0SnrFEiEVol%2BK3kiw6ErsSGY%2FeeGl1wXLjWVMM%3D) 3. (Optional) To create a new External Controller, click ![GUID-B9B906D7-0A24-439D-9CCA-7E3B57735B45-low.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-b18eb240-17a1-974e-62ee-051dbdfb422d.png?sv=2026-02-06&spr=https&st=2026-11-20T22%3A16%3A06Z&se=2026-11-20T23%3A16%3A06Z&sr=c&sp=r&sig=Cb5Qj0SnrFEiEVol%2BK3kiw6ErsSGY%2FeeGl1wXLjWVMM%3D). The **Controller Details** panel appears where you can provide credentials for the cloud environment, the IP address, and the corresponding subnet details of the Controller. 4. Enter the required details: Option definitions | Option | Definition | | --- | --- | | **Controller Name** | Enter a unique name for the Controller. > [!NOTE] > Note > > This is field is editable only for External Controller. > [!NOTE] > Note > > The minimum length for name is 1 character. The name can contain up to 50 alphanumeric (upper or lower case letters) characters, including hyphens and underscores. The name must begin with a letter. | | **Description** | Enter the description for the Controller. > [!NOTE] > Note > > This is field is editable only for External Controller. > [!NOTE] > Note > > The minimum length for description is 1 character. The maximum allowed character length is 150 characters. | | **Shared Key** | Enter a secret key for the Controller. > [!NOTE] > Note > > This is field is available only for External Controller. | | **Confirm Shared Key** | Re-enter the secret key for the Controller. > [!NOTE] > Note > > This is field is available only for External Controller. | | **Public Manager Name or IP** | Public IP address or the domain name of the Manager. To assign a public IP address or a domain name for the Manager, click **Other Actions** → **Configure Manager's Public IP Address**, select **Use a Public Manager Name or IP**. Enter the public IP address or the domain name of the Manager in the **Public Manager Name or IP** text box and click **Save**. | | **Last Updated** | It is blank when creating the Controller for the first time. For an existing Controller, it displays the date, time, and user who last updated the Controller settings. | | **Trellix Vitual IPS Clusters** | It is blank when creating the Controller for the first time. For an existing Controller, it displays the list of Clusters assigned to this Controller. | | **Cloud Access** | | \| ![GUID-B9B906D7-0A24-439D-9CCA-7E3B57735B45-low.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-b18eb240-17a1-974e-62ee-051dbdfb422d.png?sv=2026-02-06&spr=https&st=2026-11-20T22%3A16%3A06Z&se=2026-11-20T23%3A16%3A06Z&sr=c&sp=r&sig=Cb5Qj0SnrFEiEVol%2BK3kiw6ErsSGY%2FeeGl1wXLjWVMM%3D) \| \| --- \| | Add a Cloud account. The Manager uses the following methods to access a Cloud account: - **Access Key**: Access Key and Shared key is used to access the AWS account. Use this method if you are running the controller in another cloud environment and not in the AWS environment. - **IAM Role**: IAM role associated with the Controller is used to access the instance. Once the Cloud account details are configured, add the Amazon Resource Name (ARN). This is required if cross-account access is required for the Controller. By using the Cloud account credentials, the Manager discovers and lists all the instances available in the VPC of the Cloud account. You can view the list of instances at **Analysis** → **** → **Virtual Machines**. | | ![GUID-B9B906D7-0A24-439D-9CCA-7E3B57735B45-low.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-b18eb240-17a1-974e-62ee-051dbdfb422d.png?sv=2026-02-06&spr=https&st=2026-11-20T22%3A16%3A06Z&se=2026-11-20T23%3A16%3A06Z&sr=c&sp=r&sig=Cb5Qj0SnrFEiEVol%2BK3kiw6ErsSGY%2FeeGl1wXLjWVMM%3D) | | \| ![Edit.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-afeae3b6-c630-1541-3315-bc8b389f323a.png?sv=2026-02-06&spr=https&st=2026-11-20T22%3A16%3A06Z&se=2026-11-20T23%3A16%3A06Z&sr=c&sp=r&sig=Cb5Qj0SnrFEiEVol%2BK3kiw6ErsSGY%2FeeGl1wXLjWVMM%3D) \| \| --- \| | Edit a Cloud account. You can also add multiple AWS accounts by clicking ![Edit.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-afeae3b6-c630-1541-3315-bc8b389f323a.png?sv=2026-02-06&spr=https&st=2026-11-20T22%3A16%3A06Z&se=2026-11-20T23%3A16%3A06Z&sr=c&sp=r&sig=Cb5Qj0SnrFEiEVol%2BK3kiw6ErsSGY%2FeeGl1wXLjWVMM%3D) and adding additional ARN details. | | ![Edit.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-afeae3b6-c630-1541-3315-bc8b389f323a.png?sv=2026-02-06&spr=https&st=2026-11-20T22%3A16%3A06Z&se=2026-11-20T23%3A16%3A06Z&sr=c&sp=r&sig=Cb5Qj0SnrFEiEVol%2BK3kiw6ErsSGY%2FeeGl1wXLjWVMM%3D) | | **Instance** > [!NOTE] > Note > > Only after the Controller establishes trust with the Manager, the below values be populated. | | **Status** | The icon displays the status of the Instance. The status can be one of the following: ![GUID-85CA65B4-AFC0-4C4E-8FDE-C2EE568AB31B-low.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-3e497562-5271-693b-f5ea-86f10ab4d380.png?sv=2026-02-06&spr=https&st=2026-11-20T22%3A16%3A06Z&se=2026-11-20T23%3A16%3A06Z&sr=c&sp=r&sig=Cb5Qj0SnrFEiEVol%2BK3kiw6ErsSGY%2FeeGl1wXLjWVMM%3D) Online ![GUID-892707E8-C66C-4340-8E1B-D8BE9CBF317D-low.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-e30c5710-87ad-15dd-6e1f-859cb6ff312d.png?sv=2026-02-06&spr=https&st=2026-11-20T22%3A16%3A06Z&se=2026-11-20T23%3A16%3A06Z&sr=c&sp=r&sig=Cb5Qj0SnrFEiEVol%2BK3kiw6ErsSGY%2FeeGl1wXLjWVMM%3D) Disconnected | | **Hostname** | Displays the name of the Controller. | | **Name Tag** | Displays the tag of the Controller. | | **Private IP Address** | Displays the private IP address of the Controller. | | **Public IP Address** | Displays the public IP address of the Controller. | | **Instance ID** | Displays the ID of the Controller. | | **Cloud** | Displays the Virtual Cloud network details of the Controller. | | **Region** | Displays the Region of the Controller. | | **Controller Software** | Displays the Controller software version. | | **Probe Software** | Displays the vIPS Probe software version. | | **Save** | Click to save the settings. | Controller details panel for AWS![Controller details panel for AWS](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-41eddff8-4eae-f460-956f-2efcb8d4e230.png?sv=2026-02-06&spr=https&st=2026-11-20T22%3A16%3A06Z&se=2026-11-20T23%3A16%3A06Z&sr=c&sp=r&sig=Cb5Qj0SnrFEiEVol%2BK3kiw6ErsSGY%2FeeGl1wXLjWVMM%3D) If you have selected **Amazon** as the **Cloud Environment**, the following details are displayed: | Option | Definition | | --- | --- | | **Cloud Environnment** | **Amazon** | | **Region** | Select the name of the region in which your Controller resides. | | **Access Method** | Select one of the methods given below to access the AWS environment: - **Access Key**: Access Key and Shared key is used to access the AWS account. Enter the following details: - **Access Key** — Enter the Access Key for API access of your AWS account. This key should allow minimum AmazonEC2ReadOnlyAccess. - **Secret Key** — Enter the Secret Key associated with the Access Key. - **Detected IAM Role** — Displays the IAM role associated with the Manager | | **Amazon Resource Name (ARN)** > [!NOTE] > Note > > The fields for ARN are optional. These fields are used only when you wish to configure cross account access. | | **Name** | Enter the name associated with the ARN. | | **Role ARN** | Enter the ARN value associated with the role to access the AWS environment. | | **Save** | Click to save the settings. | Controller details panel for AWS![Controller details panel for AWS](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-97868e93-2e16-14f8-ff8f-692513d71700.png?sv=2026-02-06&spr=https&st=2026-11-20T22%3A16%3A06Z&se=2026-11-20T23%3A16%3A06Z&sr=c&sp=r&sig=Cb5Qj0SnrFEiEVol%2BK3kiw6ErsSGY%2FeeGl1wXLjWVMM%3D) 5. To configure multiple AWS account complete the following steps: 1. Create the IAM role to attach the Manager. 2. Create and Inline Policy for the IAM role as given below. ``` { "Version": "2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "ec2:DescribeInstances", "ec2:DescribeAddresses", "ec2:DescribeInstanceStatus", "sts:AssumeRole" ], "Resource": "*" } ] } ``` 3. For multiple AWS account, you need to create a role in the second account and create a policy in the first account user/role so that the user/role can assume the user/role in the second account. In the main AWS account, configure the below policy to the account. ``` multiaccount__account1assumePolicy (Custom/Inline Policy – to assume role in second account) { "Version": "2012-10-17", "Statement": [ { "Action": "sts:AssumeRole", "Resource": "arn:aws:iam::xxxxxxxxxxxxx:role/account2role2020-08-01_11-31-13-367", "Effect": "Allow" } ] } ``` | Option | Definition | | --- | --- | | `Action` | The action that the user can perform in other account. | | `Effect` | The effect for the action for the user. | 4. For cross account access in the second AWS account, enter the ARN of user/role in the first account in the **Trust relationship**. If you are using the user access, Add the user ARN like given below: ``` arn:aws:iam::xxxxxxxxxxxxx:user/john_doe@trellix.com ``` If you are using the instance access, Add the instance ARN like given below: ``` arn:aws:sts::xxxxxxxxxxxxx:assumed-role/AttachEIP/i-xxxxxxxxxxxxxxxxx ``` 5. Add the ARN details in the Manager. 6. To view the details for a Controller, double-click the Controller. The **Controller Details** panel opens. It displays the Controller and Probe version installed along with the date, time and the user who last modified it. 7. To edit a Controller, double-click the Controller and edit the required details in the **Controller** panel and click **Save**. > [!NOTE] > Note > > You can edit only the **Shared Secret**, **Confirm Shared Secret**, **Comment**, **Access Key**, and **Shared Key** fields. To change the **Hostname (local IP address)**, you must recreate the Controller. > [!NOTE] > Note > > If you edit the **Shared Secret** for a Controller launched in AWS environment, you have to stop the Controller instance in the AWS environment and update the **User data** to reflect the updated **Shared Secret** key.