https://github.com/realaravinth/ids-matrix

An Intrusion Detection System built on top of matrix
https://github.com/realaravinth/ids-matrix

intrusion-detection-system matrix-org pam-authentication pam-module rust-lang

Last synced: 28 days ago
JSON representation

An Intrusion Detection System built on top of matrix

• Host: GitHub
• URL: https://github.com/realaravinth/ids-matrix
• Owner: realaravinth
• License: gpl-2.0
• Created: 2020-06-21T14:36:30.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2022-03-10T16:04:29.000Z (almost 3 years ago)
• Last Synced: 2024-11-06T04:41:02.564Z (3 months ago)
• Topics: intrusion-detection-system, matrix-org, pam-authentication, pam-module, rust-lang
• Language: Rust
• Homepage:
• Size: 20.5 KB
• Stars: 0
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Build Status](https://travis-ci.com/realaravinth/ids-matrix.svg?branch=master)](https://travis-ci.com/realaravinth/ids-matrix)

[![License: GPL v2](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)

[![dependency status](https://deps.rs/repo/github/realaravinth/ids-matrix/status.svg?style=flat-square)](https://deps.rs/repo/github/realaravinth/ids-matrix)

# ids-matrix

A lightweight Intrusion Detection System built on top of matrix





**WARNING: `realaravinth/ids-matrix` comes with ABSOLUTELY NO WARRANY, to the extent permitted by applicable law.**





The instructions provided here are for the Debian(Buster) GNU/Linux, however it can be modified to work with other distrubtions as well.

It uses `pam_exec` to collect login information so kindly refer to your distribution's guide if this guide doesn't work.

## Table of contents:

- [Dependencies:](#dependencies)

- [How to compile](#how-to-compile)

- [Installation](#installation)

- [Contributions](#contributions)

## Dependencies

  * libpam-modules

  * coreutils(uses `date` and `uname`)[optional]

  * net-tools(uses `hostname`)[optional]


  * rust(to compile)

  *optional: you can remove parts of the code if you wish to not to install the optional dependencies*

## How to compile

  1. `cd` into source directory

  2. edit src/main.rs and fill

    * `server`: url of your matrix server

    * `access_token`: access token of your matrix account(create new one with least priveleges)

    * `room_id`: room ID of the room where you want to publish the updates

  3. `cargo build --release`

    This compiles the program and places the binary in `target/release` directory

## Installation

  

  1. Place `ids-matrix` binary in `/usr/local/bin` of your server

  2. Append the following to `/etc/pam.d/sshd`(always take backup of the original config):


    `session optional pam_exec.so /usr/local/bin/ids-matrix`

    

## Contributions

Yes please! Fork this repo and send in PRs, I'll be happy to review and merge them!