Managing Connectors

Notes and Constraints

• Built-in connectors cannot be edited or deleted.
• Built-in connections cannot be started, stopped, edited, deleted, or configured.
• Built-in operation connections cannot be edited or deleted.

Managing Connectors

This section describes how to check connectors and check connector details.

1. Log in to the SecMaster console.
2. Click in the upper left corner of the management console and select a region or project.
3. 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
   

4. In the navigation pane on the left, choose Settings > Connectors.

5. View the connector list. You can view information about existing connectors on the connector management page.

   Table 1 Connector list parameters

   Parameter	Description
   Name/ID	Name and ID of a connector. The connector ID is automatically generated by the system.
   Source	Source vendor and product information.
   Destination	Destination vendor and product information.
   Built-in	Whether the connector is built in the system.
   Connection Status	Number of connections by status for a connector. Running: displays the number of connections in the Running state. Paused: displays the number of connections in the Paused state.
   Created	Time when a connector was created.
   Operation	Built-in connectors cannot be edited or deleted.

   To view details about a connector, you need to click the connector name on the Connectors page.

   Table 2 Parameters on the connector details page

   Parameter	Description
   Basic Information	You can view the connector name and ID.
   Source	You can view the source description, vendor, and product information.
   Destination	You can view the destination description, vendor, and product information.
   Connections	You can view the list of connections associated with the connector. For details about connection parameters, see Table 3.

   Table 3 Connection parameters

   Parameter	Description
   Connection Name	Name of the connection.
   Source Operation Connection	Source operation connection. It specifies the authentication method and parameters of the source.
   Destination Operation Connection	Destination operation connection. It specifies the authentication method and parameters of the destination.

Managing Connections

On the connector details page, you can view connections..

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

4. In the navigation pane on the left, choose Settings > Connectors.

5. On the Connectors page, click the name of the target connector to go to the Connector Details page.
6. In the Connections area on the connector details page, view the existing connections of the connector.

   Table 4 Connection list parameters

   Parameter	Description
   Connection Name/ID	Name and ID of a connection. The connection ID is automatically generated by the system.
   Source Operation Connection	Source operation connection associated with the connection. The source operation connection specifies the authentication method and parameters of the source.
   Destination Operation Connection	Destination operation connection associated with the connection. The destination operation connection specifies the authentication method and parameters of the destination.
   Status	Connection status. The options are as follows: Running: The connection has been started. Paused: The connection has been disabled.
   Built-in	Whether the connection is built in the system. Built-in: The connection is built in the system.
   Parameter	Connector execution parameters and their values. Different connections can pass runtime parameters with different values.
   Last Executed	Last time when the connection was executed.
   Operation	Built-in connections cannot be started, stopped, edited, deleted, or configured.

Managing Operation Connections

This section describes how to view operation connections, edit custom operation connections, and delete custom operation connections.

1. Log in to the SecMaster console.
2. Click in the upper left corner of the management console and select a region or project.
3. 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
   

4. In the navigation pane on the left, choose Settings > Connectors.

5. On the Connectors page, click the name of the target connector to go to the Connector Details page.
6. On the connector details page, click Manage Operation Connections to go to the operation connection management page.
7. Add an operation connection.
   1. On the operation connection management page, click Add Operation Connection.
   2. On the displayed page, configure operation connection parameters.

      Table 5 Operation connection parameters

      Parameter	Description
      Name	Enter a name for the operation connection. The operation connection naming rules are as follows: Only uppercase letters (A to Z), lowercase letters (a to z), digits (0 to 9), and the following special characters are allowed: -_. The value can contain 1 to 64 characters.
      Type	Select the operation connection type based on the authentication method supported by the API to be called. AK&SK: An AK and an SK are required for authentication. You need to manually enter the required endpoint, AK, and SK. For details about how to obtain the AK/SK, see How Do I Obtain an Access Key (AK/SK)?. Username and password: A username and password are required for authentication. You need to manually enter the required endpoint, username, and password. Agency: 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 and uses the cloud service agency for authentication. For more information about cloud service agency authorization, see Authorizing SecMaster. Other: If an authentication method other than AK&SK, username and password, and cloud service agency is used for calling APIs, set Type to Other.
      Credentials	If Type is set to AK&SK, you need to configure the Attachment Address, AK, and SK fields. Attachment Address is the domain name (endpoint). If Type is set to Username and password, you need to configure the Attach Address, Username, and Password fields. Attachment Address is the domain name (endpoint). If Type is set to Cloud service agency, you do not need to manually enter authentication parameters. If Type is set to Other, you can enter custom JSON string to specify the Authentication Parameter (Optional). The string can contain a maximum of 30,000 characters, for example, {"token": "xxxx"}. If no authentication is required for calling the API, there is no need to configure this parameter.
      Authentication Parameter (Optional)	Custom JSON string, which is used to specify other authentication parameters. The string cannot exceed 30,000 characters.
      Description (Optional)	(Optional) Enter a description for the operation connection. The description can contain a maximum of 1,000 characters.

   3. After configuring the parameters, click OK in the lower right corner of the page. You can view the added operation connection on the operation connection management page. In the operation connection list, the Built-in column shows the operation connection type: Custom or Built-in.

8. View an operation connection. On the operation connection management page, you can view the operation connection list.

   Table 6 Operation connection list parameters

   Parameter	Description
   Name/ID	Name/ID of an operation connection. The operation connection ID is automatically generated by the system.
   Type	Type of an operation connection. AK&SK: An AK and SK are used for authentication. Username and password: A username and password are used for authentication. Agency: The system automatically obtains the domain name (endpoint) of the corresponding cloud service and uses the cloud service agency for authentication. For more information about cloud service agency authorization, see Authorizing SecMaster. Other: An authentication method other than AK&SK, username and password, and cloud service agency is used for calling APIs.
   Built-in	Whether the operation connection is built in the system.
   Description	Description of an operation connection.
   Updated	Time when an operation connection was updated.
   Operation	You can edit and delete custom operation connections. Built-in operation connections cannot be edited or deleted.

9. Edit an operation connection. Built-in operation connections cannot be edited. Only custom operation connections can be edited.
   1. On the Manage Operation Connections page, locate the target operation connection and click Edit in the Operation column.
   2. On the displayed page, modify the configuration information of the operation connection. For details about the parameters of an operation connection, see Table 5.
   3. After modification is complete, click OK.
   4. Return to the operation connection management page and view the modified operation connection.

10. Delete an operation connection. Before deleting an operation connection, make sure it is not in use by any connection. Built-in operation connections cannot be deleted. Only custom operation connections can be deleted.
    1. On the Manage Operation Connections page, locate the target operation connection and click Delete in the Operation column. To delete multiple custom operation connections all at once, select the target operation connections and click Delete above the operation connection list.
    2. Scenario 1: MFA Has Been Configured in IAM

       In the Delete Operation Connection dialog box displayed, confirm the information, enter the credential authentication information, and click OK.

       The verification method can be a mobile number, an email address, or a virtual MFA. For more information about MFA, see MFA Overview.

       Scenario 2: MFA Is Not Enabled in IAM

       In the Delete Operation Connection dialog box displayed, confirm the information, click Auto Enter to auto-fill DELETE in the text box below, and click OK.

    3. Return to the Manage Operation Connections page. The deleted operation connection is no longer displayed in the list.