SafeNetTrustedAccessEventCollector

Retrieve access, authentication, and audit logs and store them on a Security Information and Event Management (SIEM) system, local repository, or syslog file server. You can retrieve the logs only for the tenant that is associated with the API key, or for a direct or delegated child of that tenant.

Authentication & Identity Management · Thales SafeNet Trusted Access

Details

ID	`SafeNetTrustedAccessEventCollector`
Provider	Thales
Category	Authentication & Identity Management
From Version	6.8.0
Docker Image	`demisto/python3:3.12.13.10325753`
Supported Modules	Agentix XSIAM

README

Retrieve access, authentication, and audit logs and stores them in a Security Information and Event Management (SIEM) system, local repository, or syslog file server. You can retrieve the logs only for the tenant that is associated with the API key, or for a direct or delegated child of that tenant.

Configure SafeNetTrustedAccessEventCollector in Cortex

Parameter	Description	Required
URL	The URL consists of the root part of the REST API Endpoint URL provided in SafeNet Trusted Access, and has the form https://api.[name].com	True
Tenant Code	Tenant code for your virtual server or account.	True
API Key for the authentication.		True
The product name corresponding to the integration that originated the events		False
The vendor name corresponding to the integration that originated the events		False
The maximum number of audit logs to fetch. Valid limit is multiples of 1000 and less than 10,000.		True
First fetch timestamp		False
Trust any certificate (not secure)		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.

sta-get-events

Get access, authentication, and audit logs from SafeNet Trusted Access.

Base Command

sta-get-events

Input

Argument Name	Description	Required
should_push_events	If true, the command will create events, otherwise it will only display them. Possible values are: true, false. Default is false.	Required
since	Since date.	Optional
until	Until date.	Optional
marker	A string pointing at the next page of results. The marker can be found within the previous response.	Optional

Context Output

There is no context output for this command.

Command example

!sta-get-events should_push_events=false since="10 seconds"

Human Readable Output

Event Logs

Marker: 111111

category context details id logVersion timeStamp

AUDIT tenantId: TENENTID
originatingAddress: 1.1.1.1
principalId: ID
globalAccessId: ID type: AUTHENTICATION
serial: SERIAL
action: 0
actionText: AUTH_ATTEMPT
result: 1
resultText: AUTH_SUCCESS
agentId: ID
message: MSG
credentialType: TYPE $ID 1.0 2022-01-01T00:00:00.00000Z

AUDIT tenantId: TENENTID
originatingAddress: 1.1.1.1
principalId: ID
globalAccessId: ID type: AUTHENTICATION
serial: SERIAL
action: 0
actionText: AUTH_ATTEMPT
result: 2
resultText: CHALLENGE
agentId: ID
message: MSG
usedName: NAME
credentialType: TYPE $ID 1.0 2022-01-01T00:00:00.00000Z

category	context	details	id	logVersion	timeStamp
AUDIT	tenantId: TENENTID originatingAddress: 1.1.1.1 principalId: ID globalAccessId: ID	type: AUTHENTICATION serial: SERIAL action: 0 actionText: AUTH_ATTEMPT result: 1 resultText: AUTH_SUCCESS agentId: ID message: MSG credentialType: TYPE	$ID	1.0	2022-01-01T00:00:00.00000Z
AUDIT	tenantId: TENENTID originatingAddress: 1.1.1.1 principalId: ID globalAccessId: ID	type: AUTHENTICATION serial: SERIAL action: 0 actionText: AUTH_ATTEMPT result: 2 resultText: CHALLENGE agentId: ID message: MSG usedName: NAME credentialType: TYPE	$ID	1.0	2022-01-01T00:00:00.00000Z

Configuration parameters

url — URL (required)
tenant_code — Tenant Code (required)
credentials — (required)
product — The product name corresponding to the integration that originated the events
vendor — The vendor name corresponding to the integration that originated the events
limit — The maximum number of audit logs to fetch. Valid limit is multiples of 1000 and less than 10,000. (required)
first_fetch — First fetch timestamp
insecure — Trust any certificate (not secure)
proxy — Use system proxy settings

Commands (1)

sta-get-events
Get access, authentication, and audit logs from SafeNet Trusted Access.

Source

SafeNetTrustedAccessEventCollector.py SafeNetTrustedAccessEventCollector_test.py SafeNetTrustedAccessEventCollector.yml SafeNetTrustedAccessEventCollector_description.md command_examples.txt

Download History Raw

category: Authentication & Identity Management
provider: Thales
sectionorder:
- Connect
- Collect
commonfields:
  id: SafeNetTrustedAccessEventCollector
  version: -1
configuration:
- additionalinfo: The URL consists of the root part of the REST API Endpoint URL provided in SafeNet Trusted Access, and has the form https://api.[name].com
  display: URL
  name: url
  required: true
  type: 0
  section: Connect
- additionalinfo: Tenant code for your virtual server or account.
  display: Tenant Code
  name: tenant_code
  required: true
  type: 0
  section: Connect
- display: ""
  displaypassword: API Key for the authentication.
  name: credentials
  type: 9
  required: true
  hiddenusername: true
  section: Connect
- defaultvalue: trusted_access
  display: The product name corresponding to the integration that originated the events
  name: product
  type: 0
  required: false
  section: Connect
- defaultvalue: safenet
  display: The vendor name corresponding to the integration that originated the events
  name: vendor
  type: 0
  required: false
  section: Collect
- display: The maximum number of audit logs to fetch. Valid limit is multiples of 1000 and less than 10,000.
  name: limit
  type: 0
  defaultvalue: 1000
  required: true
  section: Collect
- display: First fetch timestamp
  name: first_fetch
  type: 0
  defaultvalue: 3 days ago
  required: false
  section: Collect
- name: insecure
  display: Trust any certificate (not secure)
  type: 8
  additionalinfo:
  required: false
  section: Connect
- name: proxy
  display: Use system proxy settings
  type: 8
  required: false
  section: Connect
description: 'Retrieve access, authentication, and audit logs and store them on a Security Information and Event Management (SIEM) system, local repository, or syslog file server. You can retrieve the logs only for the tenant that is associated with the API key, or for a direct or delegated child of that tenant.'
display: 'Thales SafeNet Trusted Access Event Collector'
name: SafeNetTrustedAccessEventCollector
supportlevelheader: xsoar
script:
  commands:
  - arguments:
    - auto: PREDEFINED
      defaultValue: 'false'
      description: If true, the command will create events, otherwise it will only display them.
      name: should_push_events
      predefined:
      - 'true'
      - 'false'
      required: true
    - description: 'Since date.'
      name: since
    - description: 'Until date.'
      name: until
    - description: A string pointing at the next page of results. The marker can be found within the previous response.
      name: marker
    description: 'Get access, authentication, and audit logs from SafeNet Trusted Access.'
    name: sta-get-events
  script: '-'
  type: python
  subtype: python3
  isfetchevents: true
  dockerimage: demisto/python3:3.12.13.10325753
marketplaces:
- marketplacev2
- platform
fromversion: 6.8.0
tests:
- No tests (auto formatted)
supportedModules:
- xsiam