Home Products Audit Mediator

Audit Mediator

5
1 reviews
663
Views
2
1
Details
Releases
Reviews
Issues
Pull requests
Videos
Articles
Object Script mediator to audit ObjectScript REST API requests

What's new in this version

Create event type on docker build and changes in readme to reflect this.

iris-api-audit-mediator

This is a ObjectScript Application to audit API methods requests.
Can be developed with Docker and VSCode,
can be deployed as ZPM module.

Installation for development

Clone/git pull the repo into any local directory e.g. like it is shown below (here I show all the examples related to this repository, but I assume you have your own derived from the template):

$ git clone git@github.com:yurimarx/iris-api-audit-mediator.git

Open the terminal in this directory and run:

$ docker-compose up -d --build

Installation with ZPM

zpm:USER>install iris-api-audit-mediator

How it Works

  1. Clone the project
$ git clone git@github.com:yurimarx/iris-api-audit-mediator.git
  1. Build and up the project source code
$ docker-compose up -d --build
  1. My project create the User Defined Audit Event on build into iris.script file, with the command:
Do ##class(Security.Events).Create("RESTAPI","Request","RESTAPI","REST API Requests")
  1. Go to Management Portal -> System Administration -> Security -> Auditing -> Configure User Events
  2. See my event created, with:
  3. Set Event Source: RESTAPI
  4. Set Event Type: Request
  5. Set Event Name: RESTAPI
  6. In this case is not necessary, but if you need create other audit events with other types and names, use the button Create New Event
  7. Populate your Person app with data, call the endpoint http://localhost:52773/crud/persons/populate
  8. Now, call http://localhost:52773/crud/persons/all, or any other endpoint
  9. This request will be registered into Audit database
  10. Now Go to Management Portal -> System Administration -> Security -> Auditing -> View Auditing Database
  11. Looking for rows with Event Source RESTAPI and Event Type Request and click Detail to see audit record details.
  12. Enjoy!

Future features

  1. Config custom audit messages

Thanks to:

  1. Robert Cemper: beta tester
  2. Evgeny Shvarov: iris-rest-api-template was the base to this app
Made with
Install
zpm install iris-api-audit-mediator download archive
Version
1.0.301 Dec, 2021
Category
Solutions
Works with
InterSystems IRISInterSystems IRIS for Health
First published
23 Nov, 2021