Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Contents

Table of Contents
minLevel2
printablefalse

Getting Started

...

Info

Slack is a cloud-based communication platform that enables real-time messaging, archiving, and search for modern teams. This guide explains how to add Slack integration to Cloudaware.

Slack - CA_logo_black.pngImage Added To see how Cloudaware seamlessly integrates with Slack in action, request a demo.

Table of Contents
stylenone

Introduction

Cloudaware supports two types of Slack integration:

1) Slack CloudAware Slack Cloudaware Application

2) Slack Webhook URL

Possible use cases:

  • 30-Day spending exceeds certain amount

  • IDS detects an attack against an instance

  • Server health deteriorates 

  • Incident management

...

Slack Cloudaware Application

Use case: You would like to be notified about any high and critical vulnerability detected.

Creating Application In Cloudaware

...

In Cloudaware

1. Log in to your Cloudaware account your Cloudaware account Admin

...

2. Select Slack CloudAware Slack Cloudaware Application in Other integrations. Click +Add

...

3. Name your integration → Save

...

4. Click Add to SlackGrant CloudAware

...

5. Grant Cloudaware App necessary permissions and select a Slack channel the notifications will be posted to. Click Allow

6. You will be notified about CloudAware about Cloudaware App set up for your Slack Workspace via email and Slack channel

7. The green light in 'Status' means that Slack CloudAware Slack Cloudaware Application has been created successfully. If there is a red light, please contact support@cloudaware.com

...

Configuring Slack Notifications

Select 1. Select Slack Notification in Other integrations. Click +Add

...

2. Select 'Integrated Slack Application'. Fill in the integration details* selecting the app you set up before. Click Save

...

*Name, Message are mandatory fields. 

In our use case we are creating the Upgrade Request notification. Use sObject.CA10__risk__c where CA10__Instancerisk__c is API Name of the object (Cloudaware Upgradable Package in this example).

Use Fields List to determine fields you'd like to exclude from being displayed in your Slack message (Name in this example).

Object Name, Message Message, Color Color, Url  Url Base are expression fields. The data type of the value returned depends on the elements used in the expression. See the list of sample outputs under use case below.Here are sample outputs:

Expression

Output

Code Block
test
Code Block
test
Code Block
sObject.Name
Code Block
‘the name of this field in your org’
Code Block
‘sObject.Name ’
Code Block
sObject.Name
Code Block
‘Hey, ‘+sObject.Name ’ 
Code Block
Hey, ‘the name of this field in your org’
Code Block
Hey, +sObject.Name
Code Block
Hey, +sObject.Name
Code Block
‘good’
Code Block
good
Code Block
sObject.colour_c
Code Block
‘the name of this field in your org’
Code Block
sObject.CA10_severity_c== “High”? ‘danger’ : ‘good’ 
Code Block
danger/good

3. Copy and save the URL as it is required for further configuration in Cloudaware in Cloudaware (see Configuring Cloudaware Configuring CloudAware Workflow To Invoke Slack Action).

Incoming Slack Webhook URL

Use case: You would like to get the notification in Slack channel when package upgrade is requested by your customer (custom object: CloudAware Upgradable package). 

Webhook Configuration In Slack

Enter 1. Enter your Apps Directory in Slack → Incoming Webhooks → toggle 'Activate Incoming Webhooks' to On → Add New Webhook to Workspace (see more here)

...

2. Grant your App necessary permissions and select a Slack channel the notifications will be posted to. Click Allow

...


3. Copy the Webhook URL and save it for later use

...

Adding Slack Webhook To Cloudaware

Log 1. Log in to your Cloudaware account your Cloudaware account Admin

2. Select Slack Notification in Other integrations. Click +Add

...

3. Select 'Slack Webhook URL'. Fill in the integration details* → Save

...

*Name, Slack Webhook URL, Message are mandatory fields. 

In our use case we are creating the Upgrade Request notification (replace Test by the customer name). To understand which instance the package needs to be upgraded on, insert sObject.CA10_Instance_c where CA10_Instance_c is API Name of the object (Cloudaware Upgradable CloudAware Upgradable Package in this example).

Use Fields List to determine fields you'd like to exclude from being displayed in your Slack message (Name in this example).

Object Name, Message, Color, Url BaseBase are expression fields. The data type of the value returned depends on the elements used in the expression. Here are the list of sample outputs:

Expression

Output

Code Block
test
Code Block
test
Code Block
sObject.Name
Code Block
‘the name of this field in your org’
Code Block
‘sObject.Name ’
Code Block
sObject.Name
Code Block
‘Hey, ‘+sObject.Name ’ 
Code Block
Hey, ‘the name of this field in your org’
Code Block
Hey, +sObject.Name
Code Block
Hey, +sObject.Name
Code Block
‘good’
Code Block
good
Code Block
sObject.colour_c
Code Block
‘the name of this field in your org’
Code Block
sObject.CA10_severity_c == “High”? ‘danger’ : ‘good’ 
Code Block
danger
/
good

You can apply standard Slack formatting in the field Message. In our use case we apply bold message format by adding * before the text of the message.

4. The green light in 'Status' means that Slack Notification Webhook has been configured successfully. If there is a red light, please contact support@cloudaware.com

...

5. Copy and save the URL as it is required for further configuration in Cloudaware (see Configuring Cloudaware Workflow To Invoke Slack Action)

Configuring Cloudaware Workflow To Invoke Slack Action

...

Configuring Cloudaware Workflow To Invoke Slack Action


Anchor
Slack-To-Invoke-Action
Slack-To-Invoke-Action
1. In your Cloudaware account click Setup in the main menu

2. In the Quick Find box start typing workflows to select Workflows & Approvals → Workflow Rules → New RuleSelect CloudAware Upgradable Package as the

...

3. Select the object for the rule to be applied to (in our use case CloudAware Upgradable Package) and click Next

4. Add Rule Name (1), set Evaluation Criteria(2) and Rule Criteria(3)*. Add Filter Logic if necessary. Click Save & Next

...

*In our use case we are creating a workflow rule will send out alerts when the field 'Upgrade' (checkbox) is true on CloudAware Upgradable Package object.

5. Add Workflow Action → New Outbound Message. Paste the copied Endpoint URL. Click Save

...

6. Review the workflow. Click Done to activate it

7. Once this workflow rule is triggered, the following Slack notification may be sent:

...