CMS_ADD1_RECIPIENT_CERT(3ssl)       OpenSSL      CMS_ADD1_RECIPIENT_CERT(3ssl)


NUME
       CMS_add1_recipient, CMS_add1_recipient_cert, CMS_add0_recipient_key -
       adauga destinatari la o structura de date in plic CMS

SINOPSIS
        #include <openssl/cms.h>

        CMS_RecipientInfo *CMS_add1_recipient(CMS_ContentInfo *cms, X509 *recip,
                                              EVP_PKEY *originatorPrivKey,
                                              X509 *originator, unsigned int flags);

        CMS_RecipientInfo *CMS_add1_recipient_cert(CMS_ContentInfo *cms,
                                                   X509 *recip, unsigned int flags);

        CMS_RecipientInfo *CMS_add0_recipient_key(CMS_ContentInfo *cms, int nid,
                                                  unsigned char *key, size_t keylen,
                                                  unsigned char *id, size_t idlen,
                                                  ASN1_GENERALIZEDTIME *date,
                                                  ASN1_OBJECT *otherTypeId,
                                                  ASN1_TYPE *otherType);

DESCRIERE
       CMS_add1_recipient() adauga destinatarul recip <?>i furnizeaza cheia
       privata (pkey) a ini<?>iatorului originatorPrivKey <?>i certificatul
       ini<?>iatorului originator la CMS_ContentInfo. Campurile referitoare la
       ini<?>iator sunt relevante numai in cazul in care se utilizeaza metoda
       keyAgreement de furnizare a cheii partajate.

       CMS_add1_recipient_cert() adauga destinatarul recip la structura de
       date in plic CMS_ContentInfo cms ca structura KeyTransRecipientInfo.

       CMS_add0_recipient_key() adauga cheia simetrica key de lungime keylen
       folosind algoritmul de invaluire nid, identificatorul id de lungime
       idlen <?>i valorile op<?>ionale date, otherTypeId <?>i otherType la
       structura de date in plic CMS_ContentInfo cms ca o structura
       KEKRecipientInfo.

       Structura CMS_ContentInfo trebuie ob<?>inuta in urma unui apel
       ini<?>ial la CMS_encrypt() cu fanionul CMS_PARTIAL activat.

NOTE
       Scopul principal al acestei func<?>ii este de a oferi un control mai
       fin asupra unei structuri de date in plic CMS atunci cand valorile
       implicite ale func<?>iei CMS_encrypt(), mai simple, nu sunt adecvate.
       De exemplu, daca trebuie adaugate una sau mai multe structuri
       KEKRecipientInfo. Se pot adauga, de asemenea, atribute noi utilizand
       structura CMS_RecipientInfo returnata <?>i func<?>iile utilitare de
       atribuire CMS.

       OpenSSL va identifica in mod implicit certificatele destinatarului
       utilizand numele emitentului <?>i numarul de serie. Daca CMS_USE_KEYID
       este activat, acesta va utiliza in schimb valoarea identificatorului de
       cheie subiect. Apare o eroare daca toate certificatele destinatarului
       nu au extensia ,,subject key identifier".

       In prezent, pentru nid sunt accepta<?>i numai algoritmi de invaluire a
       cheilor baza<?>i pe AES, in special: NID_id_aes128_wrap,
       NID_id_aes192_wrap <?>i NID_id_aes256_wrap. Daca nid este definit la
       NID_undef, atunci se va utiliza un algoritm de invaluire AES compatibil
       cu keylen.

VALORI RETURNATE
       CMS_add1_recipient_cert() <?>i CMS_add0_recipient_key() returneaza un
       indicator intern catre structura CMS_RecipientInfo tocmai adaugata sau
       NULL daca apare o eroare.

CONSULTA<?>I <?>I
       ERR_get_error(3), CMS_decrypt(3), CMS_final(3),

ISTORIC
       CMS_add1_recipient_cert <?>i CMS_add0_recipient_key au fost adaugate in
       OpenSSL 3.0.

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

       Licen<?>iat sub Licen<?>a Apache 2.0 (,,License"). Nu ave<?>i voie sa
       utiliza<?>i acest fi<?>ier decat in 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 in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

3.5.2                            5 august 2025   CMS_ADD1_RECIPIENT_CERT(3ssl)