/src/openssl30/crypto/cms/cms_att.c

Source (jump to first uncovered line)
/*
 * Copyright 2008-2024 The OpenSSL Project Authors. All Rights Reserved.
 *
 * Licensed under the Apache License 2.0 (the "License").  You may not use
 * this file except in compliance with the License.  You can obtain a copy
 * in the file LICENSE in the source distribution or at
 * https://www.openssl.org/source/license.html
 */

#include <openssl/asn1t.h>
#include <openssl/pem.h>
#include <openssl/x509v3.h>
#include <openssl/err.h>
#include <openssl/cms.h>
#include "internal/nelem.h"
#include "crypto/x509.h"
#include "cms_local.h"

/*-
 * Attribute flags.
 * CMS attribute restrictions are discussed in
 *  - RFC 5652 Section 11.
 * ESS attribute restrictions are discussed in
 *  - RFC 2634 Section 1.3.4  AND
 *  - RFC 5035 Section 5.4
 */
/* This is a signed attribute */
#define CMS_ATTR_F_SIGNED         0x01
/* This is an unsigned attribute */
#define CMS_ATTR_F_UNSIGNED       0x02
/* Must be present if there are any other attributes of the same type */
#define CMS_ATTR_F_REQUIRED_COND  0x10
/* There can only be one instance of this attribute */
#define CMS_ATTR_F_ONLY_ONE       0x20
/* The Attribute's value must have exactly one entry */
#define CMS_ATTR_F_ONE_ATTR_VALUE 0x40

/* Attributes rules for different attributes */
static const struct {
    int nid;   /* The attribute id */
    int flags;
} cms_attribute_properties[] = {
    /* See RFC Section 11 */
    { NID_pkcs9_contentType, CMS_ATTR_F_SIGNED
                             | CMS_ATTR_F_ONLY_ONE
                             | CMS_ATTR_F_ONE_ATTR_VALUE
                             | CMS_ATTR_F_REQUIRED_COND },
    { NID_pkcs9_messageDigest, CMS_ATTR_F_SIGNED
                               | CMS_ATTR_F_ONLY_ONE
                               | CMS_ATTR_F_ONE_ATTR_VALUE
                               | CMS_ATTR_F_REQUIRED_COND },
    { NID_pkcs9_signingTime, CMS_ATTR_F_SIGNED
                             | CMS_ATTR_F_ONLY_ONE
                             | CMS_ATTR_F_ONE_ATTR_VALUE },
    { NID_pkcs9_countersignature, CMS_ATTR_F_UNSIGNED },
    /* ESS */
    { NID_id_smime_aa_signingCertificate, CMS_ATTR_F_SIGNED
                                          | CMS_ATTR_F_ONLY_ONE
                                          | CMS_ATTR_F_ONE_ATTR_VALUE },
    { NID_id_smime_aa_signingCertificateV2, CMS_ATTR_F_SIGNED
                                            | CMS_ATTR_F_ONLY_ONE
                                            | CMS_ATTR_F_ONE_ATTR_VALUE },
    { NID_id_smime_aa_receiptRequest, CMS_ATTR_F_SIGNED
                                      | CMS_ATTR_F_ONLY_ONE
                                      | CMS_ATTR_F_ONE_ATTR_VALUE }
};

/* CMS SignedData Attribute utilities */

int CMS_signed_get_attr_count(const CMS_SignerInfo *si)
{
    return X509at_get_attr_count(si->signedAttrs);
}

int CMS_signed_get_attr_by_NID(const CMS_SignerInfo *si, int nid, int lastpos)
{
    return X509at_get_attr_by_NID(si->signedAttrs, nid, lastpos);
}

int CMS_signed_get_attr_by_OBJ(const CMS_SignerInfo *si, const ASN1_OBJECT *obj,
                               int lastpos)
{
    return X509at_get_attr_by_OBJ(si->signedAttrs, obj, lastpos);
}

X509_ATTRIBUTE *CMS_signed_get_attr(const CMS_SignerInfo *si, int loc)
{
    return X509at_get_attr(si->signedAttrs, loc);
}

