Documentation
¶
Overview ¶
Package triple_des implements Triple DES encryption and decryption with streaming support. It provides Triple DES encryption and decryption operations using the standard Triple DES algorithm with support for 16-byte and 24-byte keys.
Index ¶
- func NewStreamDecrypter(r io.Reader, c *cipher.TripleDesCipher) io.Reader
- func NewStreamEncrypter(w io.Writer, c *cipher.TripleDesCipher) io.WriteCloser
- type BufferError
- type DecryptError
- type EncryptError
- type KeySizeError
- type ReadError
- type StdDecrypter
- type StdEncrypter
- type StreamDecrypter
- type StreamEncrypter
- type UnsupportedBlockModeError
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func NewStreamDecrypter ¶
NewStreamDecrypter creates a new streaming Triple DES decrypter that reads encrypted data from the provided io.Reader. The decrypter uses the specified cipher interface and validates the key length and cipher mode for proper Triple DES decryption. Only CBC, CTR, ECB, CFB, and OFB modes are supported.
func NewStreamEncrypter ¶
func NewStreamEncrypter(w io.Writer, c *cipher.TripleDesCipher) io.WriteCloser
NewStreamEncrypter creates a new streaming Triple DES encrypter that writes encrypted data to the provided io.Writer. The encrypter uses the specified cipher interface and validates the key length and cipher mode for proper Triple DES encryption. Only CBC, CTR, ECB, CFB, and OFB modes are supported.
Types ¶
type BufferError ¶
type BufferError struct {
// contains filtered or unexported fields
}
BufferError represents an error when the buffer size is too small. This error occurs when the provided buffer is too small to hold the decrypted data. The error includes both buffer size and data size for detailed debugging.
func (BufferError) Error ¶
func (e BufferError) Error() string
Error returns a formatted error message describing the buffer size issue. The message includes both buffer size and data size for debugging.
type DecryptError ¶
type DecryptError struct {
Err error // The underlying error that caused the failure
}
DecryptError represents an error when Triple DES decryption operation fails. This error occurs when the decryption process fails due to various reasons. The error includes the underlying error for detailed debugging.
func (DecryptError) Error ¶
func (e DecryptError) Error() string
Error returns a formatted error message describing the decryption failure. The message includes the underlying error for debugging.
type EncryptError ¶
type EncryptError struct {
Err error // The underlying error that caused the failure
}
EncryptError represents an error when Triple DES encryption operation fails. This error occurs when the encryption process fails due to various reasons. The error includes the underlying error for detailed debugging.
func (EncryptError) Error ¶
func (e EncryptError) Error() string
Error returns a formatted error message describing the encryption failure. The message includes the underlying error for debugging.
type KeySizeError ¶
type KeySizeError int
KeySizeError represents an error when the Triple DES key size is invalid. Triple DES keys must be exactly 16 or 24 bytes (128 or 192 bits). For 16-byte keys, the implementation automatically expands them to 24 bytes using the pattern key1 + key2 + key1. This error occurs when the provided key does not meet these size requirements.
func (KeySizeError) Error ¶
func (k KeySizeError) Error() string
Error returns a formatted error message describing the invalid key size. The message includes the actual key size and the required sizes for debugging.
type ReadError ¶
type ReadError struct {
Err error // The underlying error that caused the failure
}
ReadError represents an error when reading encrypted data fails. This error occurs when reading encrypted data from the underlying reader fails. The error includes the underlying error for detailed debugging.
type StdDecrypter ¶
type StdDecrypter struct {
Error error // Error field for storing decryption errors
// contains filtered or unexported fields
}
StdDecrypter represents a Triple DES decrypter for standard decryption operations. It implements Triple DES decryption using the standard Triple DES algorithm with support for 16-byte and 24-byte keys and various cipher modes.
func NewStdDecrypter ¶
func NewStdDecrypter(c *cipher.TripleDesCipher) *StdDecrypter
NewStdDecrypter creates a new Triple DES decrypter with the specified cipher and key. Validates the key length and cipher mode, then initializes the decrypter for Triple DES decryption operations. The key must be 16 or 24 bytes for Triple DES decryption. Only CBC, CTR, ECB, CFB, and OFB modes are supported.
func (*StdDecrypter) Decrypt ¶
func (d *StdDecrypter) Decrypt(src []byte) (dst []byte, err error)
Decrypt decrypts the given byte slice using Triple DES decryption. Creates a Triple DES cipher block and uses the configured cipher interface to perform the decryption operation with proper error handling. Returns empty data when input is empty.
type StdEncrypter ¶
type StdEncrypter struct {
Error error // Error field for storing encryption errors
// contains filtered or unexported fields
}
StdEncrypter represents a Triple DES encrypter for standard encryption operations. It implements Triple DES encryption using the standard Triple DES algorithm with support for 16-byte and 24-byte keys and various cipher modes.
func NewStdEncrypter ¶
func NewStdEncrypter(c *cipher.TripleDesCipher) *StdEncrypter
NewStdEncrypter creates a new Triple DES encrypter with the specified cipher and key. Validates the key length and cipher mode, then initializes the encrypter for Triple DES encryption operations. The key must be 16 or 24 bytes for Triple DES encryption. Only CBC, CTR, ECB, CFB, and OFB modes are supported.
func (*StdEncrypter) Encrypt ¶
func (e *StdEncrypter) Encrypt(src []byte) (dst []byte, err error)
Encrypt encrypts the given byte slice using Triple DES encryption. Creates a Triple DES cipher block and uses the configured cipher interface to perform the encryption operation with proper error handling. Returns empty data when input is empty.
type StreamDecrypter ¶
type StreamDecrypter struct {
Error error // Error field for storing decryption errors
// contains filtered or unexported fields
}
StreamDecrypter represents a streaming Triple DES decrypter that implements io.Reader. It provides efficient decryption for large data streams by reading all encrypted data at once and then providing it in chunks to maintain compatibility with standard decryption.
func (*StreamDecrypter) Read ¶
func (d *StreamDecrypter) Read(p []byte) (n int, err error)
Read implements the io.Reader interface for streaming Triple DES decryption. On the first call, reads all encrypted data from the underlying reader and decrypts it. Subsequent calls return chunks of the decrypted data to maintain streaming interface.
type StreamEncrypter ¶
type StreamEncrypter struct {
Error error // Error field for storing encryption errors
// contains filtered or unexported fields
}
StreamEncrypter represents a streaming Triple DES encrypter that implements io.WriteCloser. It provides efficient encryption for large data streams by processing data in chunks and writing encrypted output to the underlying writer with true streaming support.
func (*StreamEncrypter) Close ¶
func (e *StreamEncrypter) Close() error
Close implements the io.Closer interface for the streaming Triple DES encrypter. Closes the underlying writer if it implements io.Closer. Note: All data is processed in Write method for compatibility with cipher interface.
func (*StreamEncrypter) Write ¶
func (e *StreamEncrypter) Write(p []byte) (n int, err error)
Write implements the io.Writer interface for streaming Triple DES encryption. Provides improved performance through cipher block reuse while maintaining compatibility. Accumulates data and processes it using the cipher interface for consistency.
type UnsupportedBlockModeError ¶ added in v1.1.7
type UnsupportedBlockModeError struct {
Mode string
}
UnsupportedBlockModeError represents an error when an unsupported block mode is used. This error occurs when trying to use cipher modes that are not supported by 3DES, such as GCM mode which requires 128-bit block size while 3DES only has 64-bit block size.
func (UnsupportedBlockModeError) Error ¶ added in v1.1.7
func (e UnsupportedBlockModeError) Error() string
Error returns a formatted error message describing the unsupported mode. The message includes the mode name and explains why it's not supported.
Source Files