Lib.rs

Continuous integration	Docs	License	Crate version	Crate downloads

This is an experimental crate to interact with sigstore.

This is under high development, many features and checks are still missing.

Features

CosignVerification

The crate implements the following verification mechanisms:

• Verify using a given key
• Verify bundle produced by transparency log (Rekor)
• Verify signature produced in keyless mode, using Fulcio Web-PKI

Signature annotations and certificate email can be provided at verification time.

OpenID Connect

For use with Fulcio ephemeral key signing, an OpenID connect API is available.

Rekor Client

All of the rekor client APIs can be leveraged.

Key Interface

The crate implements the following key interfaces:

• Generate a key pair
• Sign data
• Verify signature
• Export public / (encrypted) private key in PEM / DER format
• Import public / (encrypted) private key in PEM / DER format

Known limitations

• The crate does not handle verification of attestations yet or perform OIC container signing operations.

Examples

The examples directory contains demo programs using the library.

• openidflow
• key_interface
• rekor

Each example can be executed with the cargo run --example <name> command.

For example, the openidconnect example can be run with the following command:

cargo run --example openidconnect

Security

Should you discover any security issues, please refer to sigstores security process