Autopsy  4.6.0
Graphical digital forensics platform for The Sleuth Kit and other tools.
Public Member Functions | Static Public Member Functions | Static Public Attributes | List of all members
org.sleuthkit.autopsy.centralrepository.datamodel.EamDb Interface Reference

Inherited by org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb.

Public Member Functions

void addArtifact (CorrelationAttribute eamArtifact) throws EamDbException
 
void addReferenceInstance (EamGlobalFileInstance eamGlobalFileInstance, CorrelationAttribute.Type correlationType) throws EamDbException
 
void bulkInsertArtifacts () throws EamDbException
 
void bulkInsertCases (List< CorrelationCase > cases) throws EamDbException
 
void bulkInsertReferenceTypeEntries (Set< EamGlobalFileInstance > globalInstances, CorrelationAttribute.Type contentType) throws EamDbException
 
void deleteOrganization (EamOrganization organizationToDelete) throws EamDbException
 
void deleteReferenceSet (int referenceSetID) throws EamDbException
 
List< EamGlobalSetgetAllReferenceSets (CorrelationAttribute.Type correlationType) throws EamDbException
 
List< CorrelationAttributeInstancegetArtifactInstancesByPath (CorrelationAttribute.Type aType, String filePath) throws EamDbException
 
List< CorrelationAttributeInstancegetArtifactInstancesByTypeValue (CorrelationAttribute.Type aType, String value) throws EamDbException
 
List< CorrelationAttributeInstancegetArtifactInstancesKnownBad (CorrelationAttribute.Type aType, String value) throws EamDbException
 
CorrelationCase getCase (Case autopsyCase) throws EamDbException
 
CorrelationCase getCaseByUUID (String caseUUID) throws EamDbException
 
List< CorrelationCasegetCases () throws EamDbException
 
CorrelationAttribute.Type getCorrelationTypeById (int typeId) throws EamDbException
 
Long getCountArtifactInstancesByCaseDataSource (String caseUUID, String dataSourceID) throws EamDbException
 
Long getCountArtifactInstancesByTypeValue (CorrelationAttribute.Type aType, String value) throws EamDbException
 
Long getCountArtifactInstancesKnownBad (CorrelationAttribute.Type aType, String value) throws EamDbException
 
Long getCountUniqueCaseDataSourceTuplesHavingTypeValue (CorrelationAttribute.Type aType, String value) throws EamDbException
 
Long getCountUniqueDataSources () throws EamDbException
 
CorrelationDataSource getDataSource (CorrelationCase correlationCase, String dataSourceDeviceId) throws EamDbException
 
List< CorrelationDataSourcegetDataSources () throws EamDbException
 
String getDbInfo (String name) throws EamDbException
 
List< CorrelationAttribute.Type > getDefinedCorrelationTypes () throws EamDbException
 
List< CorrelationAttribute.Type > getEnabledCorrelationTypes () throws EamDbException
 
CoordinationService.Lock getExclusiveMultiUserDbLock () throws EamDbException
 
int getFrequencyPercentage (CorrelationAttribute corAttr) throws EamDbException
 
List< String > getListCasesHavingArtifactInstancesKnownBad (CorrelationAttribute.Type aType, String value) throws EamDbException
 
EamOrganization getOrganizationByID (int orgID) throws EamDbException
 
List< EamOrganizationgetOrganizations () throws EamDbException
 
List< EamGlobalFileInstancegetReferenceInstancesByTypeValue (CorrelationAttribute.Type aType, String aValue) throws EamDbException
 
EamGlobalSet getReferenceSetByID (int globalSetID) throws EamDbException
 
EamOrganization getReferenceSetOrganization (int referenceSetID) throws EamDbException
 
List< CorrelationAttribute.Type > getSupportedCorrelationTypes () throws EamDbException
 
boolean isArtifactKnownBadByReference (CorrelationAttribute.Type aType, String value) throws EamDbException
 
