X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=turbot_lambda%2Fturbot_lambda.py;h=1aa428fa95c0740d05c8aa3368877479a07f66ea;hb=1ef1c6f234ba7fb1f88900a664369efb1fc61efb;hp=d67ed0d2a2ead93900087eb331dae12935ee5aed;hpb=a377e260992b6ab2949d5dfe4b835caae4980e4f;p=turbot diff --git a/turbot_lambda/turbot_lambda.py b/turbot_lambda/turbot_lambda.py index d67ed0d..1aa428f 100644 --- a/turbot_lambda/turbot_lambda.py +++ b/turbot_lambda/turbot_lambda.py @@ -1,46 +1,241 @@ from urllib.parse import parse_qs -from turbot.rot import rot +from slack import WebClient +import base64 +import boto3 +import requests +import json +import pickle +import os +from types import SimpleNamespace +from google.auth.transport.requests import Request +from googleapiclient.discovery import build -def turbot_lambda(event, context): - """Top-level entry point for our lambda function. +import turbot.interaction +import turbot.events - This parses the request and arguments and farms out to supporting - functions to implement all supported slash commands.""" +ssm = boto3.client('ssm') - body = parse_qs(event['body']) - command = body['command'][0] - args = body['text'][0] +# Note: Late import here to have the environment variable above available +from turbot.slack import slack_is_valid_request # noqa + +if 'SLACK_BOT_TOKEN' in os.environ: + slack_bot_token = os.environ['SLACK_BOT_TOKEN'] +else: + response = ssm.get_parameter(Name='SLACK_BOT_TOKEN', WithDecryption=True) + slack_bot_token = response['Parameter']['Value'] + os.environ['SLACK_BOT_TOKEN'] = slack_bot_token +slack_client = WebClient(slack_bot_token) + +if 'GSHEETS_PICKLE_BASE64' in os.environ: + gsheets_pick_base64 = os.environ['GSHEETS_PICKLE_BASE64'] +else: + response = ssm.get_parameter(Name='GSHEETS_PICKLE_BASE64', + WithDecryption=True) + gsheets_pickle_base64 = response['Parameter']['Value'] + os.environ['GSHEETS_PICKLE_BASE64'] = gsheets_pickle_base64 +gsheets_pickle = base64.b64decode(gsheets_pickle_base64) +gsheets_creds = pickle.loads(gsheets_pickle) - if (command == "/rotlambda" or command == "/rot"): - return rot_slash_command(args) +if gsheets_creds: + if gsheets_creds.valid: + print("Loaded valid GSheets credentials from SSM") + else: + gsheets_creds.refresh(Request()) + gsheets_pickle = pickle.dumps(gsheets_creds) + gsheets_pickle_base64_bytes = base64.b64encode(gsheets_pickle) + gsheets_pickle_base64 = gsheets_pickle_base64_bytes.decode('us-ascii') + print("Storing refreshed GSheets credentials into SSM") + os.environ['GSHEETS_PICKLE_BASE64'] = gsheets_pickle_base64 + ssm.put_parameter(Name='GSHEETS_PICKLE_BASE64', + Type='SecureString', + Value=gsheets_pickle_base64, + Overwrite=True) +service = build('sheets', + 'v4', + credentials=gsheets_creds, + cache_discovery=False) +sheets = service.spreadsheets() +service = build('drive', + 'v3', + credentials=gsheets_creds, + cache_discovery=False) +files = service.files() +permissions = service.permissions() - error = "Command {} not implemented.".format(command) +db = boto3.resource('dynamodb') - print("Error: {}".format(error)) +turb = SimpleNamespace() +turb.slack_client = slack_client +turb.db = db +turb.table = db.Table("turbot") +turb.sheets = sheets +turb.files = files +turb.permissions = permissions + +def error(message): + """Generate an error response for a Slack request + + This will print the error message (so that it appears in CloudWatch + logs) and will then return a dictionary suitable for returning + as an error response.""" + + print("Error: {}.".format(message)) return { - 'statusCode': 404, - 'body': error + 'statusCode': 400, + 'body': '' } -def rot_slash_command(args): - """Implementation of the /rot command +def turbot_lambda(event, context): + """Top-level entry point for our lambda function. + + This function first verifies that the request actually came from + Slack, (by means of the SLACK_SIGNING_SECRET SSM parameter), and + refuses to do anything if not. - The args string should be as follows: + Then this defers to either turbot_event_handler or + turbot_slash_command to do any real work. + """ - [count|*] String to be rotated + headers = requests.structures.CaseInsensitiveDict(event['headers']) - 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. + signature = headers['X-Slack-Signature'] + timestamp = headers['X-Slack-Request-Timestamp'] - 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.""" + if not slack_is_valid_request(signature, timestamp, event['body']): + 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 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(turb, event, context) + if (content_type == "application/x-www-form-urlencoded"): + return turbot_interactive_or_slash_command(turb, event, context) + return error("Unknown content-type: {}".format(content_type)) + +def turbot_event_handler(turb, event, context): + """Handler for all subscribed Slack events""" + + body = json.loads(event['body']) + + type = body['type'] + + if type == 'url_verification': + return url_verification_handler(turb, body) + if type == 'event_callback': + return event_callback_handler(turb, body) + return error("Unknown event type: {}".format(type)) + +def url_verification_handler(turb, body): + + # First, we have to properly respond to url_verification + # challenges or else Slack won't let us configure our URL as an + # event handler. + challenge = body['challenge'] return { 'statusCode': 200, - 'body': rot(args) + 'body': challenge } + +def event_callback_handler(turb, body): + event = body['event'] + type = event['type'] + + if type in turbot.events.events: + return turbot.events.events[type](turb, event) + return error("Unknown event type: {}".format(type)) + +def turbot_interactive_or_slash_command(turb, event, context): + """Handler for Slack interactive things (buttons, shortcuts, etc.) + as well as slash commands. + + This function simply makes a quick 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']) + + # The difference is that an interactive thingy has a 'payload' + # while a slash command has a 'command' + if 'payload' in body: + return turbot_interactive(turb, json.loads(body['payload'][0])) + if 'command' in body: + return turbot_slash_command(turb, body) + return error("Unrecognized event (neither interactive nor slash command)") + +def turbot_interactive(turb, payload): + """Handler for Slack interactive requests + + 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.""" + + type = payload['type'] + + if type == 'block_actions': + return turbot_block_action(turb, payload) + if type == 'view_submission': + return turbot.interaction.view_submission(turb, payload) + if type == 'shortcut': + return turbot_shortcut(turb, payload) + return error("Unrecognized interactive type: {}".format(type)) + +def turbot_block_action(turb, payload): + """Handler for Slack interactive block actions + + Specifically, those that have a payload type of 'block_actions'""" + + actions = payload['actions'] + + if len(actions) != 1: + return error("No support for multiple actions ({}) in a single request" + .format(len(actions))) + + action = actions[0] + + atype = action['type'] + if 'value' in action: + avalue = action['value'] + else: + avalue = '*' + + if ( + atype in turbot.interaction.actions + and avalue in turbot.interaction.actions[atype] + ): + return turbot.interaction.actions[atype][avalue](turb, payload) + return error("Unknown action of type/value: {}/{}".format(atype, avalue)) + +def turbot_shortcut(turb, payload): + """Handler for Slack shortcuts + + These are invoked as either global or message shortcuts by a user.""" + + print("In turbot_shortcut, payload is: {}".format(str(payload))) + + return error("Shortcut interactions not yet implemented") + +def turbot_slash_command(turb, 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] + if 'text' in body: + args = body['text'][0] + else: + args = '' + + if command in turbot.interaction.commands: + return turbot.interaction.commands[command](turb, body, args) + + return error("Command {} not implemented".format(command))