Add jira and slack integrations to staging

jimmyjayp · jimmyjayp · commit 31b37d97df5b · 2021-11-22T23:34:05.000-05:00
diff --git a/api_server/docs/integrations/jira.md b/api_server/docs/integrations/jira.md
@@ -1 +1,39 @@
 # Jira (Atlassian Cloud)
+
+The CodeStream Jira Cloud integration requires users to go through the OAuth
+process. This requires a developer app in an Atlassian account to enable the
+OAuth handshake and grant access to the system.
+
+## Creating Developer App for OAuth
+
+1. Login to your Atlassian cloud account and go to [the developer apps
+   site](https://developer.atlassian.com/apps/).
+
+1. Create > OAuth 2.0 Integrations
+
+1. Distribution > Enable sharing; Also, complete the rest of the page
+
+1. Permissions > Add Jira Platform REST API
+
+1. Confiure Jira Platform Rest API
+	- Add **View Jira Issue Data**
+	- Add **Create and Manage Issues**
+	- Verify **View user profiles** has been added
+
+1. Authorization > User persistent refresh token
+
+1. Set callback URL like `https://stg-api.codestream.us/no-auth/provider-token/jira`
+
+1. Add the client ID, secret, etc.. to the CodeStream server config.
+    ```
+    {
+        "integrations": {
+        	"jira": {
+                "cloud": {
+                "appClientId": "*************************",
+                "appClientSecret": "**********************************",
+                "disabled": false
+            }
+        }
+    }
+    ```
diff --git a/api_server/docs/integrations/slack.md b/api_server/docs/integrations/slack.md
@@ -28,7 +28,9 @@ Steps to create a Slack App for a non-production CodeStream environment.
         them.
         *   Add the following Redirect URL:
             - `https://<codestream-api-host>/no-auth/provider-token/slack`
-        *   Add the following Scopes and save them (Request reasons included here):
+        *   Add the following Scopes and save them (Request reasons included
+            here). _NOTE: the source of truth for the list of scopes is [here]().
+            You should verify this list accordingly._
             - **channels:read** - We allow users to select a public channel to share
             to.
             - **chat:write** - Users can send a copy of their messages from
@@ -56,7 +58,7 @@ workspaces that wish to connect with the corresponding CodeStream environment.
 ## Update the CodeStream Configuration
 
 Finally, add the secrets and configuration data to the CodeStream API server's
-configuration file. The following data is needed:
+configuration file in the **integrations** section.
 
 From the **Basic Information** page of the Slack App, get these data and add
 them to the CodeStream configuration file.
@@ -67,6 +69,31 @@ them to the CodeStream configuration file.
 - Signing Secret
 
 
+```
+{
+    "integrations": {
+		"slack": {
+			"cloud": {
+				"appClientId": null,
+				"appClientSecret": null,
+				"appId": null,
+				"appSharingClientId": "*******************************",
+				"appSharingClientSecret": "********************************",
+				"appSharingId": "***************************",
+				"appSharingSigningSecret": "**************************",
+				"appSigningSecret": null,
+				"appStrictClientId": null,
+				"appStrictClientSecret": null,
+				"appStrictId": null,
+				"appStrictSigningSecret": null,
+				"disabled": false,
+				"interactiveComponentsEnabled": true
+			}
+		}
+    }
+}
+```
+
 ## Permalink to Code Requesting Auth
 
 This is the _source of truth_ where slack access is concerned.
diff --git a/shared/codestream_configs/profiles/cloud.json b/shared/codestream_configs/profiles/cloud.json
@@ -216,7 +216,9 @@
 				"prod": {
 					"_loadSecretsFile": "atlassian/prod.cfg"
 				},
-				"stg": {}
+				"stg": {
+					"_loadSecretsFile": "atlassian/stg.cfg"
+				}
 			}
 		},
 		"linear": {
@@ -289,7 +291,10 @@
 					"_loadSecretsFile": "slack/qa-combined.cfg",
 					"interactiveComponentsEnabled": true
 				},
-				"stg": {}
+				"stg": {
+					"_loadSecretsFile": "slack/stg-combined.cfg",
+					"interactiveComponentsEnabled": true
+				}
 			}
 		},
 		"trello": {
