fileencryption

README

Go-File-Encryption

Introduction

• A file encryption/decryption library that uses the same algorithm as OpenSSL's with IV and salt
• You can set key and IV manually instead of creating them from password and salt.

!!!Caution!!!

• OpenSSL's key creation algorithm with password and salt is NOT secure.
• You should set key and IV manually or use some alternative algorithms.

Examples

• Read cbc_test.go

License

• Under the MIT License
• Copyright (c) 2017 Tsuzu

Documentation

Overview

Copyright (c) 2017 Tsuzu

This software is released under the MIT License. https://opensource.org/licenses/MIT

Copyright (c) 2017 Tsuzu

This software is released under the MIT License. https://opensource.org/licenses/MIT

Index

• Constants
• Variables
• func CreateKeyIVForAES128(password string, salt []byte) ([]byte, []byte)
• func CreateKeyIVForAES256(password string, salt []byte) ([]byte, []byte)
• func CreateSalt() ([]byte, error)
• func PBKDF1(password, salt []byte) ([]byte, []byte)
• func ReadByteChannelForFixedSize(ch chan byte, length int) []byte
• func SendByteArrayToChannel(b []byte, ch chan byte)
• type CBCDecryptionStream
  • func NewCBCDecryptionStream(keyLen int, password string, reader io.Reader) (*CBCDecryptionStream, error)
  • func (stream *CBCDecryptionStream) Read(b []byte) (retLength int, retError error)
• type CBCEncryptionStream
  • func NewCBCEncryptionStream(keyLen int, password string, reader io.Reader) (*CBCEncryptionStream, error)
  • func (stream *CBCEncryptionStream) Read(b []byte) (retLength int, retError error)
• type CrytionStream

Constants

const BlockSize = 128 / 8

const BufReadLength = BlockSize * 2048

const SaltSize = BlockSize / 2

Variables

var ErrIllegalLengthOfkey = errors.New("Illegal length of key")

var ErrIllegalPadding = errors.New("Illegal Padding")

var ErrIllegalPrefixOfEncrypted = errors.New("Illegal Prefix of Encrypted")

var ErrInsufficientData = errors.New("Insufficient Data")

var SaltPrefix = []byte("Salted__")

Functions

func CreateKeyIVForAES128

func CreateKeyIVForAES128(password string, salt []byte) ([]byte, []byte)

[DEPRECETED] This is the same as OpenSSL's, but it is insecure.

func CreateKeyIVForAES256

func CreateKeyIVForAES256(password string, salt []byte) ([]byte, []byte)

[DEPRECETED] This is the same as OpenSSL's, but it is insecure.

func CreateSalt

func CreateSalt() ([]byte, error)

func PBKDF1

func PBKDF1(password, salt []byte) ([]byte, []byte)

func ReadByteChannelForFixedSize

func ReadByteChannelForFixedSize(ch chan byte, length int) []byte

func SendByteArrayToChannel

func SendByteArrayToChannel(b []byte, ch chan byte)

Types

type CBCDecryptionStream

type CBCDecryptionStream struct {
	Password string
	Key      []byte
	IV       []byte
	Salt     []byte
	EOFFlag  bool
	// contains filtered or unexported fields
}

func NewCBCDecryptionStream

func NewCBCDecryptionStream(keyLen int, password string, reader io.Reader) (*CBCDecryptionStream, error)

keyLen only supports 128 or 256

func (*CBCDecryptionStream) Read

func (stream *CBCDecryptionStream) Read(b []byte) (retLength int, retError error)

type CBCEncryptionStream

type CBCEncryptionStream struct {
	Password string
	Key      []byte
	IV       []byte
	Salt     []byte
	EOFFlag  bool
	// contains filtered or unexported fields
}

func NewCBCEncryptionStream

func NewCBCEncryptionStream(keyLen int, password string, reader io.Reader) (*CBCEncryptionStream, error)

keyLen only supports 128 or 256

func (*CBCEncryptionStream) Read

func (stream *CBCEncryptionStream) Read(b []byte) (retLength int, retError error)

type CrytionStream

type CrytionStream interface {
	io.Reader
}