Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
tpm2_ticket(1)		    General Commands Manual		tpm2_ticket(1)

       tpm2_ticket(1)  -  Enables  policy  authorization by verifying a	ticket
       that represents a validated authorization that had an  expiration  time
       associated with it.

       tpm2_ticket [OPTIONS]

       tpm2_ticket(1)  -  Enables  policy  authorization by verifying a	ticket
       that represents a validated authorization that had an  expiration  time
       associated with it.

       o -L, --policy=FILE:

	 File to save the compounded policy digest.

       o -S, --session=FILE:

	 The  policy  session  file  generated via the -S option to tpm2_star-

       o -n, --name=FILE:

	 Name of the object that validated the authorization.

       o --ticket=FILE:

	 The ticket file to record the authorization ticket structure.

       o --timeout=FILE:

	 The file path to record the timeout structure returned.

       o -q, --qualification=FILE_OR_HEX_STR:

	 Optional, the policy qualifier	data that the signer can choose	to in-
	 clude in the signature.  Can be either	a hex string or	path.

       This  collection	of options are common to many programs and provide in-
       formation that many users may expect.

       o -h, --help=[man|no-man]: Display the tools manpage.  By  default,  it
	 attempts  to  invoke  the  manpager for the tool, however, on failure
	 will output a short tool summary.  This is the	same behavior  if  the
	 "man"	option argument	is specified, however if explicit "man"	is re-
	 quested, the tool will	provide	errors from man	 on  stderr.   If  the
	 "no-man"  option  if  specified, or the manpager fails, the short op-
	 tions will be output to stdout.

	 To successfully use the manpages feature requires the manpages	to  be
	 installed or on MANPATH, See man(1) for more details.

       o -v,  --version:  Display version information for this tool, supported
	 tctis and exit.

       o -V, --verbose:	Increase the information that the tool prints  to  the
	 console  during  its  execution.  When	using this option the file and
	 line number are printed.

       o -Q, --quiet: Silence normal tool output to stdout.

       o -Z, --enable-errata: Enable the application of	errata fixups.	Useful
	 if  an	 errata	fixup needs to be applied to commands sent to the TPM.
	 Defining the environment TPM2TOOLS_ENABLE_ERRATA is equivalent.   in-
	 formation many	users may expect.

