.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "shishi_kdc_process" 3 "1.0.3" "shishi" "shishi"
.SH NAME
shishi_kdc_process \- API function
.SH SYNOPSIS
.B #include <shishi.h>
.sp
.BI "int shishi_kdc_process(Shishi * " handle ", Shishi_asn1 " kdcreq ", Shishi_asn1 " kdcrep ", Shishi_key * " key ", int " keyusage ", Shishi_asn1 * " enckdcreppart ");"
.SH ARGUMENTS
.IP "Shishi * handle" 12
Shishi handle as allocated by \fBshishi_init()\fP.
.IP "Shishi_asn1 kdcreq" 12
Input variable holding the transmitted KDC\-REQ.
.IP "Shishi_asn1 kdcrep" 12
Input variable holding the received KDC\-REP.
.IP "Shishi_key * key" 12
Input pointet to key for decrypting parts of \fIkdcrep\fP.
.IP "int keyusage" 12
Kerberos key usage code.
.IP "Shishi_asn1 * enckdcreppart" 12
Output pointer for the extracted EncKDCRepPart.
.SH "DESCRIPTION"
Processes a KDC client exchange and extracts a decrypted
EncKDCRepPart, holding details about the received ticket.
Use \fBshishi_kdcrep_get_ticket()\fP to extract the ticket itself.
This function verifies the various conditions that must hold
if the response is to be considered valid.  In particular,
it compares nonces (using \fBshishi_kdc_check_nonce()\fP), and if
the exchange was an AS exchange, it also checks cname and
crealm (using \fBshishi_as_check_cname()\fP, \fBshishi_as_check_crealm()\fP).

Usually \fBshishi_as_process()\fP and \fBshishi_tgs_process()\fP should be
used instead of this call, since they simplify computation of
the decryption key.
.SH "RETURN VALUE"
Returns \fBSHISHI_OK\fP if the KDC client exchange was
successful.  Multiple failure conditions are possible.
.SH "REPORTING BUGS"
Report bugs to <bug-shishi@gnu.org>.
GNU Shishi home page: http://www.gnu.org/software/shishi/
General help using GNU software: http://www.gnu.org/gethelp/
.SH COPYRIGHT
Copyright \(co 2002-2022 Simon Josefsson.
.br
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.
.SH "SEE ALSO"
The full documentation for
.B shishi
is maintained as a Texinfo manual.  If the
.B info
and
.B shishi
programs are properly installed at your site, the command
.IP
.B info shishi
.PP
should give you access to the complete manual.