Notification Channels

To receive notifications from KloudMate about incidents in your infrastructure, you need to set up notification channels. Notification channels are the communication platforms where alerts are sent.

KloudMate supports the following notification channels:

• Email
• Slack
• SNS
• MS Teams
• Webhook
• Jira

In the case of multiple workspaces and AWS accounts, you must set up notifications for each account in their respective Settings.

Navigate to Settings > Notification Channels. The screen displays all existing channels with their name, type, and address.

1. Click the Create button at the top-right corner.
2. Select the desired channel type from the dropdown.

Once created, the channel appears in the list. You can Edit or Delete any channel using the more options (⋯) icon.

Below are the configuration steps for each specific channel type:

Email

1. Select Email from the dropdown menu.
2. Enter a Name for the channel (e.g., demo) and your email address in the Address field.
3. Click Submit.

Slack

1. Select Slack from the dropdown menu, then click the Add to Slack button.
2. You will be redirected to the Slack integrations page. Follow the on-screen instructions, add a message for your App Manager, then click Submit.

MS Teams

1. Select MS Teams from the dropdown menu.
2. Create an incoming webhook URL from Microsoft Teams by going to Channel > Connectors > Incoming Webhooks in the Microsoft Teams Apps.
3. Enter the Team Channel Name and the Webhook Address in their respective fields.
4. Click Submit.

Optionally, you can download the KloudMate logo from the link provided on the screen to update the webhook’s image in MS Teams.

SNS

1. Select SNS from the dropdown menu.
2. Copy the KloudMate SNS Access Policy displayed on the screen. Navigate to your AWS Console and paste the policy into your SNS topic. Update the placeholders in the policy with the correct values.
3. Return to KloudMate, enter a Name and your Topic ARN in their respective fields.
4. Click Submit.

Webhooks

1. Select Webhook from the dropdown menu.
2. Enter a Webhook Name and the Webhook URL in their respective fields.
3. Under Secret, provide a secure key. This secret will be used to generate an HMAC-SHA256 signature for each webhook payload, allowing you to verify that the request authentically came from KloudMate.
4. Click Submit.

Webhook Signature Validation

When KloudMate sends a webhook to your configured URL, it includes an X-KM-Signature HTTP header. This signature is an HMAC-SHA256 hash generated using the payload body and the Secret you provided during configuration.

To ensure the webhook is genuinely from KloudMate, you should compute the hash on your server and compare it with the X-KM-Signature header.

Here are examples of how to perform this validation in common programming languages:

Node.js (Express)

const crypto = require('crypto');

// Ensure you have access to the raw request body.
// For Express, you might use express.raw({ type: 'application/json' }) 
function verifySignature(req) {
  const signatureHeader = req.headers['x-km-signature'];
  const secret = 'YOUR_WEBHOOK_SECRET';
  
  // Create HMAC-SHA256 hash of the raw JSON body
  const expectedSignature = crypto
    .createHmac('sha256', secret)
    .update(req.rawBody) // Pass the raw JSON string here
    .digest('hex');

  return signatureHeader === expectedSignature;
}

Python

import hmac
import hashlib

def verify_signature(payload_body: bytes, secret: str, signature_header: str) -> bool:
  # payload_body must be the raw bytes of the request body
  expected_signature = hmac.new(
    secret.encode('utf-8'),
    payload_body,
    hashlib.sha256
  ).hexdigest()
  
  return hmac.compare_digest(expected_signature, signature_header)

Go

import (
  "crypto/hmac"
  "crypto/sha256"
  "encoding/hex"
)

func verifySignature(payloadBody []byte, secret string, signatureHeader string) bool {
  mac := hmac.New(sha256.New, []byte(secret))
  mac.Write(payloadBody)
  expectedMAC := hex.EncodeToString(mac.Sum(nil))
  
  return hmac.Equal([]byte(expectedMAC), []byte(signatureHeader))
}

Jira

1. Select Jira from the dropdown menu and click the Connect Jira button.

2. You will be redirected to the Jira authorization page. Click Accept to authorize the integration between KloudMate and your Atlassian account.

3. You will be redirected back to the Jira Notification Channel configuration page in KloudMate.

Enter a Channel Name and select the following:

• Site: your Jira site
• Project: the Jira project to link
• Issue Type: the type of issue to create (e.g., Task)
• Status for Open state: the Jira status that corresponds to an open ticket (e.g., To Do, In Progress)
• Status for Closed state: the Jira status that corresponds to a closed ticket (e.g., Done)

4. Click Submit to complete the integration.

Jira integration with KloudMate is one-way. Status changes in KloudMate will be reflected in Jira, but status changes made in Jira will not be reflected in KloudMate.

Alarm and Issue Details in Jira

Alarm details in Jira

KloudMate	Jira
Alarm name	Ticket title
KloudMate account name	Ticket title
Alarm description	Ticket description
Alarm value	Ticket description
Regression alarms	Ticket comment

Issues details in Jira

KloudMate	Jira
Issue’s service name	Ticket title
KloudMate account name	Ticket title
Regression Issues	Ticket title
Issue name	Ticket description
Issue comments	Ticket comments

Creating a Manual Jira Ticket

You can create a Jira ticket directly from an issue or alarm details page to raise individual tickets that are not assigned to a notification policy.

Prerequisite: A Jira notification channel must already be configured.

1. Navigate to the Issue or Alarm details page.
2. Click the Create in Jira button. A dialog will open showing all Jira channels integrated with your KloudMate account, along with any previously linked Jira tickets for that issue.

3. Under Jira Channels, select the checkbox(es) for the channel(s) you want to raise a ticket in.
4. Click Create Ticket.

Unlinking a Jira Ticket

1. On the issue or alarm details page, click the settings icon next to the Create in Jira button to open the Jira Tickets panel.
2. The panel displays all Jira tickets currently linked to the issue, showing the Ticket ID, Site, Project, and Issue Type.
3. Click the unlink icon next to the ticket you want to remove to unlink it from KloudMate.