Automating notifications is a common DevOps task. In this post, I'll explain how to send Adobe Cloud Manager pipeline status notifications to Slack using a Project Firefly headless application.
In the <a style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif;" title="Getting Started with Project Firefly" href="../blog/getting-started-with-project-firefly" target="_blank" rel="noopener">Getting Started with Project Firefly</a> post, we created a Firefly project and used the Developer Console to add the Cloud Manager API, as well as a credential (JWT) to our project.&nbsp;
<h3>Slack API</h3>
To begin this integration, follow the instructions on the Slack website to create an <a title="slack documentation for incoming webhook" href="https://api.slack.com/messaging/webhooks" target="_blank" rel="noopener">incoming webhook</a>.&nbsp; 
<img src="https://i.ibb.co/nrbNcZz/retrieve-webhook-url.png" alt="retrieve webhook url in slack" width="100%" />
After your Slack App is created, make a note of the webhook URL, we will use it when coding the application.&nbsp;
<h3>Coding the Application</h3>
Open the <a title="AIO CLI documentation" href="https://github.com/adobe/aio-cli#aio-appadd" target="_blank" rel="noopener">AIO CLI documentation</a> and <a title="Cloud Manager API documentation" href="https://www.adobe.io/apis/experiencecloud/cloud-manager/api-reference.html#!AdobeDocs/cloudmanager-api-docs/master/swagger-specs/api.yaml" target="_blank" rel="noopener">Cloud Manager API documentation</a> in a browser tab for quick reference. Using the terminal, navigate to your code project and run the following command:
<pre class="language-markup"><code>aio app:add:action</code></pre>
The action creation wizard will walk you through generating a new action. Select, <code>Generic</code> as the action type and give the action an appropriate name (e.g. <code>notify-slack</code>). Agree to overwrite the package.json and manifest.yml files when prompted.
Open the code project within an editor and open the .env file. Notice the environment variables reflect the values that appear within the Developer Console. Add the following environment variables to the .env file.&nbsp;
<ul>
<li>PRIVATE_KEY=&lt;YOUR-PRIVATE-KEY&gt;</li>
</ul>
These environment variables will be made available to the application in the next step when we update the manifest.yml file.
<blockquote>
Note: It is not recommended to store your private key in an environment variable, for the sake of brevity I will in this tutorial, but in your production application you should read the private key from a file. Learn how to create <a title="Zipped Action Folder Resources in Project Firefly and Adobe I/O Runtime" href="../blog/zipped-action-folder-resources-in-project-firefly-and-adobe-io-runtime" target="_blank" rel="noopener">Zipped Action Folder Resources in Project Firefly and Adobe I/O Runtime</a>. 
</blockquote>
<img src="https://i.ibb.co/7SPGkZb/Cloud-Manager-Slack-Notification-Dot-Env-File.png" alt="Dot Env File" width="100%" />
Open the manifest.yml file and locate the entry for the <code>notify-slack</code> action. Items within the Inputs block will be made available to our application code within the <code>params</code> object. Environment variables (.env file) can be used within the manifest.yml file through the use of the $ symbol. Map the environment variables to the input properties as shown below.
<img src="https://i.ibb.co/6bCLxH9/Cloud-Manager-Slack-Notifications-Manifest-File.png" alt="Manifest File" width="100%" />&nbsp; From the terminal, run the following command to install the <a title="jsrasign" href="https://www.npmjs.com/package/jsrsasign" target="_blank" rel="noopener">jsrasign</a> dependency.
<pre class="language-markup"><code>npm install jsrsasign --save</code></pre>
Open the code project within an editor and create a new file within the actions &gt; notify-slack folder named token.js. The token.js module will be responsible for exchanging a JWT token for an OAuth 2.0 access token which we'll need to work with the Cloud Manager API. Paste the following code into token.js. Save and close the file.
<pre class="language-javascript"><code>const jsrsasign = require("jsrsasign");
const fetch = require("node-fetch");
const { URLSearchParams } = require("url");

async function getAccessToken(params) {
 const EXPIRATION = 60 * 60; // 1 hour

 const header = {
 alg: "RS256",
 typ: "JWT",
 };

 const payload = {
 exp: Math.round(new Date().getTime() / 1000) + EXPIRATION,
 iss: params.IMS_ORG_ID,
 sub: params.TECHNICAL_ACCOUNT_ID,
 aud: `https://ims-na1.adobelogin.com/c/${params.SERVICE_API_KEY}`,
 "https://ims-na1.adobelogin.com/s/ent_cloudmgr_sdk": true,
 };

 const jwtToken = jsrsasign.jws.JWS.sign(
 "RS256",
 JSON.stringify(header),
 JSON.stringify(payload),
 params.PRIVATE_KEY
 );

 const response = await fetch(
 "https://ims-na1.adobelogin.com/ims/exchange/jwt",
 {
 method: "POST",
 body: new URLSearchParams({
 client_id: params.SERVICE_API_KEY,
 client_secret: params.CLIENT_SECRET,
 jwt_token: jwtToken,
 }),
 }
 );

 const json = await response.json();
 return json["access_token"];
}

module.exports = {
 getAccessToken
}</code></pre>
Open the index.js file within the editor and replace the contents with the following code. Update the <code>SLACK_WEBHOOK</code> constant variable with the appropriate value for your Slack App.
<pre class="language-javascript"><code>const fetch = require('node-fetch')
const { Core } = require('@adobe/aio-sdk')
const { getAccessToken } = require('./token');
const { errorResponse, getBearerToken, stringParameters, checkMissingRequestInputs } = require('../utils')

