# -*- coding: utf-8 -*-
"""SQLite parser plugin for MacOS Duet/KnowledgeC database files."""
from dfdatetime import cocoa_time as dfdatetime_cocoa_time
from plaso.containers import events
from plaso.parsers import sqlite
from plaso.parsers.sqlite_plugins import interface
[docs]
class MacOSKnowledgeCApplicationEventData(events.EventData):
"""KnowledgeC application execution event data.
Attributes:
bundle_identifier (str): bundle identifier of the application.
creation_time (dfdatetime.DateTimeValues): creation date and time of
the KnowledgeC record.
duration (int): duration of the activity.
end_time (dfdatetime.DateTimeValues): date and time the activity ended.
start_time (dfdatetime.DateTimeValues): date and time the activity started.
"""
DATA_TYPE = 'macos:knowledgec:application'
[docs]
def __init__(self):
"""Initializes event data."""
super(MacOSKnowledgeCApplicationEventData, self).__init__(
data_type=self.DATA_TYPE)
self.bundle_identifier = None
self.creation_time = None
self.duration = None
self.end_time = None
self.start_time = None
[docs]
class MacOSKnowledgeCSafariEventData(events.EventData):
"""MacOS Duet/KnowledgeC database event data for Safari.
Attributes:
bundle_identifier (str): bundle identifier of the application.
creation_time (dfdatetime.DateTimeValues): creation date and time of
the KnowledgeC record.
duration (int): duration of the activity.
end_time (dfdatetime.DateTimeValues): date and time the activity ended.
start_time (dfdatetime.DateTimeValues): date and time the activity started.
title (str): title of the webpage visited.
url (str): URL visited.
"""
DATA_TYPE = 'macos:knowledgec:safari'
[docs]
def __init__(self):
"""Initializes event data."""
super(MacOSKnowledgeCSafariEventData, self).__init__(
data_type=self.DATA_TYPE)
self.bundle_identifier = None
self.creation_time = None
self.duration = None
self.end_time = None
self.start_time = None
self.title = None
self.url = None
[docs]
class MacOSKnowledgeCPlugin(interface.SQLitePlugin):
"""SQLite parser plugin for MacOS Duet/KnowledgeC database files."""
NAME = 'mac_knowledgec'
DATA_FORMAT = 'MacOS Duet/KnowledgeC SQLites database file'
# Define the needed queries.
# entry_creation: when the entry was created in the database.
# start: when the activity started.
# end: when the activity finished.
# action: action that created the entry (inFocus, activity, intents).
# bundle_identifier: application bundle identifier.
# title: Safari url title
QUERIES = [
(("""
SELECT
ZOBJECT.ZCREATIONDATE AS "entry_creation",
ZOBJECT.ZSTARTDATE AS "start",
ZOBJECT.ZENDDATE AS "end",
ZOBJECT.ZSTREAMNAME AS "action",
ZOBJECT.ZVALUESTRING AS "zvaluestring",
ZSTRUCTUREDMETADATA.Z_DKSAFARIHISTORYMETADATAKEY__TITLE AS "title"
FROM ZOBJECT
LEFT JOIN ZSTRUCTUREDMETADATA
ON ZOBJECT.ZSTRUCTUREDMETADATA = ZSTRUCTUREDMETADATA.Z_PK
"""),
'KnowledgeCRow')]
REQUIRED_STRUCTURE = {
'ZOBJECT': frozenset([
'ZCREATIONDATE', 'ZENDDATE', 'ZSTARTDATE', 'ZSTREAMNAME',
'ZVALUESTRING']),
'ZSTRUCTUREDMETADATA': frozenset([
'Z_DKSAFARIHISTORYMETADATAKEY__TITLE'])}
_SCHEMA_10_13 = {
'ACHANGE': (
'CREATE TABLE ACHANGE ( Z_PK INTEGER PRIMARY KEY, Z_ENT INTEGER, '
'Z_OPT INTEGER, ZCHANGETYPE INTEGER, ZENTITY INTEGER, ZENTITYPK '
'INTEGER, ZTRANSACTIONID INTEGER, ZCOLUMNS BLOB, ZTOMBSTONE0 BLOB, '
'ZTOMBSTONE1 BLOB, ZTOMBSTONE2 BLOB )'),
'ATRANSACTION': (
'CREATE TABLE ATRANSACTION ( Z_PK INTEGER PRIMARY KEY, Z_ENT '
'INTEGER, Z_OPT INTEGER, ZTIMESTAMP FLOAT, ZAUTHOR VARCHAR, '
'ZBUNDLEID VARCHAR, ZCONTEXTNAME VARCHAR, ZPROCESSID VARCHAR, '
'ZQUERYGEN BLOB )'),
'ZADDITIONCHANGESET': (
'CREATE TABLE ZADDITIONCHANGESET ( Z_PK INTEGER PRIMARY KEY, Z_ENT '
'INTEGER, Z_OPT INTEGER, ZSEQUENCENUMBER INTEGER, ZVERSION INTEGER, '
'ZENDDATE TIMESTAMP, ZSTARTDATE TIMESTAMP, ZCKFOREIGNKEY VARCHAR, '
'ZCKRECORDID VARCHAR, ZDEVICEIDENTIFIER VARCHAR, ZCHANGESET BLOB, '
'ZCKRECORDSYSTEMFIELDS BLOB )'),
'ZCONTEXTUALCHANGEREGISTRATION': (
'CREATE TABLE ZCONTEXTUALCHANGEREGISTRATION ( Z_PK INTEGER PRIMARY '
'KEY, Z_ENT INTEGER, Z_OPT INTEGER, ZCREATIONDATE TIMESTAMP, '
'ZIDENTIFIER VARCHAR, ZPROPERTIES BLOB )'),
'ZCONTEXTUALKEYPATH': (
'CREATE TABLE ZCONTEXTUALKEYPATH ( Z_PK INTEGER PRIMARY KEY, Z_ENT '
'INTEGER, Z_OPT INTEGER, ZDEVICEID INTEGER, ZISEPHEMERAL INTEGER, '
'ZISUSERCENTRIC INTEGER, ZCREATIONDATE TIMESTAMP, ZLASTMODIFIEDDATE '
'TIMESTAMP, ZKEY VARCHAR, ZVALUE BLOB )'),
'ZCUSTOMMETADATA': (
'CREATE TABLE ZCUSTOMMETADATA ( Z_PK INTEGER PRIMARY KEY, Z_ENT '
'INTEGER, Z_OPT INTEGER, ZINTEGERVALUE INTEGER, ZOBJECT INTEGER, '
'Z8_OBJECT INTEGER, ZDATEVALUE TIMESTAMP, ZDOUBLEVALUE FLOAT, ZNAME '
'VARCHAR, ZSTRINGVALUE VARCHAR, ZVALUEHASH VARCHAR, ZBINARYVALUE '
'BLOB )'),
'ZDELETIONCHANGESET': (
'CREATE TABLE ZDELETIONCHANGESET ( Z_PK INTEGER PRIMARY KEY, Z_ENT '
'INTEGER, Z_OPT INTEGER, ZSEQUENCENUMBER INTEGER, ZVERSION INTEGER, '
'ZENDDATE TIMESTAMP, ZSTARTDATE TIMESTAMP, ZCKFOREIGNKEY VARCHAR, '
'ZCKRECORDID VARCHAR, ZDEVICEIDENTIFIER VARCHAR, ZCHANGESET BLOB, '
'ZCKRECORDSYSTEMFIELDS BLOB )'),
'ZHISTOGRAM': (
'CREATE TABLE ZHISTOGRAM ( Z_PK INTEGER PRIMARY KEY, Z_ENT INTEGER, '
'Z_OPT INTEGER, ZSTREAMTYPECODE INTEGER, ZENDDATE TIMESTAMP, '
'ZSTARTDATE TIMESTAMP, ZDEVICEIDENTIFIER VARCHAR, ZIDENTIFIER '
'VARCHAR, ZSTREAMNAME VARCHAR )'),
'ZHISTOGRAMVALUE': (
'CREATE TABLE ZHISTOGRAMVALUE ( Z_PK INTEGER PRIMARY KEY, Z_ENT '
'INTEGER, Z_OPT INTEGER, ZCOUNT INTEGER, ZINTEGERVALUE INTEGER, '
'ZHISTOGRAM INTEGER, ZSTRINGVALUE VARCHAR )'),
'ZOBJECT': (
'CREATE TABLE ZOBJECT ( Z_PK INTEGER PRIMARY KEY, Z_ENT INTEGER, '
'Z_OPT INTEGER, ZUUIDHASH INTEGER, ZEVENT INTEGER, ZSOURCE INTEGER, '
'ZCATEGORYTYPE INTEGER, ZINTEGERVALUE INTEGER, ZENDDAYOFWEEK '
'INTEGER, ZENDSECONDOFDAY INTEGER, ZHASCUSTOMMETADATA INTEGER, '
'ZHASSTRUCTUREDMETADATA INTEGER, ZSECONDSFROMGMT INTEGER, '
'ZSHOULDSYNC INTEGER, ZSTARTDAYOFWEEK INTEGER, ZSTARTSECONDOFDAY '
'INTEGER, ZVALUECLASS INTEGER, ZVALUEINTEGER INTEGER, '
'ZVALUETYPECODE INTEGER, ZSTRUCTUREDMETADATA INTEGER, ZVALUE '
'INTEGER, Z8_VALUE INTEGER, ZIDENTIFIERTYPE INTEGER, ZQUANTITYTYPE '
'INTEGER, ZOBJECT INTEGER, Z8_OBJECT INTEGER, ZSUBJECT INTEGER, '
'Z8_SUBJECT INTEGER, ZCREATIONDATE TIMESTAMP, ZCONFIDENCE FLOAT, '
'ZENDDATE TIMESTAMP, ZSTARTDATE TIMESTAMP, ZVALUEDOUBLE FLOAT, '
'ZDOUBLEVALUE FLOAT, ZUUID VARCHAR, ZSTREAMNAME VARCHAR, '
'ZVALUESTRING VARCHAR, ZSTRING VARCHAR, ZVERBPHRASE VARCHAR, '
'ZMETADATA BLOB )'),
'ZSOURCE': (
'CREATE TABLE ZSOURCE ( Z_PK INTEGER PRIMARY KEY, Z_ENT INTEGER, '
'Z_OPT INTEGER, ZUSERID INTEGER, ZBUNDLEID VARCHAR, ZDEVICEID '
'VARCHAR, ZGROUPID VARCHAR, ZITEMID VARCHAR, ZSOURCEID VARCHAR )'),
'ZSTRUCTUREDMETADATA': (
'CREATE TABLE ZSTRUCTUREDMETADATA ( Z_PK INTEGER PRIMARY KEY, Z_ENT '
'INTEGER, Z_OPT INTEGER, Z_CDPORTRAITMETADATAKEY__ALGORITHM '
'INTEGER, Z_CDPORTRAITMETADATAKEY__ASSETVERSION INTEGER, '
'Z_DKAPPINSTALLMETADATAKEY__ISINSTALL INTEGER, '
'Z_DKAPPLICATIONACTIVITYMETADATAKEY__ISPUBLICLYINDEXABLE INTEGER, '
'Z_DKAPPLICATIONMETADATAKEY__PROCESSIDENTIFIER INTEGER, '
'Z_DKAUDIOMETADATAKEY__ROUTECHANGEREASON INTEGER, '
'Z_DKBLUETOOTHMETADATAKEY__DEVICETYPE INTEGER, '
'Z_DKBULLETINBOARDMETADATAKEY__HASDATE INTEGER, '
'Z_DKGLANCELAUNCHMETADATA__DEVICEIDENTIFIER INTEGER, '
'Z_DKINTENTMETADATAKEY__DONATEDBYSIRI INTEGER, '
'Z_DKINTENTMETADATAKEY__INTENTHANDLINGSTATUS INTEGER, '
'Z_DKNOWPLAYINGMETADATAKEY__IDENTIFIER INTEGER, '
'Z_DKNOWPLAYINGMETADATAKEY__PLAYING INTEGER, '
'Z_DKSEARCHFEEDBACKMETADATAKEY__INTERACTIONTYPE INTEGER, '
'Z_DKSEARCHFEEDBACKMETADATAKEY__SUGGESTIONTYPE INTEGER, '
'Z_DKSUNRISESUNSETMETADATAKEY__ISDAYLIGHT INTEGER, '
'Z_QPMETRICSMETADATAKEY__QUERYENGAGED INTEGER, '
'Z_QPMETRICSMETADATAKEY__RESULTENGAGED INTEGER, '
'ZCOM_APPLE_CALENDARUIKIT_USERACTIVITY_DATE INTEGER, '
'ZCOM_APPLE_CALENDARUIKIT_USERACTIVITY_ENDDATE INTEGER, '
'Z_CDPORTRAITMETADATAKEY__DECAYRATE FLOAT, '
'Z_CDPORTRAITMETADATAKEY__SCORE FLOAT, '
'Z_DKAPPLICATIONACTIVITYMETADATAKEY__EXPIRATIONDATE TIMESTAMP, '
'Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__LATITUDE FLOAT, '
'Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__LONGITUDE FLOAT, '
'Z_DKLOCATIONMETADATAKEY__LATITUDE FLOAT, '
'Z_DKLOCATIONMETADATAKEY__LONGITUDE FLOAT, '
'Z_DKNOWPLAYINGMETADATAKEY__DURATION FLOAT, '
'Z_DKNOWPLAYINGMETADATAKEY__ELAPSED FLOAT, '
'Z_DKPERIODMETADATAKEY__PERIODEND TIMESTAMP, '
'Z_DKPERIODMETADATAKEY__PERIODSTART TIMESTAMP, '
'Z_DKSUNRISESUNSETMETADATAKEY__CURRENTSUNRISE TIMESTAMP, '
'Z_DKSUNRISESUNSETMETADATAKEY__CURRENTSUNSET TIMESTAMP, '
'Z_DKSUNRISESUNSETMETADATAKEY__NEXTSUNRISE TIMESTAMP, '
'Z_DKSUNRISESUNSETMETADATAKEY__NEXTSUNSET TIMESTAMP, '
'Z_DKSUNRISESUNSETMETADATAKEY__PREVIOUSSUNRISE TIMESTAMP, '
'Z_DKSUNRISESUNSETMETADATAKEY__PREVIOUSSUNSET TIMESTAMP, '
'Z_QPMETRICSMETADATAKEY__TIMESTAMP FLOAT, '
'Z_CDENTITYMETADATAKEY__BESTLANGUAGE VARCHAR, '
'Z_CDENTITYMETADATAKEY__NAME VARCHAR, '
'Z_CDPORTRAITMETADATAKEY__OSBUILD VARCHAR, '
'Z_DKAPPINSTALLMETADATAKEY__PRIMARYCATEGORY VARCHAR, '
'Z_DKAPPINSTALLMETADATAKEY__TITLE VARCHAR, '
'Z_DKAPPLICATIONACTIVITYMETADATAKEY__ACTIVITYTYPE VARCHAR, '
'Z_DKAPPLICATIONACTIVITYMETADATAKEY__ITEMIDENTIFIER VARCHAR, '
'Z_DKAPPLICATIONACTIVITYMETADATAKEY__ITEMRELATEDUNIQUEIDENTIFIER '
'VARCHAR, Z_DKAPPLICATIONACTIVITYMETADATAKEY__TITLE VARCHAR, '
'Z_DKAPPLICATIONACTIVITYMETADATAKEY__USERACTIVITYREQUIREDSTRING '
'VARCHAR, Z_DKAPPLICATIONACTIVITYMETADATAKEY__USERACTIVITYUUID '
'VARCHAR, Z_DKAPPLICATIONMETADATAKEY__BACKBOARDSTATE VARCHAR, '
'Z_DKAPPLICATIONMETADATAKEY__EXTENSIONCONTAININGBUNDLEIDENTIFIER '
'VARCHAR, Z_DKAPPLICATIONMETADATAKEY__EXTENSIONHOSTIDENTIFIER '
'VARCHAR, Z_DKAPPLICATIONMETADATAKEY__LAUNCHREASON VARCHAR, '
'Z_DKAUDIOMETADATAKEY__CHANNELS VARCHAR, '
'Z_DKAUDIOMETADATAKEY__DATASOURCES VARCHAR, '
'Z_DKAUDIOMETADATAKEY__IDENTIFIER VARCHAR, '
'Z_DKAUDIOMETADATAKEY__PORTNAME VARCHAR, '
'Z_DKAUDIOMETADATAKEY__PORTTYPE VARCHAR, '
'Z_DKAUDIOMETADATAKEY__PREFERREDDATASOURCE VARCHAR, '
'Z_DKAUDIOMETADATAKEY__SELECTEDDATASOURCE VARCHAR, '
'Z_DKBATTERYSAVERMETADATAKEY__SOURCE VARCHAR, '
'Z_DKBLUETOOTHMETADATAKEY__ADDRESS VARCHAR, '
'Z_DKBLUETOOTHMETADATAKEY__NAME VARCHAR, '
'Z_DKBULLETINBOARDMETADATAKEY__FEED VARCHAR, '
'Z_DKBULLETINBOARDMETADATAKEY__MESSAGE VARCHAR, '
'Z_DKBULLETINBOARDMETADATAKEY__SUBTITLE VARCHAR, '
'Z_DKBULLETINBOARDMETADATAKEY__TITLE VARCHAR, '
'Z_DKCALENDARMETADATAKEY__INTERACTION VARCHAR, '
'Z_DKCALLMETADATAKEY__INTERACTION VARCHAR, '
'Z_DKDEVICEIDMETADATAKEY__DEVICEIDENTIFIER VARCHAR, '
'Z_DKINTENTMETADATAKEY__INTENTCLASS VARCHAR, '
'Z_DKINTENTMETADATAKEY__INTENTVERB VARCHAR, '
'Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__URL VARCHAR, '
'Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__CITY VARCHAR, '
'Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__COUNTRY VARCHAR, '
'Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__DISPLAYNAME VARCHAR, '
'Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__FULLYFORMATTEDADDRESS '
'VARCHAR, Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__LOCATIONNAME '
'VARCHAR, Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__POSTALCODE_V2 '
'VARCHAR, '
'Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__STATEORPROVINCE '
'VARCHAR, '
'Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__SUBTHOROUGHFARE '
'VARCHAR, Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__THOROUGHFARE '
'VARCHAR, Z_DKLOCATIONMETADATAKEY__IDENTIFIER VARCHAR, '
'Z_DKMETADATAHOMEAPPVIEW__HOMEUUID VARCHAR, '
'Z_DKMETADATAHOMEAPPVIEW__VIEWINFORMATION VARCHAR, '
'Z_DKMETADATAHOMEAPPVIEW__VIEWNAME VARCHAR, '
'Z_DKMETADATAHOMEAPPVIEW__VIEWUUID VARCHAR, '
'Z_DKMETADATAHOMEKITACCESSORYCONTROL__ACCESSORYNAME VARCHAR, '
'Z_DKMETADATAHOMEKITACCESSORYCONTROL__ACCESSORYUUID VARCHAR, '
'Z_DKMETADATAHOMEKITACCESSORYCONTROL__CHARACTERISTICTYPE VARCHAR, '
'Z_DKMETADATAHOMEKITACCESSORYCONTROL__CLIENTNAME VARCHAR, '
'Z_DKMETADATAHOMEKITACCESSORYCONTROL__HOMEUUID VARCHAR, '
'Z_DKMETADATAHOMEKITACCESSORYCONTROL__SERVICENAME VARCHAR, '
'Z_DKMETADATAHOMEKITACCESSORYCONTROL__SERVICETYPE VARCHAR, '
'Z_DKMETADATAHOMEKITSCENE__ACTIONSETNAME VARCHAR, '
'Z_DKMETADATAHOMEKITSCENE__ACTIONSETTYPE VARCHAR, '
'Z_DKMETADATAHOMEKITSCENE__ACTIONSETUUID VARCHAR, '
'Z_DKMETADATAHOMEKITSCENE__CLIENTNAME VARCHAR, '
'Z_DKMETADATAHOMEKITSCENE__HOMEUUID VARCHAR, '
'Z_DKMETADATAHOMEKITSCENE__SCENENAME VARCHAR, '
'Z_DKMICROLOCATIONMETADATAKEY__LOCATIONDISTRIBUTION VARCHAR, '
'Z_DKMICROLOCATIONMETADATAKEY__MICROLOCATIONDISTRIBUTION VARCHAR, '
'Z_DKNOWPLAYINGMETADATAKEY__ALBUM VARCHAR, '
'Z_DKNOWPLAYINGMETADATAKEY__ARTIST VARCHAR, '
'Z_DKNOWPLAYINGMETADATAKEY__GENRE VARCHAR, '
'Z_DKNOWPLAYINGMETADATAKEY__TITLE VARCHAR, '
'Z_DKSAFARIHISTORYMETADATAKEY__TITLE VARCHAR, '
'Z_DKSEARCHFEEDBACKMETADATAKEY__CLIENT VARCHAR, '
'Z_DKSEARCHFEEDBACKMETADATAKEY__CONTACTID VARCHAR, '
'Z_QPMETRICSMETADATAKEY__QUERY VARCHAR, '
'ZCOM_APPLE_CALENDARUIKIT_USERACTIVITY_EXTERNALID VARCHAR, '
'ZKCDCSNOTIFICATIONOPTIONCLIENTIDENTIFIERKEY VARCHAR, '
'ZKCDCSNOTIFICATIONOPTIONCLIENTLAUNCHKEY VARCHAR, '
'ZKCDCSNOTIFICATIONOPTIONPERSISTENTPREDICATESTRINGKEY VARCHAR, '
'ZMETADATAHASH VARCHAR UNIQUE, '
'Z_DKAPPLICATIONACTIVITYMETADATAKEY__ITEMRELATEDCONTENTURL VARCHAR, '
'Z_DKAPPINSTALLMETADATAKEY__SUBCATEGORIES BLOB, '
'Z_DKINTENTMETADATAKEY__SERIALIZEDINTERACTION BLOB, '
'Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__PHONENUMBERS BLOB, '
'Z_QPMETRICSMETADATAKEY__CANDIDATELIST BLOB, '
'Z_QPMETRICSMETADATAKEY__QUERYLIST BLOB )'),
'Z_4EVENT': (
'CREATE TABLE Z_4EVENT ( Z_4CUSTOMMETADATA INTEGER, Z_10EVENT '
'INTEGER, PRIMARY KEY (Z_4CUSTOMMETADATA, Z_10EVENT) )'),
'Z_METADATA': (
'CREATE TABLE Z_METADATA (Z_VERSION INTEGER PRIMARY KEY, Z_UUID '
'VARCHAR(255), Z_PLIST BLOB)'),
'Z_MODELCACHE': (
'CREATE TABLE Z_MODELCACHE (Z_CONTENT BLOB)'),
'Z_PRIMARYKEY': (
'CREATE TABLE Z_PRIMARYKEY (Z_ENT INTEGER PRIMARY KEY, Z_NAME '
'VARCHAR, Z_SUPER INTEGER, Z_MAX INTEGER)')}
_SCHEMA_10_14 = {
'ZADDITIONCHANGESET': (
'CREATE TABLE ZADDITIONCHANGESET ( Z_PK INTEGER PRIMARY KEY, Z_ENT '
'INTEGER, Z_OPT INTEGER, ZSEQUENCENUMBER INTEGER, ZVERSION INTEGER, '
'ZENDDATE TIMESTAMP, ZSTARTDATE TIMESTAMP, ZCKFOREIGNKEY VARCHAR, '
'ZCKRECORDID VARCHAR, ZDEVICEIDENTIFIER VARCHAR, ZCHANGESET BLOB, '
'ZCKRECORDSYSTEMFIELDS BLOB )'),
'ZCONTEXTUALCHANGEREGISTRATION': (
'CREATE TABLE ZCONTEXTUALCHANGEREGISTRATION ( Z_PK INTEGER PRIMARY '
'KEY, Z_ENT INTEGER, Z_OPT INTEGER, ZCREATIONDATE TIMESTAMP, '
'ZIDENTIFIER VARCHAR, ZPROPERTIES BLOB )'),
'ZCONTEXTUALKEYPATH': (
'CREATE TABLE ZCONTEXTUALKEYPATH ( Z_PK INTEGER PRIMARY KEY, Z_ENT '
'INTEGER, Z_OPT INTEGER, ZDEVICEID INTEGER, ZISEPHEMERAL INTEGER, '
'ZISUSERCENTRIC INTEGER, ZCREATIONDATE TIMESTAMP, ZLASTMODIFIEDDATE '
'TIMESTAMP, ZKEY VARCHAR, ZVALUE BLOB )'),
'ZCUSTOMMETADATA': (
'CREATE TABLE ZCUSTOMMETADATA ( Z_PK INTEGER PRIMARY KEY, Z_ENT '
'INTEGER, Z_OPT INTEGER, ZINTEGERVALUE INTEGER, ZOBJECT INTEGER, '
'Z9_OBJECT INTEGER, ZDATEVALUE TIMESTAMP, ZDOUBLEVALUE FLOAT, ZNAME '
'VARCHAR, ZSTRINGVALUE VARCHAR, ZVALUEHASH VARCHAR, ZBINARYVALUE '
'BLOB )'),
'ZDELETIONCHANGESET': (
'CREATE TABLE ZDELETIONCHANGESET ( Z_PK INTEGER PRIMARY KEY, Z_ENT '
'INTEGER, Z_OPT INTEGER, ZSEQUENCENUMBER INTEGER, ZVERSION INTEGER, '
'ZENDDATE TIMESTAMP, ZSTARTDATE TIMESTAMP, ZCKFOREIGNKEY VARCHAR, '
'ZCKRECORDID VARCHAR, ZDEVICEIDENTIFIER VARCHAR, ZCHANGESET BLOB, '
'ZCKRECORDSYSTEMFIELDS BLOB )'),
'ZHISTOGRAM': (
'CREATE TABLE ZHISTOGRAM ( Z_PK INTEGER PRIMARY KEY, Z_ENT INTEGER, '
'Z_OPT INTEGER, ZSTREAMTYPECODE INTEGER, ZENDDATE TIMESTAMP, '
'ZSTARTDATE TIMESTAMP, ZCUSTOMIDENTIFIER VARCHAR, ZDEVICEIDENTIFIER '
'VARCHAR, ZIDENTIFIER VARCHAR, ZSTREAMNAME VARCHAR )'),
'ZHISTOGRAMVALUE': (
'CREATE TABLE ZHISTOGRAMVALUE ( Z_PK INTEGER PRIMARY KEY, Z_ENT '
'INTEGER, Z_OPT INTEGER, ZINTEGERVALUE INTEGER, ZHISTOGRAM INTEGER, '
'ZCOUNT FLOAT, ZSTRINGVALUE VARCHAR )'),
'ZKEYVALUE': (
'CREATE TABLE ZKEYVALUE ( Z_PK INTEGER PRIMARY KEY, Z_ENT INTEGER, '
'Z_OPT INTEGER, ZDOMAIN VARCHAR, ZKEY VARCHAR, ZVALUE BLOB )'),
'ZOBJECT': (
'CREATE TABLE ZOBJECT ( Z_PK INTEGER PRIMARY KEY, Z_ENT INTEGER, '
'Z_OPT INTEGER, ZUUIDHASH INTEGER, ZEVENT INTEGER, ZSOURCE INTEGER, '
'ZCATEGORYTYPE INTEGER, ZINTEGERVALUE INTEGER, ZENDDAYOFWEEK '
'INTEGER, ZENDSECONDOFDAY INTEGER, ZHASCUSTOMMETADATA INTEGER, '
'ZHASSTRUCTUREDMETADATA INTEGER, ZSECONDSFROMGMT INTEGER, '
'ZSHOULDSYNC INTEGER, ZSTARTDAYOFWEEK INTEGER, ZSTARTSECONDOFDAY '
'INTEGER, ZVALUECLASS INTEGER, ZVALUEINTEGER INTEGER, '
'ZVALUETYPECODE INTEGER, ZSTRUCTUREDMETADATA INTEGER, ZVALUE '
'INTEGER, Z9_VALUE INTEGER, ZIDENTIFIERTYPE INTEGER, ZQUANTITYTYPE '
'INTEGER, ZOBJECT INTEGER, Z9_OBJECT INTEGER, ZSUBJECT INTEGER, '
'Z9_SUBJECT INTEGER, ZCREATIONDATE TIMESTAMP, ZLOCALCREATIONDATE '
'TIMESTAMP, ZCONFIDENCE FLOAT, ZENDDATE TIMESTAMP, ZSTARTDATE '
'TIMESTAMP, ZVALUEDOUBLE FLOAT, ZDOUBLEVALUE FLOAT, ZUUID VARCHAR, '
'ZSTREAMNAME VARCHAR, ZVALUESTRING VARCHAR, ZSTRING VARCHAR, '
'ZVERBPHRASE VARCHAR, ZMETADATA BLOB )'),
'ZSOURCE': (
'CREATE TABLE ZSOURCE ( Z_PK INTEGER PRIMARY KEY, Z_ENT INTEGER, '
'Z_OPT INTEGER, ZUSERID INTEGER, ZBUNDLEID VARCHAR, ZDEVICEID '
'VARCHAR, ZGROUPID VARCHAR, ZITEMID VARCHAR, ZSOURCEID VARCHAR )'),
'ZSTRUCTUREDMETADATA': (
'CREATE TABLE ZSTRUCTUREDMETADATA ( Z_PK INTEGER PRIMARY KEY, Z_ENT '
'INTEGER, Z_OPT INTEGER, Z_CDPORTRAITMETADATAKEY__ALGORITHM '
'INTEGER, Z_CDPORTRAITMETADATAKEY__ASSETVERSION INTEGER, '
'Z_DKAPPINSTALLMETADATAKEY__ISINSTALL INTEGER, '
'Z_DKAPPLICATIONACTIVITYMETADATAKEY__ISELIGIBLEFORPREDICTION '
'INTEGER, Z_DKAPPLICATIONACTIVITYMETADATAKEY__ISPUBLICLYINDEXABLE '
'INTEGER, Z_DKAPPLICATIONMETADATAKEY__PROCESSIDENTIFIER INTEGER, '
'Z_DKAUDIOMETADATAKEY__ROUTECHANGEREASON INTEGER, '
'Z_DKBLUETOOTHMETADATAKEY__DEVICETYPE INTEGER, '
'Z_DKBULLETINBOARDMETADATAKEY__HASDATE INTEGER, '
'Z_DKDIGITALHEALTHMETADATAKEY__USAGETYPE INTEGER, '
'Z_DKGLANCELAUNCHMETADATA__DEVICEIDENTIFIER INTEGER, '
'Z_DKINTENTMETADATAKEY__DONATEDBYSIRI INTEGER, '
'Z_DKINTENTMETADATAKEY__INTENTHANDLINGSTATUS INTEGER, '
'Z_DKINTENTMETADATAKEY__INTENTTYPE INTEGER, '
'Z_DKNOWPLAYINGMETADATAKEY__IDENTIFIER INTEGER, '
'Z_DKNOWPLAYINGMETADATAKEY__PLAYING INTEGER, '
'Z_DKSEARCHFEEDBACKMETADATAKEY__INTERACTIONTYPE INTEGER, '
'Z_DKSEARCHFEEDBACKMETADATAKEY__SUGGESTIONTYPE INTEGER, '
'Z_QPMETRICSMETADATAKEY__QUERYENGAGED INTEGER, '
'Z_QPMETRICSMETADATAKEY__RESULTENGAGED INTEGER, '
'ZCOM_APPLE_CALENDARUIKIT_USERACTIVITY_DATE INTEGER, '
'ZCOM_APPLE_CALENDARUIKIT_USERACTIVITY_ENDDATE INTEGER, '
'Z_CDPORTRAITMETADATAKEY__DECAYRATE FLOAT, '
'Z_CDPORTRAITMETADATAKEY__SCORE FLOAT, '
'Z_DKAPPLICATIONACTIVITYMETADATAKEY__EXPIRATIONDATE TIMESTAMP, '
'Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__LATITUDE FLOAT, '
'Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__LONGITUDE FLOAT, '
'Z_DKLOCATIONMETADATAKEY__LATITUDE FLOAT, '
'Z_DKLOCATIONMETADATAKEY__LONGITUDE FLOAT, '
'Z_DKNOWPLAYINGMETADATAKEY__DURATION FLOAT, '
'Z_DKNOWPLAYINGMETADATAKEY__ELAPSED FLOAT, '
'Z_DKPERIODMETADATAKEY__PERIODEND TIMESTAMP, '
'Z_DKPERIODMETADATAKEY__PERIODSTART TIMESTAMP, '
'Z_QPMETRICSMETADATAKEY__TIMESTAMP FLOAT, '
'Z_CDENTITYMETADATAKEY__BESTLANGUAGE VARCHAR, '
'Z_CDENTITYMETADATAKEY__NAME VARCHAR, '
'Z_CDPORTRAITMETADATAKEY__OSBUILD VARCHAR, '
'Z_DKAPPINSTALLMETADATAKEY__PRIMARYCATEGORY VARCHAR, '
'Z_DKAPPINSTALLMETADATAKEY__TITLE VARCHAR, '
'Z_DKAPPLICATIONACTIVITYMETADATAKEY__ACTIVITYTYPE VARCHAR, '
'Z_DKAPPLICATIONACTIVITYMETADATAKEY__CONTENTDESCRIPTION VARCHAR, '
'Z_DKAPPLICATIONACTIVITYMETADATAKEY__ITEMIDENTIFIER VARCHAR, '
'Z_DKAPPLICATIONACTIVITYMETADATAKEY__ITEMRELATEDUNIQUEIDENTIFIER '
'VARCHAR, '
'Z_DKAPPLICATIONACTIVITYMETADATAKEY__SUGGESTEDINVOCATIONPHRASE '
'VARCHAR, Z_DKAPPLICATIONACTIVITYMETADATAKEY__TITLE VARCHAR, '
'Z_DKAPPLICATIONACTIVITYMETADATAKEY__USERACTIVITYREQUIREDSTRING '
'VARCHAR, Z_DKAPPLICATIONACTIVITYMETADATAKEY__USERACTIVITYUUID '
'VARCHAR, Z_DKAPPLICATIONMETADATAKEY__BACKBOARDSTATE VARCHAR, '
'Z_DKAPPLICATIONMETADATAKEY__EXTENSIONCONTAININGBUNDLEIDENTIFIER '
'VARCHAR, Z_DKAPPLICATIONMETADATAKEY__EXTENSIONHOSTIDENTIFIER '
'VARCHAR, Z_DKAPPLICATIONMETADATAKEY__LAUNCHREASON VARCHAR, '
'Z_DKAUDIOMETADATAKEY__CHANNELS VARCHAR, '
'Z_DKAUDIOMETADATAKEY__DATASOURCES VARCHAR, '
'Z_DKAUDIOMETADATAKEY__IDENTIFIER VARCHAR, '
'Z_DKAUDIOMETADATAKEY__PORTNAME VARCHAR, '
'Z_DKAUDIOMETADATAKEY__PORTTYPE VARCHAR, '
'Z_DKAUDIOMETADATAKEY__PREFERREDDATASOURCE VARCHAR, '
'Z_DKAUDIOMETADATAKEY__SELECTEDDATASOURCE VARCHAR, '
'Z_DKBATTERYSAVERMETADATAKEY__SOURCE VARCHAR, '
'Z_DKBLUETOOTHMETADATAKEY__ADDRESS VARCHAR, '
'Z_DKBLUETOOTHMETADATAKEY__NAME VARCHAR, '
'Z_DKBULLETINBOARDMETADATAKEY__FEED VARCHAR, '
'Z_DKBULLETINBOARDMETADATAKEY__MESSAGE VARCHAR, '
'Z_DKBULLETINBOARDMETADATAKEY__SUBTITLE VARCHAR, '
'Z_DKBULLETINBOARDMETADATAKEY__TITLE VARCHAR, '
'Z_DKCALENDARMETADATAKEY__INTERACTION VARCHAR, '
'Z_DKCALLMETADATAKEY__INTERACTION VARCHAR, '
'Z_DKDEVICEIDMETADATAKEY__DEVICEIDENTIFIER VARCHAR, '
'Z_DKDIGITALHEALTHMETADATAKEY__WEBDOMAIN VARCHAR, '
'Z_DKINTENTMETADATAKEY__INTENTCLASS VARCHAR, '
'Z_DKINTENTMETADATAKEY__INTENTVERB VARCHAR, '
'Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__URL VARCHAR, '
'Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__CITY VARCHAR, '
'Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__COUNTRY VARCHAR, '
'Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__DISPLAYNAME VARCHAR, '
'Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__FULLYFORMATTEDADDRESS '
'VARCHAR, Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__LOCATIONNAME '
'VARCHAR, Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__POSTALCODE_V2 '
'VARCHAR, '
'Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__STATEORPROVINCE '
'VARCHAR, '
'Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__SUBTHOROUGHFARE '
'VARCHAR, Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__THOROUGHFARE '
'VARCHAR, Z_DKLOCATIONMETADATAKEY__IDENTIFIER VARCHAR, '
'Z_DKMETADATAHOMEAPPVIEW__HOMEUUID VARCHAR, '
'Z_DKMETADATAHOMEAPPVIEW__VIEWINFORMATION VARCHAR, '
'Z_DKMETADATAHOMEAPPVIEW__VIEWNAME VARCHAR, '
'Z_DKMETADATAHOMEAPPVIEW__VIEWUUID VARCHAR, '
'Z_DKMETADATAHOMEKITACCESSORYCONTROL__ACCESSORYNAME VARCHAR, '
'Z_DKMETADATAHOMEKITACCESSORYCONTROL__ACCESSORYUUID VARCHAR, '
'Z_DKMETADATAHOMEKITACCESSORYCONTROL__CHARACTERISTICTYPE VARCHAR, '
'Z_DKMETADATAHOMEKITACCESSORYCONTROL__CLIENTNAME VARCHAR, '
'Z_DKMETADATAHOMEKITACCESSORYCONTROL__HOMEUUID VARCHAR, '
'Z_DKMETADATAHOMEKITACCESSORYCONTROL__SERVICENAME VARCHAR, '
'Z_DKMETADATAHOMEKITACCESSORYCONTROL__SERVICETYPE VARCHAR, '
'Z_DKMETADATAHOMEKITSCENE__ACTIONSETNAME VARCHAR, '
'Z_DKMETADATAHOMEKITSCENE__ACTIONSETTYPE VARCHAR, '
'Z_DKMETADATAHOMEKITSCENE__ACTIONSETUUID VARCHAR, '
'Z_DKMETADATAHOMEKITSCENE__CLIENTNAME VARCHAR, '
'Z_DKMETADATAHOMEKITSCENE__HOMEUUID VARCHAR, '
'Z_DKMETADATAHOMEKITSCENE__SCENENAME VARCHAR, '
'Z_DKMICROLOCATIONMETADATAKEY__LOCATIONDISTRIBUTION VARCHAR, '
'Z_DKMICROLOCATIONMETADATAKEY__MICROLOCATIONDISTRIBUTION VARCHAR, '
'Z_DKNOTIFICATIONUSAGEMETADATAKEY__BUNDLEID VARCHAR, '
'Z_DKNOTIFICATIONUSAGEMETADATAKEY__IDENTIFIER VARCHAR, '
'Z_DKNOWPLAYINGMETADATAKEY__ALBUM VARCHAR, '
'Z_DKNOWPLAYINGMETADATAKEY__ARTIST VARCHAR, '
'Z_DKNOWPLAYINGMETADATAKEY__GENRE VARCHAR, '
'Z_DKNOWPLAYINGMETADATAKEY__TITLE VARCHAR, '
'Z_DKRELEVANTSHORTCUTMETADATAKEY__KEYIMAGEPROXYIDENTIFIER VARCHAR, '
'Z_DKSAFARIHISTORYMETADATAKEY__TITLE VARCHAR, '
'Z_DKSEARCHFEEDBACKMETADATAKEY__CLIENT VARCHAR, '
'Z_DKSEARCHFEEDBACKMETADATAKEY__CONTACTID VARCHAR, '
'Z_DKTOMBSTONEMETADATAKEY__EVENTSOURCEDEVICEID VARCHAR, '
'Z_DKTOMBSTONEMETADATAKEY__EVENTSTREAMNAME VARCHAR, '
'Z_QPMETRICSMETADATAKEY__QUERY VARCHAR, '
'ZCOM_APPLE_CALENDARUIKIT_USERACTIVITY_EXTERNALID VARCHAR, '
'ZKCDCSNOTIFICATIONOPTIONCLIENTIDENTIFIERKEY VARCHAR, '
'ZKCDCSNOTIFICATIONOPTIONCLIENTLAUNCHKEY VARCHAR, '
'ZKCDCSNOTIFICATIONOPTIONPERSISTENTPREDICATESTRINGKEY VARCHAR, '
'ZMETADATAHASH VARCHAR, '
'Z_DKAPPLICATIONACTIVITYMETADATAKEY__ITEMRELATEDCONTENTURL VARCHAR, '
'Z_DKDIGITALHEALTHMETADATAKEY__WEBPAGEURL VARCHAR, '
'Z_DKAPPINSTALLMETADATAKEY__SUBCATEGORIES BLOB, '
'Z_DKINTENTMETADATAKEY__SERIALIZEDINTERACTION BLOB, '
'Z_DKLOCATIONAPPLICATIONACTIVITYMETADATAKEY__PHONENUMBERS BLOB, '
'Z_DKRELEVANTSHORTCUTMETADATAKEY__SERIALIZEDRELEVANTSHORTCUT BLOB, '
'Z_QPMETRICSMETADATAKEY__CANDIDATELIST BLOB, '
'Z_QPMETRICSMETADATAKEY__QUERYLIST BLOB )'),
'ZSYNCPEER': (
'CREATE TABLE ZSYNCPEER ( Z_PK INTEGER PRIMARY KEY, Z_ENT INTEGER, '
'Z_OPT INTEGER, ZCLOUDID VARCHAR, ZDEVICEID VARCHAR, ZRAPPORTID '
'VARCHAR, ZUUID BLOB )'),
'Z_4EVENT': (
'CREATE TABLE Z_4EVENT ( Z_4CUSTOMMETADATA INTEGER, Z_11EVENT '
'INTEGER, PRIMARY KEY (Z_4CUSTOMMETADATA, Z_11EVENT) )'),
'Z_METADATA': (
'CREATE TABLE Z_METADATA (Z_VERSION INTEGER PRIMARY KEY, Z_UUID '
'VARCHAR(255), Z_PLIST BLOB)'),
'Z_MODELCACHE': (
'CREATE TABLE Z_MODELCACHE (Z_CONTENT BLOB)'),
'Z_PRIMARYKEY': (
'CREATE TABLE Z_PRIMARYKEY (Z_ENT INTEGER PRIMARY KEY, Z_NAME '
'VARCHAR, Z_SUPER INTEGER, Z_MAX INTEGER)')}
SCHEMAS = [_SCHEMA_10_13, _SCHEMA_10_14]
_KNOWN_ACTION_TYPES = frozenset([
'com.apple.spotlightviewer.events',
'/activity/level',
'/device/batteryPercentage',
'/device/isPluggedIn',
'/display/isBacklit',
'/event/tombstone',
'/portrait/entity',
'/portrait/topic'])
def _GetDateTimeRowValue(self, query_hash, row, value_name):
"""Retrieves a date and time value from the row.
Args:
query_hash (int): hash of the query, that uniquely identifies the query
that produced the row.
row (sqlite3.Row): row.
value_name (str): name of the value.
Returns:
dfdatetime.CocoaTime: date and time value or None if not available.
"""
timestamp = self._GetRowValue(query_hash, row, value_name)
if timestamp is None:
return None
return dfdatetime_cocoa_time.CocoaTime(timestamp=timestamp)
[docs]
def KnowledgeCRow(self, parser_mediator, query, row, **unused_kwargs):
"""Parses KnowledgeC application activity.
Args:
parser_mediator (ParserMediator): mediates interactions between parsers
and other components, such as storage and dfVFS.
query (str): query that created the row.
row (sqlite3.Row): row.
"""
query_hash = hash(query)
action = self._GetRowValue(query_hash, row, 'action')
if action.startswith('/safari/'):
event_data = MacOSKnowledgeCSafariEventData()
event_data.url = self._GetRowValue(query_hash, row, 'zvaluestring')
event_data.title = self._GetRowValue(query_hash, row, 'title')
elif action.startswith('/app/'):
event_data = MacOSKnowledgeCApplicationEventData()
event_data.bundle_identifier = self._GetRowValue(
query_hash, row, 'zvaluestring')
# TODO: Add support for additional action types.
else:
if action not in self._KNOWN_ACTION_TYPES:
parser_mediator.ProduceExtractionWarning(
'unsupported action type: {0:s}'.format(action))
return
event_data.creation_time = self._GetDateTimeRowValue(
query_hash, row, 'entry_creation')
activity_starts = self._GetRowValue(query_hash, row, 'start')
activity_ends = self._GetRowValue(query_hash, row, 'end')
if activity_starts:
event_data.start_time = dfdatetime_cocoa_time.CocoaTime(
timestamp=activity_starts)
if activity_ends:
event_data.end_time = dfdatetime_cocoa_time.CocoaTime(
timestamp=activity_ends)
if activity_starts and activity_ends:
event_data.duration = activity_ends - activity_starts
parser_mediator.ProduceEventData(event_data)
sqlite.SQLiteParser.RegisterPlugin(MacOSKnowledgeCPlugin)