luna - wolfssl/doc/dox_comments/header_files-ja/asn

   1/*!
   2    \ingroup ASN
   3
   4    \brief この関数は、デフォルトのオプションでデフォルトの証明書を初期化します：
   5    version = 3（0x2）、serial = 0、sigType = SHA_WITH_RSA、issuer = 空白、
   6    daysValid = 500、selfSigned = 1（true）発行者としてsubjectを使用、
   7    subject = 空白
   8
   9    \return none 返り値なし。
  10
  11    \param cert 初期化する未初期化のcert構造体へのポインタ
  12
  13    _Example_
  14    \code
  15    Cert myCert;
  16    wc_InitCert(&myCert);
  17    \endcode
  18
  19    \sa wc_MakeCert
  20    \sa wc_MakeCertReq
  21*/
  22int wc_InitCert(Cert* cert);
  23
  24/*!
  25     \ingroup ASN
  26
  27     \brief この関数は、証明書操作中に使用するための新しいCert構造体を割り当てます。アプリケーションが構造体自体を割り当てる必要はありません。Cert構造体もこの関数によって初期化されるため、wc_InitCert()を呼び出す必要がなくなります。アプリケーションが割り当てられたCert構造体の使用を終了したら、wc_CertFree()を呼び出す必要があります。
  28
  29     \return pointer 成功した場合、呼び出しは新しく割り当てられ初期化されたCertへのポインタを返します。
  30     \return NULL メモリ割り当て失敗時。
  31
  32     \param A 動的割り当てに使用されるヒープへのポインタ。NULLでも可。
  33
  34     _Example_
  35     \code
  36     Cert*   myCert;
  37
  38     myCert = wc_CertNew(NULL);
  39     if (myCert == NULL) {
  40         // Cert作成失敗
  41     }
  42     \endcode
  43
  44     \sa wc_InitCert
  45     \sa wc_MakeCert
  46     \sa wc_CertFree
  47
  48*/
  49Cert* wc_CertNew(void* heap);
  50
  51/*!
  52     \ingroup ASN
  53
  54     \brief この関数は、wc_CertNew()への以前の呼び出しによってcert構造体に割り当てられたメモリを解放します。
  55
  56     \return None.
  57
  58     \param A 解放するcert構造体へのポインタ。
  59
  60     _Example_
  61     \code
  62     Cert*   myCert;
  63
  64     myCert = wc_CertNew(NULL);
  65
  66     // 証明書操作を実行。
  67
  68     wc_CertFree(myCert);
  69     \endcode
  70
  71     \sa wc_InitCert
  72     \sa wc_MakeCert
  73     \sa wc_CertNew
  74
  75*/
  76void  wc_CertFree(Cert* cert);
  77
  78/*!
  79    \ingroup ASN
  80
  81    \brief CA署名付き証明書を作成するために使用されます。subject情報が入力された後に呼び出されます。この関数は、cert入力からx509証明書v3 RSAまたはECCを作成します。次に、この証明書をderBufferに書き込みます。証明書を生成するために、rsaKeyまたはeccKeyのいずれかを受け取ります。このメソッドを呼び出す前に、証明書をwc_InitCertで初期化する必要があります。
  82
  83    \return Success 指定された入力certからx509証明書を正常に作成すると、生成された証明書のサイズを返します。
  84    \return MEMORY_E XMALLOCでメモリを割り当てる際にエラーがある場合に返されます
  85    \return BUFFER_E 提供されたderBufferが生成された証明書を格納するには小さすぎる場合に返されます
  86    \return Others 証明書の生成が成功しない場合、追加のエラーメッセージが返される可能性があります。
  87
  88    \param cert 初期化されたcert構造体へのポインタ
  89    \param derBuffer 生成された証明書を保持するバッファへのポインタ
  90    \param derSz 証明書を格納するバッファのサイズ
  91    \param rsaKey 証明書の生成に使用されるrsaキーを含むRsaKey構造体へのポインタ
  92    \param eccKey 証明書の生成に使用されるeccキーを含むEccKey構造体へのポインタ
  93    \param rng 証明書を作成するために使用される乱数生成器へのポインタ
  94
  95    _Example_
  96    \code
  97    Cert myCert;
  98    wc_InitCert(&myCert);
  99    WC_RNG rng;
 100    // rngを初期化;
 101    RsaKey key;
 102    // keyを初期化;
 103    byte * derCert = malloc(FOURK_BUF);
 104    word32 certSz;
 105    certSz = wc_MakeCert(&myCert, derCert, FOURK_BUF, &key, NULL, &rng);
 106    \endcode
 107
 108    \sa wc_InitCert
 109    \sa wc_MakeCertReq
 110*/
 111int  wc_MakeCert(Cert* cert, byte* derBuffer, word32 derSz, RsaKey* rsaKey,
 112                             ecc_key* eccKey, WC_RNG* rng);
 113
 114/*!
 115    \ingroup ASN
 116
 117    \brief この関数は、入力証明書を使用して証明書署名要求を作成し、出力をderBufferに書き込みます。証明書要求を生成するために、rsaKeyまたはeccKeyのいずれかを受け取ります。証明書署名要求に署名するには、この関数の後にwc_SignCert()を呼び出す必要があります。この関数の使用例については、wolfCryptテストアプリケーション（./wolfcrypt/test/test.c）を参照してください。
 118
 119    \return Success 指定された入力certからX.509証明書要求を正常に作成すると、生成された証明書要求のサイズを返します。
 120    \return MEMORY_E XMALLOCでメモリを割り当てる際にエラーがある場合に返されます
 121    \return BUFFER_E 提供されたderBufferが生成された証明書を格納するには小さすぎる場合に返されます
 122    \return Other 証明書要求の生成が成功しない場合、追加のエラーメッセージが返される可能性があります。
 123
 124    \param cert 初期化されたcert構造体へのポインタ
 125    \param derBuffer 生成された証明書要求を保持するバッファへのポインタ
 126    \param derSz 証明書要求を格納するバッファのサイズ
 127    \param rsaKey 証明書要求の生成に使用されるrsaキーを含むRsaKey構造体へのポインタ
 128    \param eccKey 証明書要求の生成に使用されるeccキーを含むEccKey構造体へのポインタ
 129
 130    _Example_
 131    \code
 132    Cert myCert;
 133    // myCertを初期化
 134    EccKey key;
 135    // keyを初期化;
 136    byte* derCert = (byte*)malloc(FOURK_BUF);
 137
 138    word32 certSz;
 139    certSz = wc_MakeCertReq(&myCert, derCert, FOURK_BUF, NULL, &key);
 140    \endcode
 141
 142    \sa wc_InitCert
 143    \sa wc_MakeCert
 144*/
 145int  wc_MakeCertReq(Cert* cert, byte* derBuffer, word32 derSz,
 146                                    RsaKey* rsaKey, ecc_key* eccKey);
 147
 148/*!
 149    \ingroup ASN
 150
 151    \brief この関数はbufferに署名し、署名をbufferの末尾に追加します。署名タイプを受け取ります。CA署名付き証明書を作成する場合は、wc_MakeCert()またはwc_MakeCertReq()の後に呼び出す必要があります。
 152
 153    \return Success 証明書の署名に成功すると、証明書の新しいサイズ（署名を含む）を返します。
 154    \return MEMORY_E XMALLOCでメモリを割り当てる際にエラーがある場合に返されます
 155    \return BUFFER_E 提供されたバッファが生成された証明書を格納するには小さすぎる場合に返されます
 156    \return Other 証明書の生成が成功しない場合、追加のエラーメッセージが返される可能性があります。
 157
 158    \param requestSz 署名を要求している証明書本文のサイズ
 159    \param sType 作成する署名のタイプ。有効なオプションは：CTC_MD5wRSA、CTC_SHAwRSA、CTC_SHAwECDSA、CTC_SHA256wECDSA、およびCTC_SHA256wRSA
 160    \param buffer 署名される証明書を含むバッファへのポインタ。成功時：新しく署名された証明書を保持します
 161    \param buffSz 新しく署名された証明書を格納するバッファの（合計）サイズ
 162    \param rsaKey 証明書に署名するために使用されるrsaキーを含むRsaKey構造体へのポインタ
 163    \param eccKey 証明書に署名するために使用されるeccキーを含むEccKey構造体へのポインタ
 164    \param rng 証明書に署名するために使用される乱数生成器へのポインタ
 165
 166    _Example_
 167    \code
 168    Cert myCert;
 169    byte* derCert = (byte*)malloc(FOURK_BUF);
 170    // myCert、derCertを初期化
 171    RsaKey key;
 172    // keyを初期化;
 173    WC_RNG rng;
 174    // rngを初期化
 175
 176    word32 certSz;
 177    certSz = wc_SignCert(myCert.bodySz, myCert.sigType,derCert,FOURK_BUF,
 178    &key, NULL,
 179    &rng);
 180    \endcode
 181
 182    \sa wc_InitCert
 183    \sa wc_MakeCert
 184*/
 185int  wc_SignCert(int requestSz, int sigType, byte* derBuffer,
 186                 word32 derSz, RsaKey* rsaKey, ecc_key* eccKey, WC_RNG* rng);
 187
 188/*!
 189    \ingroup ASN
 190
 191    \brief この関数は、自己署名用の前の2つの関数、wc_MakeCertとwc_SignCertの組み合わせです（前の関数はCA要求に使用できます）。証明書を作成してから署名し、自己署名証明書を生成します。
 192
 193    \return Success 証明書の署名に成功すると、証明書の新しいサイズを返します。
 194    \return MEMORY_E XMALLOCでメモリを割り当てる際にエラーがある場合に返されます
 195    \return BUFFER_E 提供されたバッファが生成された証明書を格納するには小さすぎる場合に返されます
 196    \return Other 証明書の生成が成功しない場合、追加のエラーメッセージが返される可能性があります。
 197
 198    \param cert 作成して署名する証明書へのポインタ
 199    \param buffer 署名された証明書を保持するバッファへのポインタ
 200    \param buffSz 署名された証明書を格納するバッファのサイズ
 201    \param key 証明書に署名するために使用されるrsaキーを含むRsaKey構造体へのポインタ
 202    \param rng 証明書の生成と署名に使用される乱数生成器へのポインタ
 203
 204    _Example_
 205    \code
 206    Cert myCert;
 207    byte* derCert = (byte*)malloc(FOURK_BUF);
 208    // myCert、derCertを初期化
 209    RsaKey key;
 210    // keyを初期化;
 211    WC_RNG rng;
 212    // rngを初期化
 213
 214    word32 certSz;
 215    certSz = wc_MakeSelfCert(&myCert, derCert, FOURK_BUF, &key, NULL, &rng);
 216    \endcode
 217
 218    \sa wc_InitCert
 219    \sa wc_MakeCert
 220    \sa wc_SignCert
 221*/
 222int  wc_MakeSelfCert(Cert* cert, byte* derBuffer, word32 derSz, RsaKey* key,
 223                             WC_RNG* rng);
 224
 225/*!
 226    \ingroup ASN
 227
 228    \brief この関数は、証明書の発行者を、提供されたpem issuerFileの発行者に設定します。また、証明書の自己署名属性をfalseに変更します。issuerFileで指定された発行者は、cert発行者を設定する前に検証されます。このメソッドは、署名前にフィールドを設定するために使用されます。
 229
 230    \return 0 証明書の発行者を正常に設定した場合に返されます
 231    \return MEMORY_E XMALLOCでメモリを割り当てる際にエラーがある場合に返されます
 232    \return ASN_PARSE_E 証明書ヘッダーファイルの解析エラーがある場合に返されます
 233    \return ASN_OBJECT_ID_E 証明書から暗号化タイプを解析する際にエラーがある場合に返されます
 234    \return ASN_EXPECT_0_E 証明書ファイルの暗号化仕様にフォーマットエラーがある場合に返されます
 235    \return ASN_BEFORE_DATE_E 日付が証明書の開始日より前の場合に返されます
 236    \return ASN_AFTER_DATE_E 日付が証明書の有効期限より後の場合に返されます
 237    \return ASN_BITSTR_E 証明書からビット文字列を解析する際にエラーがある場合に返されます
 238    \return ECC_CURVE_OID_E 証明書からECCキーを解析する際にエラーがある場合に返されます
 239    \return ASN_UNKNOWN_OID_E 証明書が不明なキーオブジェクトIDを使用している場合に返されます
 240    \return ASN_VERSION_E ALLOW_V1_EXTENSIONSオプションが定義されておらず、証明書がV1またはV2証明書の場合に返されます
 241    \return BAD_FUNC_ARG 証明書拡張の処理エラーがある場合に返されます
 242    \return ASN_CRIT_EXT_E 証明書の処理中に見慣れない重要な拡張に遭遇した場合に返されます
 243    \return ASN_SIG_OID_E 署名暗号化タイプが提供されたファイル内の証明書の暗号化タイプと同じでない場合に返されます
 244    \return ASN_SIG_CONFIRM_E 証明書署名の確認が失敗した場合に返されます
 245    \return ASN_NAME_INVALID_E 証明書の名前がCA名前制約で許可されていない場合に返されます
 246    \return ASN_NO_SIGNER_E 証明書の真正性を検証するCA署名者がいない場合に返されます
 247
 248    \param cert 発行者を設定する証明書へのポインタ
 249    \param issuerFile pem形式の証明書を含むファイルのパス
 250
 251    _Example_
 252    \code
 253    Cert myCert;
 254    // myCertを初期化
 255    if(wc_SetIssuer(&myCert, "./path/to/ca-cert.pem") != 0) {
 256    	// 発行者設定エラー
 257    }
 258    \endcode
 259
 260    \sa wc_InitCert
 261    \sa wc_SetSubject
 262    \sa wc_SetIssuerBuffer
 263*/
 264int  wc_SetIssuer(Cert* cert, const char* issuerFile);
 265
 266/*!
 267    \ingroup ASN
 268
 269    \brief この関数は、証明書のsubjectを、提供されたpem subjectFileのsubjectに設定します。このメソッドは、署名前にフィールドを設定するために使用されます。
 270
 271    \return 0 証明書の発行者を正常に設定した場合に返されます
 272    \return MEMORY_E XMALLOCでメモリを割り当てる際にエラーがある場合に返されます
 273    \return ASN_PARSE_E 証明書ヘッダーファイルの解析エラーがある場合に返されます
 274    \return ASN_OBJECT_ID_E 証明書から暗号化タイプを解析する際にエラーがある場合に返されます
 275    \return ASN_EXPECT_0_E 証明書ファイルの暗号化仕様にフォーマットエラーがある場合に返されます
 276    \return ASN_BEFORE_DATE_E 日付が証明書の開始日より前の場合に返されます
 277    \return ASN_AFTER_DATE_E 日付が証明書の有効期限より後の場合に返されます
 278    \return ASN_BITSTR_E 証明書からビット文字列を解析する際にエラーがある場合に返されます
 279    \return ECC_CURVE_OID_E 証明書からECCキーを解析する際にエラーがある場合に返されます
 280    \return ASN_UNKNOWN_OID_E 証明書が不明なキーオブジェクトIDを使用している場合に返されます
 281    \return ASN_VERSION_E ALLOW_V1_EXTENSIONSオプションが定義されておらず、証明書がV1またはV2証明書の場合に返されます
 282    \return BAD_FUNC_ARG 証明書拡張の処理エラーがある場合に返されます
 283    \return ASN_CRIT_EXT_E 証明書の処理中に見慣れない重要な拡張に遭遇した場合に返されます
 284    \return ASN_SIG_OID_E 署名暗号化タイプが提供されたファイル内の証明書の暗号化タイプと同じでない場合に返されます
 285    \return ASN_SIG_CONFIRM_E 証明書署名の確認が失敗した場合に返されます
 286    \return ASN_NAME_INVALID_E 証明書の名前がCA名前制約で許可されていない場合に返されます
 287    \return ASN_NO_SIGNER_E 証明書の真正性を検証するCA署名者がいない場合に返されます
 288
 289    \param cert 発行者を設定する証明書へのポインタ
 290    \param subjectFile pem形式の証明書を含むファイルのパス
 291
 292    _Example_
 293    \code
 294    Cert myCert;
 295    // myCertを初期化
 296    if(wc_SetSubject(&myCert, "./path/to/ca-cert.pem") != 0) {
 297    	// subject設定エラー
 298    }
 299    \endcode
 300
 301    \sa wc_InitCert
 302    \sa wc_SetIssuer
 303*/
 304int  wc_SetSubject(Cert* cert, const char* subjectFile);
 305
 306
 307/*!
 308    \ingroup ASN
 309
 310    \brief この関数は、提供されたderバッファのsubjectから証明書の生のsubjectを設定します。このメソッドは、署名前に生のsubjectフィールドを設定するために使用されます。
 311    \return 0 証明書のsubjectを正常に設定した場合に返されます
 312    \return MEMORY_E XMALLOCでメモリを割り当てる際にエラーがある場合に返されます
 313    \return ASN_PARSE_E 証明書ヘッダーファイルの解析エラーがある場合に返されます
 314    \return ASN_OBJECT_ID_E 証明書から暗号化タイプを解析する際にエラーがある場合に返されます
 315    \return ASN_EXPECT_0_E 証明書ファイルの暗号化仕様にフォーマットエラーがある場合に返されます
 316    \return ASN_BEFORE_DATE_E 日付が証明書の開始日より前の場合に返されます
 317    \return ASN_AFTER_DATE_E 日付が証明書の有効期限より後の場合に返されます
 318    \return ASN_BITSTR_E 証明書からビット文字列を解析する際にエラーがある場合に返されます
 319    \return ECC_CURVE_OID_E 証明書からECCキーを解析する際にエラーがある場合に返されます
 320    \return ASN_UNKNOWN_OID_E 証明書が不明なキーオブジェクトIDを使用している場合に返されます
 321    \return ASN_VERSION_E ALLOW_V1_EXTENSIONSオプションが定義されておらず、証明書がV1またはV2証明書の場合に返されます
 322    \return BAD_FUNC_ARG 証明書拡張の処理エラーがある場合に返されます
 323    \return ASN_CRIT_EXT_E 証明書の処理中に見慣れない重要な拡張に遭遇した場合に返されます
 324    \return ASN_SIG_OID_E 署名暗号化タイプが提供されたファイル内の証明書の暗号化タイプと同じでない場合に返されます
 325    \return ASN_SIG_CONFIRM_E 証明書署名の確認が失敗した場合に返されます
 326    \return ASN_NAME_INVALID_E 証明書の名前がCA名前制約で許可されていない場合に返されます
 327    \return ASN_NO_SIGNER_E 証明書の真正性を検証するCA署名者がいない場合に返されます
 328
 329    \param cert 生のsubjectを設定する証明書へのポインタ
 330    \param der subjectを取得するder形式の証明書を含むバッファへのポインタ
 331    \param derSz subjectを取得するder形式の証明書を含むバッファのサイズ
 332
 333    _Example_
 334    \code
 335    Cert myCert;
 336    // myCertを初期化
 337    byte* der;
 338    der = (byte*)malloc(FOURK_BUF);
 339    // derを初期化
 340    if(wc_SetSubjectRaw(&myCert, der, FOURK_BUF) != 0) {
 341        // subject設定エラー
 342    }
 343    \endcode
 344
 345    \sa wc_InitCert
 346    \sa wc_SetSubject
 347*/
 348int  wc_SetSubjectRaw(Cert* cert, const byte* der, int derSz);
 349
 350/*!
 351    \ingroup ASN
 352
 353    \brief この関数は、証明書構造体から生のsubjectを取得します。
 354
 355    \return 0 証明書からsubjectを正常に取得した場合に返されます
 356    \return BAD_FUNC_ARG 証明書拡張の処理エラーがある場合に返されます
 357
 358    \param subjectRaw 正常に返された場合の生のsubjectへのポインタのポインタ
 359    \param cert 生のsubjectを取得する証明書へのポインタ
 360
 361    _Example_
 362    \code
 363    Cert myCert;
 364    byte *subjRaw;
 365    // myCertを初期化
 366
 367    if(wc_GetSubjectRaw(&subjRaw, &myCert) != 0) {
 368        // subject設定エラー
 369    }
 370    \endcode
 371
 372    \sa wc_InitCert
 373    \sa wc_SetSubjectRaw
 374*/
 375int  wc_GetSubjectRaw(byte **subjectRaw, Cert *cert);
 376
 377/*!
 378    \ingroup ASN
 379
 380    \brief この関数は、証明書の代替名を、提供されたpemファイル内の代替名に設定します。これは、同じ証明書で複数のドメインを保護したい場合に便利です。このメソッドは、署名前にフィールドを設定するために使用されます。
 381
 382    \return 0 証明書の代替名を正常に設定した場合に返されます
 383    \return MEMORY_E XMALLOCでメモリを割り当てる際にエラーがある場合に返されます
 384    \return ASN_PARSE_E 証明書ヘッダーファイルの解析エラーがある場合に返されます
 385    \return ASN_OBJECT_ID_E 証明書から暗号化タイプを解析する際にエラーがある場合に返されます
 386    \return ASN_EXPECT_0_E 証明書ファイルの暗号化仕様にフォーマットエラーがある場合に返されます
 387    \return ASN_BEFORE_DATE_E 日付が証明書の開始日より前の場合に返されます
 388    \return ASN_AFTER_DATE_E 日付が証明書の有効期限より後の場合に返されます
 389    \return ASN_BITSTR_E 証明書からビット文字列を解析する際にエラーがある場合に返されます
 390    \return ECC_CURVE_OID_E 証明書からECCキーを解析する際にエラーがある場合に返されます
 391    \return ASN_UNKNOWN_OID_E 証明書が不明なキーオブジェクトIDを使用している場合に返されます
 392    \return ASN_VERSION_E ALLOW_V1_EXTENSIONSオプションが定義されておらず、証明書がV1またはV2証明書の場合に返されます
 393    \return BAD_FUNC_ARG 証明書拡張の処理エラーがある場合に返されます
 394    \return ASN_CRIT_EXT_E 証明書の処理中に見慣れない重要な拡張に遭遇した場合に返されます
 395    \return ASN_SIG_OID_E 署名暗号化タイプが提供されたファイル内の証明書の暗号化タイプと同じでない場合に返されます
 396    \return ASN_SIG_CONFIRM_E 証明書署名の確認が失敗した場合に返されます
 397    \return ASN_NAME_INVALID_E 証明書の名前がCA名前制約で許可されていない場合に返されます
 398    \return ASN_NO_SIGNER_E 証明書の真正性を検証するCA署名者がいない場合に返されます
 399
 400    \param cert 代替名を設定する証明書へのポインタ
 401    \param file pem形式の証明書を含むファイルのパス
 402
 403    _Example_
 404    \code
 405    Cert myCert;
 406    // myCertを初期化
 407    if(wc_SetSubject(&myCert, "./path/to/ca-cert.pem") != 0) {
 408    	// 代替名設定エラー
 409    }
 410    \endcode
 411
 412    \sa wc_InitCert
 413    \sa wc_SetIssuer
 414*/
 415int  wc_SetAltNames(Cert* cert, const char* file);
 416
 417/*!
 418    \ingroup ASN
 419
 420    \brief この関数は、提供されたderバッファの発行者から証明書の発行者を設定します。また、証明書の自己署名属性をfalseに変更します。このメソッドは、署名前にフィールドを設定するために使用されます。
 421
 422    \return 0 証明書の発行者を正常に設定した場合に返されます
 423    \return MEMORY_E XMALLOCでメモリを割り当てる際にエラーがある場合に返されます
 424    \return ASN_PARSE_E 証明書ヘッダーファイルの解析エラーがある場合に返されます
 425    \return ASN_OBJECT_ID_E 証明書から暗号化タイプを解析する際にエラーがある場合に返されます
 426    \return ASN_EXPECT_0_E 証明書ファイルの暗号化仕様にフォーマットエラーがある場合に返されます
 427    \return ASN_BEFORE_DATE_E 日付が証明書の開始日より前の場合に返されます
 428    \return ASN_AFTER_DATE_E 日付が証明書の有効期限より後の場合に返されます
 429    \return ASN_BITSTR_E 証明書からビット文字列を解析する際にエラーがある場合に返されます
 430    \return ECC_CURVE_OID_E 証明書からECCキーを解析する際にエラーがある場合に返されます
 431    \return ASN_UNKNOWN_OID_E 証明書が不明なキーオブジェクトIDを使用している場合に返されます
 432    \return ASN_VERSION_E ALLOW_V1_EXTENSIONSオプションが定義されておらず、証明書がV1またはV2証明書の場合に返されます
 433    \return BAD_FUNC_ARG 証明書拡張の処理エラーがある場合に返されます
 434    \return ASN_CRIT_EXT_E 証明書の処理中に見慣れない重要な拡張に遭遇した場合に返されます
 435    \return ASN_SIG_OID_E 署名暗号化タイプが提供されたファイル内の証明書の暗号化タイプと同じでない場合に返されます
 436    \return ASN_SIG_CONFIRM_E 証明書署名の確認が失敗した場合に返されます
 437    \return ASN_NAME_INVALID_E 証明書の名前がCA名前制約で許可されていない場合に返されます
 438    \return ASN_NO_SIGNER_E 証明書の真正性を検証するCA署名者がいない場合に返されます
 439
 440    \param cert 発行者を設定する証明書へのポインタ
 441    \param der 発行者を取得するder形式の証明書を含むバッファへのポインタ
 442    \param derSz 発行者を取得するder形式の証明書を含むバッファのサイズ
 443
 444    _Example_
 445    \code
 446    Cert myCert;
 447    // myCertを初期化
 448    byte* der;
 449    der = (byte*)malloc(FOURK_BUF);
 450    // derを初期化
 451    if(wc_SetIssuerBuffer(&myCert, der, FOURK_BUF) != 0) {
 452	    // issuer設定エラー
 453    }
 454    \endcode
 455
 456    \sa wc_InitCert
 457    \sa wc_SetIssuer
 458*/
 459int  wc_SetIssuerBuffer(Cert* cert, const byte* der, int derSz);
 460
 461/*!
 462    \ingroup ASN
 463
 464    \brief この関数は、提供されたderバッファの発行者から証明書の生の発行者を設定します。このメソッドは、署名前に生の発行者フィールドを設定するために使用されます。
 465
 466    \return 0 証明書の発行者を正常に設定した場合に返されます
 467    \return MEMORY_E XMALLOCでメモリを割り当てる際にエラーがある場合に返されます
 468    \return ASN_PARSE_E 証明書ヘッダーファイルの解析エラーがある場合に返されます
 469    \return ASN_OBJECT_ID_E 証明書から暗号化タイプを解析する際にエラーがある場合に返されます
 470    \return ASN_EXPECT_0_E 証明書ファイルの暗号化仕様にフォーマットエラーがある場合に返されます
 471    \return ASN_BEFORE_DATE_E 日付が証明書の開始日より前の場合に返されます
 472    \return ASN_AFTER_DATE_E 日付が証明書の有効期限より後の場合に返されます
 473    \return ASN_BITSTR_E 証明書からビット文字列を解析する際にエラーがある場合に返されます
 474    \return ECC_CURVE_OID_E 証明書からECCキーを解析する際にエラーがある場合に返されます
 475    \return ASN_UNKNOWN_OID_E 証明書が不明なキーオブジェクトIDを使用している場合に返されます
 476    \return ASN_VERSION_E ALLOW_V1_EXTENSIONSオプションが定義されておらず、証明書がV1またはV2証明書の場合に返されます
 477    \return BAD_FUNC_ARG 証明書拡張の処理エラーがある場合に返されます
 478    \return ASN_CRIT_EXT_E 証明書の処理中に見慣れない重要な拡張に遭遇した場合に返されます
 479    \return ASN_SIG_OID_E 署名暗号化タイプが提供されたファイル内の証明書の暗号化タイプと同じでない場合に返されます
 480    \return ASN_SIG_CONFIRM_E 証明書署名の確認が失敗した場合に返されます
 481    \return ASN_NAME_INVALID_E 証明書の名前がCA名前制約で許可されていない場合に返されます
 482    \return ASN_NO_SIGNER_E 証明書の真正性を検証するCA署名者がいない場合に返されます
 483
 484    \param cert 生の発行者を設定する証明書へのポインタ
 485    \param der subjectを取得するder形式の証明書を含むバッファへのポインタ
 486    \param derSz subjectを取得するder形式の証明書を含むバッファのサイズ
 487
 488    _Example_
 489    \code
 490    Cert myCert;
 491    // myCertを初期化
 492    byte* der;
 493    der = (byte*)malloc(FOURK_BUF);
 494    // derを初期化
 495    if(wc_SetIssuerRaw(&myCert, der, FOURK_BUF) != 0) {
 496        // subject設定エラー
 497    }
 498    \endcode
 499
 500    \sa wc_InitCert
 501    \sa wc_SetIssuer
 502*/
 503int  wc_SetIssuerRaw(Cert* cert, const byte* der, int derSz);
 504
 505/*!
 506    \ingroup ASN
 507
 508    \brief この関数は、提供されたderバッファのsubjectから証明書のsubjectを設定します。このメソッドは、署名前にフィールドを設定するために使用されます。
 509
 510    \return 0 証明書のsubjectを正常に設定した場合に返されます
 511    \return MEMORY_E XMALLOCでメモリを割り当てる際にエラーがある場合に返されます
 512    \return ASN_PARSE_E 証明書ヘッダーファイルの解析エラーがある場合に返されます
 513    \return ASN_OBJECT_ID_E 証明書から暗号化タイプを解析する際にエラーがある場合に返されます
 514    \return ASN_EXPECT_0_E 証明書ファイルの暗号化仕様にフォーマットエラーがある場合に返されます
 515    \return ASN_BEFORE_DATE_E 日付が証明書の開始日より前の場合に返されます
 516    \return ASN_AFTER_DATE_E 日付が証明書の有効期限より後の場合に返されます
 517    \return ASN_BITSTR_E 証明書からビット文字列を解析する際にエラーがある場合に返されます
 518    \return ECC_CURVE_OID_E 証明書からECCキーを解析する際にエラーがある場合に返されます
 519    \return ASN_UNKNOWN_OID_E 証明書が不明なキーオブジェクトIDを使用している場合に返されます
 520    \return ASN_VERSION_E ALLOW_V1_EXTENSIONSオプションが定義されておらず、証明書がV1またはV2証明書の場合に返されます
 521    \return BAD_FUNC_ARG 証明書拡張の処理エラーがある場合に返されます
 522    \return ASN_CRIT_EXT_E 証明書の処理中に見慣れない重要な拡張に遭遇した場合に返されます
 523    \return ASN_SIG_OID_E 署名暗号化タイプが提供されたファイル内の証明書の暗号化タイプと同じでない場合に返されます
 524    \return ASN_SIG_CONFIRM_E 証明書署名の確認が失敗した場合に返されます
 525    \return ASN_NAME_INVALID_E 証明書の名前がCA名前制約で許可されていない場合に返されます
 526    \return ASN_NO_SIGNER_E 証明書の真正性を検証するCA署名者がいない場合に返されます
 527
 528    \param cert subjectを設定する証明書へのポインタ
 529    \param der subjectを取得するder形式の証明書を含むバッファへのポインタ
 530    \param derSz subjectを取得するder形式の証明書を含むバッファのサイズ
 531
 532    _Example_
 533    \code
 534    Cert myCert;
 535    // myCertを初期化
 536    byte* der;
 537    der = (byte*)malloc(FOURK_BUF);
 538    // derを初期化
 539    if(wc_SetSubjectBuffer(&myCert, der, FOURK_BUF) != 0) {
 540    	// subject設定エラー
 541    }
 542    \endcode
 543
 544    \sa wc_InitCert
 545    \sa wc_SetSubject
 546*/
 547int  wc_SetSubjectBuffer(Cert* cert, const byte* der, int derSz);
 548
 549/*!
 550    \ingroup ASN
 551
 552    \brief この関数は、提供されたderバッファの代替名から証明書の代替名を設定します。これは、同じ証明書で複数のドメインを保護したい場合に便利です。このメソッドは、署名前にフィールドを設定するために使用されます。
 553
 554    \return 0 証明書の代替名を正常に設定した場合に返されます
 555    \return MEMORY_E XMALLOCでメモリを割り当てる際にエラーがある場合に返されます
 556    \return ASN_PARSE_E 証明書ヘッダーファイルの解析エラーがある場合に返されます
 557    \return ASN_OBJECT_ID_E 証明書から暗号化タイプを解析する際にエラーがある場合に返されます
 558    \return ASN_EXPECT_0_E 証明書ファイルの暗号化仕様にフォーマットエラーがある場合に返されます
 559    \return ASN_BEFORE_DATE_E 日付が証明書の開始日より前の場合に返されます
 560    \return ASN_AFTER_DATE_E 日付が証明書の有効期限より後の場合に返されます
 561    \return ASN_BITSTR_E 証明書からビット文字列を解析する際にエラーがある場合に返されます
 562    \return ECC_CURVE_OID_E 証明書からECCキーを解析する際にエラーがある場合に返されます
 563    \return ASN_UNKNOWN_OID_E 証明書が不明なキーオブジェクトIDを使用している場合に返されます
 564    \return ASN_VERSION_E ALLOW_V1_EXTENSIONSオプションが定義されておらず、証明書がV1またはV2証明書の場合に返されます
 565    \return BAD_FUNC_ARG 証明書拡張の処理エラーがある場合に返されます
 566    \return ASN_CRIT_EXT_E 証明書の処理中に見慣れない重要な拡張に遭遇した場合に返されます
 567    \return ASN_SIG_OID_E 署名暗号化タイプが提供されたファイル内の証明書の暗号化タイプと同じでない場合に返されます
 568    \return ASN_SIG_CONFIRM_E 証明書署名の確認が失敗した場合に返されます
 569    \return ASN_NAME_INVALID_E 証明書の名前がCA名前制約で許可されていない場合に返されます
 570    \return ASN_NO_SIGNER_E 証明書の真正性を検証するCA署名者がいない場合に返されます
 571
 572    \param cert 代替名を設定する証明書へのポインタ
 573    \param der 代替名を取得するder形式の証明書を含むバッファへのポインタ
 574    \param derSz 代替名を取得するder形式の証明書を含むバッファのサイズ
 575
 576    _Example_
 577    \code
 578    Cert myCert;
 579    // myCertを初期化
 580    byte* der;
 581    der = (byte*)malloc(FOURK_BUF);
 582    // derを初期化
 583    if(wc_SetAltNamesBuffer(&myCert, der, FOURK_BUF) != 0) {
 584    	// subject設定エラー
 585    }
 586    \endcode
 587
 588    \sa wc_InitCert
 589    \sa wc_SetAltNames
 590*/
 591int  wc_SetAltNamesBuffer(Cert* cert, const byte* der, int derSz);
 592
 593/*!
 594    \ingroup ASN
 595
 596    \brief この関数は、提供されたderバッファの日付範囲から証明書の日付を設定します。このメソッドは、署名前にフィールドを設定するために使用されます。
 597
 598    \return 0 証明書の日付を正常に設定した場合に返されます
 599    \return MEMORY_E XMALLOCでメモリを割り当てる際にエラーがある場合に返されます
 600    \return ASN_PARSE_E 証明書ヘッダーファイルの解析エラーがある場合に返されます
 601    \return ASN_OBJECT_ID_E 証明書から暗号化タイプを解析する際にエラーがある場合に返されます
 602    \return ASN_EXPECT_0_E 証明書ファイルの暗号化仕様にフォーマットエラーがある場合に返されます
 603    \return ASN_BEFORE_DATE_E 日付が証明書の開始日より前の場合に返されます
 604    \return ASN_AFTER_DATE_E 日付が証明書の有効期限より後の場合に返されます
 605    \return ASN_BITSTR_E 証明書からビット文字列を解析する際にエラーがある場合に返されます
 606    \return ECC_CURVE_OID_E 証明書からECCキーを解析する際にエラーがある場合に返されます
 607    \return ASN_UNKNOWN_OID_E 証明書が不明なキーオブジェクトIDを使用している場合に返されます
 608    \return ASN_VERSION_E ALLOW_V1_EXTENSIONSオプションが定義されておらず、証明書がV1またはV2証明書の場合に返されます
 609    \return BAD_FUNC_ARG 証明書拡張の処理エラーがある場合に返されます
 610    \return ASN_CRIT_EXT_E 証明書の処理中に見慣れない重要な拡張に遭遇した場合に返されます
 611    \return ASN_SIG_OID_E 署名暗号化タイプが提供されたファイル内の証明書の暗号化タイプと同じでない場合に返されます
 612    \return ASN_SIG_CONFIRM_E 証明書署名の確認が失敗した場合に返されます
 613    \return ASN_NAME_INVALID_E 証明書の名前がCA名前制約で許可されていない場合に返されます
 614    \return ASN_NO_SIGNER_E 証明書の真正性を検証するCA署名者がいない場合に返されます
 615
 616    \param cert 日付を設定する証明書へのポインタ
 617    \param der 日付範囲を取得するder形式の証明書を含むバッファへのポインタ
 618    \param derSz 日付範囲を取得するder形式の証明書を含むバッファのサイズ
 619
 620    _Example_
 621    \code
 622    Cert myCert;
 623    // myCertを初期化
 624    byte* der;
 625    der = (byte*)malloc(FOURK_BUF);
 626    // derを初期化
 627    if(wc_SetDatesBuffer(&myCert, der, FOURK_BUF) != 0) {
 628    	// subject設定エラー
 629    }
 630    \endcode
 631
 632    \sa wc_InitCert
 633*/
 634int  wc_SetDatesBuffer(Cert* cert, const byte* der, int derSz);
 635
 636/*!
 637    \ingroup ASN
 638
 639    \brief RSAまたはECC公開鍵からAKIDを設定します。注：rsakeyまたはeckeyのいずれか一方のみを設定し、両方は設定しないでください。
 640
 641    \return 0 成功
 642    \return BAD_FUNC_ARG certがnullまたはrsakeyとeckeyの両方がnullの場合。
 643    \return MEMORY_E メモリの割り当てエラー。
 644    \return PUBLIC_KEY_E キーへの書き込みエラー。
 645
 646    \param cert SKIDを設定する証明書へのポインタ。
 647    \param rsakey 読み取り元のRsaKey構造体へのポインタ。
 648    \param eckey 読み取り元のecc_keyへのポインタ。
 649
 650    _Example_
 651    \code
 652    Cert myCert;
 653    RsaKey keypub;
 654
 655    wc_InitRsaKey(&keypub, 0);
 656
 657    if (wc_SetAuthKeyIdFromPublicKey(&myCert, &keypub, NULL) != 0)
 658    {
 659        // エラーを処理
 660    }
 661    \endcode
 662
 663    \sa wc_SetSubjectKeyId
 664    \sa wc_SetAuthKeyId
 665    \sa wc_SetAuthKeyIdFromCert
 666*/
 667int wc_SetAuthKeyIdFromPublicKey(Cert *cert, RsaKey *rsakey,
 668                                             ecc_key *eckey);
 669
 670/*!
 671    \ingroup ASN
 672
 673    \brief DERエンコードされた証明書からAKIDを設定します。
 674
 675    \return 0 成功
 676    \return BAD_FUNC_ARG いずれかの引数がnullまたはderSzが0未満の場合のエラー。
 677    \return MEMORY_E メモリの割り当てに問題がある場合のエラー。
 678    \return ASN_NO_SKID サブジェクトキーIDが見つかりません。
 679
 680    \param cert 書き込み先のCert構造体。
 681    \param der DERエンコードされた証明書バッファ。
 682    \param derSz derのサイズ（バイト単位）。
 683
 684    _Example_
 685    \code
 686    Cert some_cert;
 687    byte some_der[] = { // DERバッファを初期化 };
 688    wc_InitCert(&some_cert);
 689    if(wc_SetAuthKeyIdFromCert(&some_cert, some_der, sizeof(some_der) != 0)
 690    {
 691        // エラーを処理
 692    }
 693    \endcode
 694
 695    \sa wc_SetAuthKeyIdFromPublicKey
 696    \sa wc_SetAuthKeyId
 697*/
 698int wc_SetAuthKeyIdFromCert(Cert *cert, const byte *der, int derSz);
 699
 700/*!
 701    \ingroup ASN
 702
 703    \brief PEM形式の証明書ファイルからAKIDを設定します。
 704
 705    \return 0 成功
 706    \return BAD_FUNC_ARG certまたはfileがnullの場合のエラー。
 707    \return MEMORY_E メモリの割り当てに問題がある場合のエラー。
 708
 709    \param cert AKIDを設定したいCert構造体。
 710    \param file PEM証明書ファイルを含むバッファ。
 711
 712    _Example_
 713    \code
 714    char* file_name = "/path/to/file";
 715    cert some_cert;
 716    wc_InitCert(&some_cert);
 717
 718    if(wc_SetAuthKeyId(&some_cert, file_name) != 0)
 719    {
 720        // エラーを処理
 721    }
 722    \endcode
 723
 724    \sa wc_SetAuthKeyIdFromPublicKey
 725    \sa wc_SetAuthKeyIdFromCert
 726*/
 727int wc_SetAuthKeyId(Cert *cert, const char* file);
 728
 729/*!
 730    \ingroup ASN
 731
 732    \brief RSAまたはECC公開鍵からSKIDを設定します。
 733
 734    \return 0 成功
 735    \return BAD_FUNC_ARG certまたはrsakeyとeckeyがnullの場合に返されます。
 736    \return MEMORY_E メモリの割り当てエラーがある場合に返されます。
 737    \return PUBLIC_KEY_E 公開鍵の取得エラーがある場合に返されます。
 738
 739    \param cert 使用するCert構造体へのポインタ。
 740    \param rsakey RsaKey構造体へのポインタ
 741    \param eckey ecc_key構造体へのポインタ
 742
 743    _Example_
 744    \code
 745    Cert some_cert;
 746    RsaKey some_key;
 747    wc_InitCert(&some_cert);
 748    wc_InitRsaKey(&some_key);
 749
 750    if(wc_SetSubjectKeyIdFromPublicKey(&some_cert,&some_key, NULL) != 0)
 751    {
 752        // エラーを処理
 753    }
 754    \endcode
 755
 756    \sa wc_SetSubjectKeyId
 757*/
 758int wc_SetSubjectKeyIdFromPublicKey(Cert *cert, RsaKey *rsakey,
 759                                                ecc_key *eckey);
 760
 761/*!
 762    \ingroup ASN
 763
 764    \brief PEM形式の公開鍵ファイルからSKIDを設定します。両方の引数が必要です。
 765
 766    \return 0 成功
 767    \return BAD_FUNC_ARG certまたはfileがnullの場合に返されます。
 768    \return MEMORY_E キー用のメモリ割り当てに問題がある場合に返されます。
 769    \return PUBLIC_KEY_E 公開鍵のデコードエラーがある場合に返されます。
 770
 771    \param cert SKIDを設定するCert構造体。
 772    \param file PEMエンコードされたファイルを含む。
 773
 774    _Example_
 775    \code
 776    const char* file_name = "path/to/file";
 777    Cert some_cert;
 778    wc_InitCert(&some_cert);
 779
 780    if(wc_SetSubjectKeyId(&some_cert, file_name) != 0)
 781    {
 782        // エラーを処理
 783    }
 784    \endcode
 785
 786    \sa wc_SetSubjectKeyIdFromPublicKey
 787*/
 788int wc_SetSubjectKeyId(Cert *cert, const char* file);
 789
 790/*!
 791    \ingroup RSA
 792
 793    \brief この関数を使用すると、カンマ区切りのトークン文字列を使用してキー使用法を設定できます。受け入れられるトークンは：digitalSignature、nonRepudiation、contentCommitment、keyCertSign、cRLSign、dataEncipherment、keyAgreement、keyEncipherment、encipherOnly、decipherOnlyです。例："digitalSignature,nonRepudiation" nonRepudiationとcontentCommitmentは同じ用途です。
 794
 795    \return 0 成功
 796    \return BAD_FUNC_ARG いずれかの引数がnullの場合に返されます。
 797    \return MEMORY_E メモリの割り当てエラーがある場合に返されます。
 798    \return KEYUSAGE_E 認識されないトークンが入力された場合に返されます。
 799
 800    \param cert 初期化されたCert構造体へのポインタ。
 801    \param value 使用法を設定するトークンのカンマ区切り文字列。
 802
 803    _Example_
 804    \code
 805    Cert cert;
 806    wc_InitCert(&cert);
 807
 808    if(wc_SetKeyUsage(&cert, "cRLSign,keyCertSign") != 0)
 809    {
 810        // エラーを処理
 811    }
 812    \endcode
 813
 814    \sa wc_InitCert
 815    \sa wc_MakeRsaKey
 816*/
 817int wc_SetKeyUsage(Cert *cert, const char *value);
 818
 819/*!
 820    \ingroup ASN
 821
 822    \brief ファイルからPEMキーを読み込み、DERエンコードされたバッファに変換します。
 823
 824    \return 0 成功
 825    \return <0 エラー
 826    \return SSL_BAD_FILE ファイルを開く際に問題があります。
 827    \return MEMORY_E ファイルバッファ用のメモリ割り当てエラーがあります。
 828    \return BUFFER_E derBufが変換されたキーを保持するのに十分な大きさではありません。
 829
 830    \param fileName ロードするファイルの名前。
 831    \param derBuf DERエンコードされたキー用のバッファ。
 832    \param derSz DERバッファのサイズ。
 833
 834    _Example_
 835    \code
 836    char* some_file = "filename";
 837    unsigned char der[];
 838
 839    if(wc_PemPubKeyToDer(some_file, der, sizeof(der)) != 0)
 840    {
 841        // エラーを処理
 842    }
 843    \endcode
 844
 845    \sa wc_PubKeyPemToDer
 846*/
 847int wc_PemPubKeyToDer(const char* fileName,
 848                                       unsigned char* derBuf, int derSz);
 849
 850/*!
 851    \ingroup ASN
 852
 853    \brief PEMエンコードされた公開鍵をDERに変換します。バッファに書き込まれたバイト数、またはエラーの場合は負の値を返します。
 854
 855    \return >0 成功、書き込まれたバイト数。
 856    \return BAD_FUNC_ARG pem、buff、またはbuffSzがnullの場合に返されます
 857    \return <0 関数内でエラーが発生しました。
 858
 859    \param pem PEMエンコードされたキー
 860    \param pemSz pemのサイズ
 861    \param buff 出力用バッファへのポインタ。
 862    \param buffSz バッファのサイズ。
 863
 864    _Example_
 865    \code
 866    byte some_pem[] = { PEMキーで初期化 }
 867    unsigned char out_buffer[1024]; // バッファがDERを格納するのに十分な大きさであることを確認
 868
 869    if(wc_PubKeyPemToDer(some_pem, sizeof(some_pem), out_buffer,
 870    sizeof(out_buffer)) < 0)
 871    {
 872        // エラーを処理
 873    }
 874    \endcode
 875
 876    \sa wc_PemPubKeyToDer
 877*/
 878int wc_PubKeyPemToDer(const unsigned char* pem, int pemSz,
 879                                      unsigned char* buff, int buffSz);
 880
 881/*!
 882    \ingroup ASN
 883
 884    \brief この関数は、pem証明書をder証明書に変換し、結果の証明書を提供されたderBufバッファに配置します。
 885
 886    \return Success 成功時に生成されたderBufのサイズを返します
 887    \return BUFFER_E derBufのサイズが生成された証明書を保持するには小さすぎる場合に返されます
 888    \return MEMORY_E XMALLOCの呼び出しが失敗した場合に返されます
 889
 890    \param fileName der証明書に変換するpem証明書を含むファイルへのパス
 891    \param derBuf 変換された証明書を格納するcharバッファへのポインタ
 892    \param derSz 変換された証明書を格納するcharバッファのサイズ
 893
 894    _Example_
 895    \code
 896    char * file = "./certs/client-cert.pem";
 897    int derSz;
 898    byte* der = (byte*)XMALLOC((8*1024), NULL, DYNAMIC_TYPE_CERT);
 899
 900    derSz = wc_PemCertToDer(file, der, (8*1024));
 901    if (derSz <= 0) {
 902        // PemCertToDerエラー
 903    }
 904    \endcode
 905
 906    \sa なし
 907*/
 908
 909int wc_PemCertToDer(const char* fileName, unsigned char* derBuf, int derSz);
 910
 911/*!
 912    \ingroup ASN
 913
 914    \brief この関数は、derバッファに含まれるder形式の入力証明書を、outputバッファに含まれるpem形式の出力証明書に変換します。これはインプレース変換ではなく、pem形式の出力を格納するために別のバッファを使用する必要があることに注意してください。
 915
 916    \return Success 入力der証明書から正常にpem証明書を作成すると、生成されたpem証明書のサイズを返します。
 917    \return BAD_FUNC_ARG derファイルを解析してpemファイルとして格納する際にエラーがある場合に返されます
 918    \return MEMORY_E XMALLOCでメモリを割り当てる際にエラーがある場合に返されます
 919    \return ASN_INPUT_E base64エンコードエラーの場合に返されます
 920    \return BUFFER_E 出力バッファがpem形式の証明書を格納するには小さすぎる場合に返される可能性があります
 921
 922    \param der 変換する証明書のバッファへのポインタ
 923    \param derSz 変換する証明書のサイズ
 924    \param output pem形式の証明書を格納するバッファへのポインタ
 925    \param outSz pem形式の証明書を格納するバッファのサイズ
 926    \param type 生成する証明書のタイプ。有効なタイプは：CERT_TYPE、PRIVATEKEY_TYPE、ECC_PRIVATEKEY_TYPE、およびCERTREQ_TYPE。
 927
 928    _Example_
 929    \code
 930    byte* der;
 931    // 証明書でderを初期化
 932    byte* pemFormatted[FOURK_BUF];
 933
 934    word32 pemSz;
 935    pemSz = wc_DerToPem(der, derSz,pemFormatted,FOURK_BUF, CERT_TYPE);
 936    \endcode
 937
 938    \sa wc_PemCertToDer
 939*/
 940int wc_DerToPem(const byte* der, word32 derSz, byte* output,
 941                                word32 outSz, int type);
 942
 943/*!
 944    \ingroup ASN
 945
 946    \brief この関数は、der形式の入力証明書を変換します、
 947    derバッファに含まれる、pem形式の出力証明書に変換し、outputバッファに格納します。これはインプレース変換ではなく、pem形式の出力を格納するために別のバッファを使用する必要があることに注意してください。暗号情報の設定を許可します。
 948
 949    \return Success 入力der証明書から正常にpem証明書を作成すると、生成されたpem証明書のサイズを返します。
 950    \return BAD_FUNC_ARG derファイルを解析してpemファイルとして格納する際にエラーがある場合に返されます
 951    \return MEMORY_E XMALLOCでメモリを割り当てる際にエラーがある場合に返されます
 952    \return ASN_INPUT_E base64エンコードエラーの場合に返されます
 953    \return BUFFER_E 出力バッファがpem形式の証明書を格納するには小さすぎる場合に返される可能性があります
 954
 955    \param der 変換する証明書のバッファへのポインタ
 956    \param derSz 変換する証明書のサイズ
 957    \param output pem形式の証明書を格納するバッファへのポインタ
 958    \param outSz pem形式の証明書を格納するバッファのサイズ
 959    \param cipher_info 追加の暗号情報。
 960    \param type 生成する証明書のタイプ。有効なタイプは：CERT_TYPE、PRIVATEKEY_TYPE、ECC_PRIVATEKEY_TYPE、およびCERTREQ_TYPE。
 961
 962    _Example_
 963    \code
 964    byte* der;
 965    // 証明書でderを初期化
 966    byte* pemFormatted[FOURK_BUF];
 967
 968    word32 pemSz;
 969    byte* cipher_info[] { 追加の暗号情報。 }
 970    pemSz = wc_DerToPemEx(der, derSz, pemFormatted, FOURK_BUF, cipher_info, CERT_TYPE);
 971    \endcode
 972
 973    \sa wc_PemCertToDer
 974*/
 975int wc_DerToPemEx(const byte* der, word32 derSz, byte* output,
 976                                word32 outSz, byte *cipher_info, int type);
 977
 978/*!
 979    \ingroup CertsKeys
 980
 981    \brief PEM形式のキーをDER形式に変換します。
 982
 983    \return int 関数は正常実行時にバッファに書き込まれたバイト数を返します。
 984    \return int エラーを示す負の整数が返されます。
 985
 986    \param pem PEMエンコードされた証明書へのポインタ。
 987    \param pemSz PEMバッファ（pem）のサイズ
 988    \param buff DerBuffer構造体のbufferメンバーのコピーへのポインタ。
 989    \param buffSz DerBuffer構造体に割り当てられたバッファスペースのサイズ。
 990    \param pass 関数に渡されるパスワード。
 991
 992    _Example_
 993    \code
 994    byte* loadBuf;
 995    long fileSz = 0;
 996    byte* bufSz;
 997    static int LoadKeyFile(byte** keyBuf, word32* keyBufSz,
 998    const char* keyFile,
 999                    int typeKey, const char* password);
1000    …
1001    bufSz = wc_KeyPemToDer(loadBuf, (int)fileSz, saveBuf,
1002    (int)fileSz, password);
1003
1004    if(saveBufSz > 0){
1005        // バイトがバッファに書き込まれました。
1006    }
1007    \endcode
1008
1009    \sa wc_PemToDer
1010*/
1011int wc_KeyPemToDer(const unsigned char* pem, int pemSz,
1012                                    unsigned char* buff, int buffSz, const char* pass);
1013
1014/*!
1015    \ingroup CertsKeys
1016
1017    \brief この関数は、PEM形式の証明書をDER形式に変換します。OpenSSL関数PemToDerを呼び出します。
1018
1019    \return buffer バッファに書き込まれたバイトを返します。
1020
1021    \param pem PEM形式の証明書へのポインタ。
1022    \param pemSz 証明書のサイズ。
1023    \param buff DER形式にコピーされるバッファ。
1024    \param buffSz バッファのサイズ。
1025    \param type asn_public.h enum CertTypeにある証明書ファイルタイプ。
1026
1027    _Example_
1028    \code
1029    const unsigned char* pem;
1030    int pemSz;
1031    unsigned char buff[BUFSIZE];
1032    int buffSz = sizeof(buff)/sizeof(char);
1033    int type;
1034    ...
1035    if(wc_CertPemToDer(pem, pemSz, buff, buffSz, type) <= 0) {
1036        // バッファにバイトが書き込まれました
1037    }
1038    \endcode
1039
1040    \sa wc_PemToDer
1041*/
1042int wc_CertPemToDer(const unsigned char* pem, int pemSz,
1043                    unsigned char* buff, int buffSz, int type);
1044
1045/*!
1046    \ingroup CertsKeys
1047
1048    \brief この関数は、入力されたDecodedCert構造体からDER形式の公開鍵を取得します。このAPIを呼び出す前に、ユーザーはwc_InitDecodedCert()とwc_ParseCert()を呼び出す必要があります。wc_InitDecodedCert()はDER/ASN.1エンコードされた証明書を受け入れます。PEM証明書をDERに変換するには、wc_InitDecodedCert()を呼び出す前にまずwc_CertPemToDer()を使用してください。
1049
1050    \return 0 成功時、エラー時は負の値。derKeyがNULLで長さのみを返す場合はLENGTH_ONLY_E。
1051
1052    \param cert X.509証明書を保持する入力されたDecodedCert構造体
1053    \param derKey DERエンコードされた公開鍵を配置する出力バッファ
1054    \param derKeySz [IN/OUT] 入力時のderKeyバッファのサイズ、返却時の公開鍵のサイズ。derKeyがNULLとして渡された場合、derKeySzは公開鍵に必要なバッファサイズに設定され、関数からLENGTH_ONLY_Eが返されます。
1055
1056    \sa wc_GetPubKeyDerFromCert
1057*/
1058int wc_GetPubKeyDerFromCert(struct DecodedCert* cert,
1059                                        byte* derKey, word32* derKeySz);
1060
1061/*!
1062    \ingroup ASN
1063
1064    \brief この関数は、入力バッファinputからECC秘密鍵を読み取り、秘密鍵を解析し、それを使用してecc_keyオブジェクトを生成し、keyに格納します。
1065
1066    \return 0 秘密鍵のデコードに成功し、結果をecc_key構造体に格納した場合
1067    \return ASN_PARSE_E derファイルを解析してpemファイルとして格納する際にエラーがある場合に返されます
1068    \return MEMORY_E XMALLOCでメモリを割り当てる際にエラーがある場合に返されます
1069    \return BUFFER_E 変換する証明書が指定された最大証明書サイズより大きい場合に返されます
1070    \return ASN_OBJECT_ID_E 証明書エンコーディングに無効なオブジェクトIDがある場合に返されます
1071    \return ECC_CURVE_OID_E 提供されたキーのECC曲線がサポートされていない場合に返されます
1072    \return ECC_BAD_ARG_E ECCキー形式にエラーがある場合に返されます
1073    \return NOT_COMPILED_IN 秘密鍵が圧縮されており、圧縮キーが提供されていない場合に返されます
1074    \return MP_MEM 秘密鍵の解析中に使用される数学ライブラリにエラーがある場合に返されます
1075    \return MP_VAL 秘密鍵の解析中に使用される数学ライブラリにエラーがある場合に返されます
1076    \return MP_RANGE 秘密鍵の解析中に使用される数学ライブラリにエラーがある場合に返されます
1077
1078    \param input 入力秘密鍵を含むバッファへのポインタ
1079    \param inOutIdx バッファ内で開始するインデックスを含むword32オブジェクトへのポインタ
1080    \param key デコードされた秘密鍵を格納する初期化されたeccオブジェクトへのポインタ
1081    \param inSz 秘密鍵を含む入力バッファのサイズ
1082
1083    _Example_
1084    \code
1085    int ret, idx=0;
1086    ecc_key key; // キーを格納
1087
1088    byte* tmp; // キーを読み取るための一時バッファ
1089    tmp = (byte*) malloc(FOURK_BUF);
1090
1091    int inSz;
1092    inSz = fread(tmp, 1, FOURK_BUF, privateKeyFile);
1093    // tmpバッファにキーを読み取る
1094
1095    wc_ecc_init(&key); // キーを初期化
1096    ret = wc_EccPrivateKeyDecode(tmp, &idx, &key, (word32)inSz);
1097    if(ret < 0) {
1098        // eccキーのデコードエラー
1099    }
1100    \endcode
1101
1102    \sa wc_RSA_PrivateKeyDecode
1103*/
1104int wc_EccPrivateKeyDecode(const byte* input, word32* inOutIdx,
1105                                           ecc_key* key, word32 inSz);
1106
1107/*!
1108    \ingroup ASN
1109
1110    \brief この関数は、秘密ECCキーをder形式に書き込みます。
1111
1112    \return Success ECCキーのder形式への書き込みに成功すると、バッファに書き込まれた長さを返します
1113    \return BAD_FUNC_ARG keyまたはoutputがnull、またはinLenがゼロの場合に返されます
1114    \return MEMORY_E XMALLOCでメモリを割り当てる際にエラーがある場合に返されます
1115    \return BUFFER_E 変換された証明書が出力バッファに格納するには大きすぎる場合に返されます
1116    \return ASN_UNKNOWN_OID_E 使用されているECCキーが不明なタイプの場合に返されます
1117    \return MP_MEM 秘密鍵の解析中に使用される数学ライブラリにエラーがある場合に返されます
1118    \return MP_VAL 秘密鍵の解析中に使用される数学ライブラリにエラーがある場合に返されます
1119    \return MP_RANGE 秘密鍵の解析中に使用される数学ライブラリにエラーがある場合に返されます
1120
1121    \param key 入力eccキーを含むバッファへのポインタ
1122    \param output der形式のキーを格納するバッファへのポインタ
1123    \param inLen der形式のキーを格納するバッファの長さ
1124
1125    _Example_
1126    \code
1127    int derSz;
1128    ecc_key key;
1129    // キーを初期化して作成
1130    byte der[FOURK_BUF];
1131    // ここにder形式のキーを格納
1132
1133    derSz = wc_EccKeyToDer(&key, der, FOURK_BUF);
1134    if(derSz < 0) {
1135        // eccキーをderバッファに変換する際のエラー
1136    }
1137    \endcode
1138
1139    \sa wc_RsaKeyToDer
1140*/
1141int wc_EccKeyToDer(ecc_key* key, byte* output, word32 inLen);
1142
1143/*!
1144    \ingroup ASN
1145
1146    \brief 入力バッファからECC公開鍵をデコードします。ECCキーを取得するためにASNシーケンスを解析します。
1147
1148    \return 0 成功
1149    \return BAD_FUNC_ARG いずれかの引数がnullの場合に返されます。
1150    \return ASN_PARSE_E 解析エラーがある場合に返されます
1151    \return ASN_ECC_KEY_E キーのインポートエラーがある場合に返されます。
1152    考えられる理由についてはwc_ecc_import_x963を参照してください。
1153
1154    \param input デコードするDERエンコードされたキーを含むバッファ。
1155    \param inOutIdx 入力バッファの読み取り開始位置のインデックス。出力時、インデックスは入力バッファの最後に解析された位置に設定されます。
1156    \param key 公開鍵を格納するecc_key構造体へのポインタ。
1157    \param inSz 入力バッファのサイズ。
1158
1159    _Example_
1160    \code
1161    int ret;
1162    word32 idx = 0;
1163    byte buff[] = { // キーで初期化 };
1164    ecc_key pubKey;
1165    wc_ecc_init(&pubKey);
1166    if ( wc_EccPublicKeyDecode(buff, &idx, &pubKey, sizeof(buff)) != 0) {
1167            // キーのデコードエラー
1168    }
1169    \endcode
1170
1171    \sa wc_ecc_import_x963
1172*/
1173int wc_EccPublicKeyDecode(const byte* input, word32* inOutIdx,
1174                          ecc_key* key, word32 inSz);
1175
1176/*!
1177    \ingroup ASN
1178
1179    \brief この関数は、ECC公開鍵をDER形式に変換します。使用されたバッファのサイズを返します。DER形式のECC公開鍵は出力バッファに格納されます。with_AlgCurveフラグは、アルゴリズムと曲線情報を持つヘッダーを含めます
1180
1181    \return >0 成功、使用されたバッファのサイズ
1182    \return BAD_FUNC_ARG outputまたはkeyがnullの場合に返されます。
1183    \return LENGTH_ONLY_E ECC公開鍵のサイズ取得エラー。
1184    \return BUFFER_E 出力バッファが小さすぎる場合に返されます。
1185
1186    \param key ECCキーへのポインタ
1187    \param output 書き込み先の出力バッファへのポインタ。
1188    \param inLen バッファのサイズ。
1189    \param with_AlgCurve アルゴリズムと曲線情報を持つヘッダーを含めるタイミングのフラグ。
1190
1191    _Example_
1192    \code
1193    ecc_key key;
1194    wc_ecc_init(&key);
1195    WC_RNG rng;
1196    wc_InitRng(&rng);
1197    wc_ecc_make_key(&rng, 32, &key);
1198    int derSz = // der用の適切なサイズ;
1199    byte der[derSz];
1200
1201    if(wc_EccPublicKeyToDer(&key, der, derSz, 1) < 0)
1202    {
1203        // ECC公開鍵のder変換エラー
1204    }
1205    \endcode
1206
1207    \sa wc_EccKeyToDer
1208    \sa wc_EccPrivateKeyDecode
1209*/
1210int wc_EccPublicKeyToDer(ecc_key* key, byte* output,
1211                                         word32 inLen, int with_AlgCurve);
1212
1213/*!
1214    \ingroup ASN
1215
1216    \brief この関数は、ECC公開鍵をDER形式に変換します。使用されたバッファのサイズを返します。DER形式のECC公開鍵は出力バッファに格納されます。with_AlgCurveフラグは、アルゴリズムと曲線情報を持つヘッダーを含めます。compパラメータは、公開鍵を圧縮形式でエクスポートするかどうかを決定します。
1217
1218    \return >0 成功、使用されたバッファのサイズ
1219    \return BAD_FUNC_ARG outputまたはkeyがnullの場合に返されます。
1220    \return LENGTH_ONLY_E ECC公開鍵のサイズ取得エラー。
1221    \return BUFFER_E 出力バッファが小さすぎる場合に返されます。
1222
1223    \param key ECCキーへのポインタ
1224    \param output 書き込み先の出力バッファへのポインタ。
1225    \param inLen バッファのサイズ。
1226    \param with_AlgCurve アルゴリズムと曲線情報を持つヘッダーを含めるタイミングのフラグ。
1227    \param comp 1（ゼロ以外）の場合、ECC公開鍵は圧縮形式で書き込まれます。0の場合、非圧縮形式で書き込まれます。
1228
1229    _Example_
1230    \code
1231    ecc_key key;
1232    wc_ecc_init(&key);
1233    WC_RNG rng;
1234    wc_InitRng(&rng);
1235    wc_ecc_make_key(&rng, 32, &key);
1236    int derSz = // der用の適切なサイズ;
1237    byte der[derSz];
1238
1239    // 圧縮されたECCキーを書き出す
1240    if(wc_EccPublicKeyToDer_ex(&key, der, derSz, 1, 1) < 0)
1241    {
1242        // ECC公開鍵のder変換エラー
1243    }
1244    \endcode
1245
1246    \sa wc_EccKeyToDer
1247    \sa wc_EccPublicKeyDecode
1248*/
1249int wc_EccPublicKeyToDer_ex(ecc_key* key, byte* output,
1250                                     word32 inLen, int with_AlgCurve, int comp);
1251
1252
1253/*!
1254    \ingroup ASN
1255
1256    \brief この関数は、DERエンコードされたバッファからCurve25519秘密鍵（のみ）をデコードします
1257
1258    \return 0 成功
1259    \return BAD_FUNC_ARG input、inOutIdxまたはkeyがnullの場合に返されます
1260    \return ASN_PARSE_E DERエンコードされたデータの解析エラーがある場合に返されます
1261    \return ECC_BAD_ARG_E キー長がCURVE25519_KEYSIZEでない場合、またはDERキーが適切にフォーマットされているにもかかわらず他の問題を含む場合に返されます。
1262    \return BUFFER_E 入力バッファが有効なDERエンコードされたキーを含むには小さすぎる場合に返されます。
1263
1264    \param input DERエンコードされた秘密鍵を含むバッファへのポインタ
1265    \param inOutIdx 入力バッファの読み取り開始位置のインデックス。出力時、インデックスは入力バッファの最後に解析された位置に設定されます。
1266    \param key デコードされたキーを格納するcurve25519_key構造体へのポインタ
1267    \param inSz 入力DERバッファのサイズ
1268
1269    \sa wc_Curve25519KeyDecode
1270    \sa wc_Curve25519PublicKeyDecode
1271
1272    _Example_
1273    \code
1274    byte der[] = { // DERエンコードされたキー };
1275    word32 idx = 0;
1276    curve25519_key key;
1277    wc_curve25519_init(&key);
1278
1279    if (wc_Curve25519PrivateKeyDecode(der, &idx, &key, sizeof(der)) != 0) {
1280        // 秘密鍵のデコードエラー
1281    }
1282    \endcode
1283*/
1284int wc_Curve25519PrivateKeyDecode(const byte* input, word32* inOutIdx,
1285                                  curve25519_key* key, word32 inSz);
1286
1287/*!
1288    \ingroup ASN
1289
1290    \brief この関数は、DERエンコードされたバッファからCurve25519公開鍵（のみ）をデコードします。
1291
1292    \return 0 成功
1293    \return BAD_FUNC_ARG input、inOutIdxまたはkeyがnullの場合に返されます
1294    \return ASN_PARSE_E DERエンコードされたデータの解析エラーがある場合に返されます
1295    \return ECC_BAD_ARG_E キー長がCURVE25519_KEYSIZEでない場合、またはDERキーが適切にフォーマットされているにもかかわらず他の問題を含む場合に返されます。
1296    \return BUFFER_E 入力バッファが有効なDERエンコードされたキーを含むには小さすぎる場合に返されます。
1297
1298    \param input DERエンコードされた公開鍵を含むバッファへのポインタ
1299    \param inOutIdx 入力バッファの読み取り開始位置のインデックス。出力時、インデックスは入力バッファの最後に解析された位置に設定されます。
1300    \param key デコードされたキーを格納するcurve25519_key構造体へのポインタ
1301    \param inSz 入力DERバッファのサイズ
1302
1303    \sa wc_Curve25519KeyDecode
1304    \sa wc_Curve25519PrivateKeyDecode
1305
1306    _Example_
1307    \code
1308    byte der[] = { // DERエンコードされたキー };
1309    word32 idx = 0;
1310    curve25519_key key;
1311    wc_curve25519_init(&key);
1312    if (wc_Curve25519PublicKeyDecode(der, &idx, &key, sizeof(der)) != 0) {
1313        // 公開鍵のデコードエラー
1314    }
1315    \endcode
1316*/
1317int wc_Curve25519PublicKeyDecode(const byte* input, word32* inOutIdx,
1318                                 curve25519_key* key, word32 inSz);
1319
1320/*!
1321    \ingroup ASN
1322
1323    \brief この関数は、DERエンコードされたバッファからCurve25519キーをデコードします。秘密鍵、公開鍵、または両方をデコードできます。
1324
1325    \return 0 成功
1326    \return BAD_FUNC_ARG input、inOutIdxまたはkeyがnullの場合に返されます
1327    \return ASN_PARSE_E DERエンコードされたデータの解析エラーがある場合に返されます
1328    \return ECC_BAD_ARG_E キー長がCURVE25519_KEYSIZEでない場合、またはDERキーが適切にフォーマットされているにもかかわらず他の問題を含む場合に返されます。
1329    \return BUFFER_E 入力バッファが有効なDERエンコードされたキーを含むには小さすぎる場合に返されます。
1330
1331    \param input DERエンコードされたキーを含むバッファへのポインタ
1332    \param inOutIdx 入力バッファの読み取り開始位置のインデックス。出力時、インデックスは入力バッファの最後に解析された位置に設定されます。
1333    \param key デコードされたキーを格納するcurve25519_key構造体へのポインタ
1334    \param inSz 入力DERバッファのサイズ
1335
1336    \sa wc_Curve25519PrivateKeyDecode
1337    \sa wc_Curve25519PublicKeyDecode
1338
1339    _Example_
1340    \code
1341    byte der[] = { // DERエンコードされたキー };
1342    word32 idx = 0;
1343    curve25519_key key;
1344    wc_curve25519_init(&key);
1345    if (wc_Curve25519KeyDecode(der, &idx, &key, sizeof(der)) != 0) {
1346        // キーのデコードエラー
1347    }
1348    \endcode
1349*/
1350int wc_Curve25519KeyDecode(const byte* input, word32* inOutIdx,
1351                           curve25519_key* key, word32 inSz);
1352
1353/*!
1354    \ingroup ASN
1355
1356    \brief この関数は、Curve25519秘密鍵をDER形式にエンコードします。入力キー構造体に公開鍵が含まれている場合、それは無視されます。
1357
1358    \return >0 成功、DERエンコーディングの長さ
1359    \return BAD_FUNC_ARG keyまたはoutputがnullの場合に返されます
1360    \return MEMORY_E 割り当て失敗がある場合に返されます
1361    \return BUFFER_E 出力バッファが小さすぎる場合に返されます
1362
1363    \param key エンコードする秘密鍵を含むcurve25519_key構造体へのポインタ
1364    \param output DERエンコーディングを保持するバッファ
1365    \param inLen 出力バッファのサイズ
1366
1367    \sa wc_Curve25519KeyToDer
1368    \sa wc_Curve25519PublicKeyToDer
1369
1370    _Example_
1371    \code
1372    curve25519_key key;
1373    wc_curve25519_init(&key);
1374    ...
1375    int derSz = 128; // 出力DER用の適切なサイズ
1376    byte der[derSz];
1377    wc_Curve25519PrivateKeyToDer(&key, der, derSz);
1378    \endcode
1379*/
1380int wc_Curve25519PrivateKeyToDer(curve25519_key* key, byte* output,
1381                                 word32 inLen);
1382
1383/*!
1384    \ingroup ASN
1385
1386    \brief この関数は、Curve25519公開鍵をDER形式にエンコードします。入力キー構造体に秘密鍵が含まれている場合、それは無視されます。
1387
1388    \return >0 成功、DERエンコーディングの長さ
1389    \return BAD_FUNC_ARG keyまたはoutputがnullの場合に返されます
1390    \return MEMORY_E 割り当て失敗がある場合に返されます
1391    \return BUFFER_E 出力バッファが小さすぎる場合に返されます
1392
1393    \param key エンコードする公開鍵を含むcurve25519_key構造体へのポインタ
1394    \param output DERエンコーディングを保持するバッファ
1395    \param inLen 出力バッファのサイズ
1396    \param withAlg DERエンコーディングにアルゴリズム識別子を含めるかどうか
1397
1398    \sa wc_Curve25519KeyToDer
1399    \sa wc_Curve25519PrivateKeyToDer
1400
1401    _Example_
1402    \code
1403    curve25519_key key;
1404    wc_curve25519_init(&key);
1405    ...
1406    int derSz = 128; // 出力DER用の適切なサイズ
1407    byte der[derSz];
1408    wc_Curve25519PublicKeyToDer(&key, der, derSz, 1);
1409    \endcode
1410*/
1411int wc_Curve25519PublicKeyToDer(curve25519_key* key, byte* output, word32 inLen,
1412                                int withAlg);
1413
1414/*!
1415    \ingroup ASN
1416
1417    \brief この関数は、Curve25519キーをDER形式にエンコードします。秘密鍵、公開鍵、または両方をエンコードできます。
1418
1419    \return >0 成功、DERエンコーディングの長さ
1420    \return BAD_FUNC_ARG keyまたはoutputがnullの場合に返されます
1421    \return MEMORY_E 割り当て失敗がある場合に返されます
1422    \return BUFFER_E 出力バッファが小さすぎる場合に返されます
1423
1424    \param key エンコードするキーを含むcurve25519_key構造体へのポインタ
1425    \param output DERエンコーディングを保持するバッファ
1426    \param inLen 出力バッファのサイズ
1427    \param withAlg DERエンコーディングにアルゴリズム識別子を含めるかどうか
1428
1429    \sa wc_Curve25519PrivateKeyToDer
1430    \sa wc_Curve25519PublicKeyToDer
1431
1432    _Example_
1433    \code
1434    curve25519_key key;
1435    wc_curve25519_init(&key);
1436    ...
1437    int derSz = 128; // 出力DER用の適切なサイズ
1438    byte der[derSz];
1439    wc_Curve25519KeyToDer(&key, der, derSz, 1);
1440    \endcode
1441*/
1442int wc_Curve25519KeyToDer(curve25519_key* key, byte* output, word32 inLen,
1443                          int withAlg);
1444
1445/*!
1446    \ingroup ASN
1447
1448    \brief この関数は、デジタル署名を出力バッファにエンコードし、作成されたエンコードされた署名のサイズを返します。
1449
1450    \return Success エンコードされた署名をoutputに正常に書き込むと、バッファに書き込まれた長さを返します
1451
1452    \param out エンコードされた署名が書き込まれるバッファへのポインタ
1453    \param digest 署名のエンコードに使用するダイジェストへのポインタ
1454    \param digSz ダイジェストを含むバッファの長さ
1455    \param hashOID 署名の生成に使用されるハッシュタイプを識別するOID。ビルド構成に応じた有効なオプションは：SHAh、SHA256h、SHA384h、SHA512h、MD2h、MD5h、DESb、DES3b、CTC_MD5wRSA、CTC_SHAwRSA、CTC_SHA256wRSA、CTC_SHA384wRSA、CTC_SHA512wRSA、CTC_SHAwECDSA、CTC_SHA256wECDSA、CTC_SHA384wECDSA、およびCTC_SHA512wECDSA。
1456
1457    \endcode
1458    \code
1459    int signSz;
1460    byte encodedSig[MAX_ENCODED_SIG_SZ];
1461    Sha256 sha256;
1462    // ハッシュ化のためにsha256を初期化
1463
1464    byte* dig = = (byte*)malloc(WC_SHA256_DIGEST_SIZE);
1465    // ハッシュ化とハッシュ更新を実行してdigにSHA-256ハッシュを格納
1466    // （wc_InitSha256、wc_Sha256Update、wc_Sha256Finalを参照）
1467    signSz = wc_EncodeSignature(encodedSig, dig, WC_SHA256_DIGEST_SIZE, SHA256h);
1468    \endcode
1469
1470    \sa なし
1471*/
1472word32 wc_EncodeSignature(byte* out, const byte* digest,
1473                                      word32 digSz, int hashOID);
1474
1475/*!
1476    \ingroup ASN
1477
1478    \brief この関数は、ハッシュタイプに対応するハッシュOIDを返します。例えば、WC_SHA512タイプが与えられた場合、この関数はSHA512ハッシュに対応する識別子SHA512hを返します。
1479
1480    \return Success 成功時に、その暗号化タイプで使用する適切なハッシュに対応するOIDを返します。
1481    \return 0 認識されないハッシュタイプが引数として渡された場合に返されます。
1482
1483    \param type OIDを見つけるハッシュタイプ。ビルド構成に応じた有効なオプションには：WC_MD5、WC_SHA、WC_SHA256、WC_SHA384、WC_SHA512、WC_SHA3_224、WC_SHA3_256、WC_SHA3_384、またはWC_SHA3_512
1484
1485    _Example_
1486    \code
1487    int hashOID;
1488
1489    hashOID = wc_GetCTC_HashOID(WC_SHA512);
1490    if (hashOID == 0) {
1491	    // WOLFSSL_SHA512が定義されていません
1492    }
1493    \endcode
1494
1495    \sa なし
1496*/
1497int wc_GetCTC_HashOID(int type);
1498
1499/*!
1500    \ingroup ASN
1501
1502    \brief この関数は、証明書構造体のデコードされた証明書キャッシュによって使用されるメモリとリソースをクリーンアップします。WOLFSSL_CERT_GEN_CACHEが定義されている場合、デコードされた証明書構造体は証明書構造体にキャッシュされます。これにより、証明書設定関数への後続の呼び出しで、各呼び出しでデコードされた証明書を解析することを回避できます。
1503
1504    \return 0 成功時。
1505    \return BAD_FUNC_ARG 無効なポインタが引数として渡された場合に返されます。
1506
1507    \param cert 初期化されていない証明書情報構造体へのポインタ。
1508
1509    _Example_
1510    \code
1511    Cert cert; // 初期化された証明書構造体
1512
1513    wc_SetCert_Free(&cert);
1514    \endcode
1515
1516    \sa wc_SetAuthKeyIdFromCert
1517    \sa wc_SetIssuerBuffer
1518    \sa wc_SetSubjectBuffer
1519    \sa wc_SetSubjectRaw
1520    \sa wc_SetIssuerRaw
1521    \sa wc_SetAltNamesBuffer
1522    \sa wc_SetDatesBuffer
1523*/
1524void wc_SetCert_Free(Cert* cert);
1525
1526/*!
1527    \ingroup ASN
1528
1529    \brief この関数は、PKCS#8暗号化されていないバッファ内の従来の秘密鍵の先頭を見つけます。
1530
1531    \return Length 成功時に従来の秘密鍵の長さ。
1532    \return Negative 失敗時に負の値。
1533
1534    \param input 暗号化されていないPKCS#8秘密鍵を含むバッファ。
1535    \param inOutIdx 入力バッファへのインデックス。入力時、PKCS#8バッファの先頭へのバイトオフセットである必要があります。出力時、入力バッファ内の従来の秘密鍵へのバイトオフセットになります。
1536    \param sz 入力バッファのバイト数。
1537
1538    _Example_
1539    \code
1540    byte* pkcs8Buf; // PKCS#8キーを含むバッファ。
1541    word32 idx = 0;
1542    word32 sz; // pkcs8Bufのサイズ。
1543    ...
1544    ret = wc_GetPkcs8TraditionalOffset(pkcs8Buf, &idx, sz);
1545    // pkcs8Buf + idxは従来の秘密鍵バイトの先頭になります。
1546    \endcode
1547
1548    \sa wc_CreatePKCS8Key
1549    \sa wc_EncryptPKCS8Key
1550    \sa wc_DecryptPKCS8Key
1551    \sa wc_CreateEncryptedPKCS8Key
1552*/
1553int wc_GetPkcs8TraditionalOffset(byte* input,
1554                                             word32* inOutIdx, word32 sz);
1555
1556/*!
1557    \ingroup ASN
1558
1559    \brief この関数は、DER秘密鍵を受け取り、PKCS#8形式に変換します。PKCS#12縮小キーバッグの作成にも使用されます。RFC 5208を参照してください。
1560
1561    \return The 成功時にoutに配置されたPKCS#8キーのサイズ。
1562    \return LENGTH_ONLY_E outがNULLの場合、outSzに必要な出力バッファサイズが返されます。
1563    \return Other 失敗時に負の値。
1564
1565    \param out 結果を配置するバッファ。NULLの場合、outSzに必要な出力バッファサイズが返されます。
1566    \param outSz outバッファのサイズ。
1567    \param key 従来のDERキーを持つバッファ。
1568    \param keySz keyバッファのサイズ。
1569    \param algoID アルゴリズムID（例：RSAk）。
1570    \param curveOID 使用される場合のECC曲線OID。RSAキーの場合はNULLである必要があります。
1571    \param oidSz 曲線OIDのサイズ。curveOIDがNULLの場合は0に設定されます。
1572
1573    _Example_
1574    \code
1575    ecc_key eccKey;              // wolfSSL ECCキーオブジェクト。
1576    byte* der;                   // DERエンコードされたECCキー。
1577    word32 derSize;              // derのサイズ。
1578    const byte* curveOid = NULL; // eccKeyで使用される曲線のOID。
1579    word32 curveOidSz = 0;       // 曲線OIDのサイズ。
1580    byte* pkcs8;                 // PKCS#8キー用の出力バッファ。
1581    word32 pkcs8Sz;              // 出力バッファのサイズ。
1582
1583    derSize = wc_EccKeyDerSize(&eccKey, 1);
1584    ...
1585    derSize = wc_EccKeyToDer(&eccKey, der, derSize);
1586    ...
1587    ret = wc_ecc_get_oid(eccKey.dp->oidSum, &curveOid, &curveOidSz);
1588    ...
1589    ret = wc_CreatePKCS8Key(NULL, &pkcs8Sz, der,
1590        derSize, ECDSAk, curveOid, curveOidSz); // pkcs8Szに必要なサイズを取得。
1591    ...
1592    ret = wc_CreatePKCS8Key(pkcs8, &pkcs8Sz, der,
1593        derSize, ECDSAk, curveOid, curveOidSz);
1594    \endcode
1595
1596    \sa wc_GetPkcs8TraditionalOffset
1597    \sa wc_EncryptPKCS8Key
1598    \sa wc_DecryptPKCS8Key
1599    \sa wc_CreateEncryptedPKCS8Key
1600*/
1601int wc_CreatePKCS8Key(byte* out, word32* outSz,
1602        byte* key, word32 keySz, int algoID, const byte* curveOID,
1603        word32 oidSz);
1604
1605/*!
1606    \ingroup ASN
1607
1608    \brief この関数は、暗号化されていないPKCS#8 DERキー（例：wc_CreatePKCS8Keyによって作成されたもの）を受け取り、PKCS#8暗号化形式に変換します。結果の暗号化されたキーは、wc_DecryptPKCS8Keyを使用して復号できます。RFC 5208を参照してください。
1609
1610    \return The 成功時にoutに配置された暗号化されたキーのサイズ。
1611    \return LENGTH_ONLY_E outがNULLの場合、outSzに必要な出力バッファサイズが返されます。
1612    \return Other 失敗時に負の値。
1613
1614    \param key 従来のDERキーを持つバッファ。
1615    \param keySz keyバッファのサイズ。
1616    \param out 結果を配置するバッファ。NULLの場合、outSzに必要な出力バッファサイズが返されます。
1617    \param outSz outバッファのサイズ。
1618    \param password パスワードベースの暗号化アルゴリズムに使用するパスワード。
1619    \param passwordSz パスワードの長さ（NULLターミネータを含まない）。
1620    \param vPKCS 使用するPKCSバージョン。PKCS12またはPKCS5の場合は1。
1621    \param pbeOid 使用するPBEスキームのOID（例：PBES2またはRFC 2898 A.3のPBES1のOIDの1つ）。
1622    \param encAlgId 使用する暗号化アルゴリズムID（例：AES256CBCb）。
1623    \param salt 使用するソルトバッファ。NULLの場合、ランダムなソルトが使用されます。
1624    \param saltSz ソルトバッファの長さ。saltにNULLを渡す場合は0。
1625    \param itt KDFに使用する反復回数。
1626    \param rng 初期化されたWC_RNGオブジェクトへのポインタ。
1627    \param heap 動的割り当てに使用されるヒープへのポインタ。NULLでも可。
1628
1629    _Example_
1630    \code
1631    byte* pkcs8;          // 暗号化されていないPKCS#8キー。
1632    word32 pkcs8Sz;       // pkcs8のサイズ。
1633    byte* pkcs8Enc;       // 暗号化されたPKCS#8キー。
1634    word32 pkcs8EncSz;    // pkcs8Encのサイズ。
1635    const char* password; // 暗号化に使用するパスワード。
1636    int passwordSz;       // パスワードの長さ（NULLターミネータを含まない）。
1637    WC_RNG rng;
1638
1639    // 以下は、pkcs8Encにpkcs8の暗号化されたバージョンを生成します。暗号化は
1640    // PKCS#5のパスワードベース暗号化スキーム2（PBE2）とCBCモードの256ビット
1641    // キーを持つAES暗号を使用します。PKCS#5の詳細についてはRFC 8018を参照してください。
1642    ret = wc_EncryptPKCS8Key(pkcs8, pkcs8Sz, pkcs8Enc, &pkcs8EncSz, password,
1643            passwordSz, PKCS5, PBES2, AES256CBCb, NULL, 0,
1644            WC_PKCS12_ITT_DEFAULT, &rng, NULL);
1645    \endcode
1646
1647    \sa wc_GetPkcs8TraditionalOffset
1648    \sa wc_CreatePKCS8Key
1649    \sa wc_DecryptPKCS8Key
1650    \sa wc_CreateEncryptedPKCS8Key
1651*/
1652int wc_EncryptPKCS8Key(byte* key, word32 keySz, byte* out,
1653        word32* outSz, const char* password, int passwordSz, int vPKCS,
1654        int pbeOid, int encAlgId, byte* salt, word32 saltSz, int itt,
1655        WC_RNG* rng, void* heap);
1656
1657/*!
1658    \ingroup ASN
1659
1660    \brief この関数は、暗号化されたPKCS#8 DERキーを受け取り、PKCS#8暗号化されていないDERに復号します。wc_EncryptPKCS8Keyによって行われた暗号化を元に戻します。RFC5208を参照してください。入力バッファは復号されたデータで上書きされます。
1661
1662    \return The 成功時に復号されたバッファの長さ。
1663    \return Negative 失敗時に負の値。
1664
1665    \param input 入力時、暗号化されたPKCS#8キーを含むバッファ。出力が成功すると、復号されたキーを含みます。
1666    \param sz 入力バッファのサイズ。
1667    \param password キーの暗号化に使用されたパスワード。
1668    \param passwordSz パスワードの長さ（NULLターミネータを含まない）。
1669
1670    _Example_
1671    \code
1672    byte* pkcs8Enc;       // wc_EncryptPKCS8Keyで作成された暗号化されたPKCS#8キー。
1673    word32 pkcs8EncSz;    // pkcs8Encのサイズ。
1674    const char* password; // 復号に使用するパスワード。
1675    int passwordSz;       // パスワードの長さ（NULLターミネータを含まない）。
1676
1677    ret = wc_DecryptPKCS8Key(pkcs8Enc, pkcs8EncSz, password, passwordSz);
1678    \endcode
1679
1680    \sa wc_GetPkcs8TraditionalOffset
1681    \sa wc_CreatePKCS8Key
1682    \sa wc_EncryptPKCS8Key
1683    \sa wc_CreateEncryptedPKCS8Key
1684*/
1685int wc_DecryptPKCS8Key(byte* input, word32 sz, const char* password,
1686        int passwordSz);
1687
1688/*!
1689    \ingroup ASN
1690
1691    \brief この関数は、従来のDERキーを受け取り、PKCS#8形式に変換し、暗号化します。これを行うためにwc_CreatePKCS8Keyとwc_EncryptPKCS8Keyを使用します。
1692
1693    \return The 成功時にoutに配置された暗号化されたキーのサイズ。
1694    \return LENGTH_ONLY_E outがNULLの場合、outSzに必要な出力バッファサイズが返されます。
1695    \return Other 失敗時に負の値。
1696
1697    \param key 従来のDERキーを持つバッファ。
1698    \param keySz keyバッファのサイズ。
1699    \param out 結果を配置するバッファ。NULLの場合、outSzに必要な出力バッファサイズが返されます。
1700    \param outSz outバッファのサイズ。
1701    \param password パスワードベースの暗号化アルゴリズムに使用するパスワード。
1702    \param passwordSz パスワードの長さ（NULLターミネータを含まない）。
1703    \param vPKCS 使用するPKCSバージョン。PKCS12またはPKCS5の場合は1。
1704    \param pbeOid 使用するPBEスキームのOID（例：PBES2またはRFC 2898 A.3のPBES1のOIDの1つ）。
1705    \param encAlgId 使用する暗号化アルゴリズムID（例：AES256CBCb）。
1706    \param salt 使用するソルトバッファ。NULLの場合、ランダムなソルトが使用されます。
1707    \param saltSz ソルトバッファの長さ。saltにNULLを渡す場合は0。
1708    \param itt KDFに使用する反復回数。
1709    \param rng 初期化されたWC_RNGオブジェクトへのポインタ。
1710    \param heap 動的割り当てに使用されるヒープへのポインタ。NULLでも可。
1711
1712    _Example_
1713    \code
1714    byte* key;            // 従来の秘密鍵（DER形式）。
1715    word32 keySz;         // keyのサイズ。
1716    byte* pkcs8Enc;       // 暗号化されたPKCS#8キー。
1717    word32 pkcs8EncSz;    // pkcs8Encのサイズ。
1718    const char* password; // 暗号化に使用するパスワード。
1719    int passwordSz;       // パスワードの長さ（NULLターミネータを含まない）。
1720    WC_RNG rng;
1721
1722    // 以下は、pkcs8Encにkeyの暗号化されたPKCS#8バージョンを生成します。
1723    // 暗号化はPKCS#5のパスワードベース暗号化スキーム2（PBE2）とCBCモードの
1724    // 256ビットキーを持つAES暗号を使用します。PKCS#5の詳細については
1725    // RFC 8018を参照してください。
1726    ret = wc_CreateEncryptedPKCS8Key(key, keySz, pkcs8Enc, &pkcs8EncSz,
1727            password, passwordSz, PKCS5, PBES2, AES256CBCb, NULL, 0,
1728            WC_PKCS12_ITT_DEFAULT, &rng, NULL);
1729    \endcode
1730
1731    \sa wc_GetPkcs8TraditionalOffset
1732    \sa wc_CreatePKCS8Key
1733    \sa wc_EncryptPKCS8Key
1734    \sa wc_DecryptPKCS8Key
1735*/
1736int wc_CreateEncryptedPKCS8Key(byte* key, word32 keySz, byte* out,
1737        word32* outSz, const char* password, int passwordSz, int vPKCS,
1738        int pbeOid, int encAlgId, byte* salt, word32 saltSz, int itt,
1739        WC_RNG* rng, void* heap);
1740
1741/*!
1742    \ingroup ASN
1743
1744    \brief この関数は、"cert"パラメータが指すDecodedCertを初期化します。長さ"inSz"のDERエンコードされた証明書への"source"ポインタを保存します。この証明書は、wc_ParseCertへの後続の呼び出しによって解析できます。
1745
1746    \param cert 割り当てられたDecodedCertオブジェクトへのポインタ。
1747    \param source DERエンコードされた証明書へのポインタ。
1748    \param inSz DERエンコードされた証明書の長さ（バイト単位）。
1749    \param heap 動的割り当てに使用されるヒープへのポインタ。NULLでも可。
1750
1751    _Example_
1752    \code
1753    DecodedCert decodedCert; // デコードされた証明書オブジェクト。
1754    byte* certBuf;           // DERエンコードされた証明書バッファ。
1755    word32 certBufSz;        // certBufのサイズ（バイト単位）。
1756
1757    wc_InitDecodedCert(&decodedCert, certBuf, certBufSz, NULL);
1758    \endcode
1759
1760    \sa wc_ParseCert
1761    \sa wc_FreeDecodedCert
1762*/
1763void wc_InitDecodedCert(struct DecodedCert* cert,
1764    const byte* source, word32 inSz, void* heap);
1765
1766/*!
1767    \ingroup ASN
1768
1769    \brief この関数は、DecodedCertオブジェクトに保存されたDERエンコードされた証明書を解析し、そのオブジェクトのフィールドを設定します。DecodedCertは、wc_InitDecodedCertへの事前の呼び出しで初期化されている必要があります。この関数は、CertificateManagerオブジェクトへのオプションのポインタを取り、CAがCertificateManagerで見つかった場合、DecodedCertの証明機関情報を設定するために使用されます。
1770
1771    \return 0 成功時。
1772    \return Other 失敗時に負の値。
1773
1774    \param cert 初期化されたDecodedCertオブジェクトへのポインタ。
1775    \param type 証明書のタイプ。asn_public.hのCertType列挙型を参照してください。
1776    \param verify 設定されている場合、ユーザーが証明書の有効性を検証したいことを示すフラグ。
1777    \param cm CertificateManagerへのオプションのポインタ。NULLでも可。
1778
1779    _Example_
1780    \code
1781    int ret;
1782    DecodedCert decodedCert; // デコードされた証明書オブジェクト。
1783    byte* certBuf;           // DERエンコードされた証明書バッファ。
1784    word32 certBufSz;        // certBufのサイズ（バイト単位）。
1785
1786    wc_InitDecodedCert(&decodedCert, certBuf, certBufSz, NULL);
1787    ret = wc_ParseCert(&decodedCert, CERT_TYPE, NO_VERIFY, NULL);
1788    if (ret != 0) {
1789        fprintf(stderr, "wc_ParseCert failed.\n");
1790    }
1791    \endcode
1792
1793    \sa wc_InitDecodedCert
1794    \sa wc_FreeDecodedCert
1795*/
1796int wc_ParseCert(DecodedCert* cert, int type, int verify, void* cm);
1797
1798/*!
1799    \ingroup ASN
1800
1801    \brief この関数は、wc_InitDecodedCertで以前に初期化されたDecodedCertを解放します。
1802
1803    \param cert 初期化されたDecodedCertオブジェクトへのポインタ。
1804
1805    _Example_
1806    \code
1807    int ret;
1808    DecodedCert decodedCert; // デコードされた証明書オブジェクト。
1809    byte* certBuf;           // DERエンコードされた証明書バッファ。
1810    word32 certBufSz;        // certBufのサイズ（バイト単位）。
1811
1812    wc_InitDecodedCert(&decodedCert, certBuf, certBufSz, NULL);
1813    ret = wc_ParseCert(&decodedCert, CERT_TYPE, NO_VERIFY, NULL);
1814    if (ret != 0) {
1815        fprintf(stderr, "wc_ParseCert failed.\n");
1816    }
1817    wc_FreeDecodedCert(&decodedCert);
1818    \endcode
1819
1820    \sa wc_InitDecodedCert
1821    \sa wc_ParseCert
1822*/
1823void wc_FreeDecodedCert(struct DecodedCert* cert);
1824
1825/*!
1826    \ingroup ASN
1827
1828    \brief この関数は、wolfSSLが現在時刻を取得する必要があるときに使用される時刻コールバックを登録します。コールバックのプロトタイプは、C標準ライブラリの"time"関数と同じである必要があります。
1829
1830    \return 0 成功時に返されます。
1831
1832    \param f 時刻コールバックとして登録する関数。
1833
1834    _Example_
1835    \code
1836    int ret = 0;
1837    // 時刻コールバックのプロトタイプ
1838    time_t my_time_cb(time_t* t);
1839    // 登録する
1840    ret = wc_SetTimeCb(my_time_cb);
1841    if (ret != 0) {
1842        // 時刻コールバックの設定失敗
1843    }
1844    time_t my_time_cb(time_t* t)
1845    {
1846        // カスタム時刻関数
1847    }
1848    \endcode
1849
1850    \sa wc_Time
1851*/
1852int wc_SetTimeCb(wc_time_cb f);
1853
1854/*!
1855    \ingroup ASN
1856
1857    \brief この関数は、現在時刻を取得します。デフォルトでは、プラットフォーム間で異なるXTIMEマクロを使用します。ユーザーは、wc_SetTimeCb関数を介して任意の関数を使用できます。
1858
1859    \return Time 成功時に返される現在時刻。
1860
1861    \param t 現在時刻を設定するオプションのtime_tポインタ。
1862
1863    _Example_
1864    \code
1865    time_t currentTime = 0;
1866    currentTime = wc_Time(NULL);
1867    wc_Time(&currentTime);
1868    \endcode
1869
1870    \sa wc_SetTimeCb
1871*/
1872time_t wc_Time(time_t* t);
1873
1874/*!
1875    \ingroup ASN
1876
1877    \brief この関数は、X.509証明書にカスタム拡張を挿入します。
1878     注：ポインタであるパラメータのいずれかが指すアドレスのコンテンツは、
1879           証明書が生成されてder出力が得られるまで変更してはいけません。
1880           この関数はコンテンツを別のバッファにコピーしません。
1881
1882    \return 0 成功時に返されます。
1883    \return Other 失敗時に負の値。
1884
1885    \param cert 初期化されたDecodedCertオブジェクトへのポインタ。
1886    \param critical 0の場合、拡張は重要としてマークされません。それ以外の場合は重要としてマークされます。
1887    \param oid ドット区切りのoidを文字列として。例："1.2.840.10045.3.1.7"
1888    \param der 拡張のコンテンツのderエンコーディング。
1889    \param derSz derエンコーディングのサイズ（バイト単位）。
1890
1891
1892    _Example_
1893    \code
1894    int ret = 0;
1895    Cert newCert;
1896    wc_InitCert(&newCert);
1897
1898    // subject、公開鍵、発行者、その他のものを設定するコードがここに入ります。
1899
1900    ret = wc_SetCustomExtension(&newCert, 1, "1.2.3.4.5",
1901              (const byte *)"This is a critical extension", 28);
1902    if (ret < 0) {
1903        // 拡張の設定失敗。
1904    }
1905
1906    ret = wc_SetCustomExtension(&newCert, 0, "1.2.3.4.6",
1907              (const byte *)"This is NOT a critical extension", 32)
1908    if (ret < 0) {
1909        // 拡張の設定失敗。
1910    }
1911
1912    // 証明書に署名してから書き出すコードがここに入ります。
1913
1914    \endcode
1915
1916    \sa wc_InitCert
1917    \sa wc_SetUnknownExtCallback
1918*/
1919int wc_SetCustomExtension(Cert *cert, int critical, const char *oid,
1920                                      const byte *der, word32 derSz);
1921
1922/*!
1923    \ingroup ASN
1924
1925    \brief この関数は、wolfSSLが証明書の解析中に証明書内の不明なX.509拡張に遭遇したときに使用されるコールバックを登録します。コールバックのプロトタイプは次のようにする必要があります：
1926
1927    \return 0 成功時に返されます。
1928    \return Other 失敗時に負の値。
1929
1930    \param cert このコールバックに関連付けられるDecodedCert構造体。
1931    \param cb 時刻コールバックとして登録する関数。
1932
1933    _Example_
1934    \code
1935    int ret = 0;
1936    // 不明な拡張コールバックのプロトタイプ
1937    int myUnknownExtCallback(const word16* oid, word32 oidSz, int crit,
1938                             const unsigned char* der, word32 derSz);
1939
1940    // 登録する
1941    ret = wc_SetUnknownExtCallback(cert, myUnknownExtCallback);
1942    if (ret != 0) {
1943        // コールバックの設定失敗
1944    }
1945
1946    // oid: oidのドット区切り値である整数の配列。
1947    // oidSz: oid内の値の数。
1948    // crit: 拡張が重要としてマークされたかどうか。
1949    // der: 拡張のコンテンツのderエンコーディング。
1950    // derSz: derエンコーディングのサイズ（バイト単位）。
1951    int myCustomExtCallback(const word16* oid, word32 oidSz, int crit,
1952                            const unsigned char* der, word32 derSz) {
1953
1954        // 拡張を解析するロジックがここに入ります。
1955
1956        // 注：0を返すことで、この拡張を受け入れ、wolfSSLに
1957        // それが許容可能であることを通知しています。許容できない拡張が
1958        // 見つかった場合は、エラーを返す必要があります。重要フラグが
1959        // 設定された不明な拡張に遭遇した場合の標準的な動作は、
1960        // ASN_CRIT_EXT_Eを返すことです。簡潔にするため、この例では
1961        // 常にすべての拡張を受け入れています。異なるロジックを
1962        // 使用する必要があります。
1963        return 0;
1964    }
1965    \endcode
1966
1967    \sa ParseCert
1968    \sa wc_SetCustomExtension
1969*/
1970int wc_SetUnknownExtCallback(DecodedCert* cert,
1971                                             wc_UnknownExtCallback cb);
1972/*!
1973    \ingroup ASN
1974
1975    \brief この関数は、X.509証明書のder形式の署名を公開鍵に対して検証します。公開鍵は、der形式の完全なサブジェクト公開鍵情報であることが期待されます。
1976
1977    \return 0 成功時に返されます。
1978    \return Other 失敗時に負の値。
1979
1980    \param cert X.509証明書のderエンコーディング。
1981    \param certSz certのサイズ（バイト単位）。
1982    \param heap 動的割り当てに使用されるヒープへのポインタ。NULLでも可。
1983    \param pubKey 公開鍵のderエンコーディング。
1984    \param pubKeySz pubKeyのサイズ（バイト単位）。
1985    \param pubKeyOID 公開鍵のアルゴリズムを識別するOID。
1986    (例：ECDSAk、DSAkまたはRSAk)
1987*/
1988int wc_CheckCertSigPubKey(const byte* cert, word32 certSz,
1989                                      void* heap, const byte* pubKey,
1990                                      word32 pubKeySz, int pubKeyOID);
1991
1992/*!
1993    \ingroup ASN
1994
1995    \brief この関数は、ASN.1プリントオプションを初期化します。
1996
1997    \return  0 成功時。
1998    \return  BAD_FUNC_ARG asn1がNULLの場合。
1999
2000    \param opts  プリント用のASN.1オプション。
2001
2002    _Example_
2003    \code
2004    Asn1PrintOptions opt;
2005
2006    // 使用前にASN.1プリントオプションを初期化します。
2007    wc_Asn1PrintOptions_Init(&opt);
2008    \endcode
2009    \sa wc_Asn1PrintOptions_Set
2010    \sa wc_Asn1_PrintAll
2011*/
2012int wc_Asn1PrintOptions_Init(Asn1PrintOptions* opts);
2013
2014/*!
2015    \ingroup ASN
2016
2017    \brief この関数は、ASN.1プリントオプションオブジェクトにプリントオプションを設定します。
2018
2019    \return  0 成功時。
2020    \return  BAD_FUNC_ARG asn1がNULLの場合。
2021    \return  BAD_FUNC_ARG valがoptionの範囲外の場合。
2022
2023    \param opts  プリント用のASN.1オプション。
2024    \param opt   値を設定するオプション。
2025    \param val   設定する値。
2026
2027    _Example_
2028    \code
2029    Asn1PrintOptions opt;
2030
2031    // 使用前にASN.1プリントオプションを初期化します。
2032    wc_Asn1PrintOptions_Init(&opt);
2033    // タグ名をプリントする際のインデント数を1に設定します。
2034    wc_Asn1PrintOptions_Set(&opt, ASN1_PRINT_OPT_INDENT, 1);
2035    \endcode
2036
2037    \sa wc_Asn1PrintOptions_Init
2038    \sa wc_Asn1_PrintAll
2039*/
2040int wc_Asn1PrintOptions_Set(Asn1PrintOptions* opts, enum Asn1PrintOpt opt,
2041    word32 val);
2042
2043/*!
2044    \ingroup ASN
2045
2046    \brief この関数は、ASN.1解析オブジェクトを初期化します。
2047
2048    \return  0 成功時。
2049    \return  BAD_FUNC_ARG asn1がNULLの場合。
2050
2051    \param asn1  ASN.1解析オブジェクト。
2052
2053    _Example_
2054    \code
2055    Asn1 asn1;
2056
2057    // 使用前にASN.1解析オブジェクトを初期化します。
2058    wc_Asn1_Init(&asn1);
2059    \endcode
2060
2061    \sa wc_Asn1_SetFile
2062    \sa wc_Asn1_PrintAll
2063 */
2064int wc_Asn1_Init(Asn1* asn1);
2065
2066/*!
2067    \ingroup ASN
2068
2069    \brief この関数は、ASN.1解析オブジェクトへのプリント時に使用するファイルを設定します。
2070
2071    \return  0 成功時。
2072    \return  BAD_FUNC_ARG asn1がNULLの場合。
2073    \return  BAD_FUNC_ARG fileがXBADFILEの場合。
2074
2075    \param asn1  ASN.1解析オブジェクト。
2076    \param file  プリント先のファイル。
2077
2078    _Example_
2079    \code
2080    Asn1 asn1;
2081
2082    // 使用前にASN.1解析オブジェクトを初期化します。
2083    wc_Asn1_Init(&asn1);
2084    // 標準出力を書き込み先のファイル記述子として設定します。
2085    wc_Asn1_SetFile(&asn1, stdout);
2086    \endcode
2087
2088    \sa wc_Asn1_Init
2089    \sa wc_Asn1_PrintAll
2090 */
2091int wc_Asn1_SetFile(Asn1* asn1, XFILE file);
2092
2093/*!
2094    \ingroup ASN
2095
2096    \brief すべてのASN.1項目をプリントします。
2097
2098    \return  0 成功時。
2099    \return  BAD_FUNC_ARG asn1またはoptsがNULLの場合。
2100    \return  ASN_LEN_E ASN.1項目の長さが長すぎる場合。
2101    \return  ASN_DEPTH_E 終了オフセットが無効な場合。
2102    \return  ASN_PARSE_E ASN.1項目のすべてが解析されなかった場合。
2103
2104    \param asn1  ASN.1解析オブジェクト。
2105    \param opts  ASN.1プリントオプション。
2106    \param data  プリントするBER/DERデータを含むバッファ。
2107    \param len   プリントするデータの長さ（バイト単位）。
2108
2109    \code
2110    Asn1PrintOptions opts;
2111    Asn1 asn1;
2112    unsigned char data[] = { DER/BERデータで初期化 };
2113    word32 len = sizeof(data);
2114
2115    // 使用前にASN.1プリントオプションを初期化します。
2116    wc_Asn1PrintOptions_Init(&opt);
2117    // タグ名をプリントする際のインデント数を1に設定します。
2118    wc_Asn1PrintOptions_Set(&opt, ASN1_PRINT_OPT_INDENT, 1);
2119
2120    // 使用前にASN.1解析オブジェクトを初期化します。
2121    wc_Asn1_Init(&asn1);
2122    // 標準出力を書き込み先のファイル記述子として設定します。
2123    wc_Asn1_SetFile(&asn1, stdout);
2124    // 指定されたプリントオプションでバッファ内のすべてのASN.1項目をプリントします。
2125    wc_Asn1_PrintAll(&asn1, &opts, data, len);
2126    \endcode
2127
2128    \sa wc_Asn1_Init
2129    \sa wc_Asn1_SetFile
2130 */
2131int wc_Asn1_PrintAll(Asn1* asn1, Asn1PrintOptions* opts, unsigned char* data,
2132    word32 len);