Skip to main content

IBM MaaS360 Security

This Integration is part of the IBM MaaS360 Security Pack.#

Supported versions

Supported Cortex XSOAR versions: 8.4.0 and later.

This is the IBM MaaS360 Security integration for Cortex XSIAM.

Create App credentials#

To access the IBM MaaS360 Security API, you first need to generate an App access key. Follow these steps:

  1. Log in to the IBM MaaS360 portal.

  2. Go to Setup > Manage Access Keys. Generate access key

  3. Click Generate Access Key. Generate access key

  4. Create a new MaaS360 Web Services key. Generate access key

  5. Get App ID, App Version, Platform ID, and App Access Key. Generate access key

For further assistance, you may contact IBM MaaS360 support to request these credentials as well.
See Configuring provisioning for MaaS360

Find your Billing ID#

  1. Log in to the IBM MaaS360 portal.

  2. Hover over the profile menu on the top right and copy the Account ID value. This is your Billing ID. Get Billing ID

Account permissions#

To collect events, the user requires read-only permissions. Follow these steps to modify user permissions:

  1. Log in to the IBM MaaS360 portal.

  2. Go to Setup > Administrators Admin permissions

  3. Find the relevant administrator account or create a new one.

  4. Click Edit. (Note: This does not appear for the primary admin account.) Admin permissions

  5. Add the Read-Only permission. Admin permissions

Configure IBM MaaS360 Security on Cortex XSIAM#

  1. Navigate to Settings > Configurations > Data Collection > Automations & Feed Integrations.

  2. Search for IBM MaaS360 Security.

  3. Click Add instance to create and configure a new integration instance.

    ParameterDescriptionRequired
    Server URLTrue
    User NameTrue
    PasswordTrue
    App IDTrue
    App VersionTrue
    Platform IDTrue
    App Access KeyTrue
    Billing IDTrue
    Maximum number of Admin Login Reports events per fetchRounds up to the nearest page size increment. (250)False
    Maximum number of Admin Changes Audit events per fetchRounds up to the nearest page size increment. (250)False
    Trust any certificate (not secure)False
    Use system proxy settingsFalse
  4. Click Test to validate the URLs, token, and connection.

Commands#

You can execute these commands from the Cortex XSIAM CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.

ibm-maas360-security-get-events#


Gets events from IBM MaaS360 Security.

Base Command#

ibm-maas360-security-get-events

Input#

Argument NameDescriptionRequired
should_push_eventsIf true, the command will create events, otherwise it will only display them. Possible values are: true, false. Default is false.Required
limitMaximum number of results to return.Required
from_dateDate from which to get events.Optional

Context Output#

There is no context output for this command.

Human Readable Output#

Admin audits#

_timesource_log_typeupdateDateperformedByoperationTypeipAddressadministrator
2024-10-29T13:39:32Zadmin_changes_audit1730209172000test@mail.comCHANGE1.1.1.1email: test@mail.com
username: test@mail.com
firstName: tester
middleName:
lastName: tester
address:
phone:
jobTitle:
watchSubscription: Y
accountStatus: Active
managedUserGroups: All groups
lastLoginTime:
rolesAdded:
rolesDeleted:
previousState:
2024-10-29T13:39:32Zadmin_changes_audit1730209172000test@mail.comCHANGE1.1.1.1email: test@mail.com
username: test@mail.com
firstName: tester
middleName:
lastName: tester
address:
phone:
jobTitle:
watchSubscription: Y
accountStatus: Active
managedUserGroups: All groups
lastLoginTime:
rolesAdded: Help Desk
rolesDeleted:
previousState:
2024-10-29T12:53:49Zadmin_changes_audit1730206429000test@mail.comCHANGE1.1.1.1email: test@mail.com
username: test@mail.com
firstName: tester
middleName:
lastName: tester
address:
phone:
jobTitle:
watchSubscription: Y
accountStatus: Active
managedUserGroups: All groups
lastLoginTime:
rolesAdded:
rolesDeleted:
previousState:
2024-10-29T12:53:49Zadmin_changes_audit1730206429000test@mail.comCHANGE1.1.1.1email: test@mail.com
username: test@mail.com
firstName: tester
middleName:
lastName: tester
address:
phone:
jobTitle:
watchSubscription: Y
accountStatus: Active
managedUserGroups: All groups
lastLoginTime:
rolesAdded:
rolesDeleted: Help Desk
previousState:
2024-10-29T12:41:31Zadmin_changes_audit1730205691000test@mail.comCHANGE1.1.1.1email: test@mail.com
username: test@mail.com
firstName: tester
middleName:
lastName: tester
address:
phone:
jobTitle:
watchSubscription: Y
accountStatus: Active
managedUserGroups: All groups
lastLoginTime:
rolesAdded:
rolesDeleted:
previousState: