Algorithms - 3DES
Functions
Name | |
---|---|
int | wc_Des_SetKey(Des * des, const byte * key, const byte * iv, int dir) この関数は、引数として与えられたDES構造体のキーと初期化ベクトル(IV)を設定します。また、これらがまだ初期化されていない場合は、暗号化と復号化に必要なバッファーのスペースを初期化して割り当てます。注:IVが指定されていない場合(i.e.iv == null)初期化ベクトルは、デフォルトのIV 0になります。 |
void | wc_Des_SetIV(Des * des, const byte * iv) この関数は、引数として与えられたDES構造体の初期化ベクトル(IV)を設定します。NULL IVを渡したら、初期化ベクトルを0に設定します。 |
int | wc_Des_CbcEncrypt(Des * des, byte * out, const byte * in, word32 sz) この関数は入力メッセージを暗号化し、結果を出力バッファーに格納します。暗号ブロックチェーンチェーン(CBC)モードでDES暗号化を使用します。 |
int | wc_Des_CbcDecrypt(Des * des, byte * out, const byte * in, word32 sz) この関数は入力暗号文を復号化し、結果の平文を出力バッファーに出力します。暗号ブロックチェーンチェーン(CBC)モードでDES暗号化を使用します。 |
int | wc_Des_EcbEncrypt(Des * des, byte * out, const byte * in, word32 sz) この関数は入力メッセージを暗号化し、結果を出力バッファーに格納します。電子コードブック(ECB)モードでDES暗号化を使用します。 |
int | wc_Des3_EcbEncrypt(Des3 * des, byte * out, const byte * in, word32 sz) この関数は入力メッセージを暗号化し、結果を出力バッファーに格納します。電子コードブック(ECB)モードでDES3暗号化を使用します。警告:ほぼすべてのユースケースでECBモードは安全性が低いと考えられています。可能な限りECB APIを直接使用しないでください。 |
int | wc_Des3_SetKey(Des3 * des, const byte * key, const byte * iv, int dir) この関数は、引数として与えられたDES3構造のキーと初期化ベクトル(IV)を設定します。また、これらがまだ初期化されていない場合は、暗号化と復号化に必要なバッファーのスペースを初期化して割り当てます。注:IVが指定されていない場合(i.e.iv == null)初期化ベクトルは、デフォルトのIV 0になります。 |
int | wc_Des3_SetIV(Des3 * des, const byte * iv) この関数は、引数として与えられたDES3構造の初期化ベクトル(IV)を設定します。NULL IVを渡したら、初期化ベクトルを0に設定します。 |
int | wc_Des3_CbcEncrypt(Des3 * des, byte * out, const byte * in, word32 sz) この関数は入力メッセージを暗号化し、結果を出力バッファーに格納します。暗号ブロックチェーン(CBC)モードでトリプルDES(3DES)暗号化を使用します。 |
int | wc_Des3_CbcDecrypt(Des3 * des, byte * out, const byte * in, word32 sz) この関数は入力暗号文を復号化し、結果の平文を出力バッファーに出力します。暗号ブロックチェーン(CBC)モードでトリプルDES(3DES)暗号化を使用します。 |
int | wc_Des_CbcDecryptWithKey(byte * out, const byte * in, word32 sz, const byte * key, const byte * iv) この関数は入力暗号文を復号化し、結果の平文を出力バッファーに出力します。暗号ブロックチェーンチェーン(CBC)モードでDES暗号化を使用します。この関数は、wc_des_cbcdecryptの代わりに、ユーザーがDES構造体を直接インスタンス化せずにメッセージを復号化できるようにします。 |
int | wc_Des_CbcEncryptWithKey(byte * out, const byte * in, word32 sz, const byte * key, const byte * iv) この関数は入力平文を暗号化し、結果の暗号文を出力バッファーに出力します。暗号ブロックチェーンチェーン(CBC)モードでDES暗号化を使用します。この関数は、WC_DES_CBCENCRYPTの代わりになり、ユーザーがDES構造を直接インスタンス化せずにメッセージを暗号化できます。 |
int | wc_Des3_CbcEncryptWithKey(byte * out, const byte * in, word32 sz, const byte * key, const byte * iv) この関数は入力平文を暗号化し、結果の暗号文を出力バッファーに出力します。暗号ブロックチェーン(CBC)モードでトリプルDES(3DES)暗号化を使用します。この関数は、WC_DES3_CBCENCRYPTの代わりになり、ユーザーがDES3構造を直接インスタンス化せずにメッセージを暗号化できます。 |
int | wc_Des3_CbcDecryptWithKey(byte * out, const byte * in, word32 sz, const byte * key, const byte * iv) この関数は入力暗号文を復号化し、結果の平文を出力バッファーに出力します。暗号ブロックチェーン(CBC)モードでトリプルDES(3DES)暗号化を使用します。この関数は、wc_des3_cbcdecryptの代わりに、ユーザーがDES3構造を直接インスタンス化せずにメッセージを復号化できるようにします。 |
Functions Documentation
function wc_Des_SetKey
int wc_Des_SetKey(
Des * des,
const byte * key,
const byte * iv,
int dir
)
この関数は、引数として与えられたDES構造体のキーと初期化ベクトル(IV)を設定します。また、これらがまだ初期化されていない場合は、暗号化と復号化に必要なバッファーのスペースを初期化して割り当てます。注:IVが指定されていない場合(i.e.iv == null)初期化ベクトルは、デフォルトのIV 0になります。
Parameters:
- des 初期化するDES構造へのポインタ
- key DES構造を初期化するための8バイトのキーを含むバッファへのポインタ
- iv DES構造を初期化するための8バイトIVを含むバッファへのポインタ。これが提供されていない場合、IVはデフォルトで0になります Example
Des enc; // Des structure used for encryption
int ret;
byte key[] = { // initialize with 8 byte key };
byte iv[] = { // initialize with 8 byte iv };
ret = wc_Des_SetKey(&des, key, iv, DES_ENCRYPTION);
if (ret != 0) {
// error initializing des structure
}
See:
Return: 0 DES構造体のキーと初期化ベクトルを正常に設定する
3
function wc_Des_SetIV
void wc_Des_SetIV(
Des * des,
const byte * iv
)
この関数は、引数として与えられたDES構造体の初期化ベクトル(IV)を設定します。NULL IVを渡したら、初期化ベクトルを0に設定します。
Parameters:
- des IVを設定するためのDES構造へのポインタ Example
Des enc; // Des structure used for encryption
// initialize enc with wc_Des_SetKey
byte iv[] = { // initialize with 8 byte iv };
wc_Des_SetIV(&enc, iv);
}
See: wc_Des_SetKey
Return: none いいえ返します。
3
function wc_Des_CbcEncrypt
int wc_Des_CbcEncrypt(
Des * des,
byte * out,
const byte * in,
word32 sz
)
この関数は入力メッセージを暗号化し、結果を出力バッファーに格納します。暗号ブロックチェーンチェーン(CBC)モードでDES暗号化を使用します。
Parameters:
- des 暗号化に使用するDES構造へのポインタ
- out 暗号化された暗号文を保存するバッファへのポインタ
- in 暗号化するメッセージを含む入力バッファへのポインタ Example
Des enc; // Des structure used for encryption
// initialize enc with wc_Des_SetKey, use mode DES_ENCRYPTION
byte plain[] = { // initialize with message };
byte cipher[sizeof(plain)];
if ( wc_Des_CbcEncrypt(&enc, cipher, plain, sizeof(plain)) != 0) {
// error encrypting message
}
See:
Return: 0 与えられた入力メッセージの暗号化に成功したときに返されます
3
function wc_Des_CbcDecrypt
int wc_Des_CbcDecrypt(
Des * des,
byte * out,
const byte * in,
word32 sz
)
この関数は入力暗号文を復号化し、結果の平文を出力バッファーに出力します。暗号ブロックチェーンチェーン(CBC)モードでDES暗号化を使用します。
Parameters:
- des 復号化に使用するDES構造へのポインタ
- out 復号化された平文を保存するバッファへのポインタ
- in 暗号化された暗号文を含む入力バッファへのポインタ Example
Des dec; // Des structure used for decryption
// initialize dec with wc_Des_SetKey, use mode DES_DECRYPTION
byte cipher[] = { // initialize with ciphertext };
byte decoded[sizeof(cipher)];
if ( wc_Des_CbcDecrypt(&dec, decoded, cipher, sizeof(cipher)) != 0) {
// error decrypting message
}
See:
Return: 0 与えられた暗号文を正常に復号化したときに返されました
3
function wc_Des_EcbEncrypt
int wc_Des_EcbEncrypt(
Des * des,
byte * out,
const byte * in,
word32 sz
)
この関数は入力メッセージを暗号化し、結果を出力バッファーに格納します。電子コードブック(ECB)モードでDES暗号化を使用します。
Parameters:
- des 暗号化に使用するDES構造へのポインタ
- out 暗号化されたメッセージを保存するバッファへのポインタ
- in 暗号化する平文を含む入力バッファへのポインタ Example
Des enc; // Des structure used for encryption
// initialize enc with wc_Des_SetKey, use mode DES_ENCRYPTION
byte plain[] = { // initialize with message to encrypt };
byte cipher[sizeof(plain)];
if ( wc_Des_EcbEncrypt(&enc,cipher, plain, sizeof(plain)) != 0) {
// error encrypting message
}
See: wc_Des_SetKe
Return: 0: 与えられた平文を正常に暗号化すると返されます。
3
function wc_Des3_EcbEncrypt
int wc_Des3_EcbEncrypt(
Des3 * des,
byte * out,
const byte * in,
word32 sz
)
この関数は入力メッセージを暗号化し、結果を出力バッファーに格納します。電子コードブック(ECB)モードでDES3暗号化を使用します。警告:ほぼすべてのユースケースでECBモードは安全性が低いと考えられています。可能な限りECB APIを直接使用しないでください。
Parameters:
- des3 暗号化に使用するDES3構造へのポインタ
- out 暗号化されたメッセージを保存するバッファへのポインタ
- in 暗号化する平文を含む入力バッファへのポインタ Example
Des3 enc; // Des3 structure used for encryption
// initialize enc with wc_Des3_SetKey, use mode DES_ENCRYPTION
byte plain[] = { // initialize with message to encrypt };
byte cipher[sizeof(plain)];
if ( wc_Des3_EcbEncrypt(&enc,cipher, plain, sizeof(plain)) != 0) {
// error encrypting message
}
See: wc_Des3_SetKey
Return: 0 与えられた平文を正常に暗号化すると返されます
3
function wc_Des3_SetKey
int wc_Des3_SetKey(
Des3 * des,
const byte * key,
const byte * iv,
int dir
)
この関数は、引数として与えられたDES3構造のキーと初期化ベクトル(IV)を設定します。また、これらがまだ初期化されていない場合は、暗号化と復号化に必要なバッファーのスペースを初期化して割り当てます。注:IVが指定されていない場合(i.e.iv == null)初期化ベクトルは、デフォルトのIV 0になります。
Parameters:
- des3 初期化するDES3構造へのポインタ
- key DES3構造を初期化する24バイトのキーを含むバッファへのポインタ
- iv DES3構造を初期化するための8バイトIVを含むバッファへのポインタ。これが提供されていない場合、IVはデフォルトで0になります Example
Des3 enc; // Des3 structure used for encryption
int ret;
byte key[] = { // initialize with 24 byte key };
byte iv[] = { // initialize with 8 byte iv };
ret = wc_Des3_SetKey(&des, key, iv, DES_ENCRYPTION);
if (ret != 0) {
// error initializing des structure
}
See:
Return: 0 DES構造体のキーと初期化ベクトルを正常に設定する
3
function wc_Des3_SetIV
int wc_Des3_SetIV(
Des3 * des,
const byte * iv
)
この関数は、引数として与えられたDES3構造の初期化ベクトル(IV)を設定します。NULL IVを渡したら、初期化ベクトルを0に設定します。
Parameters:
- des IVを設定するためのDES3構造へのポインタ Example
Des3 enc; // Des3 structure used for encryption
// initialize enc with wc_Des3_SetKey
byte iv[] = { // initialize with 8 byte iv };
wc_Des3_SetIV(&enc, iv);
}
See: wc_Des3_SetKey
Return: none いいえ返します。
3
function wc_Des3_CbcEncrypt
int wc_Des3_CbcEncrypt(
Des3 * des,
byte * out,
const byte * in,
word32 sz
)
この関数は入力メッセージを暗号化し、結果を出力バッファーに格納します。暗号ブロックチェーン(CBC)モードでトリプルDES(3DES)暗号化を使用します。
Parameters:
- des 暗号化に使用するDES3構造へのポインタ
- out 暗号化された暗号文を保存するバッファへのポインタ
- in 暗号化するメッセージを含む入力バッファへのポインタ Example
Des3 enc; // Des3 structure used for encryption
// initialize enc with wc_Des3_SetKey, use mode DES_ENCRYPTION
byte plain[] = { // initialize with message };
byte cipher[sizeof(plain)];
if ( wc_Des3_CbcEncrypt(&enc, cipher, plain, sizeof(plain)) != 0) {
// error encrypting message
}
See:
Return: 0 与えられた入力メッセージの暗号化に成功したときに返されます
3
function wc_Des3_CbcDecrypt
int wc_Des3_CbcDecrypt(
Des3 * des,
byte * out,
const byte * in,
word32 sz
)
この関数は入力暗号文を復号化し、結果の平文を出力バッファーに出力します。暗号ブロックチェーン(CBC)モードでトリプルDES(3DES)暗号化を使用します。
Parameters:
- des 復号化に使用するDES3構造へのポインタ
- out 復号化された平文を保存するバッファへのポインタ
- in 暗号化された暗号文を含む入力バッファへのポインタ Example
Des3 dec; // Des structure used for decryption
// initialize dec with wc_Des3_SetKey, use mode DES_DECRYPTION
byte cipher[] = { // initialize with ciphertext };
byte decoded[sizeof(cipher)];
if ( wc_Des3_CbcDecrypt(&dec, decoded, cipher, sizeof(cipher)) != 0) {
// error decrypting message
}
See:
Return: 0 与えられた暗号文を正常に復号化したときに返されました
3
function wc_Des_CbcDecryptWithKey
int wc_Des_CbcDecryptWithKey(
byte * out,
const byte * in,
word32 sz,
const byte * key,
const byte * iv
)
この関数は入力暗号文を復号化し、結果の平文を出力バッファーに出力します。暗号ブロックチェーンチェーン(CBC)モードでDES暗号化を使用します。この関数は、wc_des_cbcdecryptの代わりに、ユーザーがDES構造体を直接インスタンス化せずにメッセージを復号化できるようにします。
Parameters:
- out 復号化された平文を保存するバッファへのポインタ
- in 暗号化された暗号文を含む入力バッファへのポインタ
- sz 復号化する暗号文の長さ
- key 復号化に使用する8バイトのキーを含むバッファへのポインタ Example
int ret;
byte key[] = { // initialize with 8 byte key };
byte iv[] = { // initialize with 8 byte iv };
byte cipher[] = { // initialize with ciphertext };
byte decoded[sizeof(cipher)];
if ( wc_Des_CbcDecryptWithKey(decoded, cipher, sizeof(cipher), key,
iv) != 0) {
// error decrypting message
}
See: wc_Des_CbcDecrypt
Return:
- 0 与えられた暗号文を正常に復号化したときに返されました
- MEMORY_E DES構造体の割り当てスペースが割り当てられている場合に返された
3
function wc_Des_CbcEncryptWithKey
int wc_Des_CbcEncryptWithKey(
byte * out,
const byte * in,
word32 sz,
const byte * key,
const byte * iv
)
この関数は入力平文を暗号化し、結果の暗号文を出力バッファーに出力します。暗号ブロックチェーンチェーン(CBC)モードでDES暗号化を使用します。この関数は、WC_DES_CBCENCRYPTの代わりになり、ユーザーがDES構造を直接インスタンス化せずにメッセージを暗号化できます。
Parameters:
- out 最終暗号化データ
- in 暗号化されるデータは、DESブロックサイズに埋められなければなりません。
- sz 入力バッファのサイズ
- key 暗号化に使用するキーへのポインタ。 Example
byte key[] = { // initialize with 8 byte key };
byte iv[] = { // initialize with 8 byte iv };
byte in[] = { // Initialize with plaintext };
byte out[sizeof(in)];
if ( wc_Des_CbcEncryptWithKey(&out, in, sizeof(in), key, iv) != 0)
{
// error encrypting message
}
See:
Return:
- 0 データの暗号化に成功した後に返されます。
- MEMORY_E DES構造体にメモリを割り当てるエラーがある場合は返されます。
- <0 暗号化中に任意のエラーに戻ります。
3
function wc_Des3_CbcEncryptWithKey
int wc_Des3_CbcEncryptWithKey(
byte * out,
const byte * in,
word32 sz,
const byte * key,
const byte * iv
)
この関数は入力平文を暗号化し、結果の暗号文を出力バッファーに出力します。暗号ブロックチェーン(CBC)モードでトリプルDES(3DES)暗号化を使用します。この関数は、WC_DES3_CBCENCRYPTの代わりになり、ユーザーがDES3構造を直接インスタンス化せずにメッセージを暗号化できます。
Parameters:
- out 最終暗号化データ
- in 暗号化されるデータは、DESブロックサイズに埋められなければなりません。
- sz 入力バッファのサイズ
- key 暗号化に使用するキーへのポインタ。 Example
byte key[] = { // initialize with 8 byte key };
byte iv[] = { // initialize with 8 byte iv };
byte in[] = { // Initialize with plaintext };
byte out[sizeof(in)];
if ( wc_Des3_CbcEncryptWithKey(&out, in, sizeof(in), key, iv) != 0)
{
// error encrypting message
}
See:
Return:
- 0 データの暗号化に成功した後に返されます。
- MEMORY_E DES構造体にメモリを割り当てるエラーがある場合は返されます。
- <0 暗号化中に任意のエラーに戻ります。
3
function wc_Des3_CbcDecryptWithKey
int wc_Des3_CbcDecryptWithKey(
byte * out,
const byte * in,
word32 sz,
const byte * key,
const byte * iv
)
この関数は入力暗号文を復号化し、結果の平文を出力バッファーに出力します。暗号ブロックチェーン(CBC)モードでトリプルDES(3DES)暗号化を使用します。この関数は、wc_des3_cbcdecryptの代わりに、ユーザーがDES3構造を直接インスタンス化せずにメッセージを復号化できるようにします。
Parameters:
- out 復号化された平文を保存するバッファへのポインタ
- in 暗号化された暗号文を含む入力バッファへのポインタ
- sz 復号化する暗号文の長さ
- key 復号化に使用する24バイトのキーを含むバッファへのポインタ Example
int ret;
byte key[] = { // initialize with 24 byte key };
byte iv[] = { // initialize with 8 byte iv };
byte cipher[] = { // initialize with ciphertext };
byte decoded[sizeof(cipher)];
if ( wc_Des3_CbcDecryptWithKey(decoded, cipher, sizeof(cipher),
key, iv) != 0) {
// error decrypting message
}
See: wc_Des3_CbcDecrypt
Return:
- 0 与えられた暗号文を正常に復号化したときに返されました
- MEMORY_E DES構造体の割り当てスペースが割り当てられている場合に返された
3
Updated on 2024-10-08 at 02:32:48 +0000