Skip to main content

Cyware Orchestrate

Symantec Management Center Service

App Vendor: Symantec

App Category: Configuration Management Database (CMDB)

Connector Version: 1.2.0

API Version: 2.0

About App

Symantec Management Center provides a unified management environment for the Symantec security platform portfolio of products. Management Center brings Symantec's network, security, and cloud technologies to you under a single umbrella making it easier to deploy, manage, and monitor your security environment.

The Symantec Management Center Service connector app is configured with the Orchestrate application to perform the following actions:

Action Name

Description

Get Alerts

This action retrieves the list of all available alerts.

Add Policy Content

This action adds content to a policy. You can add content such as IP address, URL, and Category.

Auth Role Name

This action retrieves the role specified by the name.

Auth Roles

This action retrieves a list of all roles.

Auth User Permission

This action retrieves a list of users and their permissions.

Auth Users

This action retrieves the auth users defined in the system.

Create Devices

This action creates a new device.

Create Policies

This action creates new policies.

Create Tenants

This action creates new tenants.

Delete Tenants

This action deletes a tenant.

Get All Groups

This action retrieves a list of all groups.

Get Connect Info Devices

This action retrieves a list of connections of all registered devices.

Get Devices

This action retrieves a list of devices.

Get Policies

This action retrieves a list of policies.

Get Policy Content

This action retrieves the content of a policy. A policy can contain IP address, URL, and Category.

Get Specific Alerts

This action retrieves a specific alert.

Get Specific Devices

This action retrieves the specific registered devices.

Get Specific Policies

This action retrieves the policies identified by the UUID.

Get Specific Tenants

This action retrieves specific tenants.

Get Target Policies

This action retrieves the list of targets associated with the policies.

Get Tenants

This action retrieves the list of all tenants.

License Info Devices

This action retrieves the license information of all registered devices.

Raise Alerts

This action raises a new alert.

Remove Devices

This action removes the device.

Software Info Devices

This action retrieves the software information of all registered devices.

Update Policies

This action updates a policy.

Update Specific Alerts

This action updates a specific alert.

Update Specific Tenants

This action updates specific tenants.

Configuration Parameters

The following configuration parameters are required for the Symantec Management Center Service connector app to communicate with the Symantec Management Center Service enterprise application. The parameters can be configured by creating instances in the connector app.

Parameter

Description

Field Type

Required/Optional

Comments

Base URL

Enter the base URL.

Example:

https:<host>:<port>/api

Text

Required

API Token

Enter the API token.

Example:

"402880824ff933a4014ff9345d7c0002"

Password

Required

TLS verification

Specify your preference to either verify or not verify the TLS certificate.

Boolean

Optional

Allowed values:

  • true

  • false

Default value:

  • false

Action: Get Alerts

This action retrieves the list of all available alerts.

Action Input Parameters

This action does not require any input parameter.

Action: Add policy Content

This action adds content to a policy. You can add content such as IP address, URL, and Category.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

UUID

Specify the unique ID for the policy.

Example:

"D1055376-3448-4A94-82DB-D9BD30BBB420"

Text

Required

Content type

Specify the content type for the policy.

Example:

"cpl"

Text

Required

Allowed values:

  • cplf

  • cpl

Change description

Specify the description for the policy content.

Example:

"Sample Description"

Text

Required

Schema version

Specify the version of the schema for the content. The version value will correspond to the format of the content.

Example:

"1.0"

Text

Required

IP addresses

Specify the list of IP addresses.

Example:

$LIST[192.168.2.2, 10.0.0.10]

List

Optional

URLs

Specify the list of URLs.

Example:

$LIST[www.sub.domain.tld, www.sub.domain2.tld]

List

Optional

Categories

Specify the list of categories.

Example:

$LIST[Sample Category, Sample Category 2]

List

Optional

Enabled

Specify if you want to enable policy content.. 1 for enabled. 0 for not.

Boolean

Optional

Supported values:

  • 1 - Enable policy content

  • 0 - Do not enable policy content

Description

Specify the content description for the policy.

