The qop_req parameter allows a choice between several cryptographic
algorithms, if supported by the chosen mechanism.
Parameters:
minor_status integer, modify
Implementation specific status code.
context_handle gss_ctx_id_t, read
identifies the context on which the message
RFC 1509 GSSAPI - Overview and C bindings September 1993
will be sent
qop_req integer, read, optional
Specifies requested quality of protection.
Callers are encouraged, on portability grounds,
to accept the default quality of protection
offered by the chosen mechanism, which may be
requested by specifying GSS_C_QOP_DEFAULT for
this parameter. If an unsupported protection
strength is requested, gss_sign will return a
major_status of GSS_S_FAILURE.
message_buffer buffer, opaque, read
message to be signed
msg_token buffer, opaque, modify
buffer to receive token
Function value:
GSS status code:
GSS_S_COMPLETE Successful completion
GSS_S_CONTEXT_EXPIRED The context has already expired
GSS_S_CREDENTIALS_EXPIRED The context is recognized, but
associated credentials have expired
GSS_S_NO_CONTEXT The context_handle parameter did not identify a
valid context
GSS_S_FAILURE Failure. See minor_status for more information.
3.9. gss_verify
OM_uint32 gss_verify (
OM_uint32 * minor_status,
gss_ctx_id_t context_handle,
gss_buffer_t message_buffer,
gss_buffer_t token_buffer,
int * qop_state)
Purpose:
Verifies that a cryptographic signature, contained in the token
parameter, fits the supplied message. The qop_state parameter allows
a message recipient to determine the strength of protection that was
applied to the message.
RFC 1509 GSSAPI - Overview and C bindings September 1993
Parameters:
minor_status integer, modify
Mechanism specific status code.
context_handle gss_ctx_id_t, read
identifies the context on which the message
arrived
message_buffer buffer, opaque, read
message to be verified
token_buffer buffer, opaque, read
token associated with message
qop_state integer, modify
quality of protection gained from signature
Function value:
GSS status code:
GSS_S_COMPLETE Successful completion
GSS_S_DEFECTIVE_TOKEN The token failed consistency checks
=16= |