[SAASINT-3244] DDS: Asana: Crawler Integration v1.0.0 #18997

tirthrajchaudhari-crest · 2024-11-06T10:16:35Z

What does this PR do?

This is a initial release PR of Asana integration including all the required assets.

Additional Notes

Crawler code for this integration has been committed in its respective repo
Pipeline and Facet group created for this integration are available in our sandbox and would be shared separately with the required teams.
OOTB detection rules JSON would be shared separately with the required teams as a part of separate repository.
Since during the standard attribute remapping we are not preserving the source attributes as per suggested best practices, it would result in filters using these standard attributes populating the values of other integrations as well as per current Datadog behaviour.

Review checklist (to be filled by reviewers)

Feature or bugfix MUST have appropriate tests (unit, integration, e2e)
Add the qa/skip-qa label if the PR doesn't need to be tested during QA.
If you need to backport this PR to another branch, you can add the backport/<branch-name> label to the PR and it will automatically open a backport PR once this one is merged

apiazza-dd · 2024-11-19T14:37:59Z

asana/README.md

+
+This integration ingests the following logs:
+
+- Audit Logs: Audit logs offer a record of important events, empowering your teams to detect and minimize the impact of incidents when they occur, and scrutinize configuration edits.


Suggested change

- Audit Logs: Audit logs offer a record of important events, empowering your teams to detect and minimize the impact of incidents when they occur, and scrutinize configuration edits.

- **Audit Logs**: Audit logs provide a detailed record of significant events, enabling your teams to identify and mitigate the impact of incidents as they arise, while also reviewing configuration changes with precision.

apiazza-dd · 2024-11-19T14:38:50Z

asana/README.md

+
+- Audit Logs: Audit logs offer a record of important events, empowering your teams to detect and minimize the impact of incidents when they occur, and scrutinize configuration edits.
+
+This integration collects audit logs and sends them to Datadog for analysis. Datadog uses the built-in logs pipeline to parse and enrich these logs, enabling effortless search and analysis. The integration provides insight into activities on the Asana platform through the out-of-the-box dashboards. Also, this integration provides out-of-the-box detection rules.


Suggested change

This integration collects audit logs and sends them to Datadog for analysis. Datadog uses the built-in logs pipeline to parse and enrich these logs, enabling effortless search and analysis. The integration provides insight into activities on the Asana platform through the out-of-the-box dashboards. Also, this integration provides out-of-the-box detection rules.

This integration gathers audit logs and forwards them to Datadog for seamless analysis. Datadog leverages its built-in log pipelines to parse and enrich these logs, facilitating easy search and detailed insights. With preconfigured dashboards, the integration offers clear visibility into activities within the Asana platform. Additionally, it includes ready-to-use detection rules for enhanced monitoring and security.

apiazza-dd · 2024-11-19T14:39:45Z

asana/README.md

+
+#### Get Credentials of Asana
+
+1. Log in to your [Asana admin console][3] as **super admin** of an Enterprise+ organization.


Suggested change

1. Log in to your [Asana admin console][3] as **super admin** of an Enterprise+ organization.

1. Log in to your [Asana Admin Console][3] as a **Super Admin** of an Enterprise+ organization.

2. Navigate to the **Apps** tab in your Admin Console.

3. Click on **Service Accounts**.

4. Select the **Add Service Account** button and complete the following steps:

1. Enter a descriptive and identifiable name under **Name**.

2. Under **Permission Scopes**, select **Scoped permissions** and check the **Audit Logs** box.

5. Click **Save Changes** and copy the **Service Account PAT** for later use.

6. Go to the **Settings** tab in your Admin Console.

7. Scroll to the bottom of the page to locate the **Domain ID (Workspace ID)**.

apiazza-dd · 2024-11-19T14:41:42Z

asana/README.md

+6. Navigate to the **Settings** tab from your admin console.
+7. Scroll down till the end of the page, where you can find **Domain ID (Workspace ID)**.
+
+#### Add your Asana Credentials


Suggested change

#### Add your Asana Credentials

#### Enter the following Asana credentials into the Datadog Asana Integration Tile.

I don't think Enter the following Asana credentials into the Datadog Asana Integration Tile. should be a heading. Just a sentence under the Add your Asana Credentials heading.

@apiazza-dd Could you please check the attached screenshots of the Slack conversation with David regarding this change?

@tirthrajchaudhari-crest Sounds good, please defer to David & Doc's instructions. Thanks!

apiazza-dd · 2024-11-19T14:42:42Z

