Managing Asset Connections

Scenarios

• What is an asset connection: An asset connection includes the domain name and authentication parameters required by each plug-in node in the security orchestration process.
• Function: During security orchestration, each plug-in node transfers the domain name to be connected and the authentication information, such as the username, password, and account AK/SK, to establish connections.
• Relationship between asset connections and plug-ins: Plug-ins access other cloud services or third-party services through domain names and authentication. So, domain name parameters (endpoints) and authentication parameters (username/password, account AK/SK, etc.) are defined in the login credential parameters of plug-ins. An asset connection configures login credential parameters for a plug-in. In a workflow, each plug-in node is associated with different asset connections so that the plug-in can access different services.

This topic describes how to manage asset connections, including Adding an Asset Connection, Viewing Asset Connections, Editing an Asset Connection, and Deleting an Asset Connection.

Adding an Asset Connection

1. Log in to the management console.
2. Click in the upper left corner of the management console and select a region or project.
3. Click in the upper left corner of the page and choose Security & Compliance > SecMaster.
4. In the navigation pane on the left, choose Workspaces > Management. In the workspace list, click the name of the target workspace.
   Figure 1 Workspace management page
   

5. In the navigation pane on the left, choose Security Orchestration > Playbooks. On the displayed page, click the Asset Connections tab.
   Figure 2 Asset Connections tab
   

6. On the Asset Connections tab page, click Add. The slide-out panel Add is displayed on the right.
7. On the panel, set asset connection parameters. For details about the parameters, see Table 1.

   Table 1 Asset connection parameters

   Parameter	Description
   Connection Name	Enter the asset connection name. The naming rules are as follows: Only uppercase letters (A to Z), lowercase letters (a to z), digits (0 to 9), and underscores (_) are allowed. A maximum of 64 characters are allowed.
   Description	(Optional) Enter the asset description. The description can contain a maximum of 64 characters.
   Plug In	Select the plug-in required for the asset connection. For details about the plug-in, see Viewing Plug-in Details.
   Connection Type	Select the type of the asset connection. Cloud service agency: If a cloud service plug-in is used, the cloud service agency is recommended. You do not need to manually enter authentication parameters such as the domain name, username, and password. The system automatically obtains the domain name (endpoint) of the corresponding cloud service based on the plug-in name and uses the cloud service agency for authentication. AK&SK: You need to manually enter the domain name (endpoint) and provide an AK and SK for authentication. Username and password: You need to manually enter the domain name (endpoint) and provide a username and password for authentication. Others: Some plug-ins have other authentication parameters in addition to the preceding authentication parameters. Set these parameters based on the plug-in login credential parameter guide.
   Credential	Enter the credential information, such as the endpoint, AK, and SK, based on the selected connection type.

8. Click OK. You can query the created asset connection in the asset connection list.

Viewing Asset Connections

1. Log in to the management console.
2. Click in the upper left corner of the management console and select a region or project.
3. Click in the upper left corner of the page and choose Security & Compliance > SecMaster.
4. In the navigation pane on the left, choose Workspaces > Management. In the workspace list, click the name of the target workspace.
   Figure 3 Workspace management page
   

5. In the navigation pane on the left, choose Security Orchestration > Playbooks. On the displayed page, click the Asset Connections tab.
   Figure 4 Asset Connections tab
   

6. On the Asset Connections tab page, view information about asset connections.
   Figure 5 Viewing asset connections
   
   • In the asset connection list, you can view the name, plug-in, and creator of an asset connection.
   • If there are many asset connections displayed, use filters to search for a specific one.
   • To view details about an asset connection, click its name to go to its Detail panel.

Editing an Asset Connection

1. Log in to the management console.
2. Click in the upper left corner of the management console and select a region or project.
3. Click in the upper left corner of the page and choose Security & Compliance > SecMaster.
4. In the navigation pane on the left, choose Workspaces > Management. In the workspace list, click the name of the target workspace.
   Figure 6 Workspace management page
   

5. In the navigation pane on the left, choose Security Orchestration > Playbooks. On the displayed page, click the Asset Connections tab.
   Figure 7 Asset Connections tab
   

6. In the row containing a desired asset connection, click Edit in the Operation column. The slide-out panel Edit is displayed.
7. On the Edit panel, edit asset connection parameters. For details about the parameters, see Table 2.

   Table 2 Asset connection parameters

   Parameter	Description
   Connection Name	Enter the asset connection name. The naming rules are as follows: Only uppercase letters (A to Z), lowercase letters (a to z), digits (0 to 9), and underscores (_) are allowed. A maximum of 64 characters are allowed.
   Description	(Optional) Enter the asset connection description. The description can contain a maximum of 64 characters.
   Plug In	Select the plug-in required for the asset connection. For details about plug-ins, see Viewing Plug-in Details.
   Created By	The creator of the asset connection. This parameter cannot be modified.
   Created	Time when the asset connection is created. This parameter cannot be modified.
   Modified By	The user who last modifies the asset connection. This parameter cannot be modified.
   Connection Type	Select the type of the asset connection.
   Credential	Enter the credential information, such as AK and SK, based on the selected connection type.

8. Click OK.

Deleting an Asset Connection

1. Log in to the management console.
2. Click in the upper left corner of the management console and select a region or project.
3. Click in the upper left corner of the page and choose Security & Compliance > SecMaster.
4. In the navigation pane on the left, choose Workspaces > Management. In the workspace list, click the name of the target workspace.
   Figure 8 Workspace management page
   

5. In the navigation pane on the left, choose Security Orchestration > Playbooks. On the displayed page, click the Asset Connections tab.
   Figure 9 Asset Connections tab
   

6. Locate the row that contains a desired asset connection, click Delete in the Operation column.
7. In the deletion confirmation dialog box displayed, click OK to confirm the deletion.
   

   Deleted assets cannot be restored. Exercise caution when performing this operation.