Ericsson Cassandra Audit - Common

A Cassandra audit plug-in for connections attempts and data access with support for whitelisting.

License

License

Categories

Categories

Cassandra Data Databases
GroupId

GroupId

com.ericsson.bss.cassandra.ecaudit
ArtifactId

ArtifactId

common_c3.0.11
Last Version

Last Version

2.3.0
Release Date

Release Date

Type

Type

jar
Description

Description

Ericsson Cassandra Audit - Common
A Cassandra audit plug-in for connections attempts and data access with support for whitelisting.
Project Organization

Project Organization

Ericsson AB

Download common_c3.0.11

How to add to project

<!-- https://jarcasting.com/artifacts/com.ericsson.bss.cassandra.ecaudit/common_c3.0.11/ -->
<dependency>
    <groupId>com.ericsson.bss.cassandra.ecaudit</groupId>
    <artifactId>common_c3.0.11</artifactId>
    <version>2.3.0</version>
</dependency>
// https://jarcasting.com/artifacts/com.ericsson.bss.cassandra.ecaudit/common_c3.0.11/
implementation 'com.ericsson.bss.cassandra.ecaudit:common_c3.0.11:2.3.0'
// https://jarcasting.com/artifacts/com.ericsson.bss.cassandra.ecaudit/common_c3.0.11/
implementation ("com.ericsson.bss.cassandra.ecaudit:common_c3.0.11:2.3.0")
'com.ericsson.bss.cassandra.ecaudit:common_c3.0.11:jar:2.3.0'
<dependency org="com.ericsson.bss.cassandra.ecaudit" name="common_c3.0.11" rev="2.3.0">
  <artifact name="common_c3.0.11" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.ericsson.bss.cassandra.ecaudit', module='common_c3.0.11', version='2.3.0')
)
libraryDependencies += "com.ericsson.bss.cassandra.ecaudit" % "common_c3.0.11" % "2.3.0"
[com.ericsson.bss.cassandra.ecaudit/common_c3.0.11 "2.3.0"]

Dependencies

compile (1)

Group / Artifact Type Version
net.openhft : chronicle-queue jar 4.16.5

test (4)

Group / Artifact Type Version
org.assertj : assertj-core jar 3.14.0
junit : junit jar 4.12
org.mockito : mockito-core jar 2.28.2
com.ericsson.bss.cassandra.ecaudit » test-utils_c3.0.11 jar 2.3.0

Project Modules

There are no modules declared in this project.

ecAudit

build coverage

With ecAudit you get auditing and query logger functionality for Apache Cassandra 2.2, 3.0 and 3.11.

Features include:

  • Detailed audit records for CQL operations and login attempts
  • Customizable audit record format
  • Obfuscation of sensitive password information
  • Powerful filtering with centralized or local whitelists
  • Logger backends with SLF4J/Logback or Chronicle

Example of audit records created by ecAudit:

15:42:41.644 - client:'127.0.0.1'|user:'cassandra'|status:'ATTEMPT'|operation:'INSERT INTO ecks.ectbl (partk, clustk, value) VALUES (?, ?, ?)[1, '1', 'valid']'
15:42:41.646 - client:'127.0.0.1'|user:'cassandra'|status:'ATTEMPT'|operation:'SELECT * FROM ecks.ectbl WHERE partk = ?[1]'
15:42:41.650 - client:'127.0.0.1'|user:'cassandra'|status:'ATTEMPT'|operation:'DELETE FROM ecks.ectbl WHERE partk = ?[1]'
15:42:41.651 - client:'127.0.0.1'|user:'cassandra'|status:'ATTEMPT'|operation:'INSERT INTO ecks.ectbl (partk, clustk, value) VALUES (?, ?, ?)[2, '2', 'valid']'
15:42:41.653 - client:'127.0.0.1'|user:'cassandra'|status:'ATTEMPT'|operation:'SELECT * FROM ecks.ectbl WHERE partk = ?[2]'
15:42:41.655 - client:'127.0.0.1'|user:'cassandra'|status:'ATTEMPT'|operation:'DELETE FROM ecks.ectbl WHERE partk = ?[2]'

Checkout the detailed description for a more comprehensive list of features, limitations and operational impact.

Getting Started

ecAudit integrates with Apache Cassandra using its existing plug-in points.

Download

Official releases of ecAudit can be downloaded from Maven Central. Get the ecAudit flavor for your Cassandra version.

ecAudit for Cassandra 3.11.<latest> ecAudit for Cassandra 3.0.<latest> ecAudit for Cassandra 2.2.<latest>

For a detailed description of compatible Cassandra versions, refer to the Cassandra Compatibility Matrix.

Maintenance

The following flavors of ecAudit are in maintenance mode and will get critical fixes, but no new features.

ecAudit for Cassandra 3.0.11

Setup

Install and configure ecAudit using the setup guide for your Cassandra version.

Issues & Contributions

Report an issue if you're having trouble to use ecAudit or have an idea for an improvement.

Want to contribute to ecAudit? Check out our contribution guide.

Credits

The following Ericsson developers contributed to the initial ecAudit project:

  • Per Otterström
  • Tobias Eriksson
  • Laxmikant Upadhyay
  • Anuj Wadhera
  • Marcus Olsson
  • Ted Petersson

License

Copyright 2018-20 Telefonaktiebolaget LM Ericsson

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

com.ericsson.bss.cassandra.ecaudit

Ericsson

Home for Ericsson's Open Source software

Versions

Version
2.3.0
2.2.2
2.2.1
2.1.0