ica_x448_derive

Edit online

Purpose

Derives a shared secret between the private key of party A stored in the context, and the given public key of party B. Requires the context to hold the private key of party A.

Format


int ica_x448_derive(ICA_X448_CTX *ctx, 
  unsigned char shared_secret[56],
  const unsigned char peer_pub[56]);

Required hardware support

The processor must have the MSA9 facility (STFLE bit 155) installed which is available starting with IBM z15® systems.

Parameters

ICA_X448_CTX *ctx
Pointer to an X448 context.
unsigned char shared_secret[56]
Buffer to return the derived shared secret between party A and party B.
const unsigned char peer_pub[56]
Buffer containing the given public key of party B as input.

Return codes

0
Success
-1
If at least one invalid parameter is given or MSA9 is not available, or the key derivation failed.

For return codes indicating exceptions, see Return codes.