Versions Compared

Key

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

Contents

Table of Contents
minLevel2
printablefalse

Getting Started

Cloudaware supports two types of Slack integration:

1) 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

1. Log in to your Cloudaware account → AdminImage Removed

...

2. Select Slack Cloudaware Application in Other integrations. Click +AddImage Removed

...

3. Name your integration → SaveImage Removed

...

4. Click Add to SlackImage Removed

...

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 App set up for your Slack Workspace via email and Slack channel

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

...

Configuring Slack Notifications

1. Select Slack Notification in Other integrations. Click +AddImage Removed

...

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

...

*Name, Message are mandatory fields. 

In our use case we are creating the Upgrade Request notification. Use sObject.CA10__risk__c where CA10__risk__c is API Name of the object.

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. 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 (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

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

...

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

...


3. Copy the Webhook URL and save it for later useImage Removed

...

Adding Slack Webhook To Cloudaware

1. Log in to your Cloudaware account → Admin

2. Select Slack Notification in Other integrations. Click +AddImage Removed

...

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

...

*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 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 Base are expression fields. The data type of the value returned depends on the elements used in the expression. 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

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.comImage Removed

...

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

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 RuleImage Removed

...

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 & NextImage Removed

...

*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 SaveImage Removed

...

6. Review the workflow. Click Done to activate it

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

...