Skip to content

SpiderFoot automates OSINT for threat intelligence and mapping your attack surface.

Implement sfp_twilio

Krishnasis Mandalf9d03372a9e4
diff --git a/modules/sfp_twilio.py b/modules/sfp_twilio.py
new file mode 100644
index 00000000..0accc239
--- /dev/null
+++ b/modules/sfp_twilio.py
@@ -0,0 +1,126 @@
+# -*- coding: utf-8 -*-
+# -------------------------------------------------------------------------------
+# Name: sfp_twilio
+# Purpose: Extract data from phone numbers.
+#
+# Author: Krishnasis Mandal <[email protected]>
+#
+# Created: 14/06/2020
+# Copyright: (c) Steve Micallef
+# Licence: GPL
+# -------------------------------------------------------------------------------
+
+from sflib import SpiderFoot, SpiderFootPlugin, SpiderFootEvent
+import base64
+import json
+
+class sfp_twilio(SpiderFootPlugin):
+ """Twilio:Footprint,Investigate,Passive:Search Engines:apikey:Obtain data from Twilio from target phone number."""
+
+ opts = {
+ 'account_sid': '',
+ 'auth_token': ''
+ }
+
+ optdescs = {
+ 'account_sid': 'Twilio Account SID',
+ 'auth_token': 'Twilio Auth Token'
+ }
+
+ results = None
+ errorState = False
+
+ def setup(self, sfc, userOpts=dict()):
+ self.sf = sfc
+ self.results = self.tempStorage()
+
+ for opt in list(userOpts.keys()):
+ self.opts[opt] = userOpts[opt]
+
+ def watchedEvents(self):
+ return ["PHONE_NUMBER"]
+
+ # What events this module produces
+ def producedEvents(self):
+ return ["HUMAN_NAME", "COMPANY_NAME", "RAW_RIR_DATA"]
+
+ # When querying third parties, it's best to have a dedicated function
+ # to do so and avoid putting it in handleEvent()
+ def queryPhoneNumber(self, phoneNumber):
+
+ token = (base64.b64encode(self.opts['account_sid'].encode('utf8') + ":".encode('utf-8') + self.opts['auth_token'].encode('utf-8'))).decode('utf-8')
+
+ headers = {
+ 'Accept': "application/json",
+ 'Authorization': "Basic " + token
+ }
+
+ res = self.sf.fetchUrl(
+ 'https://lookups.twilio.com/v1/PhoneNumbers/' + phoneNumber,
+ headers=headers,
+ timeout=15,
+ useragent=self.opts['_useragent']
+ )
+
+ if res['code'] == '400':
+ self.sf.error("Bad request.", False)
+ return None
+
+ if res['code'] == '429':
+ self.sf.error("API usage limit reached.", False)
+ return None
+
+ if res['code'] == '503':
+ self.sf.error("Service unavailable.", False)
+ return None
+
+ if not res['code'] == '200':
+ self.sf.error("Could not fetch data.", False)
+ return None
+
+ return res.get('content')
+
+ # Handle events sent to this module
+ def handleEvent(self, event):
+ eventName = event.eventType
+ srcModuleName = event.module
+ eventData = event.data
+
+ if self.errorState:
+ return None
+
+ self.sf.debug("Received event, " + eventName + ", from " + srcModuleName)
+
+ # Always check if the API key is set and complain if it isn't, then set
+ # self.errorState to avoid this being a continual complaint during the scan.
+ if self.opts['account_sid'] == "" or self.opts['auth_token'] == "":
+ self.sf.error("You enabled sfp_twilio but did not set account sid/auth token", False)
+ self.errorState = True
+ return None
+
+ # Don't look up stuff twice
+ if eventData in self.results:
+ self.sf.debug("Skipping " + eventData + " as already mapped.")
+ return None
+ else:
+ self.results[eventData] = True
+
+ content = self.queryPhoneNumber(eventData)
+
+ if content is None:
+ return None
+
+ data = json.loads(content)
+
+ evt = SpiderFootEvent("RAW_RIR_DATA", str(data), self.__name__, event)
+ self.notifyListeners(evt)
+
+ callerName = data.get('caller_name')
+
+ if callerName:
+ evt = SpiderFootEvent("HUMAN_NAME", callerName, self.__name__, event)
+ self.notifyListeners(evt)
+
+ return None
+
+# End of sfp_twilio class