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 ]