mirror of
https://github.com/overcuriousity/autopsy-flatpak.git
synced 2025-07-06 21:00:22 +00:00
257 lines
13 KiB
Python
257 lines
13 KiB
Python
"""
|
|
Autopsy Forensic Browser
|
|
|
|
Copyright 2019 Basis Technology Corp.
|
|
Contact: carrier <at> sleuthkit <dot> org
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
"""
|
|
|
|
from java.io import File
|
|
from java.lang import Class
|
|
from java.lang import ClassNotFoundException
|
|
from java.lang import Long
|
|
from java.lang import String
|
|
from java.sql import ResultSet
|
|
from java.sql import SQLException
|
|
from java.sql import Statement
|
|
from java.util.logging import Level
|
|
from java.util import ArrayList
|
|
from org.apache.commons.codec.binary import Base64
|
|
from org.sleuthkit.autopsy.casemodule import Case
|
|
from org.sleuthkit.autopsy.casemodule import NoCurrentCaseException
|
|
from org.sleuthkit.autopsy.coreutils import Logger
|
|
from org.sleuthkit.autopsy.coreutils import MessageNotifyUtil
|
|
from org.sleuthkit.autopsy.coreutils import AppSQLiteDB
|
|
from org.sleuthkit.autopsy.datamodel import ContentUtils
|
|
from org.sleuthkit.autopsy.ingest import IngestJobContext
|
|
from org.sleuthkit.datamodel import AbstractFile
|
|
from org.sleuthkit.datamodel import BlackboardArtifact
|
|
from org.sleuthkit.datamodel import BlackboardAttribute
|
|
from org.sleuthkit.datamodel import Content
|
|
from org.sleuthkit.datamodel import TskCoreException
|
|
from org.sleuthkit.datamodel.Blackboard import BlackboardException
|
|
from org.sleuthkit.datamodel import Account
|
|
from org.sleuthkit.datamodel.blackboardutils import CommunicationArtifactsHelper
|
|
from org.sleuthkit.datamodel.blackboardutils.CommunicationArtifactsHelper import MessageReadStatus
|
|
from org.sleuthkit.datamodel.blackboardutils.CommunicationArtifactsHelper import CommunicationDirection
|
|
|
|
import json
|
|
import traceback
|
|
import general
|
|
|
|
"""
|
|
Finds the SQLite DB for Facebook messenger, parses the DB for contacts & messages,
|
|
and adds artifacts to the case.
|
|
"""
|
|
class FBMessengerAnalyzer(general.AndroidComponentAnalyzer):
|
|
|
|
def __init__(self):
|
|
self._logger = Logger.getLogger(self.__class__.__name__)
|
|
|
|
self._FB_MESSENGER_PACKAGE_NAME = "com.facebook.orca"
|
|
self._FACEBOOK_PACKAGE_NAME = "com.facebook.katana"
|
|
self._MODULE_NAME = "FB Messenger Analyzer"
|
|
self._MESSAGE_TYPE = "Facebook Messenger"
|
|
self._VERSION = "239.0.0.41" ## FB version number. Did not find independent version number in FB Messenger
|
|
|
|
self.selfAccountAddress = None
|
|
self.current_case = None
|
|
|
|
## Analyze contacts
|
|
def analyzeContacts(self, dataSource, fileManager, context):
|
|
## FB messenger and FB have same database structure for contacts.
|
|
## In our example the FB Messenger database was empty.
|
|
## But the FB database had the data.
|
|
|
|
contactsDbs = AppSQLiteDB.findAppDatabases(dataSource, "contacts_db2", True, self._FACEBOOK_PACKAGE_NAME)
|
|
for contactsDb in contactsDbs:
|
|
try:
|
|
selfAccountResultSet = contactsDb.runQuery("SELECT fbid, display_name FROM contacts WHERE added_time_ms = 0")
|
|
if selfAccountResultSet:
|
|
if not self.selfAccountAddress:
|
|
self.selfAccountAddress = Account.Address(selfAccountResultSet.getString("fbid"), selfAccountResultSet.getString("display_name"))
|
|
|
|
if self.selfAccountAddress is not None:
|
|
contactsDBHelper = CommunicationArtifactsHelper(self.current_case.getSleuthkitCase(),
|
|
self._MODULE_NAME, contactsDb.getDBFile(),
|
|
Account.Type.FACEBOOK, Account.Type.FACEBOOK, self.selfAccountAddress )
|
|
else:
|
|
contactsDBHelper = CommunicationArtifactsHelper(self.current_case.getSleuthkitCase(),
|
|
self._MODULE_NAME, contactsDb.getDBFile(),
|
|
Account.Type.FACEBOOK)
|
|
|
|
contactsResultSet = contactsDb.runQuery("SELECT fbid, display_name FROM contacts WHERE added_time_ms <> 0")
|
|
if contactsResultSet is not None:
|
|
while contactsResultSet.next():
|
|
contactsDBHelper.addContact( contactsResultSet.getString("fbid"), ## unique id for account
|
|
contactsResultSet.getString("display_name"), ## contact name
|
|
"", ## phone
|
|
"", ## home phone
|
|
"", ## mobile
|
|
"") ## email
|
|
|
|
except SQLException as ex:
|
|
self._logger.log(Level.WARNING, "Error processing query result for account", ex)
|
|
self._logger.log(Level.WARNING, traceback.format_exc())
|
|
except TskCoreException as ex:
|
|
self._logger.log(Level.SEVERE, "Failed to add Facebook Messenger contact artifacts.", ex)
|
|
self._logger.log(Level.SEVERE, traceback.format_exc())
|
|
except BlackboardException as ex:
|
|
self._logger.log(Level.WARNING, "Failed to post artifacts.", ex)
|
|
self._logger.log(Level.WARNING, traceback.format_exc())
|
|
finally:
|
|
contactsDb.close()
|
|
|
|
|
|
|
|
## Adds a recipient to given list
|
|
def addRecipientToList(self, user_key, name, fromAddress, recipientList):
|
|
if user_key is not None:
|
|
recipientId = user_key.replace('FACEBOOK:', '')
|
|
toAddress = Account.Address(recipientId, name)
|
|
# ensure sender, if known, isn't added to recipientList.
|
|
if (fromAddress and fromAddress.getUniqueID() != toAddress.getUniqueID()) or (not fromAddress) :
|
|
# add recipient to list
|
|
recipientList.append(toAddress)
|
|
|
|
## Analyze messages
|
|
def analyzeMessages(self, dataSource, fileManager, context):
|
|
threadsDbs = AppSQLiteDB.findAppDatabases(dataSource, "threads_db2", True, self._FB_MESSENGER_PACKAGE_NAME)
|
|
for threadsDb in threadsDbs:
|
|
try:
|
|
if self.selfAccountAddress is not None:
|
|
threadsDBHelper = CommunicationArtifactsHelper(self.current_case.getSleuthkitCase(),
|
|
self._MODULE_NAME, threadsDb.getDBFile(),
|
|
Account.Type.FACEBOOK, Account.Type.FACEBOOK, self.selfAccountAddress )
|
|
else:
|
|
threadsDBHelper = CommunicationArtifactsHelper(self.current_case.getSleuthkitCase(),
|
|
self._MODULE_NAME, threadsDb.getDBFile(),
|
|
Account.Type.FACEBOOK)
|
|
|
|
## Messages are found in the messages table. The participant ids can be found in the thread_participants table.
|
|
## Participant names are found in thread_users table.
|
|
## Joining these tables produces multiple rows per message, one row for each recipient
|
|
sqlString = "SELECT msg_id, text, sender, timestamp_ms, messages.thread_key as thread_key,"\
|
|
" snippet, thread_participants.user_key as user_key, thread_users.name as name FROM messages"\
|
|
" JOIN thread_participants ON messages.thread_key = thread_participants.thread_key"\
|
|
" JOIN thread_users ON thread_participants.user_key = thread_users.user_key"\
|
|
" ORDER BY msg_id"
|
|
|
|
messagesResultSet = threadsDb.runQuery(sqlString)
|
|
if messagesResultSet is not None:
|
|
oldMsgId = None
|
|
|
|
direction = CommunicationDirection.UNKNOWN
|
|
fromAddress = None
|
|
recipientAddressList = None
|
|
timeStamp = -1
|
|
msgText = ""
|
|
threadId = ""
|
|
|
|
while messagesResultSet.next():
|
|
msgId = messagesResultSet.getString("msg_id")
|
|
|
|
# new msg begins when msgId changes
|
|
if msgId != oldMsgId:
|
|
# Create message artifact with collected attributes
|
|
if oldMsgId is not None:
|
|
messageArtifact = threadsDBHelper.addMessage(
|
|
self._MESSAGE_TYPE,
|
|
direction,
|
|
fromAddress,
|
|
recipientAddressList,
|
|
timeStamp,
|
|
MessageReadStatus.UNKNOWN,
|
|
"", # subject
|
|
msgText,
|
|
threadId)
|
|
|
|
oldMsgId = msgId
|
|
|
|
# New message - collect all attributes
|
|
recipientAddressList = []
|
|
|
|
## get sender address by parsing JSON in sender column
|
|
senderJsonStr = messagesResultSet.getString("sender")
|
|
if senderJsonStr is not None:
|
|
sender_dict = json.loads(senderJsonStr)
|
|
senderId = sender_dict['user_key']
|
|
senderId = senderId.replace('FACEBOOK:', '')
|
|
senderName = sender_dict['name']
|
|
fromAddress = Account.Address(senderId, senderName)
|
|
if senderId == self.selfAccountAddress.getUniqueID():
|
|
direction = CommunicationDirection.OUTGOING
|
|
else:
|
|
direction = CommunicationDirection.INCOMING
|
|
|
|
|
|
# Get recipient and add to list
|
|
self.addRecipientToList(messagesResultSet.getString("user_key"), messagesResultSet.getString("name"),
|
|
fromAddress, recipientAddressList)
|
|
|
|
timeStamp = messagesResultSet.getLong("timestamp_ms") / 1000
|
|
|
|
# Get msg text
|
|
# Sometimes there may not be an explict msg text,
|
|
# but a app genrated snippet instead
|
|
msgText = messagesResultSet.getString("text")
|
|
if not msgText:
|
|
msgText = messagesResultSet.getString("snippet")
|
|
|
|
# TBD: get attachment
|
|
|
|
threadId = messagesResultSet.getString("thread_key")
|
|
|
|
else: # same msgId as last, just collect recipient from current row
|
|
self.addRecipientToList(messagesResultSet.getString("user_key"), messagesResultSet.getString("name"),
|
|
fromAddress, recipientAddressList)
|
|
|
|
|
|
# at the end of the loop, add last message
|
|
messageArtifact = threadsDBHelper.addMessage(
|
|
self._MESSAGE_TYPE,
|
|
direction,
|
|
fromAddress,
|
|
recipientAddressList,
|
|
timeStamp,
|
|
MessageReadStatus.UNKNOWN,
|
|
"", # subject
|
|
msgText,
|
|
threadId)
|
|
|
|
except SQLException as ex:
|
|
self._logger.log(Level.WARNING, "Error processing query result for FB Messenger messages.", ex)
|
|
self._logger.log(Level.WARNING, traceback.format_exc())
|
|
except TskCoreException as ex:
|
|
self._logger.log(Level.SEVERE, "Failed to add FB Messenger message artifacts.", ex)
|
|
self._logger.log(Level.SEVERE, traceback.format_exc())
|
|
except BlackboardException as ex:
|
|
self._logger.log(Level.WARNING, "Failed to post artifacts.", ex)
|
|
self._logger.log(Level.WARNING, traceback.format_exc())
|
|
finally:
|
|
threadsDb.close()
|
|
|
|
def analyze(self, dataSource, fileManager, context):
|
|
try:
|
|
self.current_case = Case.getCurrentCaseThrows()
|
|
except NoCurrentCaseException as ex:
|
|
self._logger.log(Level.WARNING, "No case currently open.", ex)
|
|
self._logger.log(Level.WARNING, traceback.format_exc())
|
|
return
|
|
|
|
self.analyzeContacts(dataSource, fileManager, context)
|
|
self.analyzeMessages(dataSource, fileManager, context)
|
|
|
|
|