ssh_server_key_api(3erl)

ssh_server_key_api3erl

-behaviour(ssh_server_key_api).

Overview

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

Data types

daemon_key_cb_options(T) = 
    [{key_cb_private, [T]} | ssh:daemon_option()]

Options provided to ssh:daemon/2,3.

The option list given in the key_cb option is available with the key key_cb_private.

Exports

Module:host_key(Algorithm, DaemonOptions) -> {ok, PrivateKey} | {error, Reason}

Types:

Algorithm = ssh:pubkey_alg()

Host key algorithm.

DaemonOptions = daemon_key_cb_options()
PrivateKey = public_key:private_key() | crypto:engine_key_ref()

Private key of the host matching the Algorithm. It may be a reference to a 'ssh-rsa', rsa-sha2-* or 'ssh-dss' (NOT ecdsa) key stored in a loaded Engine.

Reason = term()

Fetches the private key of the host.

Module:is_auth_key(PublicUserKey, User, DaemonOptions) -> Result

Types:

PublicUserKey = public_key:public_key()

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

User = string()

User owning the public key.

DaemonOptions = daemon_key_cb_options()
Result = boolean()

Checks if the user key is authorized.

Releases

5 releases since Debian 8 (Jessie); the text changed 4 times.

  1. 8
  2. 9
  3. 10
  4. 11
  5. 12

From erlang-manpages 1:25.2.3+dfsg-1+deb12u4 in Debian 12 (Bookworm). Parsed by carta from the page's man source.