bifroest

README

Enity's Bifröst

Bifröst (speaken as "Beef-roest"), is an advanced SSH server. It can be used as a drop-in-replacement for OpenSSH Server, but it was actually created with some more advanced stuff in mind; see below.

TOC

• Features
• Installation
• State
• Contributing
• License

Features

1. SSH protocol complaint
2. OpenID Connect
3. Remember me

SSH protocol complaint

Fully SSH protocol compliant server, like you would expect.

OpenID Connect

You can connect via your SSH keys, as usually. And so on...

...but you can also use OpenID Connect (or OAuth2) identity provider. The best thing about this is: In contrast to the other SSH servers with OpenID Connect, you don't need any other client locally installed, than your regular SSH Client (OpenSSH, PuTTy, ...).

Remember me

If authorized via another authentication token then a Public Key, it can store (temporally) your provided Public Key, for faster reconnect, while the session is still alive.

More to come...

Installation

1. Download the latest version of Bifröst (see releases page):

   # Syntax
   curl -sSLf https://github.com/engity-com/bifroest/releases/download/<version>/bifroest-<os>-<arch>-<edition>.tgz | sudo tar -zxv -C /usr/bin bifroest
   
   # Example
   curl -sSLf https://github.com/engity-com/bifroest/releases/download/v1.2.3/bifroest-linux-amd64-extended.tgz | sudo tar -zxv -C /usr/bin bifroest
   

2. Configure Bifröst. For example download the demo configuration and adjust for your needs (see our demo configuration for the documentation about it):

   sudo mkdir -p /etc/engity/bifroest/
   sudo curl -sSLf https://raw.githubusercontent.com/engity-com/bifroest/main/doc/demo-configuration.yaml -o /etc/engity/bifroest/configuration.yaml
   # Adjust it to your needs
   sudo vi /etc/engity/bifroest/configuration.yaml
   

3. Run Bifröst:

   sudo bifroest run
   

State

This project is currently still in the development phase. We do guarantee a stable application (file a bug once you finde one) but not an 100% stable configuration/command/API structure.

Contributing

Enity's Bifröst is an open source project by Engity GmbH. So if you want to make this project even better, you can contribute to this project on Github by fork us.

If you commit code to this project, you have to accept that this code will be released under the license of this project.

License

See the LICENSE file.