asana/README.md

+
+### Logs
+
+The Asana integration collects and forwards audit logs to Datadog.


Let's add "For more details on the logs we collect with this integration, see the Asana Audit Logs API Docs4.

apiazza-dd · 2024-11-19T14:46:20Z

asana/manifest.json

+    "configuration": "README.md#Setup",
+    "support": "README.md#Support",
+    "changelog": "CHANGELOG.md",
+    "description": "Gain insights into Asana audit logs",


Explore and analyze Asana audit logs

michaelcretzman · 2024-11-19T18:04:04Z

asana/README.md

+6. Navigate to the **Settings** tab from your admin console.
+7. Scroll down till the end of the page, where you can find **Domain ID (Workspace ID)**.
+
+#### Add your Asana Credentials


I don't think Enter the following Asana credentials into the Datadog Asana Integration Tile. should be a heading. Just a sentence under the Add your Asana Credentials heading.

jnhunsberger

One small copy change is needed

jnhunsberger · 2024-11-22T13:58:35Z

asana/README.md

+
+- **Audit Logs**: Audit logs provide a detailed record of significant events, enabling your teams to identify and mitigate the impact of incidents as they arise, while also reviewing configuration changes with precision.
+
+This integration gathers audit logs and forwards them to Datadog for seamless analysis. Datadog leverages its built-in log pipelines to parse and enrich these logs, facilitating easy search and detailed insights. With preconfigured dashboards, the integration offers clear visibility into activities within the Asana platform. Additionally, it includes ready-to-use detection rules for enhanced monitoring and security.


Additionally, it includes ready-to-use Cloud SIEM detection rules for enhanced monitoring and security.

Add assets for asana integration

4d2a6de

datadog-assets bot added docs/review-requested ecosystems/review-requested product/review-requested labels Nov 6, 2024

datadog-agent-integrations-bot bot added documentation changelog/no-changelog dev/testing dev/tooling qa/skip-qa Automatically skip this PR for the next QA labels Nov 6, 2024

tirthrajchaudhari-crest added 8 commits November 6, 2024 16:21

Update test yaml file

ddd6456

Update sample

305ffb3

Resolving merge conflicts

24c797f

Resolve CI failure

de05cf3

Update dashboard image

4d74e0e

Update title in manifest

9fab2b4

Update readme

e5fe518

Minor dashboard update

b4a49b7

tirthrajchaudhari-crest marked this pull request as ready for review November 18, 2024 10:32

tirthrajchaudhari-crest requested review from a team as code owners November 18, 2024 10:32

hestonhoffman added the editorial review Waiting on a more in-depth review from a docs team editor label Nov 18, 2024

Update readme and dashboard description

d428e06

datadog-agent-integrations-bot bot added team/agent-integrations team/documentation team/logs-backend team/siem-logs-reviewers labels Nov 19, 2024

Update readme and dashboard panel name

118bf90

apiazza-dd changed the title ~~DDS: Asana: Crawler Integration v1.0.0~~ [SAASINT-2342] DDS: Asana: Crawler Integration v1.0.0 Nov 19, 2024

apiazza-dd reviewed Nov 19, 2024

View reviewed changes

michaelcretzman requested changes Nov 19, 2024

View reviewed changes

datadog-assets bot added docs/requested-changes and removed docs/review-requested labels Nov 19, 2024

torosmassa changed the title ~~[SAASINT-2342] DDS: Asana: Crawler Integration v1.0.0~~ [SAASINT-3244] DDS: Asana: Crawler Integration v1.0.0 Nov 19, 2024

Address review comments

fd84652

tirthrajchaudhari-crest requested a review from apiazza-dd November 20, 2024 12:57

Update dashboard queries related to service name change

5fc80eb

jnhunsberger requested changes Nov 22, 2024

View reviewed changes

tirthrajchaudhari-crest added 2 commits November 25, 2024 10:52

Address review comment

325a27d

Resolve merge conflicts

73df0ba

tirthrajchaudhari-crest requested a review from jnhunsberger November 25, 2024 05:36

Merge branch 'master' into asana-assets-v1.0.0

c4169ec

shubhamvekariya-crest requested review from a team as code owners December 13, 2024 10:12

Update setup section of README

9a17b57

apiazza-dd approved these changes Dec 18, 2024

View reviewed changes

michaelcretzman approved these changes Dec 18, 2024

View reviewed changes

datadog-assets bot added docs/approved and removed docs/requested-changes labels Dec 18, 2024

