Signatures
Signer
Returns a Signer for the given private key and algorithm. All input and output
use the Bytes universal type — wrap your plaintext with
Bytes.from(...) and call .encode(...) or .asString() on the result.
Usage examples
KeyStore keystore = keystore("classpath:keystore.p12", "password".toCharArray(), "PKCS12");
PrivateKey privateKey = privateKey(keystore, "alice", "password".toCharArray());
Signer signer = signerBuilder()
.key(privateKey)
.algorithm("SHA512withRSA")
.build();
// raw bytes → raw bytes
Bytes rawSig = signer.sign(Bytes.from("Hello Bob".getBytes(UTF_8)));
// UTF-8 text → BASE64 signature string
Bytes sig = signer.sign(Bytes.from("Hello Bob"));
String b64 = sig.encode(BASE64);
// UTF-8 text → HEX signature string
String hex = signer.sign(Bytes.from("Hello Bob")).encode(HEX);
// ISO-8859-1 text → BASE64 signature string
Bytes sig2 = signer.sign(Bytes.from("Hello Bob", ISO_8859_1));
Builder options
import static com.mirkocaserta.bruce.Bruce.Provider.*;
// String-based algorithm (open-ended, supports any JCA algorithm)
Signer signer = signerBuilder()
.key(privateKey)
.algorithm("SHA512withRSA")
.provider(BOUNCY_CASTLE) // optional, defaults to JCA
// .provider("BC") // string-based alternative
.build();
// Enum-based algorithm (type-safe, IDE auto-completion)
Signer signer2 = signerBuilder()
.key(privateKey)
.algorithm(SignatureAlgorithm.SHA512_WITH_RSA)
.provider(BOUNCY_CASTLE) // optional
.build();
Common SignatureAlgorithm constants: SHA256_WITH_RSA, SHA512_WITH_RSA,
SHA256_WITH_ECDSA, SHA512_WITH_ECDSA, SHA256_WITH_DSA, RSASSA_PSS.
Interface
@FunctionalInterface
public interface Signer {
Bytes sign(Bytes message);
}
Use Bytes factory methods to construct the message and .encode()
/ .asString() to consume the returned signature.
Signer by Key
Returns a SignerByKey that resolves the private key at runtime from a
preconfigured map.
Usage examples
Map<String, PrivateKey> keys = Map.of("alice", aliceKey, "bob", bobKey);
SignerByKey signer = signerBuilder()
.keys(keys)
.algorithm("SHA512withRSA")
.buildByKey();
// raw bytes → raw bytes
Bytes sig = signer.sign("alice", Bytes.from("Hello Bob".getBytes(UTF_8)));
// UTF-8 text → BASE64 signature string
String b64 = signer.sign("alice", Bytes.from("Hello Bob")).encode(BASE64);
// UTF-8 text → HEX signature string
String hex = signer.sign("bob", Bytes.from("Hello Alice")).encode(HEX);
Interface
@FunctionalInterface
public interface SignerByKey {
Bytes sign(String privateKeyId, Bytes message);
}