package errors

import "github.com/ProtonMail/go-crypto/openpgp/errors"

Package errors contains common error types for the OpenPGP packages.

Index

Variables

var (
	// ErrDecryptSessionKeyParsing is a generic error message for parsing errors in decrypted data
	// to reduce the risk of oracle attacks.
	ErrDecryptSessionKeyParsing = DecryptWithSessionKeyError("parsing error")
	// ErrAEADTagVerification is returned if one of the tag verifications in SEIPDv2 fails
	ErrAEADTagVerification error = DecryptWithSessionKeyError("AEAD tag verification failed")
	// ErrMDCHashMismatch
	ErrMDCHashMismatch error = SignatureError("MDC hash mismatch")
	// ErrMDCMissing
	ErrMDCMissing error = SignatureError("MDC packet not found")
)
var ErrKeyExpired error = keyExpiredError(0)
var ErrKeyIncorrect error = keyIncorrectError(0)
var ErrKeyRevoked error = keyRevokedError(0)
var ErrMessageTooLarge error = messageTooLargeError(0)

ErrMessageTooLarge is returned if the read data from a compressed packet exceeds the provided limit.

var ErrSignatureExpired error = signatureExpiredError(0)
var ErrSignatureOlderThanKey error = signatureOlderThanKeyError(0)
var ErrUnknownIssuer error = unknownIssuerError(0)

Functions

func HandleSensitiveParsingError

func HandleSensitiveParsingError(err error, decrypted bool) error

HandleSensitiveParsingError handles parsing errors when reading data from potentially decrypted data. The function makes parsing errors generic to reduce the risk of oracle attacks in SEIPDv1.

Types

type AEADError

type AEADError string

AEADError indicates that there is a problem when initializing or using a AEAD instance, configuration struct, nonces or index values.

func (AEADError) Error

func (ae AEADError) Error() string

type CriticalUnknownPacketTypeError

type CriticalUnknownPacketTypeError uint8

func (CriticalUnknownPacketTypeError) Error

type DecryptWithSessionKeyError

type DecryptWithSessionKeyError string

A DecryptWithSessionKeyError is returned when a failure occurs when reading from symmetrically decrypted data or an authentication tag verification fails. Such an error indicates that the supplied session key is likely wrong or the data got corrupted.

func (DecryptWithSessionKeyError) Error

type ErrDummyPrivateKey

type ErrDummyPrivateKey string

ErrDummyPrivateKey results when operations are attempted on a private key that is just a dummy key. See https://git.gnupg.org/cgi-bin/gitweb.cgi?p=gnupg.git;a=blob;f=doc/DETAILS;h=fe55ae16ab4e26d8356dc574c9e8bc935e71aef1;hb=23191d7851eae2217ecdac6484349849a24fd94a#l1109

func (ErrDummyPrivateKey) Error

func (dke ErrDummyPrivateKey) Error() string

type ErrEncryptionKeySelection

type ErrEncryptionKeySelection struct {
	PrimaryKeyId      string
	PrimaryKeyErr     error
	EncSelectionKeyId *string
	EncSelectionErr   error
}

ErrEncryptionKeySelection is returned if encryption key selection fails (v2 API).

func (ErrEncryptionKeySelection) Error

func (eks ErrEncryptionKeySelection) Error() string

type ErrMalformedMessage

type ErrMalformedMessage string

ErrMalformedMessage results when the packet sequence is incorrect

func (ErrMalformedMessage) Error

func (dke ErrMalformedMessage) Error() string

type InvalidArgumentError

type InvalidArgumentError string

InvalidArgumentError indicates that the caller is in error and passed an incorrect value.

func (InvalidArgumentError) Error

func (i InvalidArgumentError) Error() string

type KeyInvalidError

type KeyInvalidError string

KeyInvalidError indicates that the public key parameters are invalid as they do not match the private ones

func (KeyInvalidError) Error

func (e KeyInvalidError) Error() string

type SignatureError

type SignatureError string

SignatureError indicates that a syntactically valid signature failed to validate.

func (SignatureError) Error

func (b SignatureError) Error() string

type StructuralError

type StructuralError string

A StructuralError is returned when OpenPGP data is found to be syntactically invalid.

func (StructuralError) Error

func (s StructuralError) Error() string

type UnknownPacketTypeError

type UnknownPacketTypeError uint8

func (UnknownPacketTypeError) Error

func (upte UnknownPacketTypeError) Error() string

type UnsupportedError

type UnsupportedError string

UnsupportedError indicates that, although the OpenPGP data is valid, it makes use of currently unimplemented features.

func (UnsupportedError) Error

func (s UnsupportedError) Error() string

type WeakAlgorithmError

type WeakAlgorithmError string

func (WeakAlgorithmError) Error

func (e WeakAlgorithmError) Error() string

Source Files

errors.go

Version
v1.3.0 (latest)
Published
May 22, 2025
Platform
linux/amd64
Imports
2 packages
Last checked
2 days ago

Tools for package owners.