]> git.cworth.org Git - turbot/blobdiff - turbot_lambda/turbot_lambda.py
Give turbot/events.py the same dispatch-table treatment
[turbot] / turbot_lambda / turbot_lambda.py
index b8853b36cc33ebfb050955d47d8f798c30149e0f..b6f4a36049360a4e154ac6bf1e6ca3217df8af69 100644 (file)
@@ -1,16 +1,23 @@
 from urllib.parse import parse_qs
-from turbot.rot import rot
 from slack import WebClient
 import boto3
 import requests
-import hashlib
-import hmac
 import json
+import os
+
+import turbot.actions
+import turbot.commands
+import turbot.events
+import turbot.views
 
 ssm = boto3.client('ssm')
 
 response = ssm.get_parameter(Name='SLACK_SIGNING_SECRET', WithDecryption=True)
-slack_signing_secret = bytes(response['Parameter']['Value'], 'utf-8')
+slack_signing_secret = response['Parameter']['Value']
+os.environ['SLACK_SIGNING_SECRET'] = slack_signing_secret
+
+# Note: Late import here to have the environment variable above available
+from turbot.slack import slack_is_valid_request # noqa
 
 response = ssm.get_parameter(Name='SLACK_BOT_TOKEN', WithDecryption=True)
 slack_bot_token = response['Parameter']['Value']
@@ -30,24 +37,6 @@ def error(message):
         'body': ''
     }
 
-def slack_is_valid_request(slack_signature, timestamp, body):
-    """Returns True if the timestamp and body correspond to signature.
-
-    This implements the Slack signature verification using the slack
-    signing secret (obtained via an SSM parameter in code above)."""
-
-    content = "v0:{}:{}".format(timestamp,body).encode('utf-8')
-
-    signature = 'v0=' + hmac.new(slack_signing_secret,
-                                 content,
-                                 hashlib.sha256).hexdigest()
-
-    if hmac.compare_digest(signature, slack_signature):
-        return True
-    else:
-        print("Bad signature: {} != {}".format(signature, slack_signature))
-        return False
-
 def turbot_lambda(event, context):
     """Top-level entry point for our lambda function.
 
@@ -68,15 +57,18 @@ def turbot_lambda(event, context):
         return error("Invalid Slack signature")
 
     # It's a bit cheesy, but we'll just use the content-type header to
-    # determine if we're being called from a slash command or from a
-    # slack event. (The more typical way to do this would be to have
-    # different routes setup, but I want a single function, and with
-    # AWS Lambda I don't have the option to have multiple defined
-    # entry-point functions.
-    if (headers['Content-Type'] == "application/json"):
+    # determine if we're being called from a Slack event or from a
+    # slash command or other interactivity. (The more typical way to
+    # do this would be to have different URLs for each Slack entry
+    # point, but it's simpler to have our Slack app implemented as a
+    # single AWS Lambda, (which can only have a single entry point).
+    content_type = headers['content-type']
+
+    if (content_type == "application/json"):
         return turbot_event_handler(event, context)
-    else:
-        return turbot_slash_command(event, context)
+    if (content_type == "application/x-www-form-urlencoded"):
+        return turbot_interactive_or_slash_command(event, context)
+    return error("Unknown content-type: {}".format(content_type))
 
 def turbot_event_handler(event, context):
     """Handler for all subscribed Slack events"""
@@ -106,94 +98,75 @@ def url_verification_handler(body):
 def event_callback_handler(body):
     type = body['event']['type']
 
-    if type == 'app_home_opened':
-        return app_home_opened_handler(body)
+    if type in turbot.events.events:
+        return turbot.events.events[type](slack_client, body)
     return error("Unknown event type: {}".format(type))
 
-def app_home_opened_handler(body):
-    slack_client.views_publish(user_id=body['event']['user'],
-                               view={
-                                   "type": "home",
-                                   "blocks": [
-                                       {
-                                           "type": "section",
-                                           "text": {
-                                               "type": "mrkdwn",
-                                               "text": "A simple stack of blocks for the simple sample Block Kit Home tab."
-                                           }
-                                       },
-                                       {
-                                           "type": "actions",
-                                           "elements": [
-                                               {
-                                                   "type": "button",
-                                                   "text": {
-                                                       "type": "plain_text",
-                                                       "text": "Action A",
-                                                       "emoji": True
-                                                   }
-                                               },
-                                               {
-                                                   "type": "button",
-                                                   "text": {
-                                                       "type": "plain_text",
-                                                       "text": "Action B",
-                                                       "emoji": True
-                                                   }
-                                               }
-                                           ]
-                                       }
-                                   ]
-                               })
-    return "OK"
-
-def turbot_slash_command(event, context):
-    """Implementation for Slack slash commands.
+def turbot_interactive_or_slash_command(event, context):
+    """Handler for Slack interactive things (buttons, shortcuts, etc.)
+    as well as slash commands.
 
-    This parses the request and arguments and farms out to
-    supporting functions to implement all supported slash commands.
-    """
+    This function simply makes a quiuck determination of what we're looking
+    at and then defers to either turbot_interactive or turbot_slash_command."""
 
+    # Both interactives and slash commands have a urlencoded body
     body = parse_qs(event['body'])
-    command = body['command'][0]
-    args = body['text'][0]
 
-    if (command == "/rotlambda" or command == "/rot"):
-        return rot_slash_command(body, args)
+    # The difference is that an interactive thingy has a 'payload'
+    # while a slash command has a 'command'
+    if 'payload' in body:
+        return turbot_interactive(json.loads(body['payload'][0]))
+    if 'command' in body:
+        return turbot_slash_command(body)
+    return error("Unrecognized event (neither interactive nor slash command)")
 
-    return error("Command {} not implemented".format(command))
+def turbot_interactive(payload):
+    """Handler for Slack interactive requests
 
