Submit application

Audit Mediator

Downloads10
Subscribe
1
Bookmark
1
Details
Releases
Reviews
Issues
Provider

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
ZPM installation
zpm "install iris-api-audit-mediator"
Rating
5 (1)
Category
Solutions
Works with
InterSystems IRISInterSystems IRIS for Health
Tags
Info
Publisher
Visum Consult
Version
1.0.3
Last updated
2021-12-01
Repository
Open
Documentation
Open
License
Link