1libssh2_userauth_keyboard_interacltiibvslesi_hbe2sxs(mh3a2)n_uuaslerauth_keyboard_interactive_ex(3)
2
3
4

NAME

6       libssh2_userauth_keyboard_interactive_ex - authenticate a session using
7       a challenge-response authentication
8

SYNOPSIS

10       #include <libssh2.h>
11
12       int libssh2_userauth_keyboard_interactive_ex(LIBSSH2_SESSION  *session,
13       const   char   *username,   unsigned  int  username_len,  LIBSSH2_USER‐
14       AUTH_KBDINT_RESPONSE_FUNC(*response_callback));
15
16       int   libssh2_userauth_keyboard_interactive(LIBSSH2_SESSION   *session,
17       const             char             *username,             LIBSSH2_USER‐
18       AUTH_KBDINT_RESPONSE_FUNC(*response_callback));
19
20

DESCRIPTION

22       session - Session instance as returned by libssh2_session_init_ex(3)
23
24       username - Name of user to attempt plain password authentication for.
25
26       username_len - Length of username parameter.
27
28       response_callback - As authentication proceeds, host issues several  (1
29       or  more)  challenges  and  requires  responses.  This callback will be
30       called at this moment. Callback is responsible to obtain responses  for
31       the  challenges,  fill the provided data structure and then return con‐
32       trol. Responses will be  sent  to  the  host.  String  values  will  be
33       free(3)ed by the library.
34
35       Attempts keyboard-interactive (challenge/response) authentication.
36
37       Note  that  many  SSH servers will always issue single "password" chal‐
38       lenge, requesting actual password as response, but it is  not  required
39       by  the protocol, and various authentication schemes, such as smartcard
40       authentication may use keyboard-interactive authentication type too.
41
42

RETURN VALUE

44       Return  0  on  success  or  negative  on  failure.   It  returns   LIB‐
45       SSH2_ERROR_EAGAIN   when   it   would   otherwise   block.  While  LIB‐
46       SSH2_ERROR_EAGAIN is a negative number, it isn't really a  failure  per
47       se.
48
49

ERRORS

51       LIBSSH2_ERROR_ALLOC -  An internal memory allocation call failed.
52
53       LIBSSH2_ERROR_SOCKET_SEND - Unable to send data on socket.
54
55       IBSSH2_ERROR_AUTHENTICATION_FAILED -  failed, invalid username/password
56       or public/private key.
57
58

SEE ALSO

60       libssh2_session_init_ex(3)
61
62
63
64libssh2 0.19                      8lMiabrss2h020_8userauth_keyboard_interactive_ex(3)
Impressum