TrinoDB - Guardium Logstash filter plug-in
Meet TrinoDB
- Tested versions: v1
- Environment: Trino DB
- Supported inputs: http (pull)
- Supported Guardium versions:
- Guardium Data Protection 12.0 patch 5005 and above
- Guardium Data Protection 12.1 patch 5005 and above
- Guardium Data Protection 12.2 and above
This is a Logstash filter plug-in for the universal connector that is featured in IBM Security Guardium. It parses events and messages from the Trino audit log into a Guardium Record.
The plug-in is free and open-source (Apache 2.0). It can be used as a starting point to develop additional filter plug-ins for Guardium universal connector.
1. Configuring ONPREM TRINO
Procedure
1. Create a database instance:
a.Here, We will consider that we have already installed TrinoDB ONPREM setup.
See: TrinoDB Install Offical Documentation
Enabling Audit Logs
requirements
- Provide an HTTP/S service that accepts POST events with a JSON body.
- Configure http-event-listener.connect-ingest-uri in the event listener properties file with the URI of the service.
- Detail the events to send in the Configuration section.
Procedure
-
Log into Trino server
-
Trino application logging is optional and configured in the
log.propertiesfile in your Trino installationetcconfiguration directory as set by the launcher. See: loggingetc/log.properties
io.trino=INFO io.trino.plugin.hive=DEBUG io.trino.event.QueryMonitor=DEBUG io.trino.execution.SqlTask=DEBUG
-
set
etc/http-event-listener.propertiesSee: http-event-listeneretc/http-event-listener.properties
event-listener.name=http http-event-listener.connect-ingest-uri=http://guardium_IP:5060 http-event-listener.log-created=true http-event-listener.log-completed=true http-event-listener.log-split=false
-
add
etc/http-event-listener.propertiestoevent-listener.config-fileson config.properties file refer Config propertiesetc/config.properties
event-listener.config-files=etc/http-event-listener.properties
Guardium Data Protection
The Guardium universal connector is the Guardium entry point for native audit/data_access logs. The Guardium universal connector identifies and parses the received events, and converts them to a standard Guardium format. The output of the Guardium universal connector is forwarded to the Guardium sniffer on the collector, for policy and auditing enforcements.
Before you begin
- Configure the policies you require. See policies for more information.
- You must have permission for the S-Tap Management role. The admin user includes this role by default
- Download the logstash-filter-trino_guardium_filter plug-in.
- Verify that the http input plugin is available on the GDP system.
Procedure
- On the collector, go to
Setup>Tools and Views>Configure Universal Connector. - Enable the universal connector if it is disabled.
- Click
Upload Fileand select the offline logstash-filter-trino_guardium_filter plug-in. After it is uploaded, clickOK. - Click the Plus sign to open the Connector Configuration dialog box.
- Type a name in the Connector name field.
- Update the input section to add the details from the TrinoOverHttp.conf file's input part, omitting the keyword "input{" at the beginning and its corresponding "}" at the end.
- Update the filter section to add the details from the TrinoOverHttp.conf file's filter part, omitting the keyword "filter{" at the beginning and its corresponding "}" at the end.
- The 'type' fields should match in the input and filter configuration sections. This field should be unique for every individual connector added.
- Click
Save. Guardium validates the new connector and displays it in the Configure Universal Connector page. - After the offline plug-in is installed and the configuration is uploaded and saved in the Guardium machine, restart
the Universal Connector using the
Disable/Enablebutton.
Limitations
• Client Hostname and Source Program will be seen as blank in report.