TCTI Configuration
       The  TCTI  or  "Transmission  Interface"	is the communication mechanism
       with the	TPM.  TCTIs can	be changed for communication with TPMs	across
       different mediums.

       To control the TCTI, the	tools respect:

       1. The command line option -T or	--tcti

       2. The environment variable: TPM2TOOLS_TCTI.

       Note:  The  command  line option	always overrides the environment vari-

       The current known TCTIs are:

       o tabrmd	    -	  The	  resource     manager,	    called	tabrmd
	 (	  Note that tabrmd and
	 abrmd as a tcti name are synonymous.

       o mssim - Typically used	for communicating to the TPM software  simula-

       o device	- Used when talking directly to	a TPM device file.

       o none  - Do not	initalize a connection with the	TPM.  Some tools allow
	 for off-tpm options and thus support not using	a TCTI.	 Tools that do
	 not  support  it  will	error when attempted to	be used	without	a TCTI
	 connection.  Does not support ANY options and MUST  BE	 presented  as
	 the exact text	of "none".

       The  arguments  to  either  the	command	line option or the environment
       variable	are in the form:


       Specifying an empty string for  either  the  <tcti-name>	 or  <tcti-op-
       tion-config> results in the default being used for that portion respec-

   TCTI	Defaults
       When a TCTI is not specified, the default TCTI is  searched  for	 using
       dlopen(3)  semantics.   The  tools  will	 search	for tabrmd, device and
       mssim TCTIs IN THAT ORDER and USE THE FIRST ONE FOUND.  You  can	 query
       what TCTI will be chosen	as the default by using	the -v option to print
       the version information.	 The "default-tcti" key-value pair will	 indi-
       cate which of the aforementioned	TCTIs is the default.

   Custom TCTIs
       Any TCTI	that implements	the dynamic TCTI interface can be loaded.  The
       tools internally	use dlopen(3), and the raw tcti-name value is used for
       the lookup.  Thus, this could be	a path to the shared library, or a li-
       brary name as understood	by dlopen(3) semantics.

       This collection of options are used to configure	the various known TCTI
       modules available:

       o device: For the device	TCTI, the TPM character	device file for	use by
	 the device TCTI can be	specified.  The	default	is /dev/tpm0.

	 Example:   -T	 device:/dev/tpm0   or	 export	   TPM2TOOLS_TCTI="de-

       _o mssim:	 For  the  mssim  TCTI,	the domain name	or IP address and port
	 number	used by	the simulator  can  be	specified.   The  default  are and 2321.

	 Example:  -T  mssim:host=localhost,port=2321  or export TPM2TOOLS_TC-

       _o abrmd:	For the	abrmd TCTI, the	configuration string format is	a  se-
	 ries  of  simple  key value pairs separated by	a ',' character.  Each
	 key and value string are separated by a '=' character.

	 o TCTI	abrmd supports two keys:

	   1. 'bus_name' : The name of	the  tabrmd  service  on  the  bus  (a

	   2. 'bus_type' : The type of the dbus	instance (a string) limited to
	      'session'	and 'system'.

	 Specify the tabrmd tcti name and a config string of  bus_name=com.ex-


	 Specify the default (abrmd) tcti and a	config string of bus_type=ses-


	 NOTE: abrmd and tabrmd	are synonymous.	 the various known  TCTI  mod-

       Authorize  a TPM	operation on an	object whose authorization is bound to
       specific	signing	authority.

   Create the signing authority	and load the verification key
	      openssl genrsa -out private.pem 2048

	      openssl rsa -in private.pem -outform PEM -pubout -out public.pem

	      tpm2_loadexternal	-C o -G	rsa -u public.pem -c signing_key.ctx \

   Generate signature with the expiry time

	      echo $EXPIRYTIME | xxd -r	-p | \
	      openssl dgst -sha256 -sign private.pem -out signature.dat

   Create the policy
	      tpm2_startauthsession -S session.ctx

	      tpm2_policysigned	-S session.ctx -g sha256 -s signature.dat -f rsassa \
	      -c signing_key.ctx -L policy.signed

	      tpm2_flushcontext	session.ctx

   Create a sealing object
	      tpm2_createprimary -C o -c prim.ctx -Q

	      echo "plaintext" > secret.dat

	      tpm2_create -u -r	sealing_key.priv -c sealing_key.ctx \
	      -C prim.ctx -i secret.dat	-L policy.signed -Q

   Create ticket-able policy
	      tpm2_startauthsession -S session.ctx --nonce-tpm=nonce.test --policy-session

	      {	cat nonce.test & echo $EXPIRYTIME | xxd	-r -p; } | \
	      openssl dgst -sha256 -sign private.pem -out signature.dat

	      tpm2_policysigned	-S session.ctx -g sha256 -s signature.dat -f rsassa \
	      -c signing_key.ctx -x nonce.test --ticket	tic.ket	--timeout time.out \
	      -t 0xFFFFFE0C

	      tpm2_flushcontext	session.ctx

   Test	with policyticket instead of policysigned
	      tpm2_startauthsession -S session.ctx --policy-session

	      tpm2_policyticket	-S session.ctx -n --ticket tic.ket \
	      --timeout	time.out

	      tpm2_unseal -p session:session.ctx -c sealing_key.ctx

       Tools can return	any of the following codes:

       o 0 - Success.

       o 1 - General non-specific error.

       o 2 - Options handling error.

       o 3 - Authentication error.

       o 4 - TCTI related error.

       o 5 - Non supported scheme.  Applicable to tpm2_testparams.

       It expects a session to be already established  via  tpm2_startauthses-
       sion(1) and requires one	of the following:

       o direct	device access

       o extended session support with tpm2-abrmd.

       Without	it, most resource managers will	not save session state between
       command invocations.

       Github Issues (

       See the Mailing List (

tpm2-tools							tpm2_ticket(1)


Want to link to this manual page? Use this URL:

home | help