pgpainless/pgpainless-sop
Paul Schaub 9f50946dd7
PGPainless 1.2.0
2022-04-07 21:20:46 +02:00
..
src Create dedicated KeyException class for key-related exceptions. 2022-04-07 19:42:58 +02:00
README.md PGPainless 1.2.0 2022-04-07 21:20:46 +02:00
build.gradle Switch pgpainless-sop over to java-library plugin and api-depend on sop-java 2022-01-15 02:46:42 +01:00

README.md

PGPainless-SOP

Spec Revision: 3 Maven Central javadoc

Implementation of the Stateless OpenPGP Protocol using PGPainless.

This module implements sop-java using pgpainless-core. If your code depends on sop-java, this module can be used as a realization of those interfaces.

Get started

To start using pgpainless-sop in your code, include the following lines in your build script:

// If you use Gradle
...
dependencies {
    ...
    implementation "org.pgpainless:pgpainless-sop:1.2.0"
    ...
}

// If you use Maven
...
<dependencies>
    ...
    <dependency>
        <groupId>org.pgpainless</groupId>
        <artifactId>pgpainless-sop</artifactId>
        <version>1.2.0</version>
    </dependency>
    ...
</dependencies>

pgpainless-sop will transitively pull in its dependencies, such as sop-java and pgpainless-core.

Usage Examples

SOP sop = new SOPImpl();
        
// Generate an OpenPGP key
byte[] key = sop.generateKey()
        .userId("Alice <alice@example.org>")
        .generate()
        .getBytes();

// Extract the certificate (public key)
byte[] cert = sop.extractCert()
        .key(key)
        .getBytes();

// Encrypt a message
byte[] message = ...
byte[] encrypted = sop.encrypt()
        .withCert(cert)
        .signWith(key)
        .plaintext(message)
        .getBytes();

// Decrypt a message
ByteArrayAndResult<DecryptionResult> messageAndVerifications = sop.decrypt()
        .verifyWith(cert)
        .withKey(key)
        .ciphertext(encrypted)
        .toByteArrayAndResult();
byte[] decrypted = messageAndVerifications.getBytes();
// Signature Verifications
DecryptionResult messageInfo = messageAndVerifications.getResult();
List<Verification> signatureVerifications = messageInfo.getVerifications();