148 lines
4.9 KiB
C++
148 lines
4.9 KiB
C++
/*
|
|
Copyright 2015-2016 Amebis
|
|
Copyright 2016 GÉANT
|
|
|
|
This file is part of GÉANTLink.
|
|
|
|
GÉANTLink is free software: you can redistribute it and/or modify it
|
|
under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
GÉANTLink is distributed in the hope that it will be useful, but
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with GÉANTLink. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
namespace eap
|
|
{
|
|
///
|
|
/// EAP-TTLS packet flags
|
|
///
|
|
/// \sa [Extensible Authentication Protocol Tunneled Transport Layer Security Authenticated Protocol Version 0 (EAP-TTLSv0) (Chapter: 9.1 Packet Format)](https://tools.ietf.org/html/rfc5281#section-9.1)
|
|
///
|
|
enum ttls_flags_t;
|
|
|
|
///
|
|
/// TTLS session
|
|
///
|
|
class session_ttls;
|
|
}
|
|
|
|
#pragma once
|
|
|
|
#include "../../TLS/include/Session.h"
|
|
#include "../../EAPBase/include/Session.h"
|
|
|
|
|
|
namespace eap
|
|
{
|
|
enum ttls_flags_t {
|
|
ttls_flags_length_incl = tls_flags_length_incl, ///< Length included
|
|
ttls_flags_more_frag = tls_flags_more_frag, ///< More fragments
|
|
ttls_flags_start = tls_flags_start, ///< Start
|
|
ttls_flags_ver_mask = 0x07, ///< Version mask
|
|
};
|
|
|
|
|
|
class session_ttls : public session<config_method_ttls, credentials_ttls, bool, bool>
|
|
{
|
|
public:
|
|
///
|
|
/// Constructor
|
|
///
|
|
/// \param[in] mod EAP module to use for global services
|
|
///
|
|
session_ttls(_In_ module *mod);
|
|
|
|
///
|
|
/// Copies TTLS session
|
|
///
|
|
/// \param[in] other Session to copy from
|
|
///
|
|
session_ttls(_In_ const session_ttls &other);
|
|
|
|
///
|
|
/// Moves TTLS session
|
|
///
|
|
/// \param[in] other Session to move from
|
|
///
|
|
session_ttls(_Inout_ session_ttls &&other);
|
|
|
|
///
|
|
/// Copies TTLS session
|
|
///
|
|
/// \param[in] other Session to copy from
|
|
///
|
|
/// \returns Reference to this object
|
|
///
|
|
session_ttls& operator=(_In_ const session_ttls &other);
|
|
|
|
///
|
|
/// Moves TTLS session
|
|
///
|
|
/// \param[in] other Session to move from
|
|
///
|
|
/// \returns Reference to this object
|
|
///
|
|
session_ttls& operator=(_Inout_ session_ttls &&other);
|
|
|
|
/// \name Packet processing
|
|
/// @{
|
|
|
|
///
|
|
/// Processes a packet received by EAPHost from a supplicant.
|
|
///
|
|
/// \sa [EapPeerProcessRequestPacket function](https://msdn.microsoft.com/en-us/library/windows/desktop/aa363621.aspx)
|
|
///
|
|
/// \returns
|
|
/// - \c true if succeeded
|
|
/// - \c false otherwise. See \p ppEapError for details.
|
|
///
|
|
virtual bool process_request_packet(
|
|
_In_ DWORD dwReceivedPacketSize,
|
|
_In_bytecount_(dwReceivedPacketSize) const EapPacket *pReceivedPacket,
|
|
_Out_ EapPeerMethodOutput *pEapOutput,
|
|
_Out_ EAP_ERROR **ppEapError);
|
|
|
|
///
|
|
/// Obtains a response packet from the EAP method.
|
|
///
|
|
/// \sa [EapPeerGetResponsePacket function](https://msdn.microsoft.com/en-us/library/windows/desktop/aa363610.aspx)
|
|
///
|
|
/// \returns
|
|
/// - \c true if succeeded
|
|
/// - \c false otherwise. See \p ppEapError for details.
|
|
///
|
|
virtual bool get_response_packet(
|
|
_Inout_ DWORD *pdwSendPacketSize,
|
|
_Inout_bytecap_(*dwSendPacketSize) EapPacket *pSendPacket,
|
|
_Out_ EAP_ERROR **ppEapError);
|
|
|
|
///
|
|
/// Obtains the result of an authentication session from the EAP method.
|
|
///
|
|
/// \sa [EapPeerGetResult function](https://msdn.microsoft.com/en-us/library/windows/desktop/aa363611.aspx)
|
|
///
|
|
/// \returns
|
|
/// - \c true if succeeded
|
|
/// - \c false otherwise. See \p ppEapError for details.
|
|
///
|
|
virtual bool get_result(
|
|
_In_ EapPeerMethodResultReason reason,
|
|
_Out_ EapPeerMethodResult *ppResult,
|
|
_Out_ EAP_ERROR **ppEapError);
|
|
|
|
/// @}
|
|
|
|
public:
|
|
enum version_t {
|
|
version_0 = 0, ///< EAP-TTLS v0
|
|
} m_version; ///< EAP-TTLS version
|
|
};
|
|
}
|