diff --git a/docs/doxygen-user/images/Personas/persona_edit.png b/docs/doxygen-user/images/Personas/persona_edit.png new file mode 100644 index 0000000000..1dc07c01d8 Binary files /dev/null and b/docs/doxygen-user/images/Personas/persona_edit.png differ diff --git a/docs/doxygen-user/images/Personas/personas_calllog.png b/docs/doxygen-user/images/Personas/personas_calllog.png new file mode 100644 index 0000000000..63e0a4b01a Binary files /dev/null and b/docs/doxygen-user/images/Personas/personas_calllog.png differ diff --git a/docs/doxygen-user/images/Personas/personas_contact_found.png b/docs/doxygen-user/images/Personas/personas_contact_found.png new file mode 100644 index 0000000000..b32d39936c Binary files /dev/null and b/docs/doxygen-user/images/Personas/personas_contact_found.png differ diff --git a/docs/doxygen-user/images/Personas/personas_contact_not_found.png b/docs/doxygen-user/images/Personas/personas_contact_not_found.png new file mode 100644 index 0000000000..e221e775f5 Binary files /dev/null and b/docs/doxygen-user/images/Personas/personas_contact_not_found.png differ diff --git a/docs/doxygen-user/images/Personas/personas_create.png b/docs/doxygen-user/images/Personas/personas_create.png new file mode 100644 index 0000000000..bacfb9e7c6 Binary files /dev/null and b/docs/doxygen-user/images/Personas/personas_create.png differ diff --git a/docs/doxygen-user/images/Personas/personas_create_account.png b/docs/doxygen-user/images/Personas/personas_create_account.png new file mode 100644 index 0000000000..17a89fffd8 Binary files /dev/null and b/docs/doxygen-user/images/Personas/personas_create_account.png differ diff --git a/docs/doxygen-user/images/Personas/personas_cvt_accounts.png b/docs/doxygen-user/images/Personas/personas_cvt_accounts.png new file mode 100644 index 0000000000..87a5a2755e Binary files /dev/null and b/docs/doxygen-user/images/Personas/personas_cvt_accounts.png differ diff --git a/docs/doxygen-user/images/Personas/personas_cvt_hover.png b/docs/doxygen-user/images/Personas/personas_cvt_hover.png new file mode 100644 index 0000000000..a16b6d8f71 Binary files /dev/null and b/docs/doxygen-user/images/Personas/personas_cvt_hover.png differ diff --git a/docs/doxygen-user/images/Personas/personas_main.png b/docs/doxygen-user/images/Personas/personas_main.png new file mode 100644 index 0000000000..071ba57227 Binary files /dev/null and b/docs/doxygen-user/images/Personas/personas_main.png differ diff --git a/docs/doxygen-user/images/Personas/personas_message.png b/docs/doxygen-user/images/Personas/personas_message.png new file mode 100644 index 0000000000..4d39e0aa41 Binary files /dev/null and b/docs/doxygen-user/images/Personas/personas_message.png differ diff --git a/docs/doxygen-user/main.dox b/docs/doxygen-user/main.dox index 0d808519cd..7180130389 100644 --- a/docs/doxygen-user/main.dox +++ b/docs/doxygen-user/main.dox @@ -71,6 +71,7 @@ The following topics are available here: - \subpage communications_page - \subpage geolocation_page - \subpage discovery_page + - \subpage personas_page - Reporting - \subpage tagging_page diff --git a/docs/doxygen-user/personas.dox b/docs/doxygen-user/personas.dox new file mode 100644 index 0000000000..839df4b828 --- /dev/null +++ b/docs/doxygen-user/personas.dox @@ -0,0 +1,107 @@ +/*! \page personas_page Personas + +\section personas_overview Overview + +Autopsy can store and organize account information based on personas, which represent an online identity. A person may have several online identities and therefore several personas. As an example, a single person may have a set of accounts that post online about loving cats and another set of accounts that appear unrelated that post about hating cats. + +\section personas_concepts Concepts + +Here are some basic concepts about persona: + + +Personas are stored in the Central Repository based on accounts that were found in results. These results are generated by various ingest modules such as the \ref recent_activity_page and \ref android_analyzer_page. + +Autopsy provides a dedicated tool, \ref personas_editor "Personas Editor", to create, view, edit, and delete personas. + +\section personas_editor Personas Editor + +The Personas Editor is loaded through the Tools -> Personas menu item. + +The left panel in the Personas Editor is a table that lists personas, based on the selected criteria. The right panel displays the details of selected persona. + +By default, when the Personas Editor is launched, all the personas in the Central Repository are listed in the table. You may filter this list by checking the "Filter personas by Keyword" checkbox. Type in either a persona name or an account identifier in the textbox and select the "Name" or "Account" radio button appropriately. Then click the "Show" button to show only the personas that match the filtering criteria. + +\image html Personas/personas_main.png + +\subsection personas_create Create Personas + +To create a new persona, click the "New Persona" button. A "Create Persona" dialog box will pop up. The following is a description of each field: + + + +Each persona needs at least one account associated with it. These accounts must have been previously saved to the \ref central_repo_page "central repository". Clicking "Add" under "Accounts" will bring up another dialog with four fields, all required: + + + +\image html Personas/personas_create.png + +When finished adding at least one account and filling in the required fields, click on OK to create the persona. A persona with the specified name will be created and associated with the specified account(s). + +\subsection personas_edit Edit Personas + +To edit a persona, click the "Edit Persona" button. You'll be able to edit all the data about the persona. + +\image html Personas/persona_edit.png + +\subsection personas_delete Delete Personas + +To delete a persona, select the persona in the table and click on the "Delete Persona" button. Click "Yes" on confirmation dialog to delete the selected persona. + +\subsection personas_account_create Create Account + +All personas must be associated with at least one account. Normally these account will be added to the central repository by various ingest modules, but you can also create them manually with the "Create Account" button. + +\image html Personas/personas_create_account.png + +\section personas_artifact_viewers Persona integration in Content Viewers + +Autopsy shows persona associated with accounts, where applicable. When viewing contact, call log and message results, Autopsy shows the personas associated with accounts in these panels. If no persona exists for an account, Autopsy provides a button for the user to create one. + +As shown below, when viewing a contact result you may see persona data. When one or more personas are found associated with the accounts in the result then the Persona name is shown in the contact content viewer. There will be a "View" button to see the details of the persona. + +\image html Personas/personas_contact_found.png + +If no matching persona is found, a "Create" button is shown to create a persona for the account(s). This will bring you to the \ref personas_create "Create Personas" panel with the account(s) already added. + +\image html Personas/personas_contact_not_found.png + +Personas are integrated similarly in the content viewers for call logs and messages/e-mail. + +\image html Personas/personas_calllog.png +
+\image html Personas/personas_message.png + +\section personas_cvt Persona Integration in the Communications Visualization Tool + +Personas are integrated with the \ref communications_page. When viewing accounts in the Accounts browsers in the Communications Visualization Tool, associated persona information is shown in the tooltip if you hover over the account. + +\image html Personas/personas_cvt_hover.png + +As in the Autopsy main window, you may also create or view personas when examining contacts, call logs, and messages in the Communications Visualization Tool. + +\image html Personas/personas_cvt_accounts.png + +*/ \ No newline at end of file