X509_ATTRIBUTE *CMS_signed_delete_attr(CMS_SignerInfo *si, int loc)
{
    return X509at_delete_attr(si->signedAttrs, loc);
}

int CMS_signed_add1_attr(CMS_SignerInfo *si, X509_ATTRIBUTE *attr)
{
    if (ossl_x509at_add1_attr(&si->signedAttrs, attr))
        return 1;
    return 0;
}

int CMS_signed_add1_attr_by_OBJ(CMS_SignerInfo *si,
                                const ASN1_OBJECT *obj, int type,
                                const void *bytes, int len)
{
    if (ossl_x509at_add1_attr_by_OBJ(&si->signedAttrs, obj, type, bytes, len))
        return 1;
    return 0;
}

int CMS_signed_add1_attr_by_NID(CMS_SignerInfo *si,
                                int nid, int type, const void *bytes, int len)
{
    if (ossl_x509at_add1_attr_by_NID(&si->signedAttrs, nid, type, bytes, len))
        return 1;
    return 0;
}

int CMS_signed_add1_attr_by_txt(CMS_SignerInfo *si,
                                const char *attrname, int type,
                                const void *bytes, int len)
{
    if (ossl_x509at_add1_attr_by_txt(&si->signedAttrs, attrname, type, bytes,
                                     len))
        return 1;
    return 0;
}

void *CMS_signed_get0_data_by_OBJ(const CMS_SignerInfo *si,
                                  const ASN1_OBJECT *oid,
                                  int lastpos, int type)
{
    return X509at_get0_data_by_OBJ(si->signedAttrs, oid, lastpos, type);
}

int CMS_unsigned_get_attr_count(const CMS_SignerInfo *si)
{
    return X509at_get_attr_count(si->unsignedAttrs);
}

int CMS_unsigned_get_attr_by_NID(const CMS_SignerInfo *si, int nid,
                                 int lastpos)
{
    return X509at_get_attr_by_NID(si->unsignedAttrs, nid, lastpos);
}

int CMS_unsigned_get_attr_by_OBJ(const CMS_SignerInfo *si,
                                 const ASN1_OBJECT *obj, int lastpos)
{
    return X509at_get_attr_by_OBJ(si->unsignedAttrs, obj, lastpos);
}

X509_ATTRIBUTE *CMS_unsigned_get_attr(const CMS_SignerInfo *si, int loc)
{
    return X509at_get_attr(si->unsignedAttrs, loc);
}

X509_ATTRIBUTE *CMS_unsigned_delete_attr(CMS_SignerInfo *si, int loc)
{
    return X509at_delete_attr(si->unsignedAttrs, loc);
}

int CMS_unsigned_add1_attr(CMS_SignerInfo *si, X509_ATTRIBUTE *attr)
{
    if (ossl_x509at_add1_attr(&si->unsignedAttrs, attr))
        return 1;
    return 0;
}

int CMS_unsigned_add1_attr_by_OBJ(CMS_SignerInfo *si,
                                  const ASN1_OBJECT *obj, int type,
                                  const void *bytes, int len)
{
    if (ossl_x509at_add1_attr_by_OBJ(&si->unsignedAttrs, obj, type, bytes, len))
        return 1;
    return 0;
}

int CMS_unsigned_add1_attr_by_NID(CMS_SignerInfo *si,
                                  int nid, int type,
                                  const void *bytes, int len)
{
    if (ossl_x509at_add1_attr_by_NID(&si->unsignedAttrs, nid, type, bytes, len))
        return 1;
    return 0;
}

int CMS_unsigned_add1_attr_by_txt(CMS_SignerInfo *si,
                                  const char *attrname, int type,
                                  const void *bytes, int len)
{
    if (ossl_x509at_add1_attr_by_txt(&si->unsignedAttrs, attrname,
                                     type, bytes, len))
        return 1;
    return 0;
}

void *CMS_unsigned_get0_data_by_OBJ(CMS_SignerInfo *si, ASN1_OBJECT *oid,
                                    int lastpos, int type)
{
    return X509at_get0_data_by_OBJ(si->unsignedAttrs, oid, lastpos, type);
}

