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

# shishi\_ap\_tktoptionsasn1usage(3)

API function

## NAME

shishi\_ap\_tktoptionsasn1usage - API function

## SYNOPSIS

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

**int shishi\_ap\_tktoptionsasn1usage(Shishi \*** *handle***, Shishi\_ap \*\*** *ap***, Shishi\_tkt \*** *tkt***, int** *options***, Shishi\_asn1** *node***, const char \*** *field***, int** *authenticatorcksumkeyusage***, int** *authenticatorkeyusage***);**

## ARGUMENTS

- Shishi \* handle

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

- Shishi\_ap \*\* ap

  pointer to new structure that holds information about AP exchange

- Shishi\_tkt \* tkt

  ticket to set in newly created AP.

- int options

  AP-REQ options to set in newly created AP.

- Shishi\_asn1 node

  input ASN.1 structure to store as authenticator checksum data.

- const char \* field

  field in ASN.1 structure to use.

- int authenticatorcksumkeyusage

  key usage for checksum in authenticator.

- int authenticatorkeyusage

  key usage for authenticator.

## DESCRIPTION

Create a new AP exchange using **shishi\_ap()**, and set ticket, options and authenticator checksum data from the DER encoding of the ASN.1 field using **shishi\_ap\_set\_tktoptionsasn1usage()**.  A random session key is added to the authenticator, using the same keytype as the ticket.

## RETURN VALUE

Returns SHISHI\_OK iff successful.

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