AWS-SNS-Listener

Amazon Simple Notification Service (SNS) is a managed service that provides message delivery from publishers to subscribers.

Messaging and Conferencing · AWS-SNS-Listener

Details

IDAWS-SNS-Listener
ProviderAmazon
CategoryMessaging and Conferencing
From Version6.10.0
Docker Imagedemisto/fastapi:0.125.0.10158186
Supported ModulesAgentix XSIAM

README

Amazon Simple Notification Service (SNS) is a managed service that provides message delivery from publishers to subscribers.
This integration was integrated and tested with version January 2024 of AWS-SNS-Listener.

Configure AWS-SNS-Listener in Cortex

Parameter Description Required
Long running instance Integration is long running by default  
Listen Port Runs the service on this port from within Cortex XSOAR. Requires a unique port for each long-running integration instance. Do not use the same port for multiple instances. Note: If you click the test button more than once, a failure may occur mistakenly indicating that the port is already in use. False
Username Uses basic authentication for accessing the list. If empty, no authentication is enforced. (For Cortex XSOAR 8 and Cortex XSIAM) Optional for engines, otherwise mandatory. False
Password   False
Endpoint Set the endpoint of your listener. example: /snsv2 False
Certificate (Required for HTTPS) (For Cortex XSOAR 6.x) For use with HTTPS - the certificate that the service should use. (For Cortex XSOAR 8 and Cortex XSIAM) Custom certificates are not supported. False
Private Key (Required for HTTPS) (For Cortex XSOAR 6.x) For use with HTTPS - the private key that the service should use. (For Cortex XSOAR 8 and Cortex XSIAM) When using an engine, configure a private API key. Not supported on the Cortex XSOAR​​ or Cortex XSIAM server. False
Store sample events for mapping Because this is a push-based integration, it cannot fetch sample events in the mapping wizard. After you finish mapping, it is recommended to turn off the sample events storage to reduce performance overhead. False
Use system proxy settings   False

Commands

You can execute these commands from the 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.

Configuration parameters

  • longRunning — Long running instance
  • credentials — Username
  • endpoint — Endpoint
  • certificate — Certificate (Required for HTTPS)
  • key — Private Key (Required for HTTPS)
  • store_samples — Store sample events for mapping
  • proxy — Use system proxy settings
  • longRunningPort — Listen Port (required)

Commands (0)

This integration defines no commands.

category: Messaging and Conferencing
provider: Amazon
sectionorder:
- Connect
- Collect
commonfields:
  id: AWS-SNS-Listener
  version: -1
configuration:
- display: Long running instance
  defaultvalue: 'true'
  name: longRunning
  type: 8
  hidden: true
  section: Connect
  advanced: true
  required: false
- additionalinfo: Uses basic authentication for accessing the list. If empty, no authentication is enforced. (For Cortex XSOAR 8 and Cortex XSIAM) Optional for engines, otherwise mandatory.
  display: Username
  name: credentials
  type: 9
  section: Connect
  required: false
- additionalinfo: "Set the endpoint of your listener. example: /snsv2"
  display: Endpoint
  name: endpoint
  type: 0
  section: Connect
  required: false
- display: Certificate (Required for HTTPS)
  additionalinfo: "(For Cortex XSOAR 6.x) For use with HTTPS - the certificate that the service should use. (For Cortex XSOAR 8 and Cortex XSIAM) Custom certificates are not supported."
  name: certificate
  type: 12
  section: Connect
  required: false
- display: Private Key (Required for HTTPS)
  additionalinfo: "(For Cortex XSOAR 6.x) For use with HTTPS - the private key that the service should use. (For Cortex XSOAR 8 and Cortex XSIAM) When using an engine, configure a private API key. Not supported on the Cortex XSOAR​​ or Cortex XSIAM server."
  name: key
  type: 14
  section: Connect
  required: false
- additionalinfo: "Because this is a push-based integration, it cannot fetch sample events in the mapping wizard. After you finish mapping, it is recommended to turn off the sample events storage to reduce performance overhead."
  display: Store sample events for mapping
  name: store_samples
  type: 8
  section: Connect
  required: false
- display: Use system proxy settings
  name: proxy
  type: 8
  section: Connect
  advanced: true
  required: false
- additionalinfo: "Runs the service on this port from within Cortex XSOAR. Requires a unique port for each long-running integration instance. Do not use the same port for multiple instances. Note: If you click the **Test** button more than once, a failure may occur mistakenly indicating that the port is already in use."
  display: Listen Port
  name: longRunningPort
  type: 0
  required: true
  section: Connect
description: 'Amazon Simple Notification Service (SNS) is a managed service that provides message delivery from publishers to subscribers.'
display: AWS-SNS-Listener
name: AWS-SNS-Listener
script:
  commands: []
  dockerimage: demisto/fastapi:0.125.0.10158186
  longRunning: true
  longRunningPort: true
  script: '-'
  subtype: python3
  type: python
  isFetchSamples: true
fromversion: 6.10.0
tests:
- AWS SNS Listener - Test
triggers:
  - conditions:
      - name: engine
        operator: not_exists
      - name: isEngineGroup
        operator: not_exists
    effects:
      - name: longRunningPort
        action:
          hidden: true
          required: false