/*
 * Retrieve an attribute by nid from a stack of attributes starting at index
 * *lastpos + 1.
 * Returns the attribute or NULL if there is no attribute.
 * If an attribute was found *lastpos returns the index of the found attribute.
 */
static X509_ATTRIBUTE *cms_attrib_get(int nid,
                                      const STACK_OF(X509_ATTRIBUTE) *attrs,
                                      int *lastpos)
{
    X509_ATTRIBUTE *at;
    int loc;

    loc = X509at_get_attr_by_NID(attrs, nid, *lastpos);
    if (loc < 0)
        return NULL;

    at = X509at_get_attr(attrs, loc);
    *lastpos = loc;
    return at;
}

static int cms_check_attribute(int nid, int flags, int type,
                               const STACK_OF(X509_ATTRIBUTE) *attrs,
                               int have_attrs)
{
    int lastpos = -1;
    X509_ATTRIBUTE *at = cms_attrib_get(nid, attrs, &lastpos);

    if (at != NULL) {
        int count = X509_ATTRIBUTE_count(at);

        /* Is this attribute allowed? */
        if (((flags & type) == 0)
            /* check if multiple attributes of the same type are allowed */
            || (((flags & CMS_ATTR_F_ONLY_ONE) != 0)
                && cms_attrib_get(nid, attrs, &lastpos) != NULL)
            /* Check if attribute should have exactly one value in its set */
            || (((flags & CMS_ATTR_F_ONE_ATTR_VALUE) != 0)
                && count != 1)
            /* There should be at least one value */
            || count == 0)
        return 0;
    } else {
        /* fail if a required attribute is missing */
        if (have_attrs
            && ((flags & CMS_ATTR_F_REQUIRED_COND) != 0)
            && (flags & type) != 0)
            return 0;
    }
    return 1;
}

/*
 * Check that the signerinfo attributes obey the attribute rules which includes
 * the following checks
 * - If any signed attributes exist then there must be a Content Type
 * and Message Digest attribute in the signed attributes.
 * - The countersignature attribute is an optional unsigned attribute only.
 * - Content Type, Message Digest, and Signing time attributes are signed
 *     attributes. Only one instance of each is allowed, with each of these
 *     attributes containing a single attribute value in its set.
 */
int ossl_cms_si_check_attributes(const CMS_SignerInfo *si)
{
    int i;
    int have_signed_attrs = (CMS_signed_get_attr_count(si) > 0);
    int have_unsigned_attrs = (CMS_unsigned_get_attr_count(si) > 0);

    for (i = 0; i < (int)OSSL_NELEM(cms_attribute_properties); ++i) {
        int nid = cms_attribute_properties[i].nid;
        int flags = cms_attribute_properties[i].flags;

        if (!cms_check_attribute(nid, flags, CMS_ATTR_F_SIGNED,
                                 si->signedAttrs, have_signed_attrs)
            || !cms_check_attribute(nid, flags, CMS_ATTR_F_UNSIGNED,
                                    si->unsignedAttrs, have_unsigned_attrs)) {
            ERR_raise(ERR_LIB_CMS, CMS_R_ATTRIBUTE_ERROR);
            return 0;
        }
    }
    return 1;
}

Coverage Report

Created: 2025-06-13 06:58

