base on OpenPGP implemented in pure Rust, permissively licensed # rPGP <div align="center"> <!-- Crates version --> <a href="https://crates.io/crates/pgp"> <img src="https://img.shields.io/crates/v/pgp.svg?style=flat-square" alt="Crates.io version" /> </a> <!-- Downloads --> <a href="https://crates.io/crates/pgp"> <img src="https://img.shields.io/crates/d/pgp.svg?style=flat-square" alt="Download" /> </a> <!-- docs.rs docs --> <a href="https://docs.rs/pgp"> <img src="https://img.shields.io/badge/docs-latest-blue.svg?style=flat-square" alt="docs.rs docs" /> </a> <!-- msrv --> <a href="https://img.shields.io/badge/rustc-1.85+-blue.svg?style=flat-square"> <img src="https://img.shields.io/badge/rustc-1.85+-blue.svg?style=flat-square" alt="MSRV 1.85" /> </a> </div> <div align="center"> <h3> <a href="https://docs.rs/pgp"> Rust Docs </a> <span> | </span> <a href="https://github.com/rpgp/rpgp/releases"> Releases </a> </h3> </div> <br/> > OpenPGP implemented in pure Rust, permissively licensed rPGP is a pure Rust implementation of OpenPGP. rPGP implements OpenPGP as specified in [RFC9580], including the commonly used v4 formats, as well as the latest v6 key formats and AEAD encryption mechanisms. All formats specified in the historical RFCs [RFC4880] and [RFC6637], such as v3 keys and signatures, are supported as well. See [`IMPL_STATUS.md`](docs/IMPL_STATUS.md) for more details on the implemented PGP features and [`openpgp.md`](docs/openpgp.md) for a rough taxonomy. rPGP offers a flexible low-level API and gives users the ability to build higher level PGP tooling in the most compatible way possible. Additionally, it fully supports all functionality required by the [Autocrypt 1.1 e-mail encryption specification]. ## Notable Users & Libraries built using rPGP - [Delta Chat]: Cross-platform messaging app that works over e-mail - [`rpm`]: A pure rust library for parsing and creating RPM files - [`rpgpie`]: An experimental high level OpenPGP API - [`rsop`]: A SOP CLI tool based on rPGP and rpgpie - [`debian-packaging`]: a library crate for dealing with Debian packages Don't see your project here? Please send a PR :) ## Usage ```sh > cargo add pgp ``` ### Load a public key and verify an inline-signed message ```rust no_run use std::fs; use pgp::composed::{Deserializable, Message, SignedPublicKey}; fn main() { let pub_key_file = "key.asc"; let msg_file = "msg.asc"; let key_string = fs::read_to_string(pub_key_file).unwrap(); let (public_key, _headers_public) = SignedPublicKey::from_string(&key_string).unwrap(); let msg_string = fs::read_to_string(msg_file).unwrap(); let (mut msg, _headers_msg) = Message::from_string(&msg_string).unwrap(); // Verify this message // NOTE: This assumes that the primary serves as the signing key, which is not always the case! msg.verify(&public_key).unwrap(); let msg_string = msg.as_data_string().unwrap(); // actual message content println!("Signed message: {msg_string:?}"); } ``` ### Generate and verify a detached signature with an OpenPGP keypair ```rust no_run use std::time::SystemTime; use pgp::composed::{Deserializable, SignedPublicKey, SignedSecretKey}; use pgp::packet::{SignatureConfig, SignatureType, Subpacket, SubpacketData}; use pgp::types::{KeyDetails, Password}; fn main() -> pgp::errors::Result<()> { let priv_key_file = "key.sec.asc"; let data = b"Hello world!"; // -- Create a new signature using the private key -- let signed_secret_key = SignedSecretKey::from_armor_file(priv_key_file)?.0; // Set up a signature configuration to create a binary data signature let mut config = SignatureConfig::from_key( rand::thread_rng(), &signed_secret_key.primary_key, SignatureType::Binary, )?; config.hashed_subpackets = vec![ Subpacket::regular(SubpacketData::IssuerFingerprint( signed_secret_key.fingerprint(), ))?, Subpacket::critical(SubpacketData::SignatureCreationTime( SystemTime::now().into(), ))?, ]; config.unhashed_subpackets = vec![Subpacket::regular(SubpacketData::Issuer(signed_secret_key.key_id()))?]; // Generate an OpenPGP signature packet (which is used as a "detached signature", in this context) let signature = config .sign( &signed_secret_key.primary_key, &Password::empty(), &data[..], )?; // -- Verify the signature using the public key -- let pub_key_file = "key.asc"; let public_key = SignedPublicKey::from_armor_file(pub_key_file)?.0; signature.verify(&public_key, &data[..])?; Ok(()) } ``` ## Current Status > Last updated *September 2024* - Implementation Status: [`IMPL_STATUS.md`](docs/IMPL_STATUS.md) - Security Status: [`STATUS_SECURITY.md`](docs/SECURITY_STATUS.md) - Supported Platforms: [`PLATFORMS.md`](docs/PLATFORMS.md) ## FAQs See [`FAQ.md`](docs/FAQ.md). ## OpenPGP Versions and Features See [`openpgp.md`](docs/openpgp.md). ## rPGP is a library for application developers rPGP aims to make it easy for application developers to incorporate OpenPGP functionality into their projects. Note that the OpenPGP format and its semantics are relatively complex. We recommend the text ["OpenPGP for application developers"](https://openpgp.dev/) for initial orientation. Independently, we welcome questions in the rPGP issue tracker. ## rPGP is a low-level OpenPGP library rPGP offers abstractions for handling the formats and mechanisms specified in RFC 9580. However, it offers them as relatively low-level building blocks, and doesn't attempt to ensure that users can not apply them unsafely. > rPGP allows following almost all parts of the OpenPGP specification, but the APIs are low level building blocks and do not claim that using them is (a) secure or (b) following the OpenPGP specification Using the building blocks in rPGP correctly and safely requires a solid understanding of OpenPGP and at least a basic understanding of cryptography. ### OpenPGP is a layered technology For context, OpenPGP can be thought of as a multi-layered technology, roughly like this: 1. Wire format: [Packet framing](https://www.rfc-editor.org/rfc/rfc9580.html#name-packet-syntax), [Packet content](https://www.rfc-editor.org/rfc/rfc9580.html#name-packet-types), [ASCII armor](https://www.rfc-editor.org/rfc/rfc9580.html#name-forming-ascii-armor), ... 2. Composite objects (e.g. Certificates, Messages) constructed according to [grammars](https://www.rfc-editor.org/rfc/rfc9580.html#name-packet-sequence-composition) 3. Functionality to process data, such as calculation and validation of OpenPGP signatures and encryption and decryption of messages. 4. OpenPGP semantics (e.g.: *Expiration* and *Revocation* of Certificates and their components, *Key Flags* that define which semantical operations a given component key may be used for, signaling of algorithm preferences, ...) Of these layers, the OpenPGP RFC specifies 1-3, while 4 is not specified in detail. Some work on formalizing OpenPGP semantics can be found in [draft-gallagher-openpgp-signatures](https://datatracker.ietf.org/doc/draft-gallagher-openpgp-signatures/) and [draft-dkg-openpgp-revocation](https://datatracker.ietf.org/doc/draft-dkg-openpgp-revocation/). Analogous to the RFC, rPGP handles layers 1-3, but explicitly does not deal with 4. Applications that need OpenPGP semantics must implement them manually, or rely on additional libraries to deal with that layer. NOTE: The [`rpgpie`] library implements some of these high level OpenPGP semantics. It may be useful either to incorporate in rPGP projects, or to study for reference. #### Mechanisms in OpenPGP evolve over time rPGP can handle a wide range of OpenPGP artifacts. It offers support for almost all mechanisms in OpenPGP, both modern and those now considered legacy. This explicitly includes artifacts that use historical algorithms, which are considered insecure given today's understanding. rPGP doesn't ensure that application developers use appropriate cryptographic building blocks for their purposes (even though it generally produces appropriately modern artifacts, by default). See ["Overview of OpenPGP formats and mechanisms"](docs/openpgp.md) for more details on the evolution of OpenPGP over time. ## Minimum Supported Rust Version (MSRV) All crates in this repository support Rust 1.85 or higher. In future minimally supported version of Rust can be changed, but it will be done with a minor version bump. ## Funding [RFC 9580 support for rPGP](https://nlnet.nl/project/rPGP-cryptorefresh/) has been funded in part through [NGI0 Core](https://nlnet.nl/core/), a fund established by [NLnet](https://nlnet.nl) with financial support from the European Commission's [Next Generation Internet](https://ngi.eu) programme. ## License This project is licensed under either of * Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or <http://www.apache.org/licenses/LICENSE-2.0>) * MIT license ([LICENSE-MIT](LICENSE-MIT) or <http://opensource.org/licenses/MIT>) at your option. ### Contribution Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions. [RFC2440]: https://tools.ietf.org/html/rfc2440 [RFC4880]: https://tools.ietf.org/html/rfc4880.html [RFC6637]: https://www.rfc-editor.org/rfc/rfc6637 [RFC9580]: https://www.rfc-editor.org/rfc/rfc9580.html [Autocrypt 1.1 e-mail encryption specification]: https://autocrypt.org/level1.html [the `pgp` Crate]: https://crates.io/crates/pgp/ [Delta Chat]: https://delta.chat [`rsop`]: https://crates.io/crates/rsop/ [`rpgpie`]: https://crates.io/crates/rpgpie [`rpm`]: https://crates.io/crates/rpm [`debian-packaging`]: https://crates.io/crates/debian-packaging ", Assign "at most 3 tags" to the expected json: {"id":"9199","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"