gss_process_context_token()--Process Received Context Token
Syntax
#include <gssapi.h> OM_uint32 gss_process_context_token( OM_uint32 * minor_status, gss_ctx_id_t context_handle gss_buffer_t input_token);Service Program Name: QSYS/QKRBGSS
Default public authority: *USE
Threadsafe: Yes
The gss_process_context_token() function processes a context token received from the partner application.
Parameters
- minor_status (Output)
- A status code from the security mechanism.
- context_handle (Input)
- The context that should be used when processing the token.
- input_token (Input)
- The token received from the partner application.
Return Value
The return value is one of the following status codes:
- GSS_S_BAD_SIG
- The token signature was not correct.
- GSS_S_COMPLETE
- The routine completed successfully.
- GSS_S_DEFECTIVE_TOKEN
- Consistency checks performed on the input token failed.
- GSS_S_FAILURE
- The routine failed for reasons that are not defined at the GSS level. The
minor_status return parameter contains a mechanism-dependent error
code describing the reason for the failure.
- GSS_S_NO_CONTEXT
- The context handle does not refer to a valid security context.
Authorities
Object Referred to | Data Authority Required |
---|---|
Each directory in the path name preceding the configuration file | *X |
Configuration file | *R |
Error Messages
Message ID | Error Message Text |
---|---|
CPE3418 E | Possible APAR condition or hardware failure. |
Usage Notes
- Tokens are usually associated with either the context establishment or with message security services. If the tokens are associated with the context establishment, they are processed by the gss_init_sec_context() and gss_accept_sec_context() routines. If the tokens are associated with message security services, they are processed by the gss_verify_mic() and gss_unwrap() routines. Tokens generated by the gss_delete_sec_context() routine, however, are processed by the gss_process_context_token() routine.
API introduced: V5R1
[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]