Skip to content

Commit 79c322b

Browse files
Update C2C Duo source with current docs (#5869)
* Update C2C Duo source with current docs * Updates from review --------- Co-authored-by: John Pipkin <[email protected]>
1 parent b1ac48e commit 79c322b

File tree

3 files changed

+44
-22
lines changed

3 files changed

+44
-22
lines changed

docs/send-data/hosted-collectors/cloud-to-cloud-integration-framework/duo-source.md

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,21 +5,25 @@ sidebar_label: Duo
55
tags:
66
- cloud-to-cloud
77
- duo
8-
description: The Duo Source provides a secure endpoint to receive authentication logs from the Duo Authentication Logs API.
8+
description: The Duo Source provides a secure endpoint to receive logs from multiple API endpoints.
99
---
1010

1111
import ForwardToSiem from '/docs/reuse/forward-to-siem.md';
1212
import useBaseUrl from '@docusaurus/useBaseUrl';
1313

1414
<img src={useBaseUrl('img/integrations/security-threat-detection/duo.png')} alt="thumbnail icon" width="55"/>
1515

16-
The Duo Source provides a secure endpoint to receive authentication logs from the Duo [Authentication Logs API](https://duo.com/docs/adminapi#logs). It securely stores the required authentication, scheduling, and state tracking information.
16+
The Duo Source collects logs from multiple Duo API endpoints. It securely stores the required authentication, scheduling, and state tracking information.
1717

1818
## Data collected
1919

2020
| Polling Interval | Data |
2121
| :--- | :--- |
22-
| 5 min | [Authentication Logs](https://duo.com/docs/adminapi#logs) |
22+
| 5m | [Authentication Logs](https://duo.com/docs/adminapi#logs) |
23+
| 5m | [Administrator Logs](https://duo.com/docs/adminapi#administrator-logs)|
24+
| 5m | [Telephony Logs](https://duo.com/docs/adminapi#telephony-logs)|
25+
| 5m | [Activity Logs](https://duo.com/docs/adminapi#activity-logs)|
26+
| 24h | [User Inventory Logs](https://duo.com/docs/adminapi#users) |
2327

2428
## Setup
2529

@@ -48,6 +52,8 @@ To configure a Duo Source:
4852
1. **Duo Domain**. Provide your **API hostname**, such as `api-********.duosecurity.com`.
4953
1. **Integration Key**. Provide the Duo Integration Key you want to use to authenticate collection requests.
5054
1. **Secret Key**. Provide the Duo Secret Key you want to use to authenticate collection requests. 
55+
1. **Supported APIs to Collect**. Choose the API endpoints you wish to collect logs from.
56+
1. **Collect User Inventory Every 24h**. Check this box if you want to collect user inventory every 24 hours.
5157
1. (Optional) The **Polling Interval** is set for 300 seconds by default, you can adjust it based on your needs. This sets how often the Source checks for new data.
5258
1. When you are finished configuring the Source, click **Submit**.
5359

@@ -81,6 +87,8 @@ Sources can be configured using UTF-8 encoded JSON files with the Collector Ma
8187
| domain | String | Yes | `null` | Provide your API hostname, such as api-********.duosecurity.com.| |
8288
| integration_key | String | Yes | `null` | Provide the Duo Integration Key you want to use to authenticate collection requests. | |
8389
| secret_key | String | Yes | `null` | Provide the Duo Secret Key you want to use to authenticate collection requests. | |
90+
| supported_apis| String Array| Yes | All APIs|Add an element for each of the APIs the integration should collect from.|`["authentication", "administrator", "telephony", "activity"]`|
91+
| collectUserInventory | Boolean | No | True| Set to true if the integration should collect user inventory logs. |`True`|
8492
| polling_interval | Integer | No | 300 | This sets how often the Source checks for new data. | |
8593

8694
### JSON example

static/files/c2c/duo/example.json

Lines changed: 26 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,28 @@
11
{
2-
"api.version":"v1",
3-
"source":{
4-
"schemaRef":{
5-
"type":"Duo"
2+
"api.version": "v1",
3+
"source": {
4+
"schemaRef": {
5+
"type": "Duo"
6+
},
7+
"config": {
8+
"name": "Duo",
9+
"description": "East field",
10+
"domain": "api-********.duosecurity.com",
11+
"integration_key": "********",
12+
"secret_key": "********",
13+
"supported_apis": [
14+
"administrator",
15+
"authentication",
16+
"telephony",
17+
"activity"
18+
],
19+
"collectUserInventory": true,
20+
"fields": {
21+
"_siemForward": false
622
},
7-
"config":{
8-
"name":"Duo",
9-
"description":"East field",
10-
"domain":"api-********.duosecurity.com",
11-
"integration_key":"********",
12-
"secret_key":"********",
13-
"fields":{
14-
"_siemForward":false
15-
},
16-
"category":"eastTeamF",
17-
"polling_interval":300
18-
},
19-
"sourceType":"Universal"
20-
}
21-
}
23+
"category": "eastTeamF",
24+
"polling_interval": 300
25+
},
26+
"sourceType": "Universal"
27+
}
28+
}

static/files/c2c/duo/example.tf

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,13 @@ resource "sumologic_cloud_to_cloud_source" "duo_source" {
99
"domain":"api-********.duosecurity.com",
1010
"integration_key":"********",
1111
"secret_key":"********",
12+
"supported_apis": [
13+
"administrator",
14+
"authentication",
15+
"telephony",
16+
"activity",
17+
],
18+
"collectUserInventory": true,
1219
"fields":{
1320
"_siemForward":false
1421
},

0 commit comments

Comments
 (0)