{"id":802,"date":"2020-05-26T09:45:37","date_gmt":"2020-05-26T09:45:37","guid":{"rendered":"https:\/\/int64software.com\/blog\/?p=802"},"modified":"2020-05-26T09:45:38","modified_gmt":"2020-05-26T09:45:38","slug":"generating-a-history-report-in-overlaps","status":"publish","type":"post","link":"https:\/\/int64software.com\/blog\/2020\/05\/26\/generating-a-history-report-in-overlaps\/","title":{"rendered":"Generating a History Report in OVERLAPS"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">OVERLAPS has received a new reporting tool to help with your security auditing and monitoring processes. With the release of update 2.1.1.0 you can now export your OVERLAPS History Log with the new &#8220;History Report Tool&#8221; (historyreport.exe) which can be found with the application files.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The History Report Tool can export this data to any of three file formats:<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>Adobe PDF for pre-prepared and formatted reports<\/li><li>Rich Text Format (RTF) which is compatible with most word processing applications<\/li><li>Comma-Separated Value File (CSV) which can be imported into most spreadsheet software<\/li><\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Running the History Report Tool for OVERLAPS<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The tool is launched from a command line by providing some required and optional parameters which are detailed below.<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/int64software.com\/blog\/wp-content\/uploads\/2020\/05\/commandline.jpg\" alt=\"History Report Tool command line\" class=\"wp-image-803\" width=\"600\" height=\"15\" srcset=\"https:\/\/int64software.com\/blog\/wp-content\/uploads\/2020\/05\/commandline.jpg 800w, https:\/\/int64software.com\/blog\/wp-content\/uploads\/2020\/05\/commandline-300x8.jpg 300w, https:\/\/int64software.com\/blog\/wp-content\/uploads\/2020\/05\/commandline-768x19.jpg 768w\" sizes=\"auto, (max-width: 600px) 100vw, 600px\" \/><figcaption>History Report Tool command line<\/figcaption><\/figure><\/div>\n\n\n\n<h3 class=\"wp-block-heading\">Required Parameters<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">You must specify at least one of the arguments <strong>\u201c\/pdf\u201d<\/strong>, <strong>\u201c\/rtf\u201d<\/strong> or <strong>\u201c\/csv\u201d<\/strong> and follow it with a valid path and filename to save the requested report to.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">To get help, you can instead pass the argument <strong>\u201c\/help\u201d<\/strong> or <strong>\u201c\/?\u201d<\/strong> to see more information.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Optional Parameters<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The following arguments are optional, but can be specified to gain greater control over the exported data.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/db &lt;filename.sqlite><\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">If your database is in a non-standard location, or you want to access it from a network share, specify the path and filename of your database using this parameter.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/date &lt;date><\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Give a valid date format (for example \u201cDD\/MM\/YY\u201d or \u201cMM\/DD\/YY\u201d depending on your system locale) to only export history logs from that date.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">An incorrectly formatted date will show an error, but continue to export all logs instead.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p>Note: If using a date format with spaces (e.g. \u201c31 Jan 2020\u201d), always enclose the date in quotes.<\/p><\/blockquote>\n\n\n\n<h4 class=\"wp-block-heading\">\/find &lt;search term><\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Search the logs for a specific username, computer name, etc.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/action &lt;action><\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Limit the results to a specific action. This argument can be added multiple times to specify multiple actions. For a full list of actions, run \u201chistoryreport.exe \/actions\u201d or consult the list below.<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>Login<\/li><li>Logout<\/li><li>Read<\/li><li>ReadRequest<\/li><li>Reset<\/li><li>ResetRequest<\/li><li>SelfServiceRead<\/li><li>AuthoriseRead<\/li><li>AuthoriseReset<\/li><li>DenyRead<\/li><li>DenyReset<\/li><li>ModifyConfig<\/li><li>AddUser<\/li><li>EditUser<\/li><li>RemoveUser<\/li><\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">\/limit &lt;number><\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Only output up to this number of results. Defaults to 10000.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/fndate<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Append the current date and time to the filename.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/format &lt;paper size><\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">(Only valid for PDF and RTF) Format the document paper size. Defaults to A4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Valid values are: A0 to A6, B5, Ledger, Legal or Letter.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/landscape<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">(Only valid for PDF and RTF) Orient the page in landscape layout.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">History Report Tool Output<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">If successful, the History Report Tool will show you the name of the generated file.<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"420\" height=\"70\" src=\"https:\/\/int64software.com\/blog\/wp-content\/uploads\/2020\/05\/commandline-output.jpg\" alt=\"Successfully generated a PDF file with appended date and time\" class=\"wp-image-805\" srcset=\"https:\/\/int64software.com\/blog\/wp-content\/uploads\/2020\/05\/commandline-output.jpg 420w, https:\/\/int64software.com\/blog\/wp-content\/uploads\/2020\/05\/commandline-output-300x50.jpg 300w\" sizes=\"auto, (max-width: 420px) 100vw, 420px\" \/><figcaption>Successfully generated a PDF file with appended date and time<\/figcaption><\/figure><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Below we have included an example of a generated PDF file.<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"995\" height=\"251\" src=\"https:\/\/int64software.com\/blog\/wp-content\/uploads\/2020\/05\/pdf-view-e.jpg\" alt=\"Example PDF Report from the History Report Tool\" class=\"wp-image-806\" srcset=\"https:\/\/int64software.com\/blog\/wp-content\/uploads\/2020\/05\/pdf-view-e.jpg 995w, https:\/\/int64software.com\/blog\/wp-content\/uploads\/2020\/05\/pdf-view-e-300x76.jpg 300w, https:\/\/int64software.com\/blog\/wp-content\/uploads\/2020\/05\/pdf-view-e-768x194.jpg 768w\" sizes=\"auto, (max-width: 995px) 100vw, 995px\" \/><figcaption>Example PDF Report from the History Report Tool<\/figcaption><\/figure><\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Automation<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Using the above command line parameters, it is incredibly easy to setup a Windows Scheduled Task to run this report periodically and output the result to a network share.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The report will not contain any user or system passwords, but may contain identifying information, so please make sure that you observe Data Protection laws in your country before making the reports available to others.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Feature Requests<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Like many of the expanded features added to OVERLAPS in the previous couple of years, this tool is the direct result of a request from one or more of our valued customers.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">We cannot express enough how grateful we are to those of you who take the time to let us know where we can improve, or what tweaks or features we can add to make your lives easier.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If you have an idea for something OVERLAPS related, we want to hear about it. You can contact us via the <a rel=\"noreferrer noopener\" href=\"https:\/\/int64software.com\/overlaps\/#contact\" target=\"_blank\">form on the OVERLAPS website<\/a>. We genuinely read and carefully consider each suggestion we receive, and as a result OVERLAPS has grown and been improved immeasurably over the years.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>OVERLAPS has received a new reporting tool to help with your security auditing and monitoring processes. With the release of update 2.1.1.0 you can now export your OVERLAPS History Log with the new &#8220;History Report Tool&#8221; (historyreport.exe) which can be found with the application files.<\/p>\n","protected":false},"author":1,"featured_media":806,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_crdt_document":"","footnotes":""},"categories":[16],"tags":[48,40,8],"class_list":["post-802","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-overlaps","tag-microsoft-laps","tag-tool","tag-tutorial"],"_links":{"self":[{"href":"https:\/\/int64software.com\/blog\/wp-json\/wp\/v2\/posts\/802","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/int64software.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/int64software.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/int64software.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/int64software.com\/blog\/wp-json\/wp\/v2\/comments?post=802"}],"version-history":[{"count":3,"href":"https:\/\/int64software.com\/blog\/wp-json\/wp\/v2\/posts\/802\/revisions"}],"predecessor-version":[{"id":808,"href":"https:\/\/int64software.com\/blog\/wp-json\/wp\/v2\/posts\/802\/revisions\/808"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/int64software.com\/blog\/wp-json\/wp\/v2\/media\/806"}],"wp:attachment":[{"href":"https:\/\/int64software.com\/blog\/wp-json\/wp\/v2\/media?parent=802"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/int64software.com\/blog\/wp-json\/wp\/v2\/categories?post=802"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/int64software.com\/blog\/wp-json\/wp\/v2\/tags?post=802"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}