00001
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016
00017
00018
00019
00020
00021
00022
00023
00024 #ifndef MBEDTLS_OID_H
00025 #define MBEDTLS_OID_H
00026
00027 #if !defined(MBEDTLS_CONFIG_FILE)
00028 #include "config.h"
00029 #else
00030 #include MBEDTLS_CONFIG_FILE
00031 #endif
00032
00033 #include "asn1.h"
00034 #include "pk.h"
00035
00036 #include <stddef.h>
00037
00038 #if defined(MBEDTLS_CIPHER_C)
00039 #include "cipher.h"
00040 #endif
00041
00042 #if defined(MBEDTLS_MD_C)
00043 #include "md.h"
00044 #endif
00045
00046 #if defined(MBEDTLS_X509_USE_C) || defined(MBEDTLS_X509_CREATE_C)
00047 #include "x509.h"
00048 #endif
00049
00050 #define MBEDTLS_ERR_OID_NOT_FOUND -0x002E
00051 #define MBEDTLS_ERR_OID_BUF_TOO_SMALL -0x000B
00053
00054
00055
00056 #define MBEDTLS_OID_ISO_MEMBER_BODIES "\x2a"
00057 #define MBEDTLS_OID_ISO_IDENTIFIED_ORG "\x2b"
00058 #define MBEDTLS_OID_ISO_CCITT_DS "\x55"
00059 #define MBEDTLS_OID_ISO_ITU_COUNTRY "\x60"
00060
00061
00062
00063
00064 #define MBEDTLS_OID_COUNTRY_US "\x86\x48"
00065 #define MBEDTLS_OID_ORG_RSA_DATA_SECURITY "\x86\xf7\x0d"
00066 #define MBEDTLS_OID_RSA_COMPANY MBEDTLS_OID_ISO_MEMBER_BODIES MBEDTLS_OID_COUNTRY_US \
00067 MBEDTLS_OID_ORG_RSA_DATA_SECURITY
00068 #define MBEDTLS_OID_ORG_ANSI_X9_62 "\xce\x3d"
00069 #define MBEDTLS_OID_ANSI_X9_62 MBEDTLS_OID_ISO_MEMBER_BODIES MBEDTLS_OID_COUNTRY_US \
00070 MBEDTLS_OID_ORG_ANSI_X9_62
00071
00072
00073
00074
00075 #define MBEDTLS_OID_ORG_DOD "\x06"
00076 #define MBEDTLS_OID_ORG_OIW "\x0e"
00077 #define MBEDTLS_OID_OIW_SECSIG MBEDTLS_OID_ORG_OIW "\x03"
00078 #define MBEDTLS_OID_OIW_SECSIG_ALG MBEDTLS_OID_OIW_SECSIG "\x02"
00079 #define MBEDTLS_OID_OIW_SECSIG_SHA1 MBEDTLS_OID_OIW_SECSIG_ALG "\x1a"
00080 #define MBEDTLS_OID_ORG_CERTICOM "\x81\x04"
00081 #define MBEDTLS_OID_CERTICOM MBEDTLS_OID_ISO_IDENTIFIED_ORG MBEDTLS_OID_ORG_CERTICOM
00082 #define MBEDTLS_OID_ORG_TELETRUST "\x24"
00083 #define MBEDTLS_OID_TELETRUST MBEDTLS_OID_ISO_IDENTIFIED_ORG MBEDTLS_OID_ORG_TELETRUST
00084
00085
00086
00087
00088 #define MBEDTLS_OID_ORGANIZATION "\x01"
00089 #define MBEDTLS_OID_ISO_ITU_US_ORG MBEDTLS_OID_ISO_ITU_COUNTRY MBEDTLS_OID_COUNTRY_US MBEDTLS_OID_ORGANIZATION
00090
00091 #define MBEDTLS_OID_ORG_GOV "\x65"
00092 #define MBEDTLS_OID_GOV MBEDTLS_OID_ISO_ITU_US_ORG MBEDTLS_OID_ORG_GOV
00093
00094 #define MBEDTLS_OID_ORG_NETSCAPE "\x86\xF8\x42"
00095 #define MBEDTLS_OID_NETSCAPE MBEDTLS_OID_ISO_ITU_US_ORG MBEDTLS_OID_ORG_NETSCAPE
00096
00097
00098 #define MBEDTLS_OID_ID_CE MBEDTLS_OID_ISO_CCITT_DS "\x1D"
00105 #define MBEDTLS_OID_PKIX MBEDTLS_OID_ISO_IDENTIFIED_ORG MBEDTLS_OID_ORG_DOD "\x01\x05\x05\x07"
00106
00107
00108
00109
00110 #define MBEDTLS_OID_AT MBEDTLS_OID_ISO_CCITT_DS "\x04"
00111 #define MBEDTLS_OID_AT_CN MBEDTLS_OID_AT "\x03"
00112 #define MBEDTLS_OID_AT_SUR_NAME MBEDTLS_OID_AT "\x04"
00113 #define MBEDTLS_OID_AT_SERIAL_NUMBER MBEDTLS_OID_AT "\x05"
00114 #define MBEDTLS_OID_AT_COUNTRY MBEDTLS_OID_AT "\x06"
00115 #define MBEDTLS_OID_AT_LOCALITY MBEDTLS_OID_AT "\x07"
00116 #define MBEDTLS_OID_AT_STATE MBEDTLS_OID_AT "\x08"
00117 #define MBEDTLS_OID_AT_ORGANIZATION MBEDTLS_OID_AT "\x0A"
00118 #define MBEDTLS_OID_AT_ORG_UNIT MBEDTLS_OID_AT "\x0B"
00119 #define MBEDTLS_OID_AT_TITLE MBEDTLS_OID_AT "\x0C"
00120 #define MBEDTLS_OID_AT_POSTAL_ADDRESS MBEDTLS_OID_AT "\x10"
00121 #define MBEDTLS_OID_AT_POSTAL_CODE MBEDTLS_OID_AT "\x11"
00122 #define MBEDTLS_OID_AT_GIVEN_NAME MBEDTLS_OID_AT "\x2A"
00123 #define MBEDTLS_OID_AT_INITIALS MBEDTLS_OID_AT "\x2B"
00124 #define MBEDTLS_OID_AT_GENERATION_QUALIFIER MBEDTLS_OID_AT "\x2C"
00125 #define MBEDTLS_OID_AT_UNIQUE_IDENTIFIER MBEDTLS_OID_AT "\x2D"
00126 #define MBEDTLS_OID_AT_DN_QUALIFIER MBEDTLS_OID_AT "\x2E"
00127 #define MBEDTLS_OID_AT_PSEUDONYM MBEDTLS_OID_AT "\x41"
00129 #define MBEDTLS_OID_DOMAIN_COMPONENT "\x09\x92\x26\x89\x93\xF2\x2C\x64\x01\x19"
00131
00132
00133
00134 #define MBEDTLS_OID_AUTHORITY_KEY_IDENTIFIER MBEDTLS_OID_ID_CE "\x23"
00135 #define MBEDTLS_OID_SUBJECT_KEY_IDENTIFIER MBEDTLS_OID_ID_CE "\x0E"
00136 #define MBEDTLS_OID_KEY_USAGE MBEDTLS_OID_ID_CE "\x0F"
00137 #define MBEDTLS_OID_CERTIFICATE_POLICIES MBEDTLS_OID_ID_CE "\x20"
00138 #define MBEDTLS_OID_POLICY_MAPPINGS MBEDTLS_OID_ID_CE "\x21"
00139 #define MBEDTLS_OID_SUBJECT_ALT_NAME MBEDTLS_OID_ID_CE "\x11"
00140 #define MBEDTLS_OID_ISSUER_ALT_NAME MBEDTLS_OID_ID_CE "\x12"
00141 #define MBEDTLS_OID_SUBJECT_DIRECTORY_ATTRS MBEDTLS_OID_ID_CE "\x09"
00142 #define MBEDTLS_OID_BASIC_CONSTRAINTS MBEDTLS_OID_ID_CE "\x13"
00143 #define MBEDTLS_OID_NAME_CONSTRAINTS MBEDTLS_OID_ID_CE "\x1E"
00144 #define MBEDTLS_OID_POLICY_CONSTRAINTS MBEDTLS_OID_ID_CE "\x24"
00145 #define MBEDTLS_OID_EXTENDED_KEY_USAGE MBEDTLS_OID_ID_CE "\x25"
00146 #define MBEDTLS_OID_CRL_DISTRIBUTION_POINTS MBEDTLS_OID_ID_CE "\x1F"
00147 #define MBEDTLS_OID_INIHIBIT_ANYPOLICY MBEDTLS_OID_ID_CE "\x36"
00148 #define MBEDTLS_OID_FRESHEST_CRL MBEDTLS_OID_ID_CE "\x2E"
00150
00151
00152
00153 #define MBEDTLS_OID_NS_CERT MBEDTLS_OID_NETSCAPE "\x01"
00154 #define MBEDTLS_OID_NS_CERT_TYPE MBEDTLS_OID_NS_CERT "\x01"
00155 #define MBEDTLS_OID_NS_BASE_URL MBEDTLS_OID_NS_CERT "\x02"
00156 #define MBEDTLS_OID_NS_REVOCATION_URL MBEDTLS_OID_NS_CERT "\x03"
00157 #define MBEDTLS_OID_NS_CA_REVOCATION_URL MBEDTLS_OID_NS_CERT "\x04"
00158 #define MBEDTLS_OID_NS_RENEWAL_URL MBEDTLS_OID_NS_CERT "\x07"
00159 #define MBEDTLS_OID_NS_CA_POLICY_URL MBEDTLS_OID_NS_CERT "\x08"
00160 #define MBEDTLS_OID_NS_SSL_SERVER_NAME MBEDTLS_OID_NS_CERT "\x0C"
00161 #define MBEDTLS_OID_NS_COMMENT MBEDTLS_OID_NS_CERT "\x0D"
00162 #define MBEDTLS_OID_NS_DATA_TYPE MBEDTLS_OID_NETSCAPE "\x02"
00163 #define MBEDTLS_OID_NS_CERT_SEQUENCE MBEDTLS_OID_NS_DATA_TYPE "\x05"
00164
00165
00166
00167
00168 #define MBEDTLS_OID_PRIVATE_KEY_USAGE_PERIOD MBEDTLS_OID_ID_CE "\x10"
00169 #define MBEDTLS_OID_CRL_NUMBER MBEDTLS_OID_ID_CE "\x14"
00171
00172
00173
00174 #define MBEDTLS_OID_ANY_EXTENDED_KEY_USAGE MBEDTLS_OID_EXTENDED_KEY_USAGE "\x00"
00176 #define MBEDTLS_OID_KP MBEDTLS_OID_PKIX "\x03"
00177 #define MBEDTLS_OID_SERVER_AUTH MBEDTLS_OID_KP "\x01"
00178 #define MBEDTLS_OID_CLIENT_AUTH MBEDTLS_OID_KP "\x02"
00179 #define MBEDTLS_OID_CODE_SIGNING MBEDTLS_OID_KP "\x03"
00180 #define MBEDTLS_OID_EMAIL_PROTECTION MBEDTLS_OID_KP "\x04"
00181 #define MBEDTLS_OID_TIME_STAMPING MBEDTLS_OID_KP "\x08"
00182 #define MBEDTLS_OID_OCSP_SIGNING MBEDTLS_OID_KP "\x09"
00184
00185
00186
00187
00188 #define MBEDTLS_OID_PKCS MBEDTLS_OID_RSA_COMPANY "\x01"
00189 #define MBEDTLS_OID_PKCS1 MBEDTLS_OID_PKCS "\x01"
00190 #define MBEDTLS_OID_PKCS5 MBEDTLS_OID_PKCS "\x05"
00191 #define MBEDTLS_OID_PKCS9 MBEDTLS_OID_PKCS "\x09"
00192 #define MBEDTLS_OID_PKCS12 MBEDTLS_OID_PKCS "\x0c"
00194
00195
00196
00197 #define MBEDTLS_OID_PKCS1_RSA MBEDTLS_OID_PKCS1 "\x01"
00198 #define MBEDTLS_OID_PKCS1_MD2 MBEDTLS_OID_PKCS1 "\x02"
00199 #define MBEDTLS_OID_PKCS1_MD4 MBEDTLS_OID_PKCS1 "\x03"
00200 #define MBEDTLS_OID_PKCS1_MD5 MBEDTLS_OID_PKCS1 "\x04"
00201 #define MBEDTLS_OID_PKCS1_SHA1 MBEDTLS_OID_PKCS1 "\x05"
00202 #define MBEDTLS_OID_PKCS1_SHA224 MBEDTLS_OID_PKCS1 "\x0e"
00203 #define MBEDTLS_OID_PKCS1_SHA256 MBEDTLS_OID_PKCS1 "\x0b"
00204 #define MBEDTLS_OID_PKCS1_SHA384 MBEDTLS_OID_PKCS1 "\x0c"
00205 #define MBEDTLS_OID_PKCS1_SHA512 MBEDTLS_OID_PKCS1 "\x0d"
00207 #define MBEDTLS_OID_RSA_SHA_OBS "\x2B\x0E\x03\x02\x1D"
00208
00209 #define MBEDTLS_OID_PKCS9_EMAIL MBEDTLS_OID_PKCS9 "\x01"
00211
00212 #define MBEDTLS_OID_RSASSA_PSS MBEDTLS_OID_PKCS1 "\x0a"
00213 #define MBEDTLS_OID_MGF1 MBEDTLS_OID_PKCS1 "\x08"
00215
00216
00217
00218 #define MBEDTLS_OID_DIGEST_ALG_MD2 MBEDTLS_OID_RSA_COMPANY "\x02\x02"
00219 #define MBEDTLS_OID_DIGEST_ALG_MD4 MBEDTLS_OID_RSA_COMPANY "\x02\x04"
00220 #define MBEDTLS_OID_DIGEST_ALG_MD5 MBEDTLS_OID_RSA_COMPANY "\x02\x05"
00221 #define MBEDTLS_OID_DIGEST_ALG_SHA1 MBEDTLS_OID_ISO_IDENTIFIED_ORG MBEDTLS_OID_OIW_SECSIG_SHA1
00222 #define MBEDTLS_OID_DIGEST_ALG_SHA224 MBEDTLS_OID_GOV "\x03\x04\x02\x04"
00223 #define MBEDTLS_OID_DIGEST_ALG_SHA256 MBEDTLS_OID_GOV "\x03\x04\x02\x01"
00225 #define MBEDTLS_OID_DIGEST_ALG_SHA384 MBEDTLS_OID_GOV "\x03\x04\x02\x02"
00227 #define MBEDTLS_OID_DIGEST_ALG_SHA512 MBEDTLS_OID_GOV "\x03\x04\x02\x03"
00229 #define MBEDTLS_OID_HMAC_SHA1 MBEDTLS_OID_RSA_COMPANY "\x02\x07"
00231
00232
00233
00234 #define MBEDTLS_OID_DES_CBC MBEDTLS_OID_ISO_IDENTIFIED_ORG MBEDTLS_OID_OIW_SECSIG_ALG "\x07"
00235 #define MBEDTLS_OID_DES_EDE3_CBC MBEDTLS_OID_RSA_COMPANY "\x03\x07"
00237
00238
00239
00240 #define MBEDTLS_OID_PKCS5_PBKDF2 MBEDTLS_OID_PKCS5 "\x0c"
00241 #define MBEDTLS_OID_PKCS5_PBES2 MBEDTLS_OID_PKCS5 "\x0d"
00242 #define MBEDTLS_OID_PKCS5_PBMAC1 MBEDTLS_OID_PKCS5 "\x0e"
00244
00245
00246
00247 #define MBEDTLS_OID_PKCS5_PBE_MD2_DES_CBC MBEDTLS_OID_PKCS5 "\x01"
00248 #define MBEDTLS_OID_PKCS5_PBE_MD2_RC2_CBC MBEDTLS_OID_PKCS5 "\x04"
00249 #define MBEDTLS_OID_PKCS5_PBE_MD5_DES_CBC MBEDTLS_OID_PKCS5 "\x03"
00250 #define MBEDTLS_OID_PKCS5_PBE_MD5_RC2_CBC MBEDTLS_OID_PKCS5 "\x06"
00251 #define MBEDTLS_OID_PKCS5_PBE_SHA1_DES_CBC MBEDTLS_OID_PKCS5 "\x0a"
00252 #define MBEDTLS_OID_PKCS5_PBE_SHA1_RC2_CBC MBEDTLS_OID_PKCS5 "\x0b"
00254
00255
00256
00257 #define MBEDTLS_OID_PKCS9_CSR_EXT_REQ MBEDTLS_OID_PKCS9 "\x0e"
00259
00260
00261
00262 #define MBEDTLS_OID_PKCS12_PBE MBEDTLS_OID_PKCS12 "\x01"
00264 #define MBEDTLS_OID_PKCS12_PBE_SHA1_RC4_128 MBEDTLS_OID_PKCS12_PBE "\x01"
00265 #define MBEDTLS_OID_PKCS12_PBE_SHA1_RC4_40 MBEDTLS_OID_PKCS12_PBE "\x02"
00266 #define MBEDTLS_OID_PKCS12_PBE_SHA1_DES3_EDE_CBC MBEDTLS_OID_PKCS12_PBE "\x03"
00267 #define MBEDTLS_OID_PKCS12_PBE_SHA1_DES2_EDE_CBC MBEDTLS_OID_PKCS12_PBE "\x04"
00268 #define MBEDTLS_OID_PKCS12_PBE_SHA1_RC2_128_CBC MBEDTLS_OID_PKCS12_PBE "\x05"
00269 #define MBEDTLS_OID_PKCS12_PBE_SHA1_RC2_40_CBC MBEDTLS_OID_PKCS12_PBE "\x06"
00271
00272
00273
00274
00275
00276
00277 #define MBEDTLS_OID_EC_ALG_UNRESTRICTED MBEDTLS_OID_ANSI_X9_62 "\x02\01"
00278
00279
00280
00281
00282 #define MBEDTLS_OID_EC_ALG_ECDH MBEDTLS_OID_CERTICOM "\x01\x0c"
00283
00284
00285
00286
00287
00288
00289
00290 #define MBEDTLS_OID_EC_GRP_SECP192R1 MBEDTLS_OID_ANSI_X9_62 "\x03\x01\x01"
00291
00292
00293
00294 #define MBEDTLS_OID_EC_GRP_SECP224R1 MBEDTLS_OID_CERTICOM "\x00\x21"
00295
00296
00297
00298 #define MBEDTLS_OID_EC_GRP_SECP256R1 MBEDTLS_OID_ANSI_X9_62 "\x03\x01\x07"
00299
00300
00301
00302 #define MBEDTLS_OID_EC_GRP_SECP384R1 MBEDTLS_OID_CERTICOM "\x00\x22"
00303
00304
00305
00306 #define MBEDTLS_OID_EC_GRP_SECP521R1 MBEDTLS_OID_CERTICOM "\x00\x23"
00307
00308
00309
00310 #define MBEDTLS_OID_EC_GRP_SECP192K1 MBEDTLS_OID_CERTICOM "\x00\x1f"
00311
00312
00313
00314 #define MBEDTLS_OID_EC_GRP_SECP224K1 MBEDTLS_OID_CERTICOM "\x00\x20"
00315
00316
00317
00318 #define MBEDTLS_OID_EC_GRP_SECP256K1 MBEDTLS_OID_CERTICOM "\x00\x0a"
00319
00320
00321
00322
00323
00324
00325
00326 #define MBEDTLS_OID_EC_BRAINPOOL_V1 MBEDTLS_OID_TELETRUST "\x03\x03\x02\x08\x01\x01"
00327
00328
00329 #define MBEDTLS_OID_EC_GRP_BP256R1 MBEDTLS_OID_EC_BRAINPOOL_V1 "\x07"
00330
00331
00332 #define MBEDTLS_OID_EC_GRP_BP384R1 MBEDTLS_OID_EC_BRAINPOOL_V1 "\x0B"
00333
00334
00335 #define MBEDTLS_OID_EC_GRP_BP512R1 MBEDTLS_OID_EC_BRAINPOOL_V1 "\x0D"
00336
00337
00338
00339
00340
00341
00342
00343 #define MBEDTLS_OID_ANSI_X9_62_FIELD_TYPE MBEDTLS_OID_ANSI_X9_62 "\x01"
00344 #define MBEDTLS_OID_ANSI_X9_62_PRIME_FIELD MBEDTLS_OID_ANSI_X9_62_FIELD_TYPE "\x01"
00345
00346
00347
00348
00349 #define MBEDTLS_OID_ANSI_X9_62_SIG MBEDTLS_OID_ANSI_X9_62 "\x04"
00350 #define MBEDTLS_OID_ANSI_X9_62_SIG_SHA2 MBEDTLS_OID_ANSI_X9_62_SIG "\x03"
00351
00352
00353
00354 #define MBEDTLS_OID_ECDSA_SHA1 MBEDTLS_OID_ANSI_X9_62_SIG "\x01"
00355
00356
00357
00358
00359 #define MBEDTLS_OID_ECDSA_SHA224 MBEDTLS_OID_ANSI_X9_62_SIG_SHA2 "\x01"
00360
00361
00362
00363
00364 #define MBEDTLS_OID_ECDSA_SHA256 MBEDTLS_OID_ANSI_X9_62_SIG_SHA2 "\x02"
00365
00366
00367
00368
00369 #define MBEDTLS_OID_ECDSA_SHA384 MBEDTLS_OID_ANSI_X9_62_SIG_SHA2 "\x03"
00370
00371
00372
00373
00374 #define MBEDTLS_OID_ECDSA_SHA512 MBEDTLS_OID_ANSI_X9_62_SIG_SHA2 "\x04"
00375
00376 #ifdef __cplusplus
00377 extern "C" {
00378 #endif
00379
00383 typedef struct {
00384 const char *asn1;
00385 size_t asn1_len;
00386 const char *name;
00387 const char *description;
00388 } mbedtls_oid_descriptor_t;
00389
00401 int mbedtls_oid_get_numeric_string( char *buf, size_t size, const mbedtls_asn1_buf *oid );
00402
00403 #if defined(MBEDTLS_X509_USE_C) || defined(MBEDTLS_X509_CREATE_C)
00404
00412 int mbedtls_oid_get_x509_ext_type( const mbedtls_asn1_buf *oid, int *ext_type );
00413 #endif
00414
00424 int mbedtls_oid_get_attr_short_name( const mbedtls_asn1_buf *oid, const char **short_name );
00425
00434 int mbedtls_oid_get_pk_alg( const mbedtls_asn1_buf *oid, mbedtls_pk_type_t *pk_alg );
00435
00445 int mbedtls_oid_get_oid_by_pk_alg( mbedtls_pk_type_t pk_alg,
00446 const char **oid, size_t *olen );
00447
00448 #if defined(MBEDTLS_ECP_C)
00449
00457 int mbedtls_oid_get_ec_grp( const mbedtls_asn1_buf *oid, mbedtls_ecp_group_id *grp_id );
00458
00468 int mbedtls_oid_get_oid_by_ec_grp( mbedtls_ecp_group_id grp_id,
00469 const char **oid, size_t *olen );
00470 #endif
00471
00472 #if defined(MBEDTLS_MD_C)
00473
00482 int mbedtls_oid_get_sig_alg( const mbedtls_asn1_buf *oid,
00483 mbedtls_md_type_t *md_alg, mbedtls_pk_type_t *pk_alg );
00484
00493 int mbedtls_oid_get_sig_alg_desc( const mbedtls_asn1_buf *oid, const char **desc );
00494
00505 int mbedtls_oid_get_oid_by_sig_alg( mbedtls_pk_type_t pk_alg, mbedtls_md_type_t md_alg,
00506 const char **oid, size_t *olen );
00507
00516 int mbedtls_oid_get_md_alg( const mbedtls_asn1_buf *oid, mbedtls_md_type_t *md_alg );
00517 #endif
00518
00527 int mbedtls_oid_get_extended_key_usage( const mbedtls_asn1_buf *oid, const char **desc );
00528
00538 int mbedtls_oid_get_oid_by_md( mbedtls_md_type_t md_alg, const char **oid, size_t *olen );
00539
00540 #if defined(MBEDTLS_CIPHER_C)
00541
00549 int mbedtls_oid_get_cipher_alg( const mbedtls_asn1_buf *oid, mbedtls_cipher_type_t *cipher_alg );
00550 #endif
00551
00552 #if defined(MBEDTLS_PKCS12_C)
00553
00563 int mbedtls_oid_get_pkcs12_pbe_alg( const mbedtls_asn1_buf *oid, mbedtls_md_type_t *md_alg,
00564 mbedtls_cipher_type_t *cipher_alg );
00565 #endif
00566
00567 #ifdef __cplusplus
00568 }
00569 #endif
00570
00571 #endif