openssl

package module

v1.6.0 Latest Latest Go to latest Published: May 11, 2023 License: Apache-2.0 Imports: 16 Imported by: 76

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/forgoer/openssl

Links

Open Source Insights

README ¶

Openssl encryption

A functions wrapping of OpenSSL library for symmetric and asymmetric encryption and decryption

AES
DES
3DES
RSA
HMAC-SHA

Installation

The only requirement is the Go Programming Language

go get -u github.com/forgoer/openssl

Usage

AES

The length of the key can be 16/24/32 characters (128/192/256 bits)

AES-ECB:

src := []byte("123456")
key := []byte("1234567890123456")
dst , _ := openssl.AesECBEncrypt(src, key, openssl.PKCS7_PADDING)
fmt.Printf(base64.StdEncoding.EncodeToString(dst))  // yXVUkR45PFz0UfpbDB8/ew==

dst , _ = openssl.AesECBDecrypt(dst, key, openssl.PKCS7_PADDING)
fmt.Println(string(dst)) // 123456

AES-CBC:

src := []byte("123456")
key := []byte("1234567890123456")
iv := []byte("1234567890123456")
dst , _ := openssl.AesCBCEncrypt(src, key, iv, openssl.PKCS7_PADDING)
fmt.Println(base64.StdEncoding.EncodeToString(dst)) // 1jdzWuniG6UMtoa3T6uNLA==

dst , _ = openssl.AesCBCDecrypt(dst, key, iv, openssl.PKCS7_PADDING)
fmt.Println(string(dst)) // 123456

DES

The length of the key must be 8 characters (64 bits).

DES-ECB:

openssl.DesECBEncrypt(src, key, openssl.PKCS7_PADDING)
openssl.DesECBDecrypt(src, key, openssl.PKCS7_PADDING)

DES-CBC:

openssl.DesCBCEncrypt(src, key, iv, openssl.PKCS7_PADDING)
openssl.DesCBCDecrypt(src, key, iv, openssl.PKCS7_PADDING)

3DES

The length of the key must be 24 characters (192 bits).

3DES-ECB:

openssl.Des3ECBEncrypt(src, key, openssl.PKCS7_PADDING)
openssl.Des3ECBDecrypt(src, key, openssl.PKCS7_PADDING)

3DES-CBC:

openssl.Des3CBCEncrypt(src, key, iv, openssl.PKCS7_PADDING)
openssl.Des3CBCDecrypt(src, key, iv, openssl.PKCS7_PADDING)

RSA

openssl.RSAGenerateKey(bits int, out io.Writer)
openssl.RSAGeneratePublicKey(priKey []byte, out io.Writer)

openssl.RSAEncrypt(src, pubKey []byte) ([]byte, error)
openssl.RSADecrypt(src, priKey []byte) ([]byte, error)

openssl.RSASign(src []byte, priKey []byte, hash crypto.Hash) ([]byte, error)
openssl.RSAVerify(src, sign, pubKey []byte, hash crypto.Hash) error

HMAC-SHA

// Sha1 Calculate the sha1 hash of a string
Sha1(str string) []byte

// HmacSha1 Calculate the sha1 hash of a string using the HMAC method
HmacSha1(key string, data string) []byte

// HmacSha1ToString Calculate the sha1 hash of a string using the HMAC method, outputs lowercase hexits
HmacSha1ToString(key string, data string) string

// Sha256 Calculate the sha256 hash of a string
Sha256(str string) []byte

// HmacSha256 Calculate the sha256 hash of a string using the HMAC method
HmacSha256(key string, data string) []byte

// HmacSha256ToString Calculate the sha256 hash of a string using the HMAC method, outputs lowercase hexits
HmacSha256ToString(key string, data string) string

License

This project is licensed under the Apache 2.0 license.

Contact

If you have any issues or feature requests, please contact us. PR is welcomed.

https://github.com/forgoer/openssl/issues

Documentation ¶

Index ¶

Constants
Variables
func AesCBCDecrypt(src, key, iv []byte, padding string) ([]byte, error)
func AesCBCEncrypt(src, key, iv []byte, padding string) ([]byte, error)
func AesECBDecrypt(src, key []byte, padding string) ([]byte, error)
func AesECBEncrypt(src, key []byte, padding string) ([]byte, error)
func AesNewCipher(key []byte) (cipher.Block, error)
func CBCDecrypt(block cipher.Block, src, iv []byte, padding string) ([]byte, error)
func CBCEncrypt(block cipher.Block, src, iv []byte, padding string) ([]byte, error)
func Des3CBCDecrypt(src, key, iv []byte, padding string) ([]byte, error)
func Des3CBCEncrypt(src, key, iv []byte, padding string) ([]byte, error)
func Des3ECBDecrypt(src, key []byte, padding string) ([]byte, error)
func Des3ECBEncrypt(src, key []byte, padding string) ([]byte, error)
func DesCBCDecrypt(src, key, iv []byte, padding string) ([]byte, error)
func DesCBCEncrypt(src, key, iv []byte, padding string) ([]byte, error)
func DesECBDecrypt(src, key []byte, padding string) ([]byte, error)
func DesECBEncrypt(src, key []byte, padding string) ([]byte, error)
func DesNewCipher(key []byte) (cipher.Block, error)
func ECBDecrypt(block cipher.Block, src []byte, padding string) ([]byte, error)
func ECBEncrypt(block cipher.Block, src []byte, padding string) ([]byte, error)
func HmacSha1(key string, data string) []byte
func HmacSha1ToString(key string, data string) string
func HmacSha256(key string, data string) []byte
func HmacSha256ToString(key string, data string) string
func KeyGenerator(src []byte, blockSize int) []byte
func Md5(str string) []byte
func Md5ToString(str string) string
func NewECBDecrypter(b cipher.Block) cipher.BlockMode
func NewECBEncrypter(b cipher.Block) cipher.BlockMode
func PKCS5Padding(src []byte, blockSize int) []byte
func PKCS5Unpadding(src []byte) ([]byte, error)
func PKCS7Padding(src []byte, blockSize int) []byte
func PKCS7UnPadding(src []byte) ([]byte, error)
func Padding(padding string, src []byte, blockSize int) []byte
func RSADecrypt(src, priKey []byte) ([]byte, error)
func RSAEncrypt(src, pubKey []byte) ([]byte, error)
func RSAGenerateKey(bits int, out io.Writer) error
func RSAGeneratePublicKey(priKey []byte, out io.Writer) error
func RSASign(src []byte, priKey []byte, hash crypto.Hash) ([]byte, error)
func RSAVerify(src, sign, pubKey []byte, hash crypto.Hash) error
func SHA1(data []byte) []byte
func Sha1(str string) []byte
func Sha256(str string) []byte
func UnPadding(padding string, src []byte) ([]byte, error)
func ZerosPadding(src []byte, blockSize int) []byte
func ZerosUnPadding(src []byte) ([]byte, error)

Constants ¶

View Source

const PKCS5_PADDING = "PKCS5"

View Source

const PKCS7_PADDING = "PKCS7"

View Source

const ZEROS_PADDING = "ZEROS"

Variables ¶

View Source

var ErrUnPadding = errors.New("UnPadding error")

Functions ¶

func AesCBCDecrypt ¶

func AesCBCDecrypt(src, key, iv []byte, padding string) ([]byte, error)

AesCBCDecrypt

func AesCBCEncrypt ¶

func AesCBCEncrypt(src, key, iv []byte, padding string) ([]byte, error)

AesCBCEncrypt

func AesECBDecrypt ¶

func AesECBDecrypt(src, key []byte, padding string) ([]byte, error)

AesECBDecrypt

func AesECBEncrypt ¶

func AesECBEncrypt(src, key []byte, padding string) ([]byte, error)

AesECBEncrypt

func AesNewCipher ¶ added in v1.6.0

func AesNewCipher(key []byte) (cipher.Block, error)

AesNewCipher creates and returns a new AES cipher.Block. it will automatically pad the length of the key.

func CBCDecrypt ¶

func CBCDecrypt(block cipher.Block, src, iv []byte, padding string) ([]byte, error)

CBCDecrypt

func CBCEncrypt ¶

func CBCEncrypt(block cipher.Block, src, iv []byte, padding string) ([]byte, error)

CBCEncrypt

func Des3CBCDecrypt ¶

func Des3CBCDecrypt(src, key, iv []byte, padding string) ([]byte, error)

Des3CBCDecrypt

func Des3CBCEncrypt ¶

func Des3CBCEncrypt(src, key, iv []byte, padding string) ([]byte, error)

Des3CBCEncrypt

func Des3ECBDecrypt ¶

func Des3ECBDecrypt(src, key []byte, padding string) ([]byte, error)

Des3ECBDecrypt

func Des3ECBEncrypt ¶

func Des3ECBEncrypt(src, key []byte, padding string) ([]byte, error)

Des3ECBEncrypt

func DesCBCDecrypt ¶

