Retarus Secure Email Gateway

Details

ID	`Retarus Secure Email Gateway`
Provider	Retarus GmbH
Category	Email
From Version	6.9.0
Docker Image	`demisto/netutils:1.0.0.10187688`
Supported Modules	Agentix XSIAM

README

Integrate Retarus Secure Email Gateway to seamlessly fetch events and enhance email security.

Configure RetarusSecureEmailGateway Event Collector on Cortex XSIAM

Navigate to Settings > Integrations > Servers & Services.
Search for Retarus.

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

Parameter	Required	Description
Server URL	True
Token ID	True
Channel name	False	The channel to fetch events from. In Retarus, a channel name represents a specific configuration or processing pipeline used to manage email traffic based on criteria like sender, recipient, domain, or metadata, enabling tailored routing, filtering, compliance, and logging rules.
Fetch interval in seconds	True
Trust any certificate (not secure)	False

Troubleshooting

If you encounter any issues with this integration, follow these steps to troubleshoot:
Run the retarus-get-last-run-results command to obtain detailed information about the errors and problems you are facing. This command provides insights into the last execution of the integration and helps you understand the root cause of the issues.
If you receive an HTTP 400 or HTTP 401 status code when running the command, verify the token provided in the instance configuration.

When opening a support case, include the results you obtained from running the retarus-get-last-run-results command.

Note, due to the Retarus API limitation, only one instance can be configured for each token and channel. It is important to note that while two instances with the same token but different channels are allowed, configuring two instances with the same token and channel may result in errors and/or missing events.

Configuration parameters

url — Server URL (required)
credentials — (required)
channel — Channel name
fetch_interval — Fetch interval in seconds (required)
longRunning — Long Running Instance
insecure — Trust any certificate (not secure)

Commands (1)

retarus-get-last-run-results
Retrieves the results of a connection attempt to Retarus, indicating whether it was successful or failed and why. If event fetching has been initiated, this command provides the results of the most recent fetch attempt.

Source

RetarusSecureEmailGateway.py RetarusSecureEmailGateway_test.py RetarusSecureEmailGateway.yml RetarusSecureEmailGateway_description.md command_examples.txt

Download History Raw

commonfields:
  id: Retarus Secure Email Gateway
  version: -1
sectionorder:
- Connect
- Collect
name: Retarus Secure Email Gateway
display: Retarus Secure Email Gateway
category: Email
provider: Retarus GmbH
description: Integrate Retarus Secure Email Gateway to seamlessly fetch events from Secure Email Gateway by Retarus and enhance email security.
configuration:
- defaultvalue: events.retarus.com
  display: Server URL
  name: url
  required: true
  type: 0
  section: Connect
- displaypassword: Token ID
  additionalinfo: The Token ID to use for connection.
  name: credentials
  required: true
  hiddenusername: true
  type: 9
  section: Connect
- defaultvalue: default
  display: Channel name
  section: Collect
  name: channel
  type: 0
- display: Fetch interval in seconds
  name: fetch_interval
  type: 0
  defaultvalue: 60
  required: true
  section: Collect
  advanced: true
- defaultvalue: 'true'
  display: Long Running Instance
  hidden: true
  name: longRunning
  type: 8
  section: Connect
- display: Trust any certificate (not secure)
  name: insecure
  type: 8
  required: false
  section: Connect
script:
  script: ""
  type: python
  commands:
  - name: "retarus-get-last-run-results"
    description: Retrieves the results of a connection attempt to Retarus, indicating whether it was successful or failed and why. If event fetching has been initiated, this command provides the results of the most recent fetch attempt.
  subtype: python3
  dockerimage: demisto/netutils:1.0.0.10187688
  longRunning: true
marketplaces:
- marketplacev2
- platform
fromversion: 6.9.0
tests:
- No tests