aker

SSH bastion/jump host/jumpserver

Showing:

Popularity

Downloads/wk

0

GitHub Stars

536

Maintenance

Last Commit

8mos ago

Contributors

9

Package

Dependencies

0

License

Categories

Readme

Join the chat at https://gitter.im/Akergateway/Aker

Aker SSH Gateway

alt text

What is Aker?

Aker is a security tool that helps you configure your own Linux ssh jump/bastion host. Named after an Egyptian mythology deity who guarded the borders, Aker would act as choke point through which all your sysadmins and support staff access Linux production servers. Aker SSH gateway includes a lot of security features that would help you manage and administer thousands of Linux servers at ease. For a detailed look check our Wiki

Motivation

I couldn't find an open source tool similar to CryptoAuditor and fudo, such tools are beneficial if you're seeking becoming PCI-DSS or HIPAA compliant for example, regardless of security standards compliance access to the server should be controlled and organized in a way convenient to both traditional and cloud workloads.

Current Featuers

  • Supports FreeIPA 4.2 , 4.3 and 4.4 (Optional)
  • Extensible, Write Your Own Module
  • Session Playback
  • Extract Session Commands
  • SIEM-Ready json Session Logs
  • Elasticsearch Integration

Roadmap

  • Phase 0
    • Integration with an identity provider (FreeIPA)
    • Extendable Modular structure, plugin your own module
    • Integration with config management tools
    • Parsable audit logs (json, shipped to Elasticsearch)
    • Highly available setup
    • Session playback
  • Phase 1

    • Admin WebUI
    • Live session monitoring
    • Cloud support (AWS,OpenStack etc..) or On-premises deployments
    • Command filtering (Prevent destructive commands like rm -rf)
    • Encrypt sessions logs stored on disk.
  • Phase 2

    • Support for graphical protocols (RDP, VNC, X11) monitoring
    • User productivity dashboard

See it in action

Aker - in action

Requirements

Software:

  • Linux (Tested on CentOS, Fedora and ubuntu)
  • Python (Tested on 2.7)
  • (Optional) FreeIPA, Tested on FreeIPA 4.2 & 4.3
  • redis

Python Modules:

  • configparser
  • urwid
  • paramiko
  • wcwidth
  • pyte
  • redis

Installation

  • Manually:
  • Aker can be setup on a FreeIPA client or indepentantly using json config file.

    • Common Steps (FreeIPA or Json):

      • Clone the repo
      git clone https://github.com/aker-gateway/Aker.git /usr/bin/aker/
      
      • Install dependencies (adapt for Ubuntu)
        yum -y install epel-release 
        yum -y install python2-paramiko python-configparser python-redis python-urwid python2-wcwidth redis
        
    * Set files executable perms
      ```
      chmod 755 /usr/bin/aker/aker.py
      chmod 755 /usr/bin/aker/akerctl.py
      ```

    * Setup logdir and perms
      ```
      mkdir /var/log/aker
      chmod 777 /var/log/aker
      touch /var/log/aker/aker.log
      chmod 777 /var/log/aker/aker.log
      ```

    * Enforce aker on all users but root, edit sshd_config
      ~~~
      Match Group *,!root
      ForceCommand /usr/bin/aker/aker.py
      ~~~

    * Restart ssh
    * Restart redis



* Choosing FreeIPA:
    * Assumptions:
        * Aker server already enrolled to FreeIPA domain
    
    * Create /etc/aker and copy /usr/bin/aker/aker.ini in it and edit it like below :

          ```
          [General]
          log_level = INFO
          ssh_port = 22

          # Identity Provider to determine the list of available hosts
          # options shipped are IPA, Json. Default is IPA
          idp = IPA
          hosts_file = /etc/aker/hosts.json

          # FreeIPA hostgroup name contatining Aker gateways
          # to be excluded from hosts presented to user
          gateway_group = gateways
          ```



* Choosing Json:
    * Create /etc/aker and copy /usr/bin/aker/aker.ini in it and edit it like below :

          ```
          [General]
          log_level = INFO
          ssh_port = 22

          # Identity Provider to determine the list of available hosts
          # options shipped are IPA, Json. Default is IPA
          idp = Json
          hosts_file = /etc/aker/hosts.json

          # FreeIPA hostgroup name contatining Aker gateways
          # to be excluded from hosts presented to user
          gateway_group = gateways
          ```
          
      * Edit /etc/aker/hosts.json to add users and hosts, a sample `hosts.json` file is provided .
        

Contributing

Currently I work on the code in my free time, any assistance is highly appreciated. Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100