Line	Count	Source (jump to first uncovered line)
1		/*
2		* Copyright 2008-2024 The OpenSSL Project Authors. All Rights Reserved.
3		*
4		* Licensed under the Apache License 2.0 (the "License"). You may not use
5		* this file except in compliance with the License. You can obtain a copy
6		* in the file LICENSE in the source distribution or at
7		* https://www.openssl.org/source/license.html
8		*/
9
10		#include <openssl/asn1t.h>
11		#include <openssl/pem.h>
12		#include <openssl/x509v3.h>
13		#include <openssl/err.h>
14		#include <openssl/cms.h>
15		#include "internal/nelem.h"
16		#include "crypto/x509.h"
17		#include "cms_local.h"
18
19		/*-
20		* Attribute flags.
21		* CMS attribute restrictions are discussed in
22		* - RFC 5652 Section 11.
23		* ESS attribute restrictions are discussed in
24		* - RFC 2634 Section 1.3.4 AND
25		* - RFC 5035 Section 5.4
26		*/
27		/* This is a signed attribute */
28	0	#define CMS_ATTR_F_SIGNED 0x01
29		/* This is an unsigned attribute */
30	0	#define CMS_ATTR_F_UNSIGNED 0x02
31		/* Must be present if there are any other attributes of the same type */
32	0	#define CMS_ATTR_F_REQUIRED_COND 0x10
33		/* There can only be one instance of this attribute */
34	0	#define CMS_ATTR_F_ONLY_ONE 0x20
35		/* The Attribute's value must have exactly one entry */
36	0	#define CMS_ATTR_F_ONE_ATTR_VALUE 0x40
37
38		/* Attributes rules for different attributes */
39		static const struct {
40		int nid; /* The attribute id */
41		int flags;
42		} cms_attribute_properties[] = {
43		/* See RFC Section 11 */
44		{ NID_pkcs9_contentType, CMS_ATTR_F_SIGNED
45		\| CMS_ATTR_F_ONLY_ONE
46		\| CMS_ATTR_F_ONE_ATTR_VALUE
47		\| CMS_ATTR_F_REQUIRED_COND },
48		{ NID_pkcs9_messageDigest, CMS_ATTR_F_SIGNED
49		\| CMS_ATTR_F_ONLY_ONE
50		\| CMS_ATTR_F_ONE_ATTR_VALUE
51		\| CMS_ATTR_F_REQUIRED_COND },
52		{ NID_pkcs9_signingTime, CMS_ATTR_F_SIGNED
53		\| CMS_ATTR_F_ONLY_ONE
54		\| CMS_ATTR_F_ONE_ATTR_VALUE },
55		{ NID_pkcs9_countersignature, CMS_ATTR_F_UNSIGNED },
56		/* ESS */
57		{ NID_id_smime_aa_signingCertificate, CMS_ATTR_F_SIGNED
58		\| CMS_ATTR_F_ONLY_ONE
59		\| CMS_ATTR_F_ONE_ATTR_VALUE },
60		{ NID_id_smime_aa_signingCertificateV2, CMS_ATTR_F_SIGNED
61		\| CMS_ATTR_F_ONLY_ONE
62		\| CMS_ATTR_F_ONE_ATTR_VALUE },
63		{ NID_id_smime_aa_receiptRequest, CMS_ATTR_F_SIGNED
64		\| CMS_ATTR_F_ONLY_ONE
65		\| CMS_ATTR_F_ONE_ATTR_VALUE }
66		};
67
68		/* CMS SignedData Attribute utilities */
69
70		int CMS_signed_get_attr_count(const CMS_SignerInfo *si)
71	0	{
72	0	return X509at_get_attr_count(si->signedAttrs);
73	0	}
74
75		int CMS_signed_get_attr_by_NID(const CMS_SignerInfo *si, int nid, int lastpos)
76	0	{
77	0	return X509at_get_attr_by_NID(si->signedAttrs, nid, lastpos);
78	0	}
79
80		int CMS_signed_get_attr_by_OBJ(const CMS_SignerInfo si, const ASN1_OBJECT obj,
81		int lastpos)
82	0	{
83	0	return X509at_get_attr_by_OBJ(si->signedAttrs, obj, lastpos);
84	0	}
85
86		X509_ATTRIBUTE CMS_signed_get_attr(const CMS_SignerInfo si, int loc)
87	0	{
88	0	return X509at_get_attr(si->signedAttrs, loc);
89	0	}
90
91		X509_ATTRIBUTE CMS_signed_delete_attr(CMS_SignerInfo si, int loc)
92	0	{
93	0	return X509at_delete_attr(si->signedAttrs, loc);
94	0	}
95
96		int CMS_signed_add1_attr(CMS_SignerInfo si, X509_ATTRIBUTE attr)
97	0	{
98	0	if (ossl_x509at_add1_attr(&si->signedAttrs, attr))
99	0	return 1;
100	0	return 0;
101	0	}
102
103		int CMS_signed_add1_attr_by_OBJ(CMS_SignerInfo *si,
104		const ASN1_OBJECT *obj, int type,
105		const void *bytes, int len)
106	0	{
107	0	if (ossl_x509at_add1_attr_by_OBJ(&si->signedAttrs, obj, type, bytes, len))
108	0	return 1;
109	0	return 0;
110	0	}
111
112		int CMS_signed_add1_attr_by_NID(CMS_SignerInfo *si,
113		int nid, int type, const void *bytes, int len)
114	0	{
115	0	if (ossl_x509at_add1_attr_by_NID(&si->signedAttrs, nid, type, bytes, len))
116	0	return 1;
117	0	return 0;
118	0	}
119
120		int CMS_signed_add1_attr_by_txt(CMS_SignerInfo *si,
121		const char *attrname, int type,
122		const void *bytes, int len)
123	0	{
124	0	if (ossl_x509at_add1_attr_by_txt(&si->signedAttrs, attrname, type, bytes,
125	0	len))
126	0	return 1;
127	0	return 0;
128	0	}
129
130		void CMS_signed_get0_data_by_OBJ(const CMS_SignerInfo si,
131		const ASN1_OBJECT *oid,
132		int lastpos, int type)
133	0	{
134	0	return X509at_get0_data_by_OBJ(si->signedAttrs, oid, lastpos, type);
135	0	}
136
137		int CMS_unsigned_get_attr_count(const CMS_SignerInfo *si)
138	0	{
139	0	return X509at_get_attr_count(si->unsignedAttrs);
140	0	}
141
142		int CMS_unsigned_get_attr_by_NID(const CMS_SignerInfo *si, int nid,
143		int lastpos)
144	0	{
145	0	return X509at_get_attr_by_NID(si->unsignedAttrs, nid, lastpos);
146	0	}
147
148		int CMS_unsigned_get_attr_by_OBJ(const CMS_SignerInfo *si,
149		const ASN1_OBJECT *obj, int lastpos)
150	0	{
151	0	return X509at_get_attr_by_OBJ(si->unsignedAttrs, obj, lastpos);
152	0	}
153
154		X509_ATTRIBUTE CMS_unsigned_get_attr(const CMS_SignerInfo si, int loc)
155	0	{
156	0	return X509at_get_attr(si->unsignedAttrs, loc);
157	0	}
158
159		X509_ATTRIBUTE CMS_unsigned_delete_attr(CMS_SignerInfo si, int loc)
160	0	{
161	0	return X509at_delete_attr(si->unsignedAttrs, loc);
162	0	}
163
164		int CMS_unsigned_add1_attr(CMS_SignerInfo si, X509_ATTRIBUTE attr)
165	0	{
166	0	if (ossl_x509at_add1_attr(&si->unsignedAttrs, attr))
167	0	return 1;
168	0	return 0;
169	0	}
170
171		int CMS_unsigned_add1_attr_by_OBJ(CMS_SignerInfo *si,
172		const ASN1_OBJECT *obj, int type,
173		const void *bytes, int len)
174	0	{
175	0	if (ossl_x509at_add1_attr_by_OBJ(&si->unsignedAttrs, obj, type, bytes, len))
176	0	return 1;
177	0	return 0;
178	0	}
179
180		int CMS_unsigned_add1_attr_by_NID(CMS_SignerInfo *si,
181		int nid, int type,
182		const void *bytes, int len)
183	0	{
184	0	if (ossl_x509at_add1_attr_by_NID(&si->unsignedAttrs, nid, type, bytes, len))
185	0	return 1;
186	0	return 0;
187	0	}
188
189		int CMS_unsigned_add1_attr_by_txt(CMS_SignerInfo *si,
190		const char *attrname, int type,
191		const void *bytes, int len)
192	0	{
193	0	if (ossl_x509at_add1_attr_by_txt(&si->unsignedAttrs, attrname,
194	0	type, bytes, len))
195	0	return 1;
196	0	return 0;
197	0	}
198
199		void CMS_unsigned_get0_data_by_OBJ(CMS_SignerInfo si, ASN1_OBJECT *oid,
200		int lastpos, int type)
201	0	{
202	0	return X509at_get0_data_by_OBJ(si->unsignedAttrs, oid, lastpos, type);
203	0	}
204
205		/*
206		* Retrieve an attribute by nid from a stack of attributes starting at index
207		* *lastpos + 1.
208		* Returns the attribute or NULL if there is no attribute.
209		* If an attribute was found *lastpos returns the index of the found attribute.
210		*/
211		static X509_ATTRIBUTE *cms_attrib_get(int nid,
212		const STACK_OF(X509_ATTRIBUTE) *attrs,
213		int *lastpos)
214	0	{
215	0	X509_ATTRIBUTE *at;
216	0	int loc;
217
218	0	loc = X509at_get_attr_by_NID(attrs, nid, *lastpos);
219	0	if (loc < 0)
220	0	return NULL;
221
222	0	at = X509at_get_attr(attrs, loc);
223	0	*lastpos = loc;
224	0	return at;
225	0	}
226
227		static int cms_check_attribute(int nid, int flags, int type,
228		const STACK_OF(X509_ATTRIBUTE) *attrs,
229		int have_attrs)
230	0	{
231	0	int lastpos = -1;
232	0	X509_ATTRIBUTE *at = cms_attrib_get(nid, attrs, &lastpos);
233
234	0	if (at != NULL) {
235	0	int count = X509_ATTRIBUTE_count(at);
236
237		/* Is this attribute allowed? */
238	0	if (((flags & type) == 0)
239		/* check if multiple attributes of the same type are allowed */
240	0	\|\| (((flags & CMS_ATTR_F_ONLY_ONE) != 0)
241	0	&& cms_attrib_get(nid, attrs, &lastpos) != NULL)
242		/* Check if attribute should have exactly one value in its set */
243	0	\|\| (((flags & CMS_ATTR_F_ONE_ATTR_VALUE) != 0)
244	0	&& count != 1)
245		/* There should be at least one value */
246	0	\|\| count == 0)
247	0	return 0;
248	0	} else {
249		/* fail if a required attribute is missing */
250	0	if (have_attrs
251	0	&& ((flags & CMS_ATTR_F_REQUIRED_COND) != 0)
252	0	&& (flags & type) != 0)
253	0	return 0;
254	0	}
255	0	return 1;
256	0	}
257
258		/*
259		* Check that the signerinfo attributes obey the attribute rules which includes
260		* the following checks
261		* - If any signed attributes exist then there must be a Content Type
262		* and Message Digest attribute in the signed attributes.
263		* - The countersignature attribute is an optional unsigned attribute only.
264		* - Content Type, Message Digest, and Signing time attributes are signed
265		* attributes. Only one instance of each is allowed, with each of these
266		* attributes containing a single attribute value in its set.
267		*/
268		int ossl_cms_si_check_attributes(const CMS_SignerInfo *si)
269	0	{
270	0	int i;
271	0	int have_signed_attrs = (CMS_signed_get_attr_count(si) > 0);
272	0	int have_unsigned_attrs = (CMS_unsigned_get_attr_count(si) > 0);
273
274	0	for (i = 0; i < (int)OSSL_NELEM(cms_attribute_properties); ++i) {
275	0	int nid = cms_attribute_properties[i].nid;
276	0	int flags = cms_attribute_properties[i].flags;
277
278	0	if (!cms_check_attribute(nid, flags, CMS_ATTR_F_SIGNED,
279	0	si->signedAttrs, have_signed_attrs)
280	0	\|\| !cms_check_attribute(nid, flags, CMS_ATTR_F_UNSIGNED,
281	0	si->unsignedAttrs, have_unsigned_attrs)) {
282	0	ERR_raise(ERR_LIB_CMS, CMS_R_ATTRIBUTE_ERROR);
283	0	return 0;
284	0	}
285	0	}
286	0	return 1;
287	0	}