BIO_F_CIPHER(3SSL)

NUME
BIO_f_cipher, BIO_set_cipher, BIO_get_cipher_status, BIO_get_cipher_ctx - filtru BIO de cifrare

SINOPSIS
 #include <openssl/bio.h>
 #include <openssl/evp.h>

 const BIO_METHOD *BIO_f_cipher(void);
 int BIO_set_cipher(BIO *b, const EVP_CIPHER *cipher,
                    const unsigned char *key, const unsigned char *iv, int enc);
 int BIO_get_cipher_status(BIO *b);
 int BIO_get_cipher_ctx(BIO *b, EVP_CIPHER_CTX **pctx);

DESCRIERE
BIO_f_cipher() returnează metoda BIO de criptare. Acesta este un filtru BIO care criptează orice date scrise prin intermediul său și decriptează orice date citite din acesta. Este un înveliș BIO pentru rutinele de criptare EVP_CipherInit(), EVP_CipherUpdate() și EVP_CipherFinal().

Cifrările BIO nu acceptă BIO_gets() sau BIO_puts().

BIO_flush() pe un BIO de criptare care este scris este utilizat pentru a semnala că nu mai sunt date de criptat: acesta este utilizat pentru a goli și, eventual, a completa blocul final prin BIO.

BIO_set_cipher() definește cifrul BIO b la cipher folosind cheia key și IV iv. enc trebuie fixat la 1 pentru criptare și la zero pentru decriptare.

Când se citește dintr-un BIO criptat, blocul final este decriptat automat și verificat când se detectează EOF. BIO_get_cipher_status() este o macrocomandă BIO_ctrl() care poate fi apelată pentru a determina dacă operația de decriptare a avut succes.

BIO_get_cipher_ctx() este o macrocomandă BIO_ctrl() care recuperează contextul intern de criptare BIO. Contextul recuperat poate fi utilizat împreună cu rutinele standard de criptare pentru a-l configura. Acest lucru este util atunci când BIO_set_cipher() nu este suficient de flexibilă pentru nevoile aplicațiilor.

NOTE
La criptarea BIO_flush(), trebuie să fie apelată pentru a goli blocul final prin BIO. Dacă nu se face acest lucru, blocul final va eșua la decriptarea ulterioară.

Când se decriptează, o eroare pe blocul final este semnalată printr-o valoare de returnare zero din operația de citire. O decriptare reușită urmată de EOF va returna, de asemenea, zero pentru citirea finală. BIO_get_cipher_status() trebuie apelată pentru a determina dacă decriptarea a reușit.

Ca întotdeauna, dacă este nevoie de suport pentru BIO_gets() sau BIO_puts(), acesta poate fi obținut prin precedarea BIO-ului de criptare cu un BIO cu stocarea datelor în tampon.

VALORI RETURNATE
BIO_f_cipher() returnează metoda BIO de criptare.

BIO_set_cipher() returnează 1 în caz de succes și 0 în caz de eșec.

BIO_get_cipher_status() returnează 1 pentru o decriptare reușită și <=0 pentru eșec.

BIO_get_cipher_ctx() returnează 1 în caz de succes și <=0 în caz de eșec.

DREPTURI DE AUTOR
Drepturi de autor 2000-2020 The OpenSSL Project Authors. Toate drepturile rezervate.

Licențiat sub Licența Apache 2.0 („License”). Nu aveți voie să utilizați acest fișier decât în conformitate cu licența. Puteți obține o copie din fișierul LICENSE din distribuția sursei sau de la <https://www.openssl.org/source/license.html>.

TRADUCERE
Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 (https://www.gnu.org/licenses/gpl-3.0.html) sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.