ssh_kex_hybrid.h File Reference

Post-quantum hybrid key exchange. More...

#include "ssh/ssh.h"

Go to the source code of this file.

Functions

error_t sshSendKexHybridInit (SshConnection *connection)
 Send SSH_MSG_KEX_HYBRID_INIT message. More...
 
error_t sshSendKexHybridReply (SshConnection *connection)
 Send SSH_MSG_KEX_HYBRID_REPLY message. More...
 
error_t sshFormatKexHybridReply (SshConnection *connection, uint8_t *p, size_t *length)
 Format SSH_MSG_KEX_HYBRID_REPLY message. More...
 
error_t sshFormatKexHybridInit (SshConnection *connection, uint8_t *p, size_t *length)
 Format SSH_MSG_KEX_HYBRID_INIT message. More...
 
error_t sshParseKexHybridInit (SshConnection *connection, const uint8_t *message, size_t length)
 Parse SSH_MSG_KEX_HYBRID_INIT message. More...
 
error_t sshParseKexHybridReply (SshConnection *connection, const uint8_t *message, size_t length)
 Parse SSH_MSG_KEX_HYBRID_REPLY message. More...
 
error_t sshParseKexHybridMessage (SshConnection *connection, uint8_t type, const uint8_t *message, size_t length)
 Parse PQ-hybrid specific messages. More...
 
error_t sshSelectKemAlgo (SshConnection *connection)
 Select key encapsulation mechanism. More...
 
error_t sshLoadKexClassicalEcdhParams (const char_t *kexAlgo, EcDomainParameters *params)
 Load the EC parameters that match specified key exchange algorithm. More...
 
error_t sshGenerateClassicalEcdhKeyPair (SshConnection *connection)
 ECDH key pair generation. More...
 
error_t sshComputeClassicalEcdhSharedSecret (SshConnection *connection)
 ECDH shared secret calculation. More...
 
error_t sshDigestClientInit (SshConnection *connection)
 Update exchange hash with C_INIT (concatenation of C_PQ and C_CL) More...
 

Detailed Description

Post-quantum hybrid key exchange.

License

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

Copyright (C) 2019-2024 Oryx Embedded SARL. All rights reserved.

This file is part of CycloneSSH 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.0

Definition in file ssh_kex_hybrid.h.

Function Documentation

◆ sshComputeClassicalEcdhSharedSecret()

error_t sshComputeClassicalEcdhSharedSecret ( SshConnection connection)

ECDH shared secret calculation.

Parameters
[in]connectionPointer to the SSH connection
Returns
Error code

Definition at line 932 of file ssh_kex_hybrid.c.

◆ sshDigestClientInit()

error_t sshDigestClientInit ( SshConnection connection)

Update exchange hash with C_INIT (concatenation of C_PQ and C_CL)

Parameters
[in]connectionPointer to the SSH connection
Returns
Error code

Definition at line 971 of file ssh_kex_hybrid.c.

◆ sshFormatKexHybridInit()

error_t sshFormatKexHybridInit ( SshConnection connection,
uint8_t *  p,
size_t *  length 
)

Format SSH_MSG_KEX_HYBRID_INIT message.

Parameters
[in]connectionPointer to the SSH connection
[out]pBuffer where to format the message
[out]lengthLength of the resulting message, in bytes
Returns
Error code

Definition at line 192 of file ssh_kex_hybrid.c.

◆ sshFormatKexHybridReply()

error_t sshFormatKexHybridReply ( SshConnection connection,
uint8_t *  p,
size_t *  length 
)

Format SSH_MSG_KEX_HYBRID_REPLY message.

Parameters
[in]connectionPointer to the SSH connection
[out]pBuffer where to format the message
[out]lengthLength of the resulting message, in bytes
Returns
Error code

Definition at line 246 of file ssh_kex_hybrid.c.

◆ sshGenerateClassicalEcdhKeyPair()

error_t sshGenerateClassicalEcdhKeyPair ( SshConnection connection)

ECDH key pair generation.

Parameters
[in]connectionPointer to the SSH connection
Returns
Error code

Definition at line 890 of file ssh_kex_hybrid.c.

◆ sshLoadKexClassicalEcdhParams()

error_t sshLoadKexClassicalEcdhParams ( const char_t kexAlgo,
EcDomainParameters params 
)

Load the EC parameters that match specified key exchange algorithm.

Parameters
[in]kexAlgoKey exchange algorithm name
[out]paramsElliptic curve domain parameters
Returns
Error code

Definition at line 823 of file ssh_kex_hybrid.c.

◆ sshParseKexHybridInit()

error_t sshParseKexHybridInit ( SshConnection connection,
const uint8_t *  message,
size_t  length 
)

Parse SSH_MSG_KEX_HYBRID_INIT message.

Parameters
[in]connectionPointer to the SSH connection
[in]messagePointer to message
[in]lengthLength of the message, in bytes
Returns
Error code

Definition at line 380 of file ssh_kex_hybrid.c.

◆ sshParseKexHybridMessage()

error_t sshParseKexHybridMessage ( SshConnection connection,
uint8_t  type,
const uint8_t *  message,
size_t  length 
)

Parse PQ-hybrid specific messages.

Parameters
[in]connectionPointer to the SSH connection
[in]typeSSH message type
[in]messagePointer to message
[in]lengthLength of the message, in bytes
Returns
Error code

Definition at line 695 of file ssh_kex_hybrid.c.

◆ sshParseKexHybridReply()

error_t sshParseKexHybridReply ( SshConnection connection,
const uint8_t *  message,
size_t  length 
)

Parse SSH_MSG_KEX_HYBRID_REPLY message.

Parameters
[in]connectionPointer to the SSH connection
[in]messagePointer to message
[in]lengthLength of the message, in bytes
Returns
Error code

Definition at line 489 of file ssh_kex_hybrid.c.

◆ sshSelectKemAlgo()

error_t sshSelectKemAlgo ( SshConnection connection)

Select key encapsulation mechanism.

Parameters
[in]connectionPointer to the SSH connection
Returns
Error code

Definition at line 753 of file ssh_kex_hybrid.c.

◆ sshSendKexHybridInit()

error_t sshSendKexHybridInit ( SshConnection connection)

Send SSH_MSG_KEX_HYBRID_INIT message.

Parameters
[in]connectionPointer to the SSH connection
Returns
Error code

Definition at line 57 of file ssh_kex_hybrid.c.

◆ sshSendKexHybridReply()

error_t sshSendKexHybridReply ( SshConnection connection)

Send SSH_MSG_KEX_HYBRID_REPLY message.

Parameters
[in]connectionPointer to the SSH connection
Returns
Error code

Definition at line 137 of file ssh_kex_hybrid.c.