ssh_client_key_api

Module

ssh_client_key_api

Module summary

-behaviour(ssh_client_key_api).

Description

Behavior describing the API for public key handling of an SSH client. By implementing the callbacks defined in this behavior, the public key handling of an SSH client can be customized. By default the ssh application implements this behavior with help of the standard OpenSSH files, see the ssh(6) application manual.

Data types

Type definitions that are used more than once in this module, or abstractions to indicate the intended use of the data type, or both. For more details on public key data types, refer to Section 2 Public Key Records in the public_key user's guide:

boolean() =

true | false

string() =

[byte()]

public_key() =

#'RSAPublicKey'{}| {integer(), #'Dss-Parms'{}}| term()

private_key() =

#'RSAPrivateKey'{} | #'DSAPrivateKey'{} | term()

public_key_algorithm() =

'ssh-rsa'| 'ssh-dss' | atom()

Exports

Module:add_host_key(HostNames, Key, ConnectOptions) -> ok | {error, Reason}

Types:

Description of the host that owns the

HostNames = string()

PublicKey.

Key = public_key()

Normally an RSA or DSA public key, but handling of other public keys can be added.

Options provided to

ConnectOptions = proplists:proplist()

ssh:connect/[3,4]

Reason = term().

Adds a host key to the set of trusted host keys.

Module:is_host_key(Key, Host, Algorithm, ConnectOptions) -> Result

Types:

Key = public_key()

Normally an RSA or DSA public key, but handling of other public keys can be added.

Host = string()

Description of the host.

Host key algorithm. Is to support

Algorithm = public_key_algorithm()

'ssh-rsa'| 'ssh-dss', but more algorithms can be handled. Options provided to

ConnectOptions = proplists:proplist()

ssh:connect/[3,4].

Result = boolean()

Checks if a host key is trusted.

Module:user_key(Algorithm, ConnectOptions) -> {ok, PrivateKey} | {error, Reason}

Types:

Host key algorithm. Is to support

Algorithm = public_key_algorithm()

'ssh-rsa'| 'ssh-dss' but more algorithms can be handled. Options provided to

ConnectOptions = proplists:proplist()

ssh:connect/[3,4] Private key of the user matching the

PrivateKey = private_key()

Algorithm.

Reason = term()

Fetches the users public key matching the Algorithm.