boolean isFileHashInReferenceSet (String hash, int referenceSetID) throws EamDbException
 
boolean isValueInReferenceSet (String value, int referenceSetID, int correlationTypeID) throws EamDbException
 
CorrelationCase newCase (CorrelationCase eamCase) throws EamDbException
 
CorrelationCase newCase (Case autopsyCase) throws EamDbException
 
int newCorrelationType (CorrelationAttribute.Type newType) throws EamDbException
 
void newDataSource (CorrelationDataSource eamDataSource) throws EamDbException
 
void newDbInfo (String name, String value) throws EamDbException
 
long newOrganization (EamOrganization eamOrg) throws EamDbException
 
int newReferenceSet (EamGlobalSet eamGlobalSet) throws EamDbException
 
void prepareBulkArtifact (CorrelationAttribute eamArtifact) throws EamDbException
 
boolean referenceSetExists (String referenceSetName, String version) throws EamDbException
 
boolean referenceSetIsValid (int referenceSetID, String referenceSetName, String version) throws EamDbException
 
void reset () throws EamDbException
 
void saveSettings ()
 
void setArtifactInstanceKnownStatus (CorrelationAttribute eamArtifact, TskData.FileKnown knownStatus) throws EamDbException
 
void shutdownConnections () throws EamDbException
 
void updateCase (CorrelationCase eamCase) throws EamDbException
 
void updateCorrelationType (CorrelationAttribute.Type aType) throws EamDbException
 
void updateDbInfo (String name, String value) throws EamDbException
 
void updateOrganization (EamOrganization updatedOrganization) throws EamDbException
 
void updateSettings ()
 
void upgradeSchema () throws EamDbException, SQLException
 

Static Public Member Functions

static EamDb getInstance () throws EamDbException
 
static boolean isEnabled ()
 

Static Public Attributes

static final CaseDbSchemaVersionNumber CURRENT_DB_SCHEMA_VERSION = new CaseDbSchemaVersionNumber(1, 1)
 
static final int SCHEMA_VERSION = 1
 

Detailed Description

Main interface for interacting with the database

Definition at line 32 of file EamDb.java.

Member Function Documentation

void org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.addArtifact ( CorrelationAttribute  eamArtifact) throws EamDbException
void org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.addReferenceInstance ( EamGlobalFileInstance  eamGlobalFileInstance,
CorrelationAttribute.Type  correlationType 
) throws EamDbException

Add a new reference instance

Parameters
eamGlobalFileInstanceThe reference instance to add
correlationTypeCorrelation Type that this Reference Instance is
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

void org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.bulkInsertArtifacts ( ) throws EamDbException
void org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.bulkInsertCases ( List< CorrelationCase cases) throws EamDbException
void org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.bulkInsertReferenceTypeEntries ( Set< EamGlobalFileInstance globalInstances,
CorrelationAttribute.Type  contentType 
) throws EamDbException

Insert the bulk collection of Global File Instances

Parameters
globalInstancesa Set of EamGlobalFileInstances to insert into the db.
contentTypethe Type of the global instances
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

Referenced by org.sleuthkit.autopsy.modules.hashdatabase.ImportCentralRepoDbProgressDialog.CentralRepoImportWorker.doInBackground().

void org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.deleteOrganization ( EamOrganization  organizationToDelete) throws EamDbException

Delete an organization if it is not being used by any case.

Parameters
organizationToDeletethe organization to be deleted
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

Referenced by org.sleuthkit.autopsy.centralrepository.optionspanel.ManageOrganizationsDialog.deleteButtonActionPerformed().

void org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.deleteReferenceSet ( int  referenceSetID) throws EamDbException
List<EamGlobalSet> org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getAllReferenceSets ( CorrelationAttribute.Type  correlationType) throws EamDbException

Get all reference sets

Parameters
correlationTypeType of sets to return
Returns
List of all reference sets in the central repository
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

