Difference between revisions of "Audit Web Services"

From Fusion Registry Wiki
Jump to navigation Jump to search
(Audited Structure Events)
Line 8: Line 8:
 
= Audited Structure Events =
 
= Audited Structure Events =
  
== Request ==
+
== Search Transaction ==
List all the supported endpoints.  This is used by Fusion Portal to enable the user to select an endpoint type.
+
Search structure transactions
  
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
|style="background-color:#eaecf0"|<b>Entry Point</b>|| <b> /ws/secure/audit/getDetailsByTransactionId</b>
+
|style="background-color:#eaecf0"|<b>Entry Point</b>|| <b> /ws/registry/tx/searchTransactions</b>
 
|-
 
|-
|style="background-color:#eaecf0"|<b>Access</b>|| <span style='color:red'><b>Restricted to '''Portal Manager'''</b></span>
+
|style="background-color:#eaecf0"|<b>Access</b>|| <span style='color:red'><b>Restricted to '''Audit Manager, Structure Manager, Portal Manager'''</b></span>
 
|-
 
|-
 
|style="background-color:#eaecf0"|<b>Http Method</b>|| GET  
 
|style="background-color:#eaecf0"|<b>Http Method</b>|| GET  
 
|}
 
|}
  
 +
{| class="wikitable"
 +
|+ Query Parameters
 +
|-
 +
! Parameter !! Required !! Description
 +
|-
 +
| dateFrom || no ||  transaction date from in [[SDMX_Time_Formats|SDMX date format]]
 +
|-
 +
| dateTo || no ||  transaction date to in [[SDMX_Time_Formats|SDMX date format]]
 +
|-
 +
| max || no ||  the maximum number of results
 +
|-
 +
| user || no ||  Username of user which initiated the transaction
 +
|-
 +
| orderDesc || no || Order results in date descending order
 +
|}
 +
 +
=== Response ===
 +
A JSON array of audited transactions 
 +
  [
 +
    {
 +
      "Date": 1645027254245,
 +
      "Id": 53,
 +
      "User": "root",
 +
      "Action": "Replace",
 +
      "Type": "Structure Submission"
 +
    },...
 +
  ]
  
 +
== Audit Details for Transaction ==
 +
Return the audit details for a transaction. The transaction ID can be obtained from the RSS feed, or from the results of the '''searchTransactions''' API
 +
 +
{| class="wikitable"
 +
|-
 +
|style="background-color:#eaecf0"|<b>Entry Point</b>|| <b> /ws/secure/audit/getDetailsByTransactionId</b>
 +
|-
 +
|style="background-color:#eaecf0"|<b>Access</b>|| <span style='color:red'><b>Restricted to '''Audit Manager, Structure Manager, Portal Manager'''</b></span>
 +
|-
 +
|style="background-color:#eaecf0"|<b>Http Method</b>|| GET
 +
|}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 30: Line 68:
 
|}
 
|}
  
 +
== Response ==
 +
A JSON response in the following format:
  
 
 
 
== Response Format ==
 
 
  {
 
  {
 
     "UID": "6d6ef80c-d19f-4506-94cb-05e53ebd06e1",
 
     "UID": "6d6ef80c-d19f-4506-94cb-05e53ebd06e1",

Revision as of 11:13, 16 February 2022

Overview

Fusion Registry 11 provides 2 main audit functions

  1. Audit of structure events, including data registrations
  2. System audits, example Fusion Portal events

Audited Structure Events

Search Transaction

Search structure transactions

Entry Point /ws/registry/tx/searchTransactions
Access Restricted to Audit Manager, Structure Manager, Portal Manager
Http Method GET
Query Parameters
Parameter Required Description
dateFrom no transaction date from in SDMX date format
dateTo no transaction date to in SDMX date format
max no the maximum number of results
user no Username of user which initiated the transaction
orderDesc no Order results in date descending order

Response

A JSON array of audited transactions

 [
   {
     "Date": 1645027254245,
     "Id": 53,
     "User": "root",
     "Action": "Replace",
     "Type": "Structure Submission"
   },...
 ]

Audit Details for Transaction

Return the audit details for a transaction. The transaction ID can be obtained from the RSS feed, or from the results of the searchTransactions API

Entry Point /ws/secure/audit/getDetailsByTransactionId
Access Restricted to Audit Manager, Structure Manager, Portal Manager
Http Method GET
Query Parameters
Parameter Required Description
id yes Transaction Id

Response

A JSON response in the following format:

{
   "UID": "6d6ef80c-d19f-4506-94cb-05e53ebd06e1",
   "TxId": 1,
   "Type": "Structure Submission",
   "ServerName": "localhost",
   "VMID": "g6ee3edeb60c835d:55ba23af:19df811c3be:-8000",
   "MachineId": "DESKTOP-E6MP45C/192.168.4.70",
   "ServerContext": "/FusionRegistry",
   "ServletPath": "/ws/registry",
   "ServerPort": 8080,
   "PathInfo": "/json/save",
   "Parameters": "",
   "Protocol": "HTTP/1.1",
   "AcceptHeaders": "application/json, text/javascript, */*; q=0.01",
   "AcceptLanguage": "en-US,en;q=0.9",
   "SubmissionMethod": "POST",
   "HttpResponseStatus": 200,
   "RequestTime": 1644827120293,
   "Duration": 385,
   "Username": "root",
   "RequestIP": "0:0:0:0:0:0:0:1",
   "ProductVersion": "11.0.0.13",
   "UserAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.82 Safari/537.36",
   "BrowserName": "Chrome",
   "BrowserVersion": "98",
   "OS": "Windows 10"
 }