Key Concepts and Terms
Below are key concepts and terms to help you get started with SOCless:
- Playbooks: The automated processes you create. Playbooks contain a series of coordinated steps that work towards an end goal. They are written in JSON
- AWS Step Functions: The AWS service that manages playbook executions.
- State: A single step in a playbook. States can take actions, evaluate choices, parallelize actions, wait for time periods, or aid debugging of playbooks.
- Integrations: AWS Lambda functions that integrate with your existing security products. States use integrations to take actions in playbooks. Integrations are written in Python. The term may refer to a single function, or a group of functions related to the same product.
- Event Endpoints: AWS Lambda functions that process incoming events and trigger playbook executions.
- Event Triggers: Services that trigger event endpoints. Currently tested event triggers include AWS API Gateway for http-based alerts, and AWS CloudWatch for scheduled events. However, any service that can trigger an AWS Lambda function may serve as an event trigger.
- Event Table: The AWS DynamoDB table that stores event data. Event endpoints create events in the Event Table.
- Execution Results Table. The AWS DynamoDB table that stores playbook execution data. Integrations read input and write outputs to the Execution Results Table as they perform actions during a playbook's execution.
- socless_python: The Python library that manages the execution life-cycle of integrations and event endpoints, making them simple to write, reuse and share.