Skip to main content

Cyware Orchestrate

Microsoft SCOM

App Vendor: Microsoft

App Category: IT Services

Connector Version: 1.0.0

API Version: 1.0.0

Notice

This is a beta-app and the documentation is in progress.

About App

Microsoft System Center Operations Manager (SCOM) is a cross-platform data center monitoring system for operating systems and hypervisors. The Microsoft SCOM app enables security teams to integrate with the Microsoft SCOM enterprise application to manage and monitor rules, entities, alerts, and dashboards of systems in an enterprise.

The Microsoft SCOM app is configured with the Orchestrate application to perform the following actions:

Action Name

Description

Retrieve Alert Data

This action retrieves alert data.

Retrieve Alert Columns

This action retrieves alert columns.

Retrieve a Dashboard

This action retrieves a dashboard.

Retrieve Entity Name

This action retrieves an entity name.

Retrieve Group Data

This action retrieves the details of a group.

Retrieve Monitor Information

This action retrieves monitor information.

Retrieve Rules

This action retrieves rules.

Retrieving Tasks

This action retrieves tasks.

Retrive a Widget

This action retrieves a widget.

Configuration Parameters

The following configuration parameters are required for the Microsoft SCOM app to communicate with the Microsoft SCOM enterprise application. The parameters can be configured by creating instances in the app.

Parameter

Description

Field Type

Required/Optional

Comments

Base URL

Enter the base URL.

Example:

"https://cyware.com"

Text

Required

Username

Enter the username

Text

Required

Password

Enter the password

Password

Required

Action: Retrieve Alert Data

This action retrieves alert data.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Class ID

Enter the class ID of an alert.

Example:

"sample id"

Text

Required

Criteria

Enter the criteria.

Example:

{ "priority": "low" }

Text

Required

Allowed values:

  • severity

  • priority

  • resolution state

Display Columns

Enter the display columns.

Example:

"Alert ID"

Text

Required

You can retrieve the column names using the Retrieve Alert Columns action.

Object ID

Enter the object IDs.

Example:

"sample object id"

Text

Required

Example Request

[
  {
    "criteria": 
    {
      "priority": "low"
    },
    "displaycolumns": "Alert ID",
    "class_id": "sample id",
    "object_ids": "sample object id"
  }
]
Action: Retrieve Alert Columns

This action retrieves alert columns.

Action Input Parameters

This action does not require any input parameter.

Action: Retrieve a Dashboard

This action can be used to retrieve a dashboard.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Dashboard ID

Enter the dashboard ID.

Example:

"sample id"

Text

Required

Example Request

[
  {
    "dashboard_id": "sample id"
  }
]
Action: Retrieve Entity Name

This action retrieves the entity name.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Entity ID

Enter the entity ID.

Example:

"sample id"

Text

Required

Example Request

[
  {
    "entity_id": "sample id"
  }
]
Action: Retrieve Group Data

This action retrieves the details of a group.

Action Input Parameters

This action does not require any input parameter.

Action: Retrieve Monitor Information

This action retrieves the details of a monitor.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Monitor ID

Enter the monitor ID.

Example:

"sample id"

Text

Required

Example Request

[
  {
    "monitor_id": "sample id"
  }
]
Action: Retrieve Rules

This action retrieve a list of rules.

Action Input Parameters

This action does not require any input parameter.

Action: Retrieving Tasks

This action retrieves a list of tasks.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Task ID

Enter the task ID.

Example:

"sample id"

Text

Required

View Type

Enter the view type.

Example:

"sample type"

Text

Required

Example Request

[
  {
    "ids": "sample id",
    "view_type": "sample type"
  }
]
Action: Retrive a widget

This action retrieves the details of a widget.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Widget ID

Enter the widget ID.

Example:

"sample id"

Text

Required

Example Request

[
  {
    "widget_id": "sample id"
  }
]