CHAP (Challenge Handshake Authentication Protocol) More...

#include "core/net.h"
#include "ppp/ppp.h"

Data Structures
struct	ChapFsm
	CHAP finite state machine. More...

Macros
#define	CHAP_SUPPORT DISABLED

#define	CHAP_RESTART_TIMER 3000

#define	CHAP_MAX_CHALLENGES 5

Enumerations
enum	ChapState { CHAP_STATE_0_INITIAL = 0, CHAP_STATE_1_STARTED = 1, CHAP_STATE_2_CHALLENGE_SENT = 2, CHAP_STATE_3_CHALLENGE_RCVD = 3, CHAP_STATE_4_RESPONSE_SENT = 4, CHAP_STATE_5_RESPONSE_RCVD = 5, CHAP_STATE_6_SUCCESS_SENT = 6, CHAP_STATE_7_SUCCESS_RCVD = 7, CHAP_STATE_8_FAILURE_SENT = 8, CHAP_STATE_9_FAILURE_RCVD = 9 }
	CHAP states. More...

enum	ChapCode { CHAP_CODE_CHALLENGE = 1, CHAP_CODE_RESPONSE = 2, CHAP_CODE_SUCCESS = 3, CHAP_CODE_FAILURE = 4 }
	Code field values. More...

enum	ChapAlgoId { CHAP_ALGO_ID_CHAP_MD5 = 5, CHAP_ALGO_ID_MS_CHAP = 128, CHAP_ALGO_ID_MS_CHAP_V2 = 129 }
	CHAP algorithm identifiers. More...

Functions
error_t	chapStartAuth (PppContext *context)
	Start CHAP authentication. More...

error_t	chapAbortAuth (PppContext *context)
	Abort CHAP authentication. More...

void	chapTick (PppContext *context)
	CHAP timer handler. More...

void	chapProcessPacket (PppContext context, const PppPacket packet, size_t length)
	Process an incoming CHAP packet. More...

error_t	chapProcessChallenge (PppContext context, const ChapChallengePacket challengePacket, size_t length)
	Process Challenge packet. More...

error_t	chapProcessResponse (PppContext context, const ChapResponsePacket responsePacket, size_t length)
	Process Response packet. More...

error_t	chapProcessSuccess (PppContext context, const ChapSuccessPacket successPacket, size_t length)
	Process Success packet. More...

error_t	chapProcessFailure (PppContext context, const ChapFailurePacket failurePacket, size_t length)
	Process Failure packet. More...

error_t	chapSendChallenge (PppContext *context)
	Send Challenge packet. More...

error_t	chapSendResponse (PppContext context, const uint8_t value)
	Send Response packet. More...

error_t	chapSendSuccess (PppContext *context)
	Send Success packet. More...

error_t	chapSendFailure (PppContext *context)
	Send Failure packet. More...

bool_t	chapCheckPassword (PppContext context, const char_t password)
	Password verification. More...

Variables
typedef	__packed_struct
	Challenge packet. More...

uint8_t	identifier

uint16_t	length

uint8_t	valueSize

uint8_t	value []

	ChapChallengePacket

	ChapResponsePacket

uint8_t	message []

	ChapSuccessPacket

	ChapFailurePacket

Detailed Description

CHAP (Challenge Handshake Authentication Protocol)

License

SPDX-License-Identifier: GPL-2.0-or-later

This file is part of CycloneTCP Open.

This program 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 2 of the License, or (at your option) any later version.

This program 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 this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Author: Oryx Embedded SARL (www.oryx-embedded.com)

Version: 2.4.4

Definition in file chap.h.

Macro Definition Documentation

◆ CHAP_MAX_CHALLENGES

#define CHAP_MAX_CHALLENGES 5

Definition at line 54 of file chap.h.

◆ CHAP_RESTART_TIMER

#define CHAP_RESTART_TIMER 3000

Definition at line 47 of file chap.h.

◆ CHAP_SUPPORT

#define CHAP_SUPPORT DISABLED

Definition at line 40 of file chap.h.

Enumeration Type Documentation

◆ ChapAlgoId

enum ChapAlgoId

CHAP algorithm identifiers.

Enumerator
CHAP_ALGO_ID_CHAP_MD5
CHAP_ALGO_ID_MS_CHAP
CHAP_ALGO_ID_MS_CHAP_V2

Definition at line 101 of file chap.h.

◆ ChapCode

enum ChapCode

Code field values.

Enumerator
CHAP_CODE_CHALLENGE	Challenge.
CHAP_CODE_RESPONSE	Response.
CHAP_CODE_SUCCESS	Success.
CHAP_CODE_FAILURE	Failure.

Definition at line 88 of file chap.h.

◆ ChapState

enum ChapState

CHAP states.

Enumerator
CHAP_STATE_0_INITIAL
CHAP_STATE_1_STARTED
CHAP_STATE_2_CHALLENGE_SENT
CHAP_STATE_3_CHALLENGE_RCVD
CHAP_STATE_4_RESPONSE_SENT
CHAP_STATE_5_RESPONSE_RCVD
CHAP_STATE_6_SUCCESS_SENT
CHAP_STATE_7_SUCCESS_RCVD
CHAP_STATE_8_FAILURE_SENT
CHAP_STATE_9_FAILURE_RCVD

Definition at line 69 of file chap.h.

Function Documentation

◆ chapAbortAuth()

error_t chapAbortAuth ( PppContext * context )

Abort CHAP authentication.

Parameters

[in] context PPP context

Returns: Error code

Definition at line 91 of file chap.c.

◆ chapCheckPassword()

bool_t chapCheckPassword	(	PppContext *	context,
		const char_t *	password
	)

Password verification.

Parameters

[in]	context	PPP context
[in]	password	NULL-terminated string containing the password to be checked

Returns: TRUE if the password is valid, else FALSE

Definition at line 716 of file chap.c.

◆ chapProcessChallenge()

error_t chapProcessChallenge	(	PppContext *	context,
		const ChapChallengePacket *	challengePacket,
		size_t	length
	)

Process Challenge packet.

Parameters

[in]	context	PPP context
[in]	challengePacket	Packet received from the peer
[in]	length	Length of the packet, in bytes

Returns: Error code

Definition at line 218 of file chap.c.

◆ chapProcessFailure()

error_t chapProcessFailure	(	PppContext *	context,
		const ChapFailurePacket *	failurePacket,
		size_t	length
	)

Process Failure packet.

Parameters

[in]	context	PPP context
[in]	failurePacket	Packet received from the peer
[in]	length	Length of the packet, in bytes

Returns: Error code

Definition at line 445 of file chap.c.

◆ chapProcessPacket()

void chapProcessPacket	(	PppContext *	context,
		const PppPacket *	packet,
		size_t	length
	)

Process an incoming CHAP packet.

Parameters

[in]	context	PPP context
[in]	packet	CHAP packet received from the peer
[in]	length	Length of the packet, in bytes

Definition at line 149 of file chap.c.

◆ chapProcessResponse()

error_t chapProcessResponse	(	PppContext *	context,
		const ChapResponsePacket *	responsePacket,
		size_t	length
	)

Process Response packet.

Parameters

[in]	context	PPP context
[in]	responsePacket	Packet received from the peer
[in]	length	Length of the packet, in bytes

Returns: Error code

Definition at line 273 of file chap.c.

◆ chapProcessSuccess()

error_t chapProcessSuccess	(	PppContext *	context,
		const ChapSuccessPacket *	successPacket,
		size_t	length
	)

Process Success packet.

Parameters

[in]	context	PPP context
[in]	successPacket	Packet received from the peer
[in]	length	Length of the packet, in bytes

Returns: Error code

Definition at line 388 of file chap.c.

◆ chapSendChallenge()

error_t chapSendChallenge ( PppContext * context )

Send Challenge packet.

Parameters

[in] context PPP context

Returns: Error code

Definition at line 480 of file chap.c.

◆ chapSendFailure()

error_t chapSendFailure ( PppContext * context )

Send Failure packet.

Parameters

[in] context PPP context

Returns: Error code

Definition at line 668 of file chap.c.

◆ chapSendResponse()

error_t chapSendResponse	(	PppContext *	context,
		const uint8_t *	value
	)

Send Response packet.

Parameters

[in]	context	PPP context
[in]	value	Response value

Returns: Error code

Definition at line 563 of file chap.c.

◆ chapSendSuccess()

error_t chapSendSuccess ( PppContext * context )

Send Success packet.

Parameters

[in] context PPP context

Returns: Error code

Definition at line 621 of file chap.c.

◆ chapStartAuth()

error_t chapStartAuth ( PppContext * context )

Start CHAP authentication.

Parameters

[in] context PPP context

Returns: Error code

Definition at line 57 of file chap.c.

◆ chapTick()

void chapTick ( PppContext * context )

CHAP timer handler.

Parameters

[in] context PPP context

Definition at line 110 of file chap.c.

Variable Documentation

◆ __packed_struct

typedef __packed_struct

Initial value:

{

uint8_t code

Challenge packet.

Failure packet.

Success packet.

Response packet.

Definition at line 121 of file chap.h.

◆ ChapChallengePacket

ChapChallengePacket

Definition at line 128 of file chap.h.

◆ ChapFailurePacket

ChapFailurePacket

Definition at line 168 of file chap.h.

◆ ChapResponsePacket

ChapResponsePacket

Definition at line 142 of file chap.h.

◆ ChapSuccessPacket

ChapSuccessPacket

Definition at line 155 of file chap.h.

◆ identifier

uint8_t identifier

Definition at line 124 of file chap.h.

◆ length

uint16_t length

Definition at line 125 of file chap.h.

◆ message

uint8_t message

Definition at line 154 of file chap.h.

◆ value

uint8_t value[]

Definition at line 127 of file chap.h.

◆ valueSize

uint8_t valueSize

Definition at line 126 of file chap.h.

Data Structures

Macros

Enumerations

Functions

Variables

Detailed Description

License

Macro Definition Documentation

◆ CHAP_MAX_CHALLENGES

◆ CHAP_RESTART_TIMER

◆ CHAP_SUPPORT

Enumeration Type Documentation

◆ ChapAlgoId

◆ ChapCode

◆ ChapState

Function Documentation

◆ chapAbortAuth()

◆ chapCheckPassword()

◆ chapProcessChallenge()

◆ chapProcessFailure()

◆ chapProcessPacket()

◆ chapProcessResponse()

◆ chapProcessSuccess()

◆ chapSendChallenge()

◆ chapSendFailure()

◆ chapSendResponse()

◆ chapSendSuccess()

◆ chapStartAuth()

◆ chapTick()

Variable Documentation

◆ __packed_struct

◆ ChapChallengePacket

◆ ChapFailurePacket

◆ ChapResponsePacket

◆ ChapSuccessPacket

◆ identifier

◆ length

◆ message

◆ value

◆ valueSize