Digital Guardian
Use Digital Guardian Integration to fetch incidents and to programmatically add or remove entries from watchlists and component lists.
Data Enrichment & Threat Intelligence · Digital Guardian
Details
| ID | Digital Guardian |
|---|---|
| Provider | Fortra |
| Category | Data Enrichment & Threat Intelligence |
| From Version | 5.0.0 |
| Docker Image | demisto/python3:3.12.8.3296088 |
| Supported Modules | Agentix XSIAM |
README
Digital Guardian ARC Watchlist Integration
This integration was integrated and tested with version 2.11.0 of Digital Guardian ARC
Configure Digital Guardian in Cortex
| Parameter | Description | Required |
|---|---|---|
| auth_url | auth_url | True |
| arc_url | arc_url | True |
| insecure | Allow Insecure HTTPS | False |
| client_id | client_id | True |
| client_secret | client_secret | True |
| export_profile | export_profile | True |
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.
digitalguardian-add-watchlist-entry
Add Watchlist Entry
Base Command
digitalguardian-add-watchlist-entry
Input
| Argument Name | Description | Required |
|---|---|---|
| watchlist_name | Watchlist Name | Required |
| watchlist_entry | Watchlist Entry | Required |
Context Output
There is no context output for this command.
Command Example
!digitalguardian-add-watchlist-entry watchlist_entry=playbook_test watchlist_name=atac_test
Context Example
{}
Human Readable Output
added watchlist entry (playbook_test) to watchlist name (atac_test)
digitalguardian-check-watchlist-entry
Check Watchlist Entry
Base Command
digitalguardian-check-watchlist-entry
Input
| Argument Name | Description | Required |
|---|---|---|
| watchlist_name | Watchlist Name | Required |
| watchlist_entry | Watchlist Entry | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| DigitalGuardian.Watchlist.Found | boolean | Watchlist Found |
Command Example
!digitalguardian-check-watchlist-entry watchlist_entry=playbook_test watchlist_name=atac_test
Context Example
{
"DigitalGuardian": {
"Watchlist": {
"Found": true
}
}
}
Human Readable Output
Watchlist found
digitalguardian-remove-watchlist-entry
Remove Watchlist Entry
Base Command
digitalguardian-remove-watchlist-entry
Input
| Argument Name | Description | Required |
|---|---|---|
| watchlist_name | Watchlist Name | Required |
| watchlist_entry | Watchlist Entry | Optional |
Context Output
There is no context output for this command.
Command Example
!digitalguardian-remove-watchlist-entry watchlist_entry=playbook_test watchlist_name=atac_test
Context Example
{}
Human Readable Output
removed watchlist entry (playbook_test) from watchlist name (atac_test)
digitalguardian-add-componentlist-entry
Add Componentlist Entry
Base Command
digitalguardian-add-componentlist-entry
Input
| Argument Name | Description | Required |
|---|---|---|
| componentlist_name | Componentlist Name | Required |
| componentlist_entry | Componentlist Entry | Required |
Context Output
There is no context output for this command.
Command Example
!digitalguardian-add-componentlist-entry componentlist_entry=email@example.com componentlist_name="Test - JLL - Email Address Blacklist"
Context Example
{}
Human Readable Output
added componentlist entry (email@example.com) to componentlist name (Test - JLL - Email Address Blacklist)
digitalguardian-check-componentlist-entry
Check Componentlist Entry
Base Command
digitalguardian-check-componentlist-entry
Input
| Argument Name | Description | Required |
|---|---|---|
| componentlist_name | Componentlist Name | Required |
| componentlist_entry | Componentlist Entry | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| DigitalGuardian.Componentlist.Found | boolean | Componentlist Found |
Command Example
!digitalguardian-check-componentlist-entry componentlist_entry=email@example.com componentlist_name="Test - JLL - Email Address Blacklist"
Context Example
{
"DigitalGuardian": {
"Componentlist": {
"Found": true
}
}
}
Human Readable Output
Componentlist found
digitalguardian-remove-componentlist-entry
Remove Componentlist Entry
Base Command
digitalguardian-remove-componentlist-entry
Input
| Argument Name | Description | Required |
|---|---|---|
| componentlist_name | Componentlist Name | Required |
| componentlist_entry | Componentlist Entry | Required |
Context Output
There is no context output for this command.
Command Example
!digitalguardian-remove-componentlist-entry componentlist_entry=email@example.com componentlist_name="Test - JLL - Email Address Blacklist"
Context Example
{}
Human Readable Output
removed componentlist entry (email@example.com) from componentlist name (Test - JLL - Email Address Blacklist)
Configuration parameters
auth_url— Auth Server URL (required)arc_url— Gateway Base URL (required)client_id— API Client ID (required)client_secret— API Client Secret (required)export_profile— Export Profile (required)isFetch— Fetch incidentsincidentType— Incident typeincidentFetchInterval— Incidents Fetch Intervalinsecure— Trust any certificate (not secure)proxy— Use system proxy settings
Commands (6)
-
digitalguardian-add-componentlist-entryAdd Componentlist Entry.
-
digitalguardian-add-watchlist-entryAdd Watchlist Entry.
-
digitalguardian-check-componentlist-entryCheck Componentlist Entry.
-
digitalguardian-check-watchlist-entryCheck Watchlist Entry.
-
digitalguardian-remove-componentlist-entryRemove Componentlist Entry.
-
digitalguardian-remove-watchlist-entryRemove Watchlist Entry.
To use Digital Guardian External API calls, you must first get a valid token to use for authentication. ### Getting a new Token You must obtain the following values by submitting a request to support@digitalguardian.com | **Requested Information** | **Mapped to Integration Field Name** | | --- | --- | | API Client ID | client_id | | API Client Secret | client_secret | | Gateway Base URL | arc_url | | Auth Server URL | auth_url | Note: The Export Profile for use with this integration has the ID of 'demisto'. This Export Profile requires ARC 2.12.0 in order to function properly.