Struct openssl::ec::EcKey
[−]
pub struct EcKey(_);
Public and optional Private key on the given curve
OpenSSL documentation at EC_KEY_new
Methods
impl EcKey[src]
fn from_curve_name(nid: Nid) -> Result<EcKey, ErrorStack>[src]
Constructs an EcKey corresponding to a known curve.
It will not have an associated public or private key. This kind of key is primarily useful
to be provided to the set_tmp_ecdh methods on Ssl and SslContextBuilder.
OpenSSL documenation at EC_KEY_new_by_curve_name
fn from_public_key(
group: &EcGroupRef,
public_key: &EcPointRef
) -> Result<EcKey, ErrorStack>[src]
group: &EcGroupRef,
public_key: &EcPointRef
) -> Result<EcKey, ErrorStack>
Constructs an EcKey from the specified group with the associated EcPoint, public_key.
This will only have the associated public_key.
Example
use openssl::bn::BigNumContext; use openssl::ec::*; use openssl::nid; use openssl::pkey::PKey; // get bytes from somewhere, i.e. this will not produce a valid key let public_key: Vec<u8> = vec![]; // create an EcKey from the binary form of a EcPoint let group = EcGroup::from_curve_name(nid::SECP256K1).unwrap(); let mut ctx = BigNumContext::new().unwrap(); let point = EcPoint::from_bytes(&group, &public_key, &mut ctx).unwrap(); let key = EcKey::from_public_key(&group, &point);
fn generate(group: &EcGroupRef) -> Result<EcKey, ErrorStack>[src]
Generates a new public/private key pair on the specified curve.
fn new_by_curve_name(nid: Nid) -> Result<EcKey, ErrorStack>[src]
: use from_curve_name
fn private_key_from_pem(pem: &[u8]) -> Result<EcKey, ErrorStack>[src]
Deserializes a PEM-formatted private key.
fn private_key_from_pem_passphrase(
pem: &[u8],
passphrase: &[u8]
) -> Result<EcKey, ErrorStack>[src]
pem: &[u8],
passphrase: &[u8]
) -> Result<EcKey, ErrorStack>
Deserializes a PEM-formatted private key, using the supplied password if the key is encrypted.
Panics
Panics if passphrase contains an embedded null.
fn private_key_from_pem_callback<F>(
pem: &[u8],
callback: F
) -> Result<EcKey, ErrorStack> where
F: FnOnce(&mut [u8]) -> Result<usize, ErrorStack>, [src]
pem: &[u8],
callback: F
) -> Result<EcKey, ErrorStack> where
F: FnOnce(&mut [u8]) -> Result<usize, ErrorStack>,
Deserializes a PEM-formatted private key, using a callback to retrieve a password if the key is encrypted.
The callback should copy the password into the provided buffer and return the number of bytes written.
fn private_key_from_der(der: &[u8]) -> Result<EcKey, ErrorStack>[src]
Deserializes a private key from DER-formatted data.
Methods from Deref<Target = EcKeyRef>
fn private_key_to_pem(&self) -> Result<Vec<u8>, ErrorStack>[src]
Serializes the private key to PEM.
fn private_key_to_pem_passphrase(
&self,
cipher: Cipher,
passphrase: &[u8]
) -> Result<Vec<u8>, ErrorStack>[src]
&self,
cipher: Cipher,
passphrase: &[u8]
) -> Result<Vec<u8>, ErrorStack>
Serializes the private key to PEM, encrypting it with the specified symmetric cipher and passphrase.
fn private_key_to_der(&self) -> Result<Vec<u8>, ErrorStack>[src]
Serializes the private key to DER.
fn group(&self) -> Option<&EcGroupRef>[src]
Return [EcGroup] of the EcKey
OpenSSL documentation at EC_KEY_get0_group
fn public_key(&self) -> Option<&EcPointRef>[src]
Return [EcPoint] associated with the public key
OpenSSL documentation at EC_KEY_get0_pubic_key
fn private_key(&self) -> Option<&BigNumRef>[src]
Return [EcPoint] associated with the private key
OpenSSL documentation at EC_KEY_get0_private_key
fn check_key(&self) -> Result<(), ErrorStack>[src]
Checks the key for validity.
OpenSSL documenation at EC_KEY_check_key
fn to_owned(&self) -> Result<EcKey, ErrorStack>[src]
Create a copy of the EcKey to allow modification
Trait Implementations
impl ForeignType for EcKey
type CType = EC_KEY
The raw C type.
type Ref = EcKeyRef
The type representing a reference to this type.
unsafe fn from_ptr(ptr: *mut EC_KEY) -> EcKey
Constructs an instance of this type from its raw type.
fn as_ptr(&self) -> *mut EC_KEY
Returns a raw pointer to the wrapped value.
impl Drop for EcKey
impl Deref for EcKey
type Target = EcKeyRef
The resulting type after dereferencing.
fn deref(&self) -> &EcKeyRef
Dereferences the value.