const SLACK_WEBHOOK = 'https://hooks.slack.com/services/&lt;YOUR-WEBHOOK-URL&gt;';

async function sendNotification (params) {
 const accessToken = await getAccessToken(params);

 let type = params.event['@type'].indexOf('started') &gt; -1 ? 'STARTED' : 'ENDED';
 let id = params.event['activitystreams:object']['@id'];

 // Make GET Request to Cloud Manager API
 let pipelineRequest = await fetch(id, {
 'method': 'GET',
 'headers': { 'Content-Type': 'application/json', 'Authorization': `Bearer ${accessToken}`, 'x-gw-ims-org-id': params.IMS_ORG_ID, 'x-api-key': params.SERVICE_API_KEY}
 });

 let pipeline = await pipelineRequest.json();
 let notification = `Cloud Manager Pipeline Notification \n Event Type: ${type} \n Status: ${pipeline.status} \n ID: ${id}`;

 //Make POST to Slack Webhook
 const message = await fetch(SLACK_WEBHOOK, {
 'method': 'POST',
 'headers': { 'Content-Type': 'application/json' },
 'body': JSON.stringify({
 'text': notification
 })
 })

 const response = {
 statusCode: 200,
 body: message
 }

 return response
}

async function main (params) {
 const logger = Core.Logger('main', { level: params.LOG_LEVEL || 'info' })

 try {
 const requiredParams = ['event', 'SERVICE_API_KEY', 'CLIENT_SECRET', 'IMS_ORG_ID', 'TECHNICAL_ACCOUNT_ID']
 const requiredHeaders = []
 const errorMessage = checkMissingRequestInputs(params, requiredParams, requiredHeaders)
 
 if (errorMessage) {
 return errorResponse(400, errorMessage, logger)
 }
 
 let response = await sendNotification(params);
 return response;

 } catch (error) {
 logger.error(error)
 return errorResponse(500, 'server error', logger)
 }
}

exports.main = main
</code></pre>
You should now have two modules within your actions &gt; notify-slack folder.
<img src="https://i.ibb.co/CBmKr0d/filesystem-notify-slack-modules.png" alt="Filesystem showing notify-slack modules" width="100%" />
From the terminal, run the following command to start the application.
<pre class="language-markup"><code>aio app run</code></pre>
Notice that the console output provides two URLs to view the application.&nbsp;
<ul>
<li>Local Application - Renders the application from a local HTTPS server
<ul>
<li><code>https://localhost:9080 </code></li>
</ul>
</li>
<li>Experience Cloud Shell - Renders the application within the Experience Cloud Shell with an authenticated session
<ul>
<li><code>https://experience.adobe.com/?devMode=true#/custom-apps/?localDevUrl=https://localhost:9080</code></li>
</ul>
</li>
</ul>
Confirm that the action is available from the menu.
<img src="https://i.ibb.co/ZMGSd3z/Slack-Notification-Firefly-Developer-Tool.png" alt="Firefly Developer Tool" width="100%" />&nbsp;
<h3>Registering I/O Event Listener</h3>
1) Return to the Developer Console and click the Add Event button within the production workspace of the project.
<img src="https://i.ibb.co/ZJGdsdj/Developer-Console-Add-Event-Cloud-Manager.png" alt="Developer Console Add Event Cloud Manager" width="100%" />
2) Select the Experience Cloud category and then select the Cloud Manager service.
<img src="https://i.ibb.co/VSTnMYf/Developer-Console-Add-Event-Cloud-Manager-Selection.png" alt="Select Cloud Manager" width="100%" />
3) Click the Next button. Select the events you want to subscribe to. For this demo, I selected the Pipeline Execution Started and Pipeline Execution Ended events.
<img src="https://i.ibb.co/f4N8t6w/Developer-Console-Event-Configuration.png" alt="Developer Console Configure Event Registration" width="100%" />
4) Click the Next button. Select the Service Account Credential to associate with the application.
<img src="https://i.ibb.co/Wc0ZpL6/Developer-Console-Event-Configuration-Service-Account-Credential-Selection.png" alt="Developer Console Select Service Account Credential" width="100%" />
5) Click the Next button. Enter a unique name for this event registration (e.g. <code>PipelineSlackNotification</code>). Select the action that we created earlier (e.g. <code>notify-slack</code>) from the Runtime action drop-down menu.
<img src="https://i.ibb.co/zxgfLZv/Developer-Console-Event-Runtime-Mapping.png" alt="Map Event Registration to Runtime Action" width="100%" />
6) Click the Save Configurated Events button. The Event Registration should reflect an active status.
<img src="https://i.ibb.co/jTBZ4tv/Developer-Console-Event-Registration-Active.png" alt="Registered Event is Active" width="100%" />
<h3>Building Cloud Manager Pipeline</h3>
1) Initiate a build on the Cloud Manager Pipeline
<img src="https://i.ibb.co/ZgSwxWd/Cloud-Manager-Build-Pipeline.png" alt="Build Cloud Manager Pipeline" width="100%" />
2) Open Slack channel and verify the notification was sent
<img src="https://i.ibb.co/5Mx7YL2/Cloud-Manager-Slack-Notification.png" alt="Slack Channel Notification" width="100%" />&nbsp;

In this post I show how to send Adobe Cloud Manager pipeline status notifications to Slack using a Project Firefly headless application