mirror of
https://github.com/pgpainless/pgpainless.git
synced 2024-11-15 17:02:06 +01:00
52 lines
No EOL
1.8 KiB
Markdown
52 lines
No EOL
1.8 KiB
Markdown
<!--
|
|
SPDX-FileCopyrightText: 2021 Paul Schaub <vanitasvitae@fsfe.org>
|
|
|
|
SPDX-License-Identifier: Apache-2.0
|
|
-->
|
|
|
|
# PGPainless-SOP
|
|
|
|
[](https://datatracker.ietf.org/doc/html/draft-dkg-openpgp-stateless-cli-03)
|
|
[](https://search.maven.org/artifact/org.pgpainless/pgpainless-sop)
|
|
[](https://pgpainless.org/releases/latest/javadoc/org/pgpainless/sop/package-summary.html)
|
|
[](https://api.reuse.software/info/github.com/pgpainless/pgpainless)
|
|
|
|
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.
|
|
|
|
## Usage Examples
|
|
```java
|
|
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();
|
|
``` |