Next: SAFE and PRIV Functions, Previous: Ticket Set Functions, Up: Programming Manual [Contents][Index]
The “AP-REQ” and “AP-REP” are ASN.1 structures used by application client and servers to prove to each other who they are. The structures contain auxilliary information, together with an authenticator (see Authenticator Functions) which is the real cryptographic proof. The following illustrates the AP-REQ and AP-REP ASN.1 structures.
AP-REQ ::= [APPLICATION 14] SEQUENCE {
pvno [0] INTEGER (5),
msg-type [1] INTEGER (14),
ap-options [2] APOptions,
ticket [3] Ticket,
authenticator [4] EncryptedData {Authenticator,
{ keyuse-pa-TGSReq-authenticator
| keyuse-APReq-authenticator }}
}
AP-REP ::= [APPLICATION 15] SEQUENCE {
pvno [0] INTEGER (5),
msg-type [1] INTEGER (15),
enc-part [2] EncryptedData {EncAPRepPart,
{ keyuse-EncAPRepPart }}
}
EncAPRepPart ::= [APPLICATION 27] SEQUENCE {
ctime [0] KerberosTime,
cusec [1] Microseconds,
subkey [2] EncryptionKey OPTIONAL,
seq-number [3] UInt32 OPTIONAL
}
handle: shishi handle as allocated by shishi_init().
ap: pointer to new structure that holds information about AP exchange
Description: Create a new AP exchange with a random subkey of the default
encryption type from configuration. Note that there is no
guarantee that the receiver will understand that key type, you
should probably use shishi_ap_etype() or shishi_ap_nosubkey()
instead. In the future, this function will likely behave as
shishi_ap_nosubkey() and shishi_ap_nosubkey() will be removed.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
ap: pointer to new structure that holds information about AP exchange
etype: encryption type of newly generated random subkey.
Description: Create a new AP exchange with a random subkey of indicated encryption type.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
ap: pointer to new structure that holds information about AP exchange
Description: Create a new AP exchange without subkey in authenticator.
Return value: Returns SHISHI_OK iff successful.
ap: structure that holds information about AP exchange
Description: Deallocate resources associated with AP exchange. This should be called by the application when it no longer need to utilize the AP exchange handle.
ap: structure that holds information about AP exchange
tkt: ticket to set in AP.
options: AP-REQ options to set in AP.
Description: Set the ticket (see shishi_ap_tkt_set()) and set the AP-REQ
apoptions (see shishi_apreq_options_set()).
Return value: Returns SHISHI_OK iff successful.
ap: structure that holds information about AP exchange
tkt: ticket to set in AP.
options: AP-REQ options to set in AP.
data: input array with data to checksum in Authenticator.
len: length of input array with data to checksum in Authenticator.
Description: Set the ticket (see shishi_ap_tkt_set()) and set the AP-REQ
apoptions (see shishi_apreq_options_set()) and set the
Authenticator checksum data.
Return value: Returns SHISHI_OK iff successful.
ap: structure that holds information about AP exchange
tkt: ticket to set in AP.
options: AP-REQ options to set in AP.
cksumtype: authenticator checksum type to set in AP.
data: input array with data to store in checksum field in Authenticator.
len: length of input array with data to store in checksum field in
Authenticator.
Description: Set the ticket (see shishi_ap_tkt_set()) and set the AP-REQ
apoptions (see shishi_apreq_options_set()) and set the raw
Authenticator checksum data.
Return value: Returns SHISHI_OK iff successful.
ap: structure that holds information about AP exchange
tkt: ticket to set in AP.
options: AP-REQ options to set in AP.
node: input ASN.1 structure to store as authenticator checksum data.
field: field in ASN.1 structure to use.
authenticatorcksumkeyusage: key usage for checksum in authenticator.
authenticatorkeyusage: key usage for authenticator.
Description: Set ticket, options and authenticator checksum data using
shishi_ap_set_tktoptionsdata(). The authenticator checksum data is
the DER encoding of the ASN.1 field provided.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
ap: pointer to new structure that holds information about AP exchange
tkt: ticket to set in newly created AP.
options: AP-REQ options to set in newly created AP.
Description: Create a new AP exchange using shishi_ap(), and set the ticket and
AP-REQ apoptions using shishi_ap_set_tktoptions(). A random
session key is added to the authenticator, using the same keytype
as the ticket.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
ap: pointer to new structure that holds information about AP exchange
tkt: ticket to set in newly created AP.
options: AP-REQ options to set in newly created AP.
data: input array with data to checksum in Authenticator.
len: length of input array with data to checksum in Authenticator.
Description: Create a new AP exchange using shishi_ap(), and set the ticket,
AP-REQ apoptions and the Authenticator checksum data using
shishi_ap_set_tktoptionsdata(). A random session key is added to
the authenticator, using the same keytype as the ticket.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
ap: pointer to new structure that holds information about AP exchange
tkt: ticket to set in newly created AP.
options: AP-REQ options to set in newly created AP.
cksumtype: authenticator checksum type to set in AP.
data: input array with data to store in checksum field in Authenticator.
len: length of input array with data to store in checksum field in
Authenticator.
Description: Create a new AP exchange using shishi_ap(), and set the ticket,
AP-REQ apoptions and the raw Authenticator checksum data field
using shishi_ap_set_tktoptionsraw(). A random session key is added
to the authenticator, using the same keytype as the ticket.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
ap: pointer to new structure that holds information about AP exchange
etype: encryption type of newly generated random subkey.
tkt: ticket to set in newly created AP.
options: AP-REQ options to set in newly created AP.
data: input array with data to checksum in Authenticator.
len: length of input array with data to checksum in Authenticator.
Description: Create a new AP exchange using shishi_ap(), and set the ticket,
AP-REQ apoptions and the Authenticator checksum data using
shishi_ap_set_tktoptionsdata(). A random session key is added to
the authenticator, using the same keytype as the ticket.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
ap: pointer to new structure that holds information about AP exchange
tkt: ticket to set in newly created AP.
options: AP-REQ options to set in newly created AP.
node: input ASN.1 structure to store as authenticator checksum data.
field: field in ASN.1 structure to use.
authenticatorcksumkeyusage: key usage for checksum in authenticator.
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.
ap: structure that holds information about AP exchange
Description: Get Ticket from AP exchange.
Return value: Returns the ticket from the AP exchange, or NULL if not yet set or an error occured.
ap: structure that holds information about AP exchange
tkt: ticket to store in AP.
Description: Set the Ticket in the AP exchange.
ap: structure that holds information about AP exchange
out: output array that holds authenticator checksum data.
len: on input, maximum length of output array that holds
authenticator checksum data, on output actual length of
output array that holds authenticator checksum data.
Description: Get checksum data from Authenticator.
Return value: Returns SHISHI_OK if successful, or
SHISHI_TOO_SMALL_BUFFER if buffer provided was too small (then len
will hold necessary buffer size).
ap: structure that holds information about AP exchange
authenticatorcksumdata: input array with data to compute checksum
on and store in Authenticator in AP-REQ.
authenticatorcksumdatalen: length of input array with data to
compute checksum on and store in Authenticator in AP-REQ.
Description: Set the Authenticator Checksum Data in the AP exchange. This is the data that will be checksumed, and the checksum placed in the checksum field. It is not the actual checksum field. See also shishi_ap_authenticator_cksumraw_set.
ap: structure that holds information about AP exchange
authenticatorcksumtype: authenticator checksum type to set in AP.
authenticatorcksumraw: input array with authenticator checksum
field value to set in Authenticator in AP-REQ.
authenticatorcksumrawlen: length of input array with
authenticator checksum field value to set in Authenticator in AP-REQ.
Description: Set the Authenticator Checksum Data in the AP exchange. This is the actual checksum field, not data to compute checksum on and then store in the checksum field. See also shishi_ap_authenticator_cksumdata_set.
ap: structure that holds information about AP exchange
Description: Get the Authenticator Checksum Type in the AP exchange.
Return value: Return the authenticator checksum type.
ap: structure that holds information about AP exchange
cksumtype: authenticator checksum type to set in AP.
Description: Set the Authenticator Checksum Type in the AP exchange.
ap: structure that holds information about AP exchange
Description: Get ASN.1 Authenticator structure from AP exchange.
Return value: Returns the Authenticator from the AP exchange, or NULL if not yet set or an error occured.
ap: structure that holds information about AP exchange
authenticator: authenticator to store in AP.
Description: Set the Authenticator in the AP exchange.
ap: structure that holds information about AP exchange
Description: Get ASN.1 AP-REQ structure from AP exchange.
Return value: Returns the AP-REQ from the AP exchange, or NULL if not yet set or an error occured.
ap: structure that holds information about AP exchange
apreq: apreq to store in AP.
Description: Set the AP-REQ in the AP exchange.
ap: structure that holds information about AP exchange
out: pointer to output array with der encoding of AP-REQ.
outlen: pointer to length of output array with der encoding of AP-REQ.
Description: Build AP-REQ using shishi_ap_req_build() and DER encode it. out
is allocated by this function, and it is the responsibility of
caller to deallocate it.
Return value: Returns SHISHI_OK iff successful.
ap: structure that holds information about AP exchange
der: input array with DER encoded AP-REQ.
derlen: length of input array with DER encoded AP-REQ.
Description: DER decode AP-REQ and set it AP exchange. If decoding fails, the AP-REQ in the AP exchange is lost.
Return value: Returns SHISHI_OK.
ap: structure that holds information about AP exchange
Description: Checksum data in authenticator and add ticket and authenticator to AP-REQ.
Return value: Returns SHISHI_OK iff successful.
ap: structure that holds information about AP exchange
Description: Decode ticket in AP-REQ and set the Ticket fields in the AP exchange.
Return value: Returns SHISHI_OK iff successful.
ap: structure that holds information about AP exchange
key: cryptographic key used to decrypt ticket in AP-REQ.
keyusage: key usage to use during decryption, for normal
AP-REQ’s this is normally SHISHI_KEYUSAGE_APREQ_AUTHENTICATOR,
for AP-REQ’s part of TGS-REQ’s, this is normally
SHISHI_KEYUSAGE_TGSREQ_APREQ_AUTHENTICATOR.
Description: Decrypt ticket in AP-REQ using supplied key and decrypt Authenticator in AP-REQ using key in decrypted ticket, and on success set the Ticket and Authenticator fields in the AP exchange.
Return value: Returns SHISHI_OK iff successful.
ap: structure that holds information about AP exchange
key: cryptographic key used to decrypt ticket in AP-REQ.
Description: Decrypt ticket in AP-REQ using supplied key and decrypt Authenticator in AP-REQ using key in decrypted ticket, and on success set the Ticket and Authenticator fields in the AP exchange.
Return value: Returns SHISHI_OK iff successful.
ap: structure that holds information about AP exchange
apreq: output AP-REQ variable.
Description: Build AP-REQ using shishi_ap_req_build() and return it.
Return value: Returns SHISHI_OK iff successful.
ap: structure that holds information about AP exchange
Description: Extract the application key from AP. If subkeys are used, it is taken from the Authenticator, otherwise the session key is used.
Return value: Return application key from AP.
ap: structure that holds information about AP exchange
Description: Get ASN.1 AP-REP structure from AP exchange.
Return value: Returns the AP-REP from the AP exchange, or NULL if not yet set or an error occured.
ap: structure that holds information about AP exchange
aprep: aprep to store in AP.
Description: Set the AP-REP in the AP exchange.
ap: structure that holds information about AP exchange
out: output array with newly allocated DER encoding of AP-REP.
outlen: length of output array with DER encoding of AP-REP.
Description: Build AP-REP using shishi_ap_rep_build() and DER encode it. out
is allocated by this function, and it is the responsibility of
caller to deallocate it.
Return value: Returns SHISHI_OK iff successful.
ap: structure that holds information about AP exchange
der: input array with DER encoded AP-REP.
derlen: length of input array with DER encoded AP-REP.
Description: DER decode AP-REP and set it AP exchange. If decoding fails, the AP-REP in the AP exchange remains.
Return value: Returns SHISHI_OK.
ap: structure that holds information about AP exchange
Description: Checksum data in authenticator and add ticket and authenticator to AP-REP.
Return value: Returns SHISHI_OK iff successful.
ap: structure that holds information about AP exchange
aprep: output AP-REP variable.
Description: Build AP-REP using shishi_ap_rep_build() and return it.
Return value: Returns SHISHI_OK iff successful.
ap: structure that holds information about AP exchange
Description: Verify AP-REP compared to Authenticator.
Return value: Returns SHISHI_OK, SHISHI_APREP_VERIFY_FAILED or an error.
ap: structure that holds information about AP exchange
der: input array with DER encoded AP-REP.
derlen: length of input array with DER encoded AP-REP.
Description: DER decode AP-REP and set it in AP exchange using
shishi_ap_rep_der_set() and verify it using shishi_ap_rep_verify().
Return value: Returns SHISHI_OK, SHISHI_APREP_VERIFY_FAILED or an error.
ap: structure that holds information about AP exchange
aprep: input AP-REP.
Description: Set the AP-REP in the AP exchange using shishi_ap_rep_set() and
verify it using shishi_ap_rep_verify().
Return value: Returns SHISHI_OK, SHISHI_APREP_VERIFY_FAILED or an error.
ap: structure that holds information about AP exchange
Description: Get ASN.1 EncAPRepPart structure from AP exchange.
Return value: Returns the EncAPREPPart from the AP exchange, or NULL if not yet set or an error occured.
ap: structure that holds information about AP exchange
encapreppart: EncAPRepPart to store in AP.
Description: Set the EncAPRepPart in the AP exchange.
option: enumerated AP-Option type, see Shishi_apoptions.
Description: Convert AP-Option type to AP-Option name string. Note that option must be just one of the AP-Option types, it cannot be an binary ORed indicating several AP-Options.
Return value: Returns static string with name of AP-Option that must not be deallocated, or "unknown" if AP-Option was not understood.
str: zero terminated character array with name of AP-Option, e.g. "use-session-key".
Description: Convert AP-Option name to AP-Option type.
Return value: Returns enumerated type member corresponding to AP-Option, or 0 if string was not understood.
handle: shishi handle as allocated by shishi_init().
Description: This function creates a new AP-REQ, populated with some default values.
Return value: Returns the AP-REQ or NULL on failure.
handle: shishi handle as allocated by shishi_init().
fh: file handle open for writing.
apreq: AP-REQ to print.
Description: Print ASCII armored DER encoding of AP-REQ to file.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
fh: file handle open for writing.
apreq: AP-REQ to save.
Description: Save DER encoding of AP-REQ to file.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
apreq: AP-REQ to save.
filetype: input variable specifying type of file to be written,
see Shishi_filetype.
filename: input variable with filename to write to.
Description: Write AP-REQ to file in specified TYPE. The file will be truncated if it exists.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
fh: file handle open for reading.
apreq: output variable with newly allocated AP-REQ.
Description: Read ASCII armored DER encoded AP-REQ from file and populate given variable.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
fh: file handle open for reading.
apreq: output variable with newly allocated AP-REQ.
Description: Read DER encoded AP-REQ from file and populate given variable.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
apreq: output variable with newly allocated AP-REQ.
filetype: input variable specifying type of file to be read,
see Shishi_filetype.
filename: input variable with filename to read from.
Description: Read AP-REQ from file in specified TYPE.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
apreq: AP-REQ to add authenticator field to.
etype: encryption type used to encrypt authenticator.
kvno: version of the key used to encrypt authenticator.
buf: input array with encrypted authenticator.
buflen: size of input array with encrypted authenticator.
Description: Set the encrypted authenticator field in the AP-REP. The encrypted
data is usually created by calling shishi_encrypt() on the DER
encoded authenticator. To save time, you may want to use
shishi_apreq_add_authenticator() instead, which calculates the
encrypted data and calls this function in one step.
Return value: Returns SHISHI_OK on success.
handle: shishi handle as allocated by shishi_init().
apreq: AP-REQ to add authenticator field to.
key: key to to use for encryption.
keyusage: cryptographic key usage value to use in encryption.
authenticator: authenticator as allocated by shishi_authenticator().
Description: Encrypts DER encoded authenticator using key and store it in the AP-REQ.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
apreq: AP-REQ to add ticket field to.
ticket: input ticket to copy into AP-REQ ticket field.
Description: Copy ticket into AP-REQ.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
apreq: AP-REQ to get options from.
flags: Output integer containing options from AP-REQ.
Description: Extract the AP-Options from AP-REQ into output integer.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
apreq: AP-REQ as allocated by shishi_apreq().
Description: Return non-0 iff the "Use session key" option is set in the AP-REQ.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
apreq: AP-REQ as allocated by shishi_apreq().
Description: Return non-0 iff the "Mutual required" option is set in the AP-REQ.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
apreq: AP-REQ as allocated by shishi_apreq().
options: Options to set in AP-REQ.
Description: Set the AP-Options in AP-REQ to indicate integer.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
apreq: AP-REQ as allocated by shishi_apreq().
option: Options to add in AP-REQ.
Description: Add the AP-Options in AP-REQ. Options not set in input parameter option are preserved in the AP-REQ.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
apreq: AP-REQ as allocated by shishi_apreq().
option: Options to remove from AP-REQ.
Description: Remove the AP-Options from AP-REQ. Options not set in input parameter option are preserved in the AP-REQ.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
apreq: AP-REQ variable to get value from.
etype: output variable that holds the value.
Description: Extract AP-REQ.authenticator.etype.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
apreq: AP-REQ variable to get ticket from.
ticket: output variable to hold extracted ticket.
Description: Extract ticket from AP-REQ.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
Description: This function creates a new AP-REP, populated with some default values.
Return value: Returns the authenticator or NULL on failure.
handle: shishi handle as allocated by shishi_init().
fh: file handle open for writing.
aprep: AP-REP to print.
Description: Print ASCII armored DER encoding of AP-REP to file.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
fh: file handle open for writing.
aprep: AP-REP to save.
Description: Save DER encoding of AP-REP to file.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
aprep: AP-REP to save.
filetype: input variable specifying type of file to be written,
see Shishi_filetype.
filename: input variable with filename to write to.
Description: Write AP-REP to file in specified TYPE. The file will be truncated if it exists.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
fh: file handle open for reading.
aprep: output variable with newly allocated AP-REP.
Description: Read ASCII armored DER encoded AP-REP from file and populate given variable.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
fh: file handle open for reading.
aprep: output variable with newly allocated AP-REP.
Description: Read DER encoded AP-REP from file and populate given variable.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
aprep: output variable with newly allocated AP-REP.
filetype: input variable specifying type of file to be read,
see Shishi_filetype.
filename: input variable with filename to read from.
Description: Read AP-REP from file in specified TYPE.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
aprep: AP-REP variable to get value from.
etype: output variable that holds the value.
Description: Extract AP-REP.enc-part.etype.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
Description: This function creates a new EncAPRepPart, populated with some default values. It uses the current time as returned by the system for the ctime and cusec fields.
Return value: Returns the encapreppart or NULL on failure.
handle: shishi handle as allocated by shishi_init().
fh: file handle open for writing.
encapreppart: EncAPRepPart to print.
Description: Print ASCII armored DER encoding of EncAPRepPart to file.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
fh: file handle open for writing.
encapreppart: EncAPRepPart to save.
Description: Save DER encoding of EncAPRepPart to file.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
encapreppart: EncAPRepPart to save.
filetype: input variable specifying type of file to be written,
see Shishi_filetype.
filename: input variable with filename to write to.
Description: Write EncAPRepPart to file in specified TYPE. The file will be truncated if it exists.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
fh: file handle open for reading.
encapreppart: output variable with newly allocated EncAPRepPart.
Description: Read ASCII armored DER encoded EncAPRepPart from file and populate given variable.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
fh: file handle open for reading.
encapreppart: output variable with newly allocated EncAPRepPart.
Description: Read DER encoded EncAPRepPart from file and populate given variable.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
encapreppart: output variable with newly allocated EncAPRepPart.
filetype: input variable specifying type of file to be read,
see Shishi_filetype.
filename: input variable with filename to read from.
Description: Read EncAPRepPart from file in specified TYPE.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
encapreppart: input EncAPRepPart variable.
key: newly allocated key.
Description: Extract the subkey from the encrypted AP-REP part.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
encapreppart: EncAPRepPart as allocated by shishi_encapreppart().
t: newly allocated zero-terminated character array with client time.
Description: Extract client time from EncAPRepPart.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
encapreppart: EncAPRepPart as allocated by shishi_encapreppart().
t: string with generalized time value to store in EncAPRepPart.
Description: Store client time in EncAPRepPart.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
encapreppart: EncAPRepPart as allocated by shishi_encapreppart().
cusec: output integer with client microseconds field.
Description: Extract client microseconds field from EncAPRepPart.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
encapreppart: EncAPRepPart as allocated by shishi_encapreppart().
cusec: client microseconds to set in authenticator, 0-999999.
Description: Set the cusec field in the Authenticator.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
encapreppart: EncAPRepPart as allocated by shishi_encapreppart().
seqnumber: output integer with sequence number field.
Description: Extract sequence number field from EncAPRepPart.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
encapreppart: encapreppart as allocated by shishi_encapreppart().
Description: Remove sequence number field in EncAPRepPart.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
encapreppart: encapreppart as allocated by shishi_encapreppart().
seqnumber: integer with sequence number field to store in encapreppart.
Description: Store sequence number field in EncAPRepPart.
Return value: Returns SHISHI_OK iff successful.
handle: shishi handle as allocated by shishi_init().
encapreppart: EncAPRepPart as allocated by shishi_encapreppart().
authenticator: Authenticator to copy time fields from.
Description: Copy time fields from Authenticator into EncAPRepPart.
Return value: Returns SHISHI_OK iff successful.
Next: SAFE and PRIV Functions, Previous: Ticket Set Functions, Up: Programming Manual [Contents][Index]