Skip to content
New issue

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

#

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

Already on GitHub? # to your account

docs: generalize version numbers, add rpm-ostree instructions #77

Merged
merged 1 commit into from
May 26, 2024
Merged

docs: generalize version numbers, add rpm-ostree instructions #77

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
17 changes: 12 additions & 5 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,21 +11,28 @@ The AuthRamp PAM (Pluggable Authentication Modules) module provides an account l
### RPM
If you're a RPM distribution user, then then pam-authramp can be installed using a binary .rpm file provided in each [release](https://github.com/34N0/pam-authramp/releases).
```bash
curl -LO https://github.com/34N0/pam-authramp/releases/download/v0.9.1-beta/pam-authramp-0.9.1-1.x86_64.rpm
sudo rpm -i pam-authramp-0.9.1-1.x86_64.rpm
sudo rpm -i pam-authramp-<VERSION>.x86_64.rpm
```
### COPR
The module is released in a COPR repository:
```bash
sudo dnf copr enable 34n0s/pam-authramp
sudo dnf install pam-authramp
```

### rpm-ostree
Use a 3rd party tool like [rpm-copr](https://github.com/34N0/rpm-copr) to add the copr repository
```bash
rpm-copr enable 34n0s/pam-authramp
rpm-ostree install pam-authramp
```

### Debian
If you're a Debian user (or a user of a Debian derivative like Ubuntu), then pam-authramp can be installed using a binary .deb file provided in each [release](https://github.com/34N0/pam-authramp/releases).
```bash
curl -LO https://github.com/34N0/pam-authramp/releases/download/v0.9.1-beta/pam-authramp_0.9.1-1_amd64.deb
sudo dpkg -i pam-authramp_0.9.1-1_amd64.deb
sudo dpkg -i pam-authramp_<VERSION>_amd64.deb
```

### Manually
1. Download the latest [release](https://github.com/34N0/pam-authramp/releases).
2. Copy the `libpam_authramp.so` library to the default PAM library directory. The directory varies for different distributions. For example, in current Fedora versions, the path is `/lib64/security`.
Expand Down Expand Up @@ -156,4 +163,4 @@ Contributing is welcomed! Read the [Contributing Guide](CONTRIBUTING.md) and the
## Mentions
- This project would not have been possible without the work done in the [pam-rs](https://github.com/anowell/pam-rs) crate.
- The Lockout mechanism is inspired by the [GrapheneOS](https://grapheneos.org/faq#security-and-privacy) implementation.
- This Module was developed to fix a PAM DoS vulnerability in [Secureblue](https://github.com/secureblue/secureblue).
- This Module was developed to fix a PAM DoS vulnerability in [Secureblue](https://github.com/secureblue/secureblue).