Mbed TLS v4.1.1
Loading...
Searching...
No Matches
oid.h
Go to the documentation of this file.
1
6/*
7 * Copyright The Mbed TLS Contributors
8 * SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later
9 */
10#ifndef MBEDTLS_OID_H
11#define MBEDTLS_OID_H
12
13#include "mbedtls/build_info.h"
14#include "mbedtls/asn1.h"
15
16/*
17 * Top level OID tuples
18 */
19#define MBEDTLS_OID_ISO_MEMBER_BODIES "\x2a" /* {iso(1) member-body(2)} */
20#define MBEDTLS_OID_ISO_IDENTIFIED_ORG "\x2b" /* {iso(1) identified-organization(3)} */
21#define MBEDTLS_OID_ISO_CCITT_DS "\x55" /* {joint-iso-ccitt(2) ds(5)} */
22#define MBEDTLS_OID_ISO_ITU_COUNTRY "\x60" /* {joint-iso-itu-t(2) country(16)} */
23
24/*
25 * ISO Member bodies OID parts
26 */
27#define MBEDTLS_OID_COUNTRY_US "\x86\x48" /* {us(840)} */
28#define MBEDTLS_OID_ORG_RSA_DATA_SECURITY "\x86\xf7\x0d" /* {rsadsi(113549)} */
29#define MBEDTLS_OID_RSA_COMPANY MBEDTLS_OID_ISO_MEMBER_BODIES MBEDTLS_OID_COUNTRY_US \
30 MBEDTLS_OID_ORG_RSA_DATA_SECURITY /* {iso(1) member-body(2) us(840) rsadsi(113549)} */
31#define MBEDTLS_OID_ORG_ANSI_X9_62 "\xce\x3d" /* ansi-X9-62(10045) */
32#define MBEDTLS_OID_ANSI_X9_62 MBEDTLS_OID_ISO_MEMBER_BODIES MBEDTLS_OID_COUNTRY_US \
33 MBEDTLS_OID_ORG_ANSI_X9_62
34
35/*
36 * ISO Identified organization OID parts
37 */
38#define MBEDTLS_OID_ORG_DOD "\x06" /* {dod(6)} */
39#define MBEDTLS_OID_ORG_OIW "\x0e"
40#define MBEDTLS_OID_OIW_SECSIG MBEDTLS_OID_ORG_OIW "\x03"
41#define MBEDTLS_OID_OIW_SECSIG_ALG MBEDTLS_OID_OIW_SECSIG "\x02"
42#define MBEDTLS_OID_OIW_SECSIG_SHA1 MBEDTLS_OID_OIW_SECSIG_ALG "\x1a"
43#define MBEDTLS_OID_ORG_THAWTE "\x65" /* thawte(101) */
44#define MBEDTLS_OID_THAWTE MBEDTLS_OID_ISO_IDENTIFIED_ORG \
45 MBEDTLS_OID_ORG_THAWTE
46#define MBEDTLS_OID_ORG_CERTICOM "\x81\x04" /* certicom(132) */
47#define MBEDTLS_OID_CERTICOM MBEDTLS_OID_ISO_IDENTIFIED_ORG \
48 MBEDTLS_OID_ORG_CERTICOM
49#define MBEDTLS_OID_ORG_TELETRUST "\x24" /* teletrust(36) */
50#define MBEDTLS_OID_TELETRUST MBEDTLS_OID_ISO_IDENTIFIED_ORG \
51 MBEDTLS_OID_ORG_TELETRUST
52
53/*
54 * ISO ITU OID parts
55 */
56#define MBEDTLS_OID_ORGANIZATION "\x01" /* {organization(1)} */
57#define MBEDTLS_OID_ISO_ITU_US_ORG MBEDTLS_OID_ISO_ITU_COUNTRY MBEDTLS_OID_COUNTRY_US \
58 MBEDTLS_OID_ORGANIZATION /* {joint-iso-itu-t(2) country(16) us(840) organization(1)} */
59
60#define MBEDTLS_OID_ORG_GOV "\x65" /* {gov(101)} */
61#define MBEDTLS_OID_GOV MBEDTLS_OID_ISO_ITU_US_ORG MBEDTLS_OID_ORG_GOV /* {joint-iso-itu-t(2) country(16) us(840) organization(1) gov(101)} */
62
63#define MBEDTLS_OID_ORG_NETSCAPE "\x86\xF8\x42" /* {netscape(113730)} */
64#define MBEDTLS_OID_NETSCAPE MBEDTLS_OID_ISO_ITU_US_ORG MBEDTLS_OID_ORG_NETSCAPE /* Netscape OID {joint-iso-itu-t(2) country(16) us(840) organization(1) netscape(113730)} */
65
66/* ISO arc for standard certificate and CRL extensions */
67#define MBEDTLS_OID_ID_CE MBEDTLS_OID_ISO_CCITT_DS "\x1D"
68
69#define MBEDTLS_OID_NIST_ALG MBEDTLS_OID_GOV "\x03\x04"
70
76#define MBEDTLS_OID_INTERNET MBEDTLS_OID_ISO_IDENTIFIED_ORG MBEDTLS_OID_ORG_DOD \
77 "\x01"
78#define MBEDTLS_OID_PKIX MBEDTLS_OID_INTERNET "\x05\x05\x07"
79
80/*
81 * Arc for standard naming attributes
82 */
83#define MBEDTLS_OID_AT MBEDTLS_OID_ISO_CCITT_DS "\x04"
84#define MBEDTLS_OID_AT_CN MBEDTLS_OID_AT "\x03"
85#define MBEDTLS_OID_AT_SUR_NAME MBEDTLS_OID_AT "\x04"
86#define MBEDTLS_OID_AT_SERIAL_NUMBER MBEDTLS_OID_AT "\x05"
87#define MBEDTLS_OID_AT_COUNTRY MBEDTLS_OID_AT "\x06"
88#define MBEDTLS_OID_AT_LOCALITY MBEDTLS_OID_AT "\x07"
89#define MBEDTLS_OID_AT_STATE MBEDTLS_OID_AT "\x08"
90#define MBEDTLS_OID_AT_ORGANIZATION MBEDTLS_OID_AT "\x0A"
91#define MBEDTLS_OID_AT_ORG_UNIT MBEDTLS_OID_AT "\x0B"
92#define MBEDTLS_OID_AT_TITLE MBEDTLS_OID_AT "\x0C"
93#define MBEDTLS_OID_AT_POSTAL_ADDRESS MBEDTLS_OID_AT "\x10"
94#define MBEDTLS_OID_AT_POSTAL_CODE MBEDTLS_OID_AT "\x11"
95#define MBEDTLS_OID_AT_GIVEN_NAME MBEDTLS_OID_AT "\x2A"
96#define MBEDTLS_OID_AT_INITIALS MBEDTLS_OID_AT "\x2B"
97#define MBEDTLS_OID_AT_GENERATION_QUALIFIER MBEDTLS_OID_AT "\x2C"
98#define MBEDTLS_OID_AT_UNIQUE_IDENTIFIER MBEDTLS_OID_AT "\x2D"
99#define MBEDTLS_OID_AT_DN_QUALIFIER MBEDTLS_OID_AT "\x2E"
100#define MBEDTLS_OID_AT_PSEUDONYM MBEDTLS_OID_AT "\x41"
101
102#define MBEDTLS_OID_UID "\x09\x92\x26\x89\x93\xF2\x2C\x64\x01\x01"
103#define MBEDTLS_OID_DOMAIN_COMPONENT "\x09\x92\x26\x89\x93\xF2\x2C\x64\x01\x19"
104
105/*
106 * OIDs for standard certificate extensions
107 */
108#define MBEDTLS_OID_AUTHORITY_KEY_IDENTIFIER MBEDTLS_OID_ID_CE "\x23"
109#define MBEDTLS_OID_SUBJECT_KEY_IDENTIFIER MBEDTLS_OID_ID_CE "\x0E"
110#define MBEDTLS_OID_KEY_USAGE MBEDTLS_OID_ID_CE "\x0F"
111#define MBEDTLS_OID_CERTIFICATE_POLICIES MBEDTLS_OID_ID_CE "\x20"
112#define MBEDTLS_OID_POLICY_MAPPINGS MBEDTLS_OID_ID_CE "\x21"
113#define MBEDTLS_OID_SUBJECT_ALT_NAME MBEDTLS_OID_ID_CE "\x11"
114#define MBEDTLS_OID_ISSUER_ALT_NAME MBEDTLS_OID_ID_CE "\x12"
115#define MBEDTLS_OID_SUBJECT_DIRECTORY_ATTRS MBEDTLS_OID_ID_CE "\x09"
116#define MBEDTLS_OID_BASIC_CONSTRAINTS MBEDTLS_OID_ID_CE "\x13"
117#define MBEDTLS_OID_NAME_CONSTRAINTS MBEDTLS_OID_ID_CE "\x1E"
118#define MBEDTLS_OID_POLICY_CONSTRAINTS MBEDTLS_OID_ID_CE "\x24"
119#define MBEDTLS_OID_EXTENDED_KEY_USAGE MBEDTLS_OID_ID_CE "\x25"
120#define MBEDTLS_OID_CRL_DISTRIBUTION_POINTS MBEDTLS_OID_ID_CE "\x1F"
121#define MBEDTLS_OID_INIHIBIT_ANYPOLICY MBEDTLS_OID_ID_CE "\x36"
122#define MBEDTLS_OID_FRESHEST_CRL MBEDTLS_OID_ID_CE "\x2E"
123
124/*
125 * Certificate policies
126 */
127#define MBEDTLS_OID_ANY_POLICY MBEDTLS_OID_CERTIFICATE_POLICIES "\x00"
128
129/*
130 * Netscape certificate extensions
131 */
132#define MBEDTLS_OID_NS_CERT MBEDTLS_OID_NETSCAPE "\x01"
133#define MBEDTLS_OID_NS_CERT_TYPE MBEDTLS_OID_NS_CERT "\x01"
134#define MBEDTLS_OID_NS_BASE_URL MBEDTLS_OID_NS_CERT "\x02"
135#define MBEDTLS_OID_NS_REVOCATION_URL MBEDTLS_OID_NS_CERT "\x03"
136#define MBEDTLS_OID_NS_CA_REVOCATION_URL MBEDTLS_OID_NS_CERT "\x04"
137#define MBEDTLS_OID_NS_RENEWAL_URL MBEDTLS_OID_NS_CERT "\x07"
138#define MBEDTLS_OID_NS_CA_POLICY_URL MBEDTLS_OID_NS_CERT "\x08"
139#define MBEDTLS_OID_NS_SSL_SERVER_NAME MBEDTLS_OID_NS_CERT "\x0C"
140#define MBEDTLS_OID_NS_COMMENT MBEDTLS_OID_NS_CERT "\x0D"
141#define MBEDTLS_OID_NS_DATA_TYPE MBEDTLS_OID_NETSCAPE "\x02"
142#define MBEDTLS_OID_NS_CERT_SEQUENCE MBEDTLS_OID_NS_DATA_TYPE "\x05"
143
144/*
145 * OIDs for CRL extensions
146 */
147#define MBEDTLS_OID_PRIVATE_KEY_USAGE_PERIOD MBEDTLS_OID_ID_CE "\x10"
148#define MBEDTLS_OID_CRL_NUMBER MBEDTLS_OID_ID_CE "\x14"
149
150/*
151 * X.509 v3 Extended key usage OIDs
152 */
153#define MBEDTLS_OID_ANY_EXTENDED_KEY_USAGE MBEDTLS_OID_EXTENDED_KEY_USAGE "\x00"
154
155#define MBEDTLS_OID_KP MBEDTLS_OID_PKIX "\x03"
156#define MBEDTLS_OID_SERVER_AUTH MBEDTLS_OID_KP "\x01"
157#define MBEDTLS_OID_CLIENT_AUTH MBEDTLS_OID_KP "\x02"
158#define MBEDTLS_OID_CODE_SIGNING MBEDTLS_OID_KP "\x03"
159#define MBEDTLS_OID_EMAIL_PROTECTION MBEDTLS_OID_KP "\x04"
160#define MBEDTLS_OID_TIME_STAMPING MBEDTLS_OID_KP "\x08"
161#define MBEDTLS_OID_OCSP_SIGNING MBEDTLS_OID_KP "\x09"
162
168#define MBEDTLS_OID_WISUN_FAN MBEDTLS_OID_INTERNET "\x04\x01\x82\xe4\x25\x01"
169
170#define MBEDTLS_OID_ON MBEDTLS_OID_PKIX "\x08"
171#define MBEDTLS_OID_ON_HW_MODULE_NAME MBEDTLS_OID_ON "\x04"
172
173/*
174 * PKCS definition OIDs
175 */
176
177#define MBEDTLS_OID_PKCS MBEDTLS_OID_RSA_COMPANY "\x01"
178#define MBEDTLS_OID_PKCS1 MBEDTLS_OID_PKCS "\x01"
179#define MBEDTLS_OID_PKCS5 MBEDTLS_OID_PKCS "\x05"
180#define MBEDTLS_OID_PKCS7 MBEDTLS_OID_PKCS "\x07"
181#define MBEDTLS_OID_PKCS9 MBEDTLS_OID_PKCS "\x09"
182#define MBEDTLS_OID_PKCS12 MBEDTLS_OID_PKCS "\x0c"
183
184/*
185 * PKCS#1 OIDs
186 */
187#define MBEDTLS_OID_PKCS1_MD5 MBEDTLS_OID_PKCS1 "\x04"
188#define MBEDTLS_OID_PKCS1_SHA1 MBEDTLS_OID_PKCS1 "\x05"
189#define MBEDTLS_OID_PKCS1_SHA224 MBEDTLS_OID_PKCS1 "\x0e"
190#define MBEDTLS_OID_PKCS1_SHA256 MBEDTLS_OID_PKCS1 "\x0b"
191#define MBEDTLS_OID_PKCS1_SHA384 MBEDTLS_OID_PKCS1 "\x0c"
192#define MBEDTLS_OID_PKCS1_SHA512 MBEDTLS_OID_PKCS1 "\x0d"
193
194#define MBEDTLS_OID_RSA_SHA_OBS "\x2B\x0E\x03\x02\x1D"
195
196#define MBEDTLS_OID_PKCS9_EMAIL MBEDTLS_OID_PKCS9 "\x01"
197
198/* RFC 4055 */
199#define MBEDTLS_OID_RSASSA_PSS MBEDTLS_OID_PKCS1 "\x0a"
200#define MBEDTLS_OID_MGF1 MBEDTLS_OID_PKCS1 "\x08"
201
202/*
203 * Digest algorithms
204 */
205#define MBEDTLS_OID_DIGEST_ALG_MD5 MBEDTLS_OID_RSA_COMPANY "\x02\x05"
206#define MBEDTLS_OID_DIGEST_ALG_SHA1 MBEDTLS_OID_ISO_IDENTIFIED_ORG \
207 MBEDTLS_OID_OIW_SECSIG_SHA1
208#define MBEDTLS_OID_DIGEST_ALG_SHA224 MBEDTLS_OID_NIST_ALG "\x02\x04"
209#define MBEDTLS_OID_DIGEST_ALG_SHA256 MBEDTLS_OID_NIST_ALG "\x02\x01"
210
211#define MBEDTLS_OID_DIGEST_ALG_SHA384 MBEDTLS_OID_NIST_ALG "\x02\x02"
212
213#define MBEDTLS_OID_DIGEST_ALG_SHA512 MBEDTLS_OID_NIST_ALG "\x02\x03"
214
215#define MBEDTLS_OID_DIGEST_ALG_RIPEMD160 MBEDTLS_OID_TELETRUST "\x03\x02\x01"
216
217#define MBEDTLS_OID_DIGEST_ALG_SHA3_224 MBEDTLS_OID_NIST_ALG "\x02\x07"
218
219#define MBEDTLS_OID_DIGEST_ALG_SHA3_256 MBEDTLS_OID_NIST_ALG "\x02\x08"
220
221#define MBEDTLS_OID_DIGEST_ALG_SHA3_384 MBEDTLS_OID_NIST_ALG "\x02\x09"
222
223#define MBEDTLS_OID_DIGEST_ALG_SHA3_512 MBEDTLS_OID_NIST_ALG "\x02\x0a"
224
225/*
226 * PKCS#7 OIDs
227 */
228#define MBEDTLS_OID_PKCS7_DATA MBEDTLS_OID_PKCS7 "\x01"
229#define MBEDTLS_OID_PKCS7_SIGNED_DATA MBEDTLS_OID_PKCS7 "\x02"
230#define MBEDTLS_OID_PKCS7_ENVELOPED_DATA MBEDTLS_OID_PKCS7 "\x03"
231#define MBEDTLS_OID_PKCS7_SIGNED_AND_ENVELOPED_DATA MBEDTLS_OID_PKCS7 "\x04"
232#define MBEDTLS_OID_PKCS7_DIGESTED_DATA MBEDTLS_OID_PKCS7 "\x05"
233#define MBEDTLS_OID_PKCS7_ENCRYPTED_DATA MBEDTLS_OID_PKCS7 "\x06"
234
235#define MBEDTLS_OID_PKCS9_CSR_EXT_REQ MBEDTLS_OID_PKCS9 "\x0e"
236
237
238/*
239 * ECDSA signature identifiers, from RFC 5480
240 */
241#define MBEDTLS_OID_ANSI_X9_62_SIG MBEDTLS_OID_ANSI_X9_62 "\x04" /* signatures(4) */
242#define MBEDTLS_OID_ANSI_X9_62_SIG_SHA2 MBEDTLS_OID_ANSI_X9_62_SIG "\x03" /* ecdsa-with-SHA2(3) */
243
244/* ecdsa-with-SHA1 OBJECT IDENTIFIER ::= {
245 * iso(1) member-body(2) us(840) ansi-X9-62(10045) signatures(4) 1 } */
246#define MBEDTLS_OID_ECDSA_SHA1 MBEDTLS_OID_ANSI_X9_62_SIG "\x01"
247
248/* ecdsa-with-SHA224 OBJECT IDENTIFIER ::= {
249 * iso(1) member-body(2) us(840) ansi-X9-62(10045) signatures(4)
250 * ecdsa-with-SHA2(3) 1 } */
251#define MBEDTLS_OID_ECDSA_SHA224 MBEDTLS_OID_ANSI_X9_62_SIG_SHA2 "\x01"
252
253/* ecdsa-with-SHA256 OBJECT IDENTIFIER ::= {
254 * iso(1) member-body(2) us(840) ansi-X9-62(10045) signatures(4)
255 * ecdsa-with-SHA2(3) 2 } */
256#define MBEDTLS_OID_ECDSA_SHA256 MBEDTLS_OID_ANSI_X9_62_SIG_SHA2 "\x02"
257
258/* ecdsa-with-SHA384 OBJECT IDENTIFIER ::= {
259 * iso(1) member-body(2) us(840) ansi-X9-62(10045) signatures(4)
260 * ecdsa-with-SHA2(3) 3 } */
261#define MBEDTLS_OID_ECDSA_SHA384 MBEDTLS_OID_ANSI_X9_62_SIG_SHA2 "\x03"
262
263/* ecdsa-with-SHA512 OBJECT IDENTIFIER ::= {
264 * iso(1) member-body(2) us(840) ansi-X9-62(10045) signatures(4)
265 * ecdsa-with-SHA2(3) 4 } */
266#define MBEDTLS_OID_ECDSA_SHA512 MBEDTLS_OID_ANSI_X9_62_SIG_SHA2 "\x04"
267
268#if defined(MBEDTLS_X509_USE_C)
280int mbedtls_oid_get_numeric_string(char *buf, size_t size, const mbedtls_asn1_buf *oid);
281#endif /* MBEDTLS_X509_USE_C */
282
283#if defined(MBEDTLS_X509_CREATE_C)
301int mbedtls_oid_from_numeric_string(mbedtls_asn1_buf *oid, const char *oid_str, size_t size);
302#endif /* MBEDTLS_X509_CREATE_C */
303
304#endif /* oid.h */
Generic ASN.1 parsing.
Build-time configuration info.
int mbedtls_oid_from_numeric_string(mbedtls_asn1_buf *oid, const char *oid_str, size_t size)
Translate a string containing a dotted-decimal representation of an ASN.1 OID into its encoded form (...
int mbedtls_oid_get_numeric_string(char *buf, size_t size, const mbedtls_asn1_buf *oid)
Translate an ASN.1 OID into its numeric representation (e.g. "\x2A\x86\x48\x86\xF7\x0D" into "1....