Example:

"Updated deny list with new entries"

Text

Optional

Example Request

{
  "content" : {
    "urls" : [ {
      "url" : "www.badsite.com",
      "description" : "Block this site",
      "enabled" : 1
    }, {
      "url" : "www.donotenter.com",
      "description" : "Block this site",
      "enabled" : 1
    } ],
    }
  },
  "contentType" : "cpl",
  "schemaVersion" : "1.0",
  "changeDescription" : "Updated deny list with new entries",
  "uuid" : "D1055376-3448-4A94-82DB-D9BD30BBB420"
}
Action: Auth Role Name

This action retrieves the role specified by the name.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Role name

Specify the role name to retrieve details.

Example:

"OperatorRole"

Text

Required

Example Request

[
    {
        "role_name" : "OperatorRole"
    }
]
Action: Auth Roles

This action retrieves a list of all roles.

Action Input Parameters

This action does not require any input parameter.

Action: Auth User Permission

This action retrieves a list of users and their permissions.

Action Input Parameters

This action does not require any input parameter.

Action: Auth Users

This action retrieves the auth users defined in the system.

Action Input Parameters

This action does not require any input parameter.

Action: Create Devices

This action creates a new device.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Create data

Specify the device data to be created.

Key Value

Optional

Example Request

[
    {
      "name" : "SSLV-BXB27",
      "description" : "Example Device Description",
      "type" : "sslv",
      "serialNumber" : "...",
      "authType" : "HTTP_BASIC_AUTH",
      "host" : "10.2.17.2",
      "port" : 8082,
      "https" : true,
      "role" : "Operator",
    }
]
Action: Create Policies

This action creates new policies.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Create data

Specify the data to be created for the policy.

Key Value

Optional

Example Request

[
    {
      "name" : "MY-POLICY",
      "contentType" : "cpl",
      "description" : "Sample Description",
      "referenceId" : "my_policy",
      "tenant" : "default",
      "author" : "api_user",
      "shared" : false,
      "replaceVariables" : true
    }
]
Action: Create Tenants

This action creates new tenants.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Create data

Specify the data for the tenant creation.

Key Value

Required

Example Request

[
    {
      "externalId" : "SSLV-TENANT",
      "name" : "SSLV-BXB27-CORP",
      "description" : "Tenant used for SSL intercept",
      "system" : true
    }
]
Action: Delete Tenants

This action deletes a tenant.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

UUID

Specify the unique ID of the tenant.

Example:

"D1055376-3448-4A94-82DB-D9BD30BBB420"

Text

Required

Example Request

[
    {
        "uuid" : "D1055376-3448-4A94-82DB-D9BD30BBB420"
    }
]
Action: Get All Groups

This action retrieves a list of all groups.

Action Input Parameters

This action does not require any input parameter.

Action: Get Connect Info Devices

This action retrieves a list of connections of all registered devices.

Action Input Parameters

This action does not require any input parameter.

Action: Get Devices

This action retrieves a list of devices.

Action Input Parameters

This action does not require any input parameter.

Action: Get Policies

This action retrieves a list of policies.

Action Input Parameters

This action does not require any input parameter.

Action: Get Policy Content

This action retrieves the content of a policy. A policy can contain IP address, URL, and Category.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

UUID

Specify the unique ID of the policy to retrieve policy content.

Example:

"D1055376-3448-4A94-82DB-D9BD30BBB420"

Text

Required

Example Request

[
    {
        "uuid" : "D1055376-3448-4A94-82DB-D9BD30BBB420"
    }
]
Action: Get Specific Alerts

This action retrieves a specific alert.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

UUID

Specify the unique ID for the alert.

Example:

"2D8DC8C9-FEB0-424A-B816-7EFEF3783734"

Text

Required

Example Request

[
    {
        "uuid" : "2D8DC8C9-FEB0-424A-B816-7EFEF3783734"
    }
]
Action: Get Specific Devices

This action retrieves the specific registered devices.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

UUID

Specify the unique ID of the device.

Example:

"D1055376-3448-4A94-82DB-D9BD30BBB420"

Text

Required

Example Request

[
    {
        "uuid" : "D1055376-3448-4A94-82DB-D9BD30BBB420"
    }
]
Action: Get Specific Policies

This action retrieves the policies identified by the UUID.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

UUID

Specify the unique ID for the policy.

Example:

"D1055376-3448-4A94-82DB-D9BD30BBB420"

Text

Required

Example Request

[
    {
        "uuid" : "D1055376-3448-4A94-82DB-D9BD30BBB420"
    }
]
Action: Get Specific Tenants

This action retrieves specific tenants.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

UUID

Specify the unique ID for the tenant.

Example:

"D1055376-3448-4A94-82DB-D9BD30BBB420"

Text

Required

Example Request

[
    {
        "uuid" : "D1055376-3448-4A94-82DB-D9BD30BBB420"
    }
]
Action: Get Target Policies

This action retrieves the list of targets associated with the policies.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

UUID

Specify the unique ID for the target policy.

Example:

"D1055376-3448-4A94-82DB-D9BD30BBB420"

Text

Required

Example Request

[
    {
        "uuid": "D1055376-3448-4A94-82DB-D9BD30BBB420"
    }
]
Action: Get Tenants

This action retrieves the list of all tenants.

Action Input Parameters

This action does not require any input parameter.

Action: License Info Devices

This action retrieves the license information of all registered devices.

Action Input Parameters

This action does not require any input parameter.

Action: Raise Alerts

This action raises a new alert.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Create data

Specify the data to be added for the alert.

Key Value

Required

Example Request

[
    {
      "uuid" : "2D8DC8C9-FEB0-424A-B816-7EFEF3783734",
      "received" : "2020-12-25T10:14:19",
      "owner" : "emma",
      "state" : "IN_PROGRESS",
      "category" : "SYSTEM",
      "severity" : "INFO",
    }
]
Action: Remove Devices

This action removes the device.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

UUID

Specify the unique ID for the device.

Text

Required

Example Request

[
    {
        "uuid" : "D1055376-3448-4A94-82DB-D9BD30BBB420"
    }
]
Action: Software Info Devices

This action retrieves the software information of all registered devices.

Action Input Parameters

This action does not require any input parameter.

Action: Update Policies

This action updates a policy.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

UUID

Specify the unique ID for the policy to update.

Example:

"D1055376-3448-4A94-82DB-D9BD30BBB420"

Text

Required

Update data

Enter the data to be updated for the policy.

Key Value

Required

Example Request

[
    {
      "content" : {
      "urls" : [ {
          "url" : "www.badsite.com",
          "description" : "Block this site",
          "enabled" : 1
    }, {
          "url" : "www.donotenter.com",
          "description" : "Block this site",
          "enabled" : 1
    } ],
    }
  },
  "contentType" : "cpl",
  "schemaVersion" : "1.0",
  "changeDescription" : "Updated deny list with new entries",
  "uuid" : "D1055376-3448-4A94-82DB-D9BD30BBB420"
}
]
Action: Update Specific Alerts

This action updates a policy.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

UUID

Specify the unique ID for the alert.

Text

Required

Update alert

Enter the data to be updated for the alert.

Key Value

Required

Example Request

[
    {
      "uuid" : "2D8DC8C9-FEB0-424A-B816-7EFEF3783734",
      "received" : "2020-12-25T10:14:19",
      "owner" : "emma",
      "state" : "IN_PROGRESS",
      "category" : "SYSTEM",
      "severity" : "INFO",
    }
]
Action: Update Specific Tenants

This action updates specific tenants.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

UUID

Enter the unique ID for the tenant.

Text

Required

Update data

Enter the data to be updated for the tenant.

Key Value

Required

Example Request

[
    {
      "uuid" : "D1055376-3448-4A94-82DB-D9BD30BBB420",
      "externalId" : "SSLV-TENANT",
      "name" : "SSLV-BXB27-CORP",
      "description" : "Tenant used for SSL intercept",
      "system" : true
    }
]