Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix some dead links #41

Merged
1 commit merged into from
Jan 27, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/blog/2020/11/25/the-road-to-0-4.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ image: images/blog/the-road-to-0-4/preview.png
# The road to ContainerSSH 0.4: modularized structure, audit logging, and more
<div class="blog-meta"><small>November 25, 2020</small></div>

After a rapid rush of releases this summer we have announced that version 0.4.0 would have a long-awaited feature: [detailed audit logging](/reference/audit.md). This feature would allow for a forensic reconstruction of an SSH session. The use cases for this are diverse: from building honeypots to securing a corporate environment. We even published a [preview release](https://github.com/ContainerSSH/ContainerSSH/releases/tag/0.4.0-PR1) for test driving this feature. We even implemented an automatic upload for the audit logs to an S3-compatible object storage. So, what happened? **Why isn't 0.4.0 released yet?**
After a rapid rush of releases this summer we have announced that version 0.4.0 would have a long-awaited feature: [detailed audit logging](/reference/audit). This feature would allow for a forensic reconstruction of an SSH session. The use cases for this are diverse: from building honeypots to securing a corporate environment. We even published a [preview release](https://github.com/ContainerSSH/ContainerSSH/releases/tag/0.4.0-PR1) for test driving this feature. We even implemented an automatic upload for the audit logs to an S3-compatible object storage. So, what happened? **Why isn't 0.4.0 released yet?**

The delay has everything to do with *maintainability*. The PR-1 implementation of the audit logging was built right into ContainerSSH causing a deluge of code changes. While it technically worked, it blew up the code in size and made features extremely hard to test. Look at [this code, for example](https://github.com/ContainerSSH/ContainerSSH/blob/0.4.0-PR1/ssh/server/server.go#L231). The actual authentication code dwarfs in comparison to the audit logging parts. You could say, the code violates the [Single Responsibility Principle](https://en.wikipedia.org/wiki/Single-responsibility_principle). There is no way we could retrofit component-level tests into this.

Expand All @@ -23,4 +23,4 @@ Another idea is to build in [PAM authentication](https://github.com/ContainerSSH

If you like these ideas please comment on the issues linked above and [let us know about your use case](https://github.com/ContainerSSH/ContainerSSH/issues).

**So, when is `0.4` coming out?** We don't know yet. Our *plan is early next year*, but our focus in this release is stability.
**So, when is `0.4` coming out?** We don't know yet. Our *plan is early next year*, but our focus in this release is stability.
8 changes: 4 additions & 4 deletions docs/downloads/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,14 +45,14 @@

| Version | Container | Linux | Windows | MacOS | FreeBSD | Manual |
|---------|-----------|-------|---------|-------|---------|--------|
| 0.4.0<br />Apr 1, 2021 | `containerssh/containerssh:0.4.0` | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.4.0/containerssh_0.4.0_linux_amd64.tar.gz)<br />[.deb](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.4.0/containerssh_0.4.0_linux_amd64.deb)<br />[.rpm](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.4.0/containerssh_0.4.0_linux_amd64.rpm)<br />[.apk](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.4.0/containerssh_0.4.0_linux_amd64.apk) | [.zip](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.4.0/containerssh_0.4.0_windows_amd64.zip) | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.4.0/containerssh_0.4.0_darwin_amd64.tar.gz) | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.4.0/containerssh_0.4.0_freebsd_amd64.tar.gz) | [Read »](/reference/0.4.0/index.md) |
| 0.3.1<br />Oct 23, 2020 | `containerssh/containerssh:0.3.1` | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.3.1/containerssh_0.3.1_linux_amd64.tar.gz)<br />[.deb](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.3.1/containerssh_0.3.1_linux_amd64.deb)<br />[.rpm](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.3.1/containerssh_0.3.1_linux_amd64.rpm) | [.zip](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.3.1/containerssh_0.3.1_windows_amd64.zip) | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.3.1/containerssh_0.3.1_darwin_amd64.tar.gz) | | [Read »](/reference/0.3/index.md) |
| 0.3.0<br />Oct 21, 2020 | `containerssh/containerssh:0.3.0` | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.3.0/containerssh_0.3.0_linux_amd64.tar.gz)<br />[.deb](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.3.0/containerssh_0.3.0_linux_amd64.deb)<br />[.rpm](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.3.0/containerssh_0.3.0_linux_amd64.rpm) | [.zip](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.3.0/containerssh_0.3.0_windows_amd64.zip) | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.3.0/containerssh_0.3.0_darwin_amd64.tar.gz) | | [Read »](/reference/0.3/index.md) |
| 0.4.0<br />Apr 1, 2021 | `containerssh/containerssh:0.4.0` | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.4.0/containerssh_0.4.0_linux_amd64.tar.gz)<br />[.deb](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.4.0/containerssh_0.4.0_linux_amd64.deb)<br />[.rpm](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.4.0/containerssh_0.4.0_linux_amd64.rpm)<br />[.apk](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.4.0/containerssh_0.4.0_linux_amd64.apk) | [.zip](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.4.0/containerssh_0.4.0_windows_amd64.zip) | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.4.0/containerssh_0.4.0_darwin_amd64.tar.gz) | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.4.0/containerssh_0.4.0_freebsd_amd64.tar.gz) | [Read »](/reference/0.4.0) |
| 0.3.1<br />Oct 23, 2020 | `containerssh/containerssh:0.3.1` | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.3.1/containerssh_0.3.1_linux_amd64.tar.gz)<br />[.deb](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.3.1/containerssh_0.3.1_linux_amd64.deb)<br />[.rpm](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.3.1/containerssh_0.3.1_linux_amd64.rpm) | [.zip](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.3.1/containerssh_0.3.1_windows_amd64.zip) | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.3.1/containerssh_0.3.1_darwin_amd64.tar.gz) | | [Read »](/reference/0.3) |
| 0.3.0<br />Oct 21, 2020 | `containerssh/containerssh:0.3.0` | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.3.0/containerssh_0.3.0_linux_amd64.tar.gz)<br />[.deb](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.3.0/containerssh_0.3.0_linux_amd64.deb)<br />[.rpm](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.3.0/containerssh_0.3.0_linux_amd64.rpm) | [.zip](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.3.0/containerssh_0.3.0_windows_amd64.zip) | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.3.0/containerssh_0.3.0_darwin_amd64.tar.gz) | | [Read »](/reference/0.3) |
| 0.2.2<br />Aug 2, 2020 | | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.2.2/containerssh_0.2.2_linux_amd64.tar.gz)<br />[.deb](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.2.2/containerssh_0.2.2_linux_amd64.deb)<br />[.rpm](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.2.2/containerssh_0.2.2_linux_amd64.rpm) | [.zip](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.2.2/containerssh_0.2.2_windows_amd64.zip) | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.2.2/containerssh_0.2.2_darwin_amd64.tar.gz) | | |
| 0.2.1<br />Jul 30, 2020 | | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.2.1/containerssh_0.2.1_linux_amd64.tar.gz)<br />[.deb](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.2.1/containerssh_0.2.1_linux_amd64.deb)<br />[.rpm](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.2.1/containerssh_0.2.1_linux_amd64.rpm) | [.zip](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.2.1/containerssh_0.2.1_windows_amd64.zip) | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.2.1/containerssh_0.2.1_darwin_amd64.tar.gz) | | |
| 0.2.0<br />Jul 9, 2020 | | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.2.0/containerssh_0.2.0_linux_amd64.tar.gz)<br />[.deb](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.2.0/containerssh_0.2.0_linux_amd64.deb)<br />[.rpm](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.2.0/containerssh_0.2.0_linux_amd64.rpm) | [.zip](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.2.0/containerssh_0.2.0_windows_amd64.zip) | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.2.0/containerssh_0.2.0_darwin_amd64.tar.gz) | | |
| 0.1.1<br />Jul 9, 2020 | | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.1.1/containerssh_0.1.1_linux_amd64.tar.gz)<br />[.deb](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.1.1/containerssh_0.1.1_linux_amd64.deb)<br />[.rpm](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.1.1/containerssh_0.1.1_linux_amd64.rpm) | [.zip](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.1.1/containerssh_0.1.1_windows_amd64.zip) | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.1.1/containerssh_0.1.1_darwin_amd64.tar.gz) | | |
| 0.1.0<br />Jun 18, 2020 | | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.1.0/containerssh_0.1.0_linux_amd64.tar.gz)<br />[.deb](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.1.0/containerssh_0.1.0_linux_amd64.deb)<br />[.rpm](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.1.0/containerssh_0.1.0_linux_amd64.rpm) | [.zip](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.1.0/containerssh_0.1.0_windows_amd64.zip) | [.tar.gz](https://github.com/ContainerSSH/ContainerSSH/releases/download/0.1.0/containerssh_0.1.0_darwin_amd64.tar.gz) | | |

!!! note
Container images that no longer have pulls have been removed to conserve resources.
Container images that no longer have pulls have been removed to conserve resources.
2 changes: 1 addition & 1 deletion docs/getting-started/authserver.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,4 +49,4 @@ Your server will need to respond with the following JSON:
!!! tip
We provide a [Go library to implement a authentication server](https://github.com/containerssh/auth).

You can read more in the [reference manual](/reference/auth.md)
You can read more in the [reference manual](/reference/auth)