---
name: "shishi_kdc_process"
section: "3"
platform: "linux"
package: "shishi-doc"
version: "1.0.3-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/shishi_kdc_process"
---

# shishi\_kdc\_process(3)

API function

## NAME

shishi\_kdc\_process - API function

## SYNOPSIS

**#include \<shishi.h\>**

**int shishi\_kdc\_process(Shishi \*** *handle***, Shishi\_asn1** *kdcreq***, Shishi\_asn1** *kdcrep***, Shishi\_key \*** *key***, int** *keyusage***, Shishi\_asn1 \*** *enckdcreppart***);**

## ARGUMENTS

- Shishi \* handle

  Shishi handle as allocated by **shishi\_init()**.

- Shishi\_asn1 kdcreq

  Input variable holding the transmitted KDC-REQ.

- Shishi\_asn1 kdcrep

  Input variable holding the received KDC-REP.

- Shishi\_key \* key

  Input pointet to key for decrypting parts of *kdcrep*.

- int keyusage

  Kerberos key usage code.

- Shishi\_asn1 \* enckdcreppart

  Output pointer for the extracted EncKDCRepPart.

## DESCRIPTION

Processes a KDC client exchange and extracts a decrypted EncKDCRepPart, holding details about the received ticket. Use **shishi\_kdcrep\_get\_ticket()** 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 **shishi\_kdc\_check\_nonce()**), and if the exchange was an AS exchange, it also checks cname and crealm (using **shishi\_as\_check\_cname()**, **shishi\_as\_check\_crealm()**).

Usually **shishi\_as\_process()** and **shishi\_tgs\_process()** should be used instead of this call, since they simplify computation of the decryption key.

## RETURN VALUE

Returns **SHISHI\_OK** if the KDC client exchange was successful.  Multiple failure conditions are possible.

## 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/

## COPYRIGHT

Copyright © 2002-2022 Simon Josefsson.\
 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.

## SEE ALSO

The full documentation for **shishi** is maintained as a Texinfo manual.  If the **info** and **shishi** programs are properly installed at your site, the command

-

  **info shishi**

should give you access to the complete manual.