func DesCBCDecrypt(src, key, iv []byte, padding string) ([]byte, error)

DesCBCDecrypt

func DesCBCEncrypt ¶

func DesCBCEncrypt(src, key, iv []byte, padding string) ([]byte, error)

DesCBCEncrypt

func DesECBDecrypt ¶

func DesECBDecrypt(src, key []byte, padding string) ([]byte, error)

DesECBDecrypt

func DesECBEncrypt ¶

func DesECBEncrypt(src, key []byte, padding string) ([]byte, error)

DesECBEncrypt

func DesNewCipher ¶ added in v1.6.0

func DesNewCipher(key []byte) (cipher.Block, error)

DesNewCipher creates and returns a new DES cipher.Block.

func ECBDecrypt ¶

func ECBDecrypt(block cipher.Block, src []byte, padding string) ([]byte, error)

func ECBEncrypt ¶

func ECBEncrypt(block cipher.Block, src []byte, padding string) ([]byte, error)

func HmacSha1 ¶

func HmacSha1(key string, data string) []byte

HmacSha1 Calculate the sha1 hash of a string using the HMAC method

func HmacSha1ToString ¶ added in v1.5.0

func HmacSha1ToString(key string, data string) string

HmacSha1ToString Calculate the sha1 hash of a string using the HMAC method, outputs lowercase hexits

func HmacSha256 ¶ added in v1.5.0

func HmacSha256(key string, data string) []byte

HmacSha256 Calculate the sha256 hash of a string using the HMAC method

func HmacSha256ToString ¶ added in v1.5.0

func HmacSha256ToString(key string, data string) string

HmacSha256ToString Calculate the sha256 hash of a string using the HMAC method, outputs lowercase hexits

func KeyGenerator ¶

func KeyGenerator(src []byte, blockSize int) []byte

func Md5 ¶

func Md5(str string) []byte

Md5 Calculate the md5 hash of a string

func Md5ToString ¶ added in v1.3.0

func Md5ToString(str string) string

Md5ToString Calculate the md5 hash of a string, return hex string

func NewECBDecrypter ¶

func NewECBDecrypter(b cipher.Block) cipher.BlockMode

NewECBDecrypter returns a BlockMode which decrypts in electronic code book mode, using the given Block.

func NewECBEncrypter ¶

func NewECBEncrypter(b cipher.Block) cipher.BlockMode

NewECBEncrypter returns a BlockMode which encrypts in electronic code book mode, using the given Block.

func PKCS5Padding ¶

func PKCS5Padding(src []byte, blockSize int) []byte

func PKCS5Unpadding ¶

func PKCS5Unpadding(src []byte) ([]byte, error)

func PKCS7Padding ¶

func PKCS7Padding(src []byte, blockSize int) []byte

func PKCS7UnPadding ¶

func PKCS7UnPadding(src []byte) ([]byte, error)

func Padding ¶

func Padding(padding string, src []byte, blockSize int) []byte

func RSADecrypt ¶ added in v1.2.0

func RSADecrypt(src, priKey []byte) ([]byte, error)

RSADecrypt RSA decrypt

func RSAEncrypt ¶ added in v1.2.0

func RSAEncrypt(src, pubKey []byte) ([]byte, error)

RSAEncrypt RSA encrypt

func RSAGenerateKey ¶ added in v1.2.0

func RSAGenerateKey(bits int, out io.Writer) error

RSAGenerateKey generate RSA private key

func RSAGeneratePublicKey ¶ added in v1.2.0

func RSAGeneratePublicKey(priKey []byte, out io.Writer) error

RSAGeneratePublicKey generate RSA public key

func RSASign ¶ added in v1.2.0

func RSASign(src []byte, priKey []byte, hash crypto.Hash) ([]byte, error)

RSASign RSA sign

func RSAVerify ¶ added in v1.2.0

func RSAVerify(src, sign, pubKey []byte, hash crypto.Hash) error

RSAVerify RSA verify

func SHA1 ¶

func SHA1(data []byte) []byte

func Sha1 ¶

func Sha1(str string) []byte

Sha1 Calculate the sha1 hash of a string

func Sha256 ¶ added in v1.5.0

func Sha256(str string) []byte

Sha256 Calculate the sha256 hash of a string

func UnPadding ¶

func UnPadding(padding string, src []byte) ([]byte, error)

func ZerosPadding ¶

func ZerosPadding(src []byte, blockSize int) []byte

func ZerosUnPadding ¶

func ZerosUnPadding(src []byte) ([]byte, error)

Types ¶

This section is empty.

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL