dongle

日本語

English
简体中文

日本語

English
简体中文

トピック＃トピック＃

AES ​

AES（Advanced Encryption Standard）は対称暗号化アルゴリズムで、16 バイト、24 バイト、32 バイトの鍵長をサポートします。dongle は標準およびストリーミング AES 暗号化をサポートし、多様なブロックモード、パディングモード、出力形式を提供します。

以下のブロックモードをサポート：

  • CBC（Cipher Block Chaining）：暗号ブロック連鎖モード、鍵 Key、初期化ベクトル IV（16バイト）、パディングモード Padding の設定が必要
  • ECB（Electronic Codebook）：電子暗号帳モード、鍵 Key とパディングモード Padding の設定が必要
  • CTR（Counter）：カウンターモード、鍵 Key と初期化ベクトル IV（16バイト）の設定が必要
  • GCM（Galois/Counter Mode）：ガロア/カウンターモード、鍵 Key、乱数 Nonce（1-255バイト）、追加認証データ AAD（オプション）の設定が必要
  • CFB（Cipher Feedback）：暗号フィードバックモード、鍵 Key と初期化ベクトル IV（16バイト）の設定が必要
  • OFB（Output Feedback）：出力フィードバックモード、鍵 Key と初期化ベクトル IV（16バイト）の設定が必要

以下のパディングモードをサポート：

  • No：パディングなし、平文長は16の倍数でなければならない
  • Zero：ゼロパディング、ブロック境界までゼロバイトで埋める、平文長が16の倍数でない場合は0x00バイトで埋める
  • PKCS7：PKCS#7パディング、最も一般的なパディング方式、Nバイトの値Nで埋める（Nはパディングバイト数）
  • PKCS5：PKCS#5パディング、8バイトブロックサイズに適用、Nバイトの値Nで埋める（Nはパディングバイト数）
  • AnsiX923：ANSI X.923パディング、最後のバイト以外は0x00で埋め、最後のバイトはパディングバイト数を表す
  • ISO97971：ISO/IEC 9797-1パディング、最初のバイトは0x80、残りは0x00で埋める
  • ISO10126：ISO/IEC 10126パディング、最後のバイト以外はランダムバイトで埋め、最後のバイトはパディングバイト数を表す
  • ISO78164：ISO/IEC 7816-4パディング、最初のバイトは0x80、残りは0x00で埋める
  • Bit：ビットパディング、平文末尾に1ビットを追加し、その後0ビットでブロック境界まで埋める
  • TBC：末尾ビット補数パディング、最後のデータバイトの最上位ビットに基づいてパディングバイトを決定（MSB=0は0x00、MSB=1は0xFFを使用）

注意：CBC/ECBブロックモードのみパディングモードの設定が必要、CBC/CTR/CFB/OFBブロックモードのみ初期化ベクトルの設定が必要

関連モジュールをインポート：

go
import (
    "github.com/dromara/dongle"
    "github.com/dromara/dongle/crypto/cipher"
)

CBCモード ​

Cipherの作成 ​

go
c := cipher.NewAesCipher(cipher.CBC)
// 鍵を設定（16バイト）
c.SetKey([]byte("dongle1234567890"))
// 初期化ベクトルを設定（16バイト）
c.SetIV([]byte("1234567890123456"))
// パディングモードを設定
c.SetPadding(cipher.PKCS7)

データの暗号化 ​

入力データ

go
// 入力文字列
encrypter := dongle.Encrypt.FromString("hello world").ByAes(c)
// 入力バイトスライス
encrypter := dongle.Encrypt.FromBytes([]byte("hello world")).ByAes(c)
// 入力ファイルストリーム
file, _ := os.Open("test.txt")
encrypter := dongle.Encrypt.FromFile(file).ByAes(c)

// 暗号化エラーをチェック
if encrypter.Error != nil {
	fmt.Printf("暗号化エラー: %v\n", encrypter.Error)
	return
}

出力データ

go
// エンコードされていない生の文字列を出力
encrypter.ToHexString() // b0a72d41c2a05fc42c98fe49ad0cead7
// エンコードされていない生のバイトスライスを出力
encrypter.ToHexBytes()  // []byte("b0a72d41c2a05fc42c98fe49ad0cead7")

// エンコードされていない生の文字列を出力
encrypter.ToBase64String() // sKctQcKgX8QsmP5JrQzq1w==
// エンコードされていない生のバイトスライスを出力
encrypter.ToBase64Bytes()  // []byte("sKctQcKgX8QsmP5JrQzq1w==")

// エンコードされていない生の文字列を出力
encrypter.ToRawString()
// エンコードされていない生のバイトスライスを出力
encrypter.ToRawBytes()

データの復号化 ​

入力データ

go
// Hexエンコード文字列を入力
decrypter := dongle.Decrypt.FromHexString(hexString).ByAes(c)
// Hexエンコードバイトスライスを入力
decrypter := dongle.Decrypt.FromHexBytes(hexBytes).ByAes(c)
// Hexエンコードファイルを入力
file, _ := os.Open("encrypted.hex")
decrypter := dongle.Decrypt.FromHexFile(file).ByAes(c)

// Base64エンコード文字列を入力
decrypter := dongle.Decrypt.FromBase64String(base64String).ByAes(c)
// Base64エンコードバイトスライスを入力
decrypter := dongle.Decrypt.FromBase64Bytes(base64Bytes).ByAes(c)
// Base64エンコードファイルストリームを入力
file, _ := os.Open("encrypted.base64")
decrypter := dongle.Decrypt.FromBase64File(file).ByAes(c)

// 生文字列を入力
decrypter := dongle.Decrypt.FromRawString(rawString).ByAes(c)
// 生バイトスライスを入力
decrypter := dongle.Decrypt.FromRawBytes(rawBytes).ByAes(c)
// 生ファイルストリームを入力
file, _ := os.Open("encrypted.bin")
decrypter := dongle.Decrypt.FromRawFile(file).ByAes(c)

// 復号化エラーをチェック
if decrypter.Error != nil {
	fmt.Printf("復号化エラー: %v\n", decrypter.Error)
	return
}

出力データ

go
// 復号化後の文字列を出力
decrypter.ToString() // hello world
// 復号化後のバイトスライスを出力
decrypter.ToBytes()  // []byte("hello world")

ECBモード ​

Cipherの作成 ​

go
c := cipher.NewAesCipher(cipher.ECB)
// 鍵を設定（16バイト）
c.SetKey([]byte("dongle1234567890"))
// パディングモードを設定
c.SetPadding(cipher.PKCS7)

データの暗号化 ​

入力データ

go
// 入力文字列
encrypter := dongle.Encrypt.FromString("hello world").ByAes(c)
// 入力バイトスライス
encrypter := dongle.Encrypt.FromBytes([]byte("hello world")).ByAes(c)
// 入力ファイルストリーム
file, _ := os.Open("test.txt")
encrypter := dongle.Encrypt.FromFile(file).ByAes(c)

// 暗号化エラーをチェック
if encrypter.Error != nil {
	fmt.Printf("暗号化エラー: %v\n", encrypter.Error)
	return
}

出力データ

go
// エンコードされていない生の文字列を出力
encrypter.ToHexString() // b32102513a0675ddb7ca7b8b4b26abce
// エンコードされていない生のバイトスライスを出力
encrypter.ToHexBytes()  // []byte("b32102513a0675ddb7ca7b8b4b26abce")

// エンコードされていない生の文字列を出力
encrypter.ToBase64String() // syECUToGdd23ynuLSyarzg==
// エンコードされていない生のバイトスライスを出力
encrypter.ToBase64Bytes()  // []byte("syECUToGdd23ynuLSyarzg==")

// エンコードされていない生の文字列を出力
encrypter.ToRawString()
// エンコードされていない生のバイトスライスを出力
encrypter.ToRawBytes()

データの復号化 ​

入力データ

go
// Hexエンコード文字列を入力
decrypter := dongle.Decrypt.FromHexString(hexString).ByAes(c)
// Hexエンコードバイトスライスを入力
decrypter := dongle.Decrypt.FromHexBytes(hexBytes).ByAes(c)
// Hexエンコードファイルストリームを入力
file, _ := os.Open("encrypted.hex")
decrypter := dongle.Decrypt.FromHexFile(file).ByAes(c)

// Base64エンコード文字列を入力
decrypter := dongle.Decrypt.FromBase64String(base64String).ByAes(c)
// Base64エンコードバイトスライスを入力
decrypter := dongle.Decrypt.FromBase64Bytes(base64Bytes).ByAes(c)
// Base64エンコードファイルストリームを入力
file, _ := os.Open("encrypted.base64")
decrypter := dongle.Decrypt.FromBase64File(file).ByAes(c)

// 生文字列を入力
decrypter := dongle.Decrypt.FromRawString(rawString).ByAes(c)
// 生バイトスライスを入力
decrypter := dongle.Decrypt.FromRawBytes(rawBytes).ByAes(c)
// 生ファイルストリームを入力
file, _ := os.Open("encrypted.bin")
decrypter := dongle.Decrypt.FromRawFile(file).ByAes(c)

// 復号化エラーをチェック
if decrypter.Error != nil {
	fmt.Printf("復号化エラー: %v\n", decrypter.Error)
	return
}

出力データ

go
// 復号化後の文字列を出力
decrypter.ToString() // hello world
// 復号化後のバイトスライスを出力
decrypter.ToBytes()  // []byte("hello world")

CTRモード ​

Cipherの作成 ​

go
c := cipher.NewAesCipher(cipher.CTR)
// 鍵を設定（16バイト）
c.SetKey([]byte("dongle1234567890"))
// 初期化ベクトルを設定（16バイト）
c.SetIV([]byte("1234567890123456"))

データの暗号化 ​

入力データ

go
// 入力文字列
encrypter := dongle.Encrypt.FromString("hello world").ByAes(c)
// 入力バイトスライス
encrypter := dongle.Encrypt.FromBytes([]byte("hello world")).ByAes(c)
// 入力ファイルストリーム
file, _ := os.Open("test.txt")
encrypter := dongle.Encrypt.FromFile(file).ByAes(c)

// 暗号化エラーをチェック
if encrypter.Error != nil {
	fmt.Printf("暗号化エラー: %v\n", encrypter.Error)
	return
}

出力データ

go
// Hex エンコードされた文字列を出力
encrypter.ToHexString() // d081959747c6a9a357665b
// Hex エンコードされたバイトスライスを出力
encrypter.ToHexBytes()  // []byte("d081959747c6a9a357665b")

// Base64 エンコードされた文字列を出力
encrypter.ToBase64String() // 0IGVl0fGqaNXZls=
// Base64 エンコードされたバイトスライスを出力
encrypter.ToBase64Bytes()  // []byte("0IGVl0fGqaNXZls=")

// エンコードされていない生の文字列を出力
encrypter.ToRawString()
// エンコードされていない生のバイトスライスを出力
encrypter.ToRawBytes()

データの復号化 ​

入力データ

go
// Hexエンコード文字列を入力
decrypter := dongle.Decrypt.FromHexString(hexString).ByAes(c)
// Hexエンコードバイトスライスを入力
decrypter := dongle.Decrypt.FromHexBytes(hexBytes).ByAes(c)
// Hexエンコードファイルストリームを入力
file, _ := os.Open("encrypted.hex")
decrypter := dongle.Decrypt.FromHexFile(file).ByAes(c)

// Base64エンコード文字列を入力
decrypter := dongle.Decrypt.FromBase64String(base64String).ByAes(c)
// Base64エンコードバイトスライスを入力
decrypter := dongle.Decrypt.FromBase64Bytes(base64Bytes).ByAes(c)
// Base64エンコードファイルストリームを入力
file, _ := os.Open("encrypted.base64")
decrypter := dongle.Decrypt.FromBase64File(file).ByAes(c)

// 生文字列を入力
decrypter := dongle.Decrypt.FromRawString(rawString).ByAes(c)
// 生バイトスライスを入力
decrypter := dongle.Decrypt.FromRawBytes(rawBytes).ByAes(c)
// 生ファイルストリームを入力
file, _ := os.Open("encrypted.bin")
decrypter := dongle.Decrypt.FromRawFile(file).ByAes(c)

// 復号化エラーをチェック
if decrypter.Error != nil {
	fmt.Printf("復号化エラー: %v\n", decrypter.Error)
	return
}

出力データ

go
// 復号化後の文字列を出力
decrypter.ToString() // hello world
// 復号化後のバイトスライスを出力
decrypter.ToBytes()  // []byte("hello world")

GCMモード ​

GCMモードは認証暗号化機能を提供し、追加認証データ（AAD）をサポートします。

Cipherの作成 ​

go
c := cipher.NewAesCipher(cipher.GCM)
// 鍵を設定（16バイト）
c.SetKey([]byte("dongle1234567890"))
// 乱数を設定（1-255バイト）
c.SetNonce([]byte("1234567890"))
// 追加認証データを設定（オプション）
c.SetAAD([]byte("dongle"))

データの暗号化 ​

入力データ

go
// 入力文字列
encrypter := dongle.Encrypt.FromString("hello world").ByAes(c)
// 入力バイトスライス
encrypter := dongle.Encrypt.FromBytes([]byte("hello world")).ByAes(c)
// 入力ファイルストリーム
file, _ := os.Open("test.txt")
encrypter := dongle.Encrypt.FromFile(file).ByAes(c)

// 暗号化エラーをチェック
if encrypter.Error != nil {
	fmt.Printf("暗号化エラー: %v\n", encrypter.Error)
	return
}

出力データ

go
// エンコードされていない生の文字列を出力
encrypter.ToHexString() // 0ffef48b9154a7234cc04e373f86198a8ed7b27f054ad7886c677b
// エンコードされていない生のバイトスライスを出力
encrypter.ToHexBytes()  // []byte("0ffef48b9154a7234cc04e373f86198a8ed7b27f054ad7886c677b")

// エンコードされていない生の文字列を出力
encrypter.ToBase64String() // D/70i5FUpyNMwE43P4YZio7Xsn8FStcIbGd7
// エンコードされていない生のバイトスライスを出力
encrypter.ToBase64Bytes()  // []byte("D/70i5FUpyNMwE43P4YZio7Xsn8FStcIbGd7")

// エンコードされていない生の文字列を出力
encrypter.ToRawString()
// エンコードされていない生のバイトスライスを出力
encrypter.ToRawBytes()

データの復号化 ​

入力データ

go
// Hexエンコード文字列を入力
decrypter := dongle.Decrypt.FromHexString(hexString).ByAes(c)
// Hexエンコードバイトスライスを入力
decrypter := dongle.Decrypt.FromHexBytes(hexBytes).ByAes(c)
// Hexエンコードファイルストリームを入力
file, _ := os.Open("encrypted.hex")
decrypter := dongle.Decrypt.FromHexFile(file).ByAes(c)

// Base64エンコード文字列を入力
decrypter := dongle.Decrypt.FromBase64String(base64String).ByAes(c)
// Base64エンコードバイトスライスを入力
decrypter := dongle.Decrypt.FromBase64Bytes(base64Bytes).ByAes(c)
// Base64エンコードファイルストリームを入力
file, _ := os.Open("encrypted.base64")
decrypter := dongle.Decrypt.FromBase64File(file).ByAes(c)

// 生文字列を入力
decrypter := dongle.Decrypt.FromRawString(rawString).ByAes(c)
// 生バイトスライスを入力
decrypter := dongle.Decrypt.FromRawBytes(rawBytes).ByAes(c)
// 生ファイルストリームを入力
file, _ := os.Open("encrypted.bin")
decrypter := dongle.Decrypt.FromRawFile(file).ByAes(c)

// 復号化エラーをチェック
if decrypter.Error != nil {
	fmt.Printf("復号化エラー: %v\n", decrypter.Error)
	return
}

出力データ

go
// 復号化後の文字列を出力
decrypter.ToString() // hello world
// 復号化後のバイトスライスを出力
decrypter.ToBytes()  // []byte("hello world")

CFBモード ​

注意：CFBモードはCFB8実装を使用します。最初の16バイトのデータについて、CFB8とOFBモードは同じ暗号化結果を生成します。これはGo標準ライブラリのCFB8実装の特性であり、エラーではありません。

Cipherの作成 ​

go
c := cipher.NewAesCipher(cipher.CFB)
// 鍵を設定（16バイト）
c.SetKey([]byte("dongle1234567890"))
// 初期化ベクトルを設定（16バイト）
c.SetIV([]byte("1234567890123456"))

データの暗号化 ​

入力データ

go
// 入力文字列
encrypter := dongle.Encrypt.FromString("hello world").ByAes(c)
// 入力バイトスライス
encrypter := dongle.Encrypt.FromBytes([]byte("hello world")).ByAes(c)
// 入力ファイルストリーム
file, _ := os.Open("test.txt")
encrypter := dongle.Encrypt.FromFile(file).ByAes(c)

// 暗号化エラーをチェック
if encrypter.Error != nil {
	fmt.Printf("暗号化エラー: %v\n", encrypter.Error)
	return
}

出力データ

go
// エンコードされていない生の文字列を出力
encrypter.ToHexString() // d081959747c6a9a357665b
// エンコードされていない生のバイトスライスを出力
encrypter.ToHexBytes()  // []byte("d081959747c6a9a357665b")

// エンコードされていない生の文字列を出力
encrypter.ToBase64String() // 0IGVl0fGqaNXZls=
// エンコードされていない生のバイトスライスを出力
encrypter.ToBase64Bytes()  // []byte("0IGVl0fGqaNXZls=")

// エンコードされていない生の文字列を出力
encrypter.ToRawString()
// エンコードされていない生のバイトスライスを出力
encrypter.ToRawBytes()

データの復号化 ​

入力データ

go
// Hexエンコード文字列を入力
decrypter := dongle.Decrypt.FromHexString(hexString).ByAes(c)
// Hexエンコードバイトスライスを入力
decrypter := dongle.Decrypt.FromHexBytes(hexBytes).ByAes(c)
// Hexエンコードファイルストリームを入力
file, _ := os.Open("encrypted.hex")
decrypter := dongle.Decrypt.FromHexFile(file).ByAes(c)

// Base64エンコード文字列を入力
decrypter := dongle.Decrypt.FromBase64String(base64String).ByAes(c)
// Base64エンコードバイトスライスを入力
decrypter := dongle.Decrypt.FromBase64Bytes(base64Bytes).ByAes(c)
// Base64エンコードファイルストリームを入力
file, _ := os.Open("encrypted.base64")
decrypter := dongle.Decrypt.FromBase64File(file).ByAes(c)

// 生文字列を入力
decrypter := dongle.Decrypt.FromRawString(rawString).ByAes(c)
// 生バイトスライスを入力
decrypter := dongle.Decrypt.FromRawBytes(rawBytes).ByAes(c)
// 生ファイルストリームを入力
file, _ := os.Open("encrypted.bin")
decrypter := dongle.Decrypt.FromRawFile(file).ByAes(c)

// 復号化エラーをチェック
if decrypter.Error != nil {
	fmt.Printf("復号化エラー: %v\n", decrypter.Error)
	return
}

出力データ

go
// 復号化後の文字列を出力
decrypter.ToString() // hello world
// 復号化後のバイトスライスを出力
decrypter.ToBytes()  // []byte("hello world")

OFBモード ​

注意：CFBモードはCFB8実装を使用します。最初の16バイトのデータの場合、CFB8とOFBモードは同じ暗号化結果を生成します。これはGo標準ライブラリCFB8実装の特性であり、バグではありません。

Cipherの作成 ​

go
c := cipher.NewAesCipher(cipher.OFB)
// 鍵を設定（16バイト）
c.SetKey([]byte("dongle1234567890"))
// 初期化ベクトルを設定（16バイト）
c.SetIV([]byte("1234567890123456"))

データの暗号化 ​

入力データ

go
// 入力文字列
encrypter := dongle.Encrypt.FromString("hello world").ByAes(c)
// 入力バイトスライス
encrypter := dongle.Encrypt.FromBytes([]byte("hello world")).ByAes(c)
// 入力ファイルストリーム
file, _ := os.Open("test.txt")
encrypter := dongle.Encrypt.FromFile(file).ByAes(c)

// 暗号化エラーをチェック
if encrypter.Error != nil {
	fmt.Printf("暗号化エラー: %v\n", encrypter.Error)
	return
}

出力データ

go
// エンコードされていない生の文字列を出力
encrypter.ToHexString() // d081959747c6a9a357665b
// エンコードされていない生のバイトスライスを出力
encrypter.ToHexBytes()  // []byte("d081959747c6a9a357665b")

// エンコードされていない生の文字列を出力
encrypter.ToBase64String() // 0IGVl0fGqaNXZls=
// エンコードされていない生のバイトスライスを出力
encrypter.ToBase64Bytes()  // []byte("0IGVl0fGqaNXZls=")

// エンコードされていない生の文字列を出力
encrypter.ToRawString()
// エンコードされていない生のバイトスライスを出力
encrypter.ToRawBytes()

データの復号化 ​

入力データ

go
// Hexエンコード文字列を入力
decrypter := dongle.Decrypt.FromHexString(hexString).ByAes(c)
// Hexエンコードバイトスライスを入力
decrypter := dongle.Decrypt.FromHexBytes(hexBytes).ByAes(c)
// Hexエンコードファイルストリームを入力
file, _ := os.Open("encrypted.hex")
decrypter := dongle.Decrypt.FromHexFile(file).ByAes(c)

// Base64エンコード文字列を入力
decrypter := dongle.Decrypt.FromBase64String(base64String).ByAes(c)
// Base64エンコードバイトスライスを入力
decrypter := dongle.Decrypt.FromBase64Bytes(base64Bytes).ByAes(c)
// Base64エンコードファイルストリームを入力
file, _ := os.Open("encrypted.base64")
decrypter := dongle.Decrypt.FromBase64File(file).ByAes(c)

// 生文字列を入力
decrypter := dongle.Decrypt.FromRawString(rawString).ByAes(c)
// 生バイトスライスを入力
decrypter := dongle.Decrypt.FromRawBytes(rawBytes).ByAes(c)
// 生ファイルストリームを入力
file, _ := os.Open("encrypted.bin")
decrypter := dongle.Decrypt.FromRawFile(file).ByAes(c)

// 復号化エラーをチェック
if decrypter.Error != nil {
	fmt.Printf("復号化エラー: %v\n", decrypter.Error)
	return
}

出力データ

go
// 復号化後の文字列を出力
decrypter.ToString() // hello world
// 復号化後のバイトスライスを出力
decrypter.ToBytes()  // []byte("hello world")

MITライセンスに基づいて公開されており、許可なく複製することは禁止されています

無断転載を禁じます © 2020-2025 dongle team