Referenced by org.sleuthkit.autopsy.modules.hashdatabase.HashDbManager.getCentralRepoHashSetsFromDatabase().

List<CorrelationAttributeInstance> org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getArtifactInstancesByPath ( CorrelationAttribute.Type  aType,
String  filePath 
) throws EamDbException

Retrieves eamArtifact instances from the database that are associated with the aType and filePath

Parameters
aTypeEamArtifact.Type to search for
filePathFile path to search for
Returns
List of 0 or more EamArtifactInstances
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

List<CorrelationAttributeInstance> org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getArtifactInstancesByTypeValue ( CorrelationAttribute.Type  aType,
String  value 
) throws EamDbException

Retrieves eamArtifact instances from the database that are associated with the eamArtifactType and eamArtifactValue of the given eamArtifact.

Parameters
aTypeEamArtifact.Type to search for
valueValue to search for
Returns
List of artifact instances for a given type/value

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

Referenced by org.sleuthkit.autopsy.centralrepository.contentviewer.DataContentViewerOtherCases.getCorrelatedInstances().

List<CorrelationAttributeInstance> org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getArtifactInstancesKnownBad ( CorrelationAttribute.Type  aType,
String  value 
) throws EamDbException

Gets list of matching eamArtifact instances that have knownStatus = "Bad".

Parameters
aTypeEamArtifact.Type to search for
valueValue to search for
Returns
List with 0 or more matching eamArtifact instances.

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

CorrelationCase org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getCase ( Case  autopsyCase) throws EamDbException
CorrelationCase org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getCaseByUUID ( String  caseUUID) throws EamDbException

Retrieves Case details based on Case UUID

Parameters
caseUUIDunique identifier for a case
Returns
The retrieved case

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

List<CorrelationCase> org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getCases ( ) throws EamDbException
CorrelationAttribute.Type org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getCorrelationTypeById ( int  typeId) throws EamDbException
Long org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getCountArtifactInstancesByCaseDataSource ( String  caseUUID,
String  dataSourceID 
) throws EamDbException

Retrieves number of eamArtifact instances in the database that are associated with the caseDisplayName and dataSource of the given eamArtifact instance.

Parameters
caseUUIDCase ID to search for
dataSourceIDData source ID to search for
Returns
Number of artifact instances having caseDisplayName and dataSource

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

Long org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getCountArtifactInstancesByTypeValue ( CorrelationAttribute.Type  aType,
String  value 
) throws EamDbException

Retrieves number of artifact instances in the database that are associated with the ArtifactType and artifactValue of the given artifact.

Parameters
aTypeEamArtifact.Type to search for
valueValue to search for
Returns
Number of artifact instances having ArtifactType and ArtifactValue.

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

Long org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getCountArtifactInstancesKnownBad ( CorrelationAttribute.Type  aType,
String  value 
) throws EamDbException

Count matching eamArtifacts instances that have knownStatus = "Bad".

Parameters
aTypeEamArtifact.Type to search for
valueValue to search for
Returns
Number of matching eamArtifacts

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

Long org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getCountUniqueCaseDataSourceTuplesHavingTypeValue ( CorrelationAttribute.Type  aType,
String  value 
) throws EamDbException

Retrieves number of unique caseDisplayName / dataSource tuples in the database that are associated with the artifactType and artifactValue of the given artifact.

Parameters
aTypeEamArtifact.Type to search for
valueValue to search for
Returns
Number of unique tuples

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

Long org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getCountUniqueDataSources ( ) throws EamDbException

Retrieves number of data sources in the database.

Returns
Number of unique data sources

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

CorrelationDataSource org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getDataSource ( CorrelationCase  correlationCase,
String  dataSourceDeviceId 
) throws EamDbException

Retrieves Data Source details based on data source device ID

Parameters
correlationCasethe current CorrelationCase used for ensuring uniqueness of DataSource
dataSourceDeviceIdthe data source device ID number
Returns
The data source

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

Referenced by org.sleuthkit.autopsy.centralrepository.eventlisteners.CaseEventListener.DataSourceAddedTask.run().

List<CorrelationDataSource> org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getDataSources ( ) throws EamDbException

Retrieves data sources that are in DB

Returns
List of data sources

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

String org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getDbInfo ( String  name) throws EamDbException

Get the value for the given name from the name/value db_info table.

Parameters
nameName to search for
Returns
value associated with name.
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb.

List<CorrelationAttribute.Type> org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getDefinedCorrelationTypes ( ) throws EamDbException

Get the list of EamArtifact.Type's that are defined in the DB and can be used to correlate artifacts.

Returns
List of EamArtifact.Type's. If none are defined in the database, the default list will be returned.
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.EamArtifactUtil.getCorrelationAttributeFromBlackboardArtifact(), and org.sleuthkit.autopsy.centralrepository.contentviewer.DataContentViewerOtherCases.getCorrelationAttributesFromNode().

List<CorrelationAttribute.Type> org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getEnabledCorrelationTypes ( ) throws EamDbException

Get the list of enabled EamArtifact.Type's that will be used to correlate artifacts.

Returns
List of enabled EamArtifact.Type's. If none are defined in the database, the default list will be returned.
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

CoordinationService.Lock org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getExclusiveMultiUserDbLock ( ) throws EamDbException

Gets an exclusive lock (if applicable). Will return the lock if successful, null if unsuccessful because locking isn't supported, and throw an exception if we should have been able to get the lock but failed (meaning the database is in use).

Returns
the lock, or null if locking is not supported
Exceptions
EamDbExceptionif the coordination service is running but we fail to get the lock

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.PostgresEamDb.

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.EamDbUtil.upgradeDatabase().

int org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getFrequencyPercentage ( CorrelationAttribute  corAttr) throws EamDbException

Calculate the percentage of data sources that have this attribute value.

Parameters
corAttrAttribute type and value to get data about
Returns
Int between 0 and 100

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

Referenced by org.sleuthkit.autopsy.centralrepository.contentviewer.DataContentViewerOtherCases.showCommonalityDetails().

static EamDb org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getInstance ( ) throws EamDbException
static

Get the instance

Returns
The EamDb instance or null if one is not configured.
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.PostgresEamDb.

Definition at line 45 of file EamDb.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.EamDbPlatformEnum.DISABLED, org.sleuthkit.autopsy.centralrepository.datamodel.PostgresEamDb.getInstance(), org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.getInstance(), org.sleuthkit.autopsy.centralrepository.datamodel.EamDbPlatformEnum.getSelectedPlatform(), and org.sleuthkit.autopsy.centralrepository.datamodel.EamDbUtil.useCentralRepo().

