/*---------------------------------------------------------------------------*
  Project:  Horizon
  File:     http_ClientCert.h

  Copyright (C)2010 Nintendo Co., Ltd.  All rights reserved.

  These coded instructions, statements, and computer programs contain
  proprietary information of Nintendo of America Inc. and/or Nintendo
  Company Ltd., and are protected by Federal copyright law.  They may
  not be disclosed to third parties or copied or duplicated in any form,
  in whole or in part, without the prior written consent of Nintendo.

  $Rev: 26779 $
 *---------------------------------------------------------------------------*/

#ifndef NN_HTTP_HTTP_CLIENTCERT_H_
#define NN_HTTP_HTTP_CLIENTCERT_H_

#include <nn/util/util_NonCopyable.h>
#include <nn/http/http_Types.h>

#ifdef __cplusplus

namespace nn {
namespace http {

class Connection;

/*!
  @brief HTTPS用のクライアント証明書を表すクラスです。複数のHTTPS通信でクライアント証明書を使いまわしたい場合に利用します。

*/
class ClientCert : private nn::util::NonCopyable<ClientCert>
{
    friend class Connection;
public:
    /*!
      @brief コンストラクタです。
    */
    explicit ClientCert();

    /*!
      @brief デストラクタです。
    */
    virtual ~ClientCert (void);

    /*!
      @brief  証明書と秘密鍵の登録を行い、クライアント証明書を初期化します。
      @param[in]  pCertData   証明書データ。データフォーマットは、X.509 v3の証明書データ(ASN.1定義)をDERエンコードしたバイナリデータ。
      @param[in]  certDataSize pCertDataのサイズ 。
      @param[in]  pPrivateKeyData   秘密鍵のデータ。データフォーマットは、X.509の鍵データ(ASN.1定義)をDERエンコードしたバイナリデータ。
      @param[in]  privateKeyDataSize pPrivateKeyDataのサイズ 。
      @return 処理の結果が返ります。<BR>
    */
    nn::Result Initialize(const u8* pCertData, size_t certDataSize, const u8* pPrivateKeyData, size_t privateKeyDataSize);

    /*!
      @brief  機器内蔵クライアント証明書を登録して、クライアント証明書を初期化します。
      @param[in]  inClientCertName   対象の機器内蔵クライアント証明書(sslの @ref nn::ssl::InternalClientCertの値。)
      @return 処理の結果が返ります。<BR>
    */
    nn::Result Initialize(InternalClientCertId inClientCertName );


    /*!
      @brief  クライアント証明書の終了処理を行います。クライアント証明書の利用が全て終了したら、一度実施する必要があります。
      @return 処理の結果が返ります。<BR>
    */
    nn::Result Finalize(void);

private:
    bool m_isInitialized;
    NN_PADDING3;
    CertId m_certId;

    /*!
      @brief  クライアント証明書が有効なものか否かを取得します。
      @return 処理の結果が返ります。<BR>
    */
    bool IsValid(){return m_isInitialized;}
};

} // end of namespace http
} // end of namespace nn

#endif // __cplusplus


#include <nn/util/detail/util_CLibImpl.h>


/*!
  @addtogroup   nn_http               http
  @{

  @defgroup     nn_http_ClientCert_c    ClientCert (C)

  @brief        @ref nn::http::ClientCert の C インタフェースモジュールです。

  @{
*/

/*!
  @struct       nnhttpClientCert
  @brief        HTTPのClientCertを表す C の構造体です。

  @brief 対応するクラス @ref nn::http::ClientCert を参照してください。
*/
NN_UTIL_DETAIL_CLIBIMPL_DEFINE_BUFFER_CLASS(nnhttpClientCert, nn::http::ClientCert, 12, u32);

/*!
  @brief 対応する C++ 関数 @ref nn::http::ClientCert::Initialize を参照してください。
*/
NN_EXTERN_C nnResult nnhttpClientCertInitialize(nnhttpClientCert* this_, const u8* pCertData, size_t certDataSize, const u8* pPrivateKeyData, size_t privateKeyDataSize);

/*!
  @brief 対応する C++ 関数 @ref nn::http::ClientCert::Initialize を参照してください。
*/
NN_EXTERN_C nnResult nnhttpClientCertInitializeByInternalCert(nnhttpClientCert* this_, NnHttpInternalClientCertId inClientCertName);


/*!
  @brief 対応する C++ 関数 @ref nn::http::ClientCert::Finalize を参照してください。
*/
NN_EXTERN_C nnResult nnhttpClientCertFinalize(nnhttpClientCert* this_);


/*!
  @}

  @}
*/

#endif /* NN_HTTP_HTTP_CLIENTCERT_H_ */