Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update MS Teams alert integration #362

Merged
merged 1 commit into from
Sep 17, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/glossary.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,7 @@ Mondoo's [registry](/platform/security/posture/policies/) is the location in the

### risk score

Mondoo assigns a [risk score](/platform/security/posture/findings/#risk-score) of Low, Medium, High, or Critical to each finding. This score is calculated using a [base score](/platform/security/posture/findings/#base-score) (from the [policy](/platform/security/posture/policies/)) and [contextual risks](/platform/security/posture/findings/#factor-contextual-risk) such as credentials exposed to the internet or a running service or database.
Mondoo assigns a [risk score](/platform/security/posture/findings/#risk-score) of Low, Medium, High, or Critical to each finding. This score is calculated using a [base score](/platform/security/posture/findings/#begin-with-a-base-score) (from the [policy](/platform/security/posture/policies/)) and [contextual risks](/platform/security/posture/findings/#factor-contextual-risk) such as credentials exposed to the internet or a running service or database.

### score

Expand Down
26 changes: 15 additions & 11 deletions docs/platform/maintain/alerting/msteams.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,29 +8,33 @@ image: /img/featured_img/mondoo-feature.jpg

You can configure Mondoo to send a message to a Microsoft Teams channel whenever there's a change to an asset's security score. You do this by integrating Microsoft Teams with the Mondoo space from which you want to receive alerts.

Before you set up the integration, you must generate a new Microsoft Teams webhook URL.
Before you set up the integration, you must first create a new workflow in Microsoft Teams.

## Create a webhook in Microsoft Teams

1. In Microsoft Teams app, select the team and channel where you want Mondoo to send alerts.
1. In Microsoft Teams, find the Workflows app and (if it isn't already added) add it.

2. On the right side of the selected channel, select the ellipsis (...).
![Find the Workflows app in Microsoft Teams](/img/platform/maintain/alerting/msteams/app.png)

3. Select **Connectors**.
![Add the Workflows app in Microsoft Teams](/img/platform/maintain/alerting/msteams/add-workflows.png)

![Add a new Connector to your channel](/img/platform/maintain/alerting/msteams/msteams-webhook-new.png)
2. Open the Workflows app.

4. Search the Incoming webhook connector and select **Add** or **Configure**.
![Workflows app in Microsoft Teams](/img/platform/maintain/alerting/msteams/workflows.png)

![Select a webhook in Microsoft Teams](/img/platform/maintain/alerting/msteams/msteams-webhook-add.png)
3. Under **Start with a popular Teams template**, select **Post to a channel when a webhook request is received**.

5. Provide a webhook name and icon and select Create.
![Create a new flow in Teams](/img/platform/maintain/alerting/msteams/create-flow.png)

![Create a new webhook in Microsoft Teams](/img/platform/maintain/alerting/msteams/msteams-webhook-create.png)
4. In the **Flow name** box, type a name, such as **Mondoo Alerts**, then select the **Next** button.

6. Select the Copy icon next to the generated webhook URL.
![Configure a new flow Teams](/img/platform/maintain/alerting/msteams/set-up-flow.png)

![Copy the confirmed URL](/img/platform/maintain/alerting/msteams/msteams-webhook-created.png)
5. Choose the team and channel where you want Mondoo to send alerts, then select the **Next** button.

![Teams URL for Mondoo webhook](/img/platform/maintain/alerting/msteams/copy-url.png)

6. Copy the URL that Microsoft Teams provides. You need this for the next steps.

## Set up the integration with your Mondoo space

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading