d15f0926ed
The creation time reported in the hkp "index" response should be the primary key's creation timestamp. We returned the creation time of the "primary key signature" (i.e. newest user id binding signature) before. see https://tools.ietf.org/html/draft-shaw-openpgp-hkp-00#section-5.2 |
||
---|---|---|
.tx | ||
contrib | ||
database | ||
dist | ||
hagridctl | ||
po/hagrid | ||
src | ||
templates-translated | ||
templates-untranslated/about | ||
.gitignore | ||
.gitlab-ci.yml | ||
build.rs | ||
Cargo.lock | ||
Cargo.toml | ||
COPYING | ||
hagrid-routes.conf | ||
make-translated-templates | ||
nginx-site.conf | ||
nginx.conf | ||
README.md | ||
Rocket.toml.dist | ||
rustfmt.toml |
Hagrid
Hagrid is a verifying OpenPGP key server.
You can find general instructions and an API documentation at the running instance at https://keys.openpgp.org.
License
Hagrid is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Hagrid is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with Hagrid. If not, see https://www.gnu.org/licenses/.
Quick Start
Building Hagrid requires a working nightly Rust toolchain. The easiest way to get the toolchain is to download rustup. After rustup is installed, get the nightly compiler and tools, copy the config file, and simply compile and run:
cd hagrid
rustup override set nightly
cp Rocket.toml.dist Rocket.toml
cargo run
This will spawn a web server listening on port 8080.
For deployment, a release build should be used (cargo build --release
). This
will be statically built, and can be copied anywhere. You will also need to
adjust Rocket.toml
accordingly. Hagrid uses sendmail
for mailing, so you
also need a working local mailer setup.
Reverse Proxy
Hagrid is designed to defer lookups to reverse proxy server like Nginx
and Apache. Lookups via /vks/v1/by-finingerprint
, /vks/v1/by-keyid
, and
/vks/v1/by-email
can be handled by a robust and performant HTTP server. A
sample configuration for nginx is part of the repository (nginx.conf
,
hagrid-routes.conf
).
Community
We're in #hagrid
on Freenode IRC, also reachable via Matrix as
#hagrid:stratum0.org
.