Referenced by org.sleuthkit.autopsy.centralrepository.optionspanel.AddNewOrganizationDialog.bnOKActionPerformed(), org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.bnOkActionPerformed(), org.sleuthkit.autopsy.modules.hashdatabase.HashLookupSettingsPanel.cancel(), org.sleuthkit.autopsy.centralrepository.optionspanel.ManageOrganizationsDialog.deleteButtonActionPerformed(), org.sleuthkit.autopsy.modules.hashdatabase.ImportCentralRepoDbProgressDialog.CentralRepoImportWorker.deleteIncompleteSet(), org.sleuthkit.autopsy.modules.hashdatabase.ImportCentralRepoDbProgressDialog.CentralRepoImportWorker.doInBackground(), org.sleuthkit.autopsy.modules.hashdatabase.HashDbManager.getCentralRepoHashSetsFromDatabase(), org.sleuthkit.autopsy.centralrepository.contentviewer.DataContentViewerOtherCases.getCorrelatedInstances(), org.sleuthkit.autopsy.centralrepository.datamodel.EamArtifactUtil.getCorrelationAttributeFromBlackboardArtifact(), org.sleuthkit.autopsy.centralrepository.datamodel.EamArtifactUtil.getCorrelationAttributeFromContent(), org.sleuthkit.autopsy.centralrepository.contentviewer.DataContentViewerOtherCases.getCorrelationAttributesFromNode(), org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb.getEamGlobalSetFromResultSet(), org.sleuthkit.autopsy.centralrepository.optionspanel.ManageOrganizationsDialog.ManageOrganizationsDialog(), org.sleuthkit.autopsy.centralrepository.eventlisteners.IngestEventsListener.IngestModuleEventListener.propertyChange(), org.sleuthkit.autopsy.centralrepository.eventlisteners.NewArtifactsRunner.run(), org.sleuthkit.autopsy.centralrepository.eventlisteners.CaseEventListener.TagDefinitionChangeTask.run(), org.sleuthkit.autopsy.centralrepository.contentviewer.DataContentViewerOtherCases.showCaseDetails(), org.sleuthkit.autopsy.centralrepository.contentviewer.DataContentViewerOtherCases.showCommonalityDetails(), and org.sleuthkit.autopsy.centralrepository.datamodel.EamDbUtil.upgradeDatabase().

List<String> org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getListCasesHavingArtifactInstancesKnownBad ( CorrelationAttribute.Type  aType,
String  value 
) throws EamDbException

Gets list of distinct case display names, where each case has 1+ Artifact Instance matching eamArtifact with knownStatus = "Bad".

Parameters
aTypeEamArtifact.Type to search for
valueValue to search for
Returns
List of cases containing this artifact with instances marked as bad
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

Referenced by org.sleuthkit.autopsy.centralrepository.eventlisteners.IngestEventsListener.DataAddedTask.run().

EamOrganization org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getOrganizationByID ( int  orgID) throws EamDbException

Get an organization having the given ID

Parameters
orgIDThe id to look up
Returns
The organization with the given ID
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

List<EamOrganization> org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getOrganizations ( ) throws EamDbException
List<EamGlobalFileInstance> org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getReferenceInstancesByTypeValue ( CorrelationAttribute.Type  aType,
String  aValue 
) throws EamDbException

Get all reference entries having a given correlation type and value

Parameters
aTypeType to use for matching
aValueValue to use for matching
Returns
List of all global file instances with a type and value
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

EamGlobalSet org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getReferenceSetByID ( int  globalSetID) throws EamDbException

Get a global set by ID

Parameters
globalSetIDThe ID to look up
Returns
The global set associated with the ID
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

EamOrganization org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getReferenceSetOrganization ( int  referenceSetID) throws EamDbException

Get the organization associated with the given reference set.

Parameters
referenceSetIDID of the reference set
Returns
The organization object
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb.

List<CorrelationAttribute.Type> org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.getSupportedCorrelationTypes ( ) throws EamDbException

Get the list of supported EamArtifact.Type's that can be used to correlate artifacts.

Returns
List of supported EamArtifact.Type's. If none are defined in the database, the default list will be returned.
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

boolean org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.isArtifactKnownBadByReference ( CorrelationAttribute.Type  aType,
String  value 
) throws EamDbException

Is the artifact known as bad according to the reference entries?

Parameters
aTypeEamArtifact.Type to search for
valueValue to search for
Returns
Global known status of the artifact

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

static boolean org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.isEnabled ( )
static

Is the database enabled?

Returns
Is the database enabled

Definition at line 98 of file EamDb.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.EamDbPlatformEnum.DISABLED, org.sleuthkit.autopsy.centralrepository.datamodel.EamDbPlatformEnum.getSelectedPlatform(), and org.sleuthkit.autopsy.centralrepository.datamodel.EamDbUtil.useCentralRepo().