BoyangHuang added the assets/deploy-logs-staging ONLY USED BY Logs Backend - Validates that a PR is OK to go to staging label Jan 2, 2025

BoyangHuang approved these changes Jan 3, 2025

View reviewed changes

steveny91 approved these changes Jan 3, 2025

View reviewed changes

datadog-assets bot added the agent/approved label Jan 3, 2025

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[SAASINT-3244] DDS: Asana: Crawler Integration v1.0.0 #18997

[SAASINT-3244] DDS: Asana: Crawler Integration v1.0.0 #18997

tirthrajchaudhari-crest commented Nov 6, 2024

apiazza-dd Nov 19, 2024

tirthrajchaudhari-crest Nov 20, 2024

apiazza-dd Nov 19, 2024

tirthrajchaudhari-crest Nov 20, 2024

apiazza-dd Nov 19, 2024

tirthrajchaudhari-crest Nov 20, 2024

apiazza-dd Nov 19, 2024

michaelcretzman Nov 19, 2024

tirthrajchaudhari-crest Nov 20, 2024 •

edited

Loading

apiazza-dd Nov 20, 2024

apiazza-dd Nov 19, 2024

tirthrajchaudhari-crest Nov 20, 2024

apiazza-dd Nov 19, 2024

tirthrajchaudhari-crest Nov 20, 2024

michaelcretzman Nov 19, 2024

jnhunsberger left a comment

jnhunsberger Nov 22, 2024

tirthrajchaudhari-crest Nov 25, 2024


		This integration ingests the following logs:

		- Audit Logs: Audit logs offer a record of important events, empowering your teams to detect and minimize the impact of incidents when they occur, and scrutinize configuration edits.

	- Audit Logs: Audit logs offer a record of important events, empowering your teams to detect and minimize the impact of incidents when they occur, and scrutinize configuration edits.
	- Audit Logs: Audit logs provide a detailed record of significant events, enabling your teams to identify and mitigate the impact of incidents as they arise, while also reviewing configuration changes with precision.


		- Audit Logs: Audit logs offer a record of important events, empowering your teams to detect and minimize the impact of incidents when they occur, and scrutinize configuration edits.

		This integration collects audit logs and sends them to Datadog for analysis. Datadog uses the built-in logs pipeline to parse and enrich these logs, enabling effortless search and analysis. The integration provides insight into activities on the Asana platform through the out-of-the-box dashboards. Also, this integration provides out-of-the-box detection rules.


		#### Get Credentials of Asana

		1. Log in to your [Asana admin console][3] as super admin of an Enterprise+ organization.

-. Log in to your [Asana admin console][3] as **super admin** of an Enterprise+ organization.
+. Log in to your [Asana Admin Console][3] as a **Super Admin** of an Enterprise+ organization.
+. Navigate to the **Apps** tab in your Admin Console.
+. Click on **Service Accounts**.
+. Select the **Add Service Account** button and complete the following steps:
+. Enter a descriptive and identifiable name under **Name**.
+. Under **Permission Scopes**, select **Scoped permissions** and check the **Audit Logs** box.
+. Click **Save Changes** and copy the **Service Account PAT** for later use.
+. Go to the **Settings** tab in your Admin Console.
+. Scroll to the bottom of the page to locate the **Domain ID (Workspace ID)**.

	#### Add your Asana Credentials
	#### Enter the following Asana credentials into the Datadog Asana Integration Tile.


		### Logs

		The Asana integration collects and forwards audit logs to Datadog.


		- Audit Logs: Audit logs provide a detailed record of significant events, enabling your teams to identify and mitigate the impact of incidents as they arise, while also reviewing configuration changes with precision.

		This integration gathers audit logs and forwards them to Datadog for seamless analysis. Datadog leverages its built-in log pipelines to parse and enrich these logs, facilitating easy search and detailed insights. With preconfigured dashboards, the integration offers clear visibility into activities within the Asana platform. Additionally, it includes ready-to-use detection rules for enhanced monitoring and security.

[SAASINT-3244] DDS: Asana: Crawler Integration v1.0.0 #18997

Are you sure you want to change the base?

[SAASINT-3244] DDS: Asana: Crawler Integration v1.0.0 #18997

Conversation

tirthrajchaudhari-crest commented Nov 6, 2024

What does this PR do?

Additional Notes

Review checklist (to be filled by reviewers)

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

tirthrajchaudhari-crest Nov 20, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

jnhunsberger left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

tirthrajchaudhari-crest Nov 20, 2024 •

edited

Loading