mirror of
https://github.com/overcuriousity/autopsy-flatpak.git
synced 2025-07-06 21:00:22 +00:00
185 lines
9.2 KiB
Python
185 lines
9.2 KiB
Python
"""
|
|
Autopsy Forensic Browser
|
|
|
|
Copyright 2016 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.sql import Connection
|
|
from java.sql import DatabaseMetaData
|
|
from java.sql import DriverManager
|
|
from java.sql import ResultSet
|
|
from java.sql import SQLException
|
|
from java.sql import Statement
|
|
from java.util.logging import Level
|
|
from org.sleuthkit.autopsy.casemodule import Case
|
|
from org.sleuthkit.autopsy.casemodule.services import Blackboard
|
|
from org.sleuthkit.autopsy.casemodule.services import FileManager
|
|
from org.sleuthkit.autopsy.coreutils import Logger
|
|
from org.sleuthkit.autopsy.coreutils import MessageNotifyUtil
|
|
from org.sleuthkit.autopsy.datamodel import ContentUtils
|
|
from org.sleuthkit.autopsy.ingest import IngestJobContext
|
|
from org.sleuthkit.autopsy.ingest import IngestServices
|
|
from org.sleuthkit.autopsy.ingest import ModuleDataEvent
|
|
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 import Account
|
|
|
|
import traceback
|
|
import general
|
|
|
|
|
|
"""
|
|
Locates a variety of different contacts databases, parses them, and populates the blackboard.
|
|
"""
|
|
class ContactAnalyzer(general.AndroidComponentAnalyzer):
|
|
|
|
def __init__(self):
|
|
self._logger = Logger.getLogger(self.__class__.__name__)
|
|
|
|
def analyze(self, dataSource, fileManager, context):
|
|
try:
|
|
|
|
# Create a 'Device' account using the data source device id
|
|
datasourceObjId = dataSource.getDataSource().getId()
|
|
ds = Case.getCurrentCase().getSleuthkitCase().getDataSource(datasourceObjId)
|
|
deviceID = ds.getDeviceId()
|
|
|
|
global deviceAccount
|
|
deviceAccount = Case.getCurrentCase().getSleuthkitCase().getCommunicationsManager().getOrCreateAccount(Account.Type.DEVICE, deviceID, general.MODULE_NAME, dataSource)
|
|
|
|
absFiles = fileManager.findFiles(dataSource, "contacts.db")
|
|
absFiles.addAll(fileManager.findFiles(dataSource, "contacts2.db"))
|
|
if absFiles.isEmpty():
|
|
return
|
|
for abstractFile in absFiles:
|
|
try:
|
|
jFile = File(Case.getCurrentCase().getTempDirectory(), str(abstractFile.getId()) + abstractFile.getName())
|
|
ContentUtils.writeToFile(abstractFile, jFile, context.dataSourceIngestIsCancelled)
|
|
self.__findContactsInDB(str(jFile.toString()), abstractFile)
|
|
except Exception as ex:
|
|
self._logger.log(Level.SEVERE, "Error parsing Contacts", ex)
|
|
self._logger.log(Level.SEVERE, traceback.format_exc())
|
|
except TskCoreException as ex:
|
|
self._logger.log(Level.SEVERE, "Error finding Contacts", ex)
|
|
self._logger.log(Level.SEVERE, traceback.format_exc())
|
|
|
|
"""
|
|
Will create artifact from a database given by the path
|
|
The fileId will be the abstract file associated with the artifacts
|
|
"""
|
|
def __findContactsInDB(self, databasePath, abstractFile):
|
|
if not databasePath:
|
|
return
|
|
|
|
bbartifacts = list()
|
|
try:
|
|
Class.forName("org.sqlite.JDBC") # load JDBC driver
|
|
connection = DriverManager.getConnection("jdbc:sqlite:" + databasePath)
|
|
statement = connection.createStatement()
|
|
except (ClassNotFoundException, SQLException) as ex:
|
|
self._logger.log(Level.SEVERE, "Error opening database", ex)
|
|
self._logger.log(Level.SEVERE, traceback.format_exc())
|
|
return
|
|
|
|
try:
|
|
# get display_name, mimetype(email or phone number) and data1 (phonenumber or email address depending on mimetype)
|
|
# sorted by name, so phonenumber/email would be consecutive for a person if they exist.
|
|
# check if contacts.name_raw_contact_id exists. Modify the query accordingly.
|
|
columnFound = False
|
|
metadata = connection.getMetaData()
|
|
columnListResultSet = metadata.getColumns(None, None, "contacts", None)
|
|
while columnListResultSet.next():
|
|
if columnListResultSet.getString("COLUMN_NAME") == "name_raw_contact_id":
|
|
columnFound = True
|
|
break
|
|
if columnFound:
|
|
resultSet = statement.executeQuery(
|
|
"SELECT mimetype, data1, name_raw_contact.display_name AS display_name \n"
|
|
+ "FROM raw_contacts JOIN contacts ON (raw_contacts.contact_id=contacts._id) \n"
|
|
+ "JOIN raw_contacts AS name_raw_contact ON(name_raw_contact_id=name_raw_contact._id) "
|
|
+ "LEFT OUTER JOIN data ON (data.raw_contact_id=raw_contacts._id) \n"
|
|
+ "LEFT OUTER JOIN mimetypes ON (data.mimetype_id=mimetypes._id) \n"
|
|
+ "WHERE mimetype = 'vnd.android.cursor.item/phone_v2' OR mimetype = 'vnd.android.cursor.item/email_v2'\n"
|
|
+ "ORDER BY name_raw_contact.display_name ASC;")
|
|
else:
|
|
resultSet = statement.executeQuery(
|
|
"SELECT mimetype, data1, raw_contacts.display_name AS display_name \n"
|
|
+ "FROM raw_contacts JOIN contacts ON (raw_contacts.contact_id=contacts._id) \n"
|
|
+ "LEFT OUTER JOIN data ON (data.raw_contact_id=raw_contacts._id) \n"
|
|
+ "LEFT OUTER JOIN mimetypes ON (data.mimetype_id=mimetypes._id) \n"
|
|
+ "WHERE mimetype = 'vnd.android.cursor.item/phone_v2' OR mimetype = 'vnd.android.cursor.item/email_v2'\n"
|
|
+ "ORDER BY raw_contacts.display_name ASC;")
|
|
|
|
artifact = abstractFile.newArtifact(BlackboardArtifact.ARTIFACT_TYPE.TSK_CONTACT)
|
|
oldName = ""
|
|
while resultSet.next():
|
|
name = resultSet.getString("display_name")
|
|
data1 = resultSet.getString("data1") # the phone number or email
|
|
mimetype = resultSet.getString("mimetype") # either phone or email
|
|
if name != oldName:
|
|
artifact = abstractFile.newArtifact(BlackboardArtifact.ARTIFACT_TYPE.TSK_CONTACT)
|
|
artifact.addAttribute(BlackboardAttribute(BlackboardAttribute.ATTRIBUTE_TYPE.TSK_NAME, general.MODULE_NAME, name))
|
|
if mimetype == "vnd.android.cursor.item/phone_v2":
|
|
artifact.addAttribute(BlackboardAttribute(BlackboardAttribute.ATTRIBUTE_TYPE.TSK_PHONE_NUMBER, general.MODULE_NAME, data1))
|
|
acctType = Account.Type.PHONE
|
|
else:
|
|
artifact.addAttribute(BlackboardAttribute(BlackboardAttribute.ATTRIBUTE_TYPE.TSK_EMAIL, general.MODULE_NAME, data1))
|
|
acctType = Account.Type.EMAIL
|
|
|
|
|
|
# Create an account
|
|
contactAccount = Case.getCurrentCase().getSleuthkitCase().getCommunicationsManager().getOrCreateAccount(acctType, data1, general.MODULE_NAME, abstractFile);
|
|
|
|
# create relationship between accounts
|
|
Case.getCurrentCase().getSleuthkitCase().getCommunicationsManager().addRelationships(deviceAccount, [contactAccount], artifact);
|
|
|
|
oldName = name
|
|
|
|
bbartifacts.append(artifact)
|
|
|
|
try:
|
|
# index the artifact for keyword search
|
|
blackboard = Case.getCurrentCase().getServices().getBlackboard()
|
|
blackboard.indexArtifact(artifact)
|
|
except Blackboard.BlackboardException as ex:
|
|
self._logger.log(Level.SEVERE, "Unable to index blackboard artifact " + artifact.getArtifactID(), ex)
|
|
self._logger.log(Level.SEVERE, traceback.format_exc())
|
|
MessageNotifyUtil.Notify.error("Failed to index contact artifact for keyword search.", artifact.getDisplayName())
|
|
|
|
except SQLException as ex:
|
|
self._logger.log(Level.WARNING, "Unable to execute contacts SQL query against {0} : {1}", [databasePath, ex])
|
|
except TskCoreException as ex:
|
|
self._logger.log(Level.SEVERE, "Error posting to blackboard", ex)
|
|
self._logger.log(Level.SEVERE, traceback.format_exc())
|
|
finally:
|
|
if bbartifacts:
|
|
IngestServices.getInstance().fireModuleDataEvent(ModuleDataEvent(general.MODULE_NAME, BlackboardArtifact.ARTIFACT_TYPE.TSK_CONTACT, bbartifacts))
|
|
|
|
try:
|
|
if resultSet is not None:
|
|
resultSet.close()
|
|
statement.close()
|
|
connection.close()
|
|
except Exception as ex:
|
|
self._logger.log(Level.SEVERE, "Error closing database", ex)
|
|
self._logger.log(Level.SEVERE, traceback.format_exc())
|