Referenced by org.sleuthkit.autopsy.modules.hashdatabase.HashLookupSettingsPanel.cancel(), org.sleuthkit.autopsy.modules.hashdatabase.HashDbManager.configureSettings(), org.sleuthkit.autopsy.centralrepository.datamodel.PostgresEamDb.connect(), org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.connect(), org.sleuthkit.autopsy.modules.hashdatabase.HashDbManager.getCentralRepoHashSetsFromDatabase(), org.sleuthkit.autopsy.centralrepository.contentviewer.DataContentViewerOtherCases.isSupported(), org.sleuthkit.autopsy.centralrepository.eventlisteners.NewArtifactsRunner.run(), org.sleuthkit.autopsy.centralrepository.eventlisteners.CaseEventListener.ContentTagTask.run(), org.sleuthkit.autopsy.centralrepository.eventlisteners.CaseEventListener.BlackboardTagTask.run(), org.sleuthkit.autopsy.centralrepository.eventlisteners.IngestEventsListener.DataAddedTask.run(), org.sleuthkit.autopsy.centralrepository.eventlisteners.CaseEventListener.TagDefinitionChangeTask.run(), org.sleuthkit.autopsy.centralrepository.eventlisteners.CaseEventListener.DataSourceAddedTask.run(), org.sleuthkit.autopsy.centralrepository.eventlisteners.CaseEventListener.CurrentCaseTask.run(), org.sleuthkit.autopsy.centralrepository.contentviewer.DataContentViewerOtherCases.setNode(), org.sleuthkit.autopsy.modules.hashdatabase.HashDbManager.updateHashSetsFromCentralRepository(), and org.sleuthkit.autopsy.centralrepository.datamodel.EamDbUtil.upgradeDatabase().

boolean org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.isFileHashInReferenceSet ( String  hash,
int  referenceSetID 
) throws EamDbException

Check if the given file hash is in this reference set. Only searches the reference_files table.

Parameters
hash
referenceSetID
Returns
true if the hash is found in the reference set
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb.

boolean org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.isValueInReferenceSet ( String  value,
int  referenceSetID,
int  correlationTypeID 
) throws EamDbException

Check if the given value is in a specific reference set

Parameters
value
referenceSetID
correlationTypeID
Returns
true if the hash is found in the reference set

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

CorrelationCase org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.newCase ( CorrelationCase  eamCase) throws EamDbException
CorrelationCase org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.newCase ( Case  autopsyCase) throws EamDbException

Creates new Case in the database from the given case

Parameters
autopsyCaseThe case to add

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb.

int org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.newCorrelationType ( CorrelationAttribute.Type  newType) throws EamDbException

Add a new EamArtifact.Type to the db.

Parameters
newTypeNew type to add.
Returns
Type.ID for newType
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

void org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.newDataSource ( CorrelationDataSource  eamDataSource) throws EamDbException
void org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.newDbInfo ( String  name,
String  value 
) throws EamDbException

Add a new name/value pair in the db_info table.

Parameters
nameKey to set
valueValue to set
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb.

long org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.newOrganization ( EamOrganization  eamOrg) throws EamDbException

Add a new organization

Parameters
eamOrgThe organization to add
Returns
the Organization ID of the newly created organization.
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

Referenced by org.sleuthkit.autopsy.centralrepository.optionspanel.AddNewOrganizationDialog.bnOKActionPerformed().

int org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.newReferenceSet ( EamGlobalSet  eamGlobalSet) throws EamDbException
void org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.prepareBulkArtifact ( CorrelationAttribute  eamArtifact) throws EamDbException

Adds an eamArtifact to an internal list to be later added to DB. Artifact can have 1 or more Artifact Instances. Insert will be triggered by a threshold or a call to bulkInsertArtifacts().

Parameters
eamArtifactThe artifact to add

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb.

boolean org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.referenceSetExists ( String  referenceSetName,
String  version 
) throws EamDbException