-def rot_slash_command(body, args):
-    """Implementation of the /rot command
+    These are the things that come from a user interacting with a button
+    a shortcut or some other interactive element that our app has made
+    available to the user."""
 
-    The args string should be as follows:
+    type = payload['type']
 
-        [count|*] String to be rotated
+    if type == 'block_actions':
+        return turbot_block_action(payload)
+    return error("Unrecognized interactive type: {}".format(type))
 
-    That is, the first word of the string is an optional number (or
-    the character '*'). If this is a number it indicates an amount to
-    rotate each character in the string. If the count is '*' or is not
-    present, then the string will be rotated through all possible 25
-    values.
+def turbot_block_action(payload):
+    """Handler for Slack interactive block actions
 
-    The result of the rotation is returned (with Slack formatting) in
-    the body of the response so that Slack will provide it as a reply
-    to the user who submitted the slash command."""
+    Specifically, those that have a payload type of 'block_actions'"""
 
-    channel_name = body['channel_name'][0]
-    response_url = body['response_url'][0]
-    channel_id = body['channel_id'][0]
+    actions = payload['actions']
 
-    result = rot(args)
+    if len(actions) != 1:
+        return error("No support for multiple actions ({}) in a single request"
+                     .format(len(actions)))
 
-    if (channel_name == "directmessage"):
-        requests.post(response_url,
-                      json = {"text": result},
-                      headers = {"Content-type": "application/json"})
-    else:
-        slack_client.chat_postMessage(channel=channel_id, text=result)
+    action = actions[0]
 
-    return {
-        'statusCode': 200,
-        'body': ""
-    }
+    atype = action['type']
+    avalue = action['value']
+
+    if (
+            atype in turbot.actions.actions
+            and avalue in turbot.actions.actions[atype]
+    ):
+        return turbot.actions.actions[atype][avalue](payload)
+    return error("Unknown action of type/value: {}/{}".format(atype, avalue))
+
+def turbot_slash_command(body):
+    """Implementation for Slack slash commands.
+
+    This parses the request and arguments and farms out to
+    supporting functions to implement all supported slash commands.
+    """
+
+    command = body['command'][0]
+    args = body['text'][0]
+
+    if command in turbot.commands.commands:
+        return turbot.commands.commands[command](slack_client, body, args)
+
+    return error("Command {} not implemented".format(command))