Text Input authentication callback structure.
This is a C implementation of the javax.security.auth.callback. TextInputCallback class used to submit authentication callback requirements to the Access Manager authentication service.
#include "am_auth.h" typedef struct am_auth_text_input_callback_info { const char *prompt; const char *default_text; const char *response; /* text */ } am_auth_text_input_callback_t;
This structure has the following members:
Prompt for the text input, if any.
Memory for the prompt is allocated by the C SDK in am_auth_login() and freed when the authentication context is destroyed using am_auth_destroy_auth_context().
Default text for the text input, if any.
Memory for the default text is allocated by the C SDK in am_auth_login() and freed when the authentication context is destroyed using am_auth_destroy_auth_context().
Text input to be submitted to the Access Manager.
Memory for the response must be allocated and freed by the caller.
See am_auth_test.c in the C SDK samples for an example of how to use the password callback.