Check whether a reference set with the given name/version is in the central repo. Used to check for name collisions when creating reference sets.

Parameters
referenceSetName
version
Returns
true if a matching set is found
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

boolean org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.referenceSetIsValid ( int  referenceSetID,
String  referenceSetName,
String  version 
) throws EamDbException

Check whether a reference set with the given parameters exists in the central repository. Used to check whether reference sets saved in the settings are still present.

Parameters
referenceSetID
referenceSetName
version
Returns
true if a matching entry exists in the central repository
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb.

void org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.reset ( ) throws EamDbException
void org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.saveSettings ( )
void org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.setArtifactInstanceKnownStatus ( CorrelationAttribute  eamArtifact,
TskData.FileKnown  knownStatus 
) throws EamDbException

Sets an eamArtifact instance to the given known status. If eamArtifact exists, it is updated. If eamArtifact does not exist nothing happens

Parameters
eamArtifactArtifact containing exactly one (1) ArtifactInstance.
knownStatusThe status to change the artifact to

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

Referenced by org.sleuthkit.autopsy.centralrepository.eventlisteners.CaseEventListener.ContentTagTask.run(), org.sleuthkit.autopsy.centralrepository.eventlisteners.CaseEventListener.BlackboardTagTask.run(), and org.sleuthkit.autopsy.centralrepository.eventlisteners.CaseEventListener.TagDefinitionChangeTask.run().

void org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.shutdownConnections ( ) throws EamDbException

Shutdown the connection pool.

This closes the connection pool including all idle database connections. It will not close active/in-use connections. Thus, it is vital that there are no in-use connections when you call this method.

Exceptions
EamDbExceptionif there is a problem closing the connection pool.

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.PostgresEamDb.

Referenced by org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.bnOkActionPerformed(), and org.sleuthkit.autopsy.centralrepository.datamodel.EamDbUtil.upgradeDatabase().

void org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.updateCase ( CorrelationCase  eamCase) throws EamDbException

Updates an existing Case in the database

Parameters
eamCaseThe case to update

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb.

void org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.updateCorrelationType ( CorrelationAttribute.Type  aType) throws EamDbException

Update a EamArtifact.Type.

Parameters
aTypeEamArtifact.Type to update.
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

void org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.updateDbInfo ( String  name,
String  value 
) throws EamDbException

Update the value for a name in the name/value db_info table.

Parameters
nameName to find
valueValue to assign to name.
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb.

void org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.updateOrganization ( EamOrganization  updatedOrganization) throws EamDbException

Update an existing organization.

Parameters
updatedOrganizationthe values the Organization with the same ID will be updated to in the database.
Exceptions
EamDbException

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.AbstractSqlEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb.

Referenced by org.sleuthkit.autopsy.centralrepository.optionspanel.AddNewOrganizationDialog.bnOKActionPerformed().

void org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.updateSettings ( )

Update settings

When using updateSettings, if any database settings have changed, you should call shutdownConnections() before using any API methods. That will ensure that any old connections are closed and all new connections will be made using the new settings.

Implemented in org.sleuthkit.autopsy.centralrepository.datamodel.SqliteEamDb, and org.sleuthkit.autopsy.centralrepository.datamodel.PostgresEamDb.

Referenced by org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.bnOkActionPerformed().

void org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.upgradeSchema ( ) throws EamDbException, SQLException

Member Data Documentation

final CaseDbSchemaVersionNumber org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.CURRENT_DB_SCHEMA_VERSION = new CaseDbSchemaVersionNumber(1, 1)
static
final int org.sleuthkit.autopsy.centralrepository.datamodel.EamDb.SCHEMA_VERSION = 1
static

Definition at line 34 of file EamDb.java.


The documentation for this interface was generated from the following file:

Copyright © 2012-2016 Basis Technology. Generated on: Mon May 7 2018
This work is licensed under a Creative Commons Attribution-Share Alike 3.0 United States License.