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

  
 
  

home | help
PKCS15-CRYPT(1) 		  OpenSC Tools			 PKCS15-CRYPT(1)

NAME
     pkcs15-crypt - perform crypto operations using PKCS#15 smart cards

SYNOPSIS
     pkcs15-crypt [OPTIONS]

DESCRIPTION
     The pkcs15-crypt utility can be used from the command line to perform cryp-
     tographic	operations  such  as  computing digital signatures or decrypting
     data, using keys stored on a PKCS#15 compliant smart card.

OPTIONS
     --version,
	 Print the OpenSC package release version.

     --aid aid
	 Specify the AID of the on-card PKCS#15 application to bind to. The  aid
	 must be in hexadecimal form.

     --decipher, -c
	 Decrypt  the  contents of the file specified by the --input option. The
	 result of the decryption operation is written to the file specified  by
	 the --output option. If this option is not given, the decrypted data is
	 printed  to  standard output, displaying non-printable characters using
	 their hex notation xNN (see also --raw).

     --input file, -i file
	 Specifies the input file to use. Defaults to stdin if not specified.

     --key id, -k id
	 Selects the ID of the key to use.

     --output file, -o file
	 Any output will be sent to the specified file. Defaults  to  stdout  if
	 not specified.

     --pin pin, -p pin
	 When  the  cryptographic  operation  requires	a PIN to access the key,
	 pkcs15-crypt will prompt the user for the PIN on  the	terminal.  Using
	 this option allows you to specify the PIN on the command line.

	 Note  that on most operating systems, the command line of a process can
	 be displayed by any user using the ps(1) command. It is therefore a se-
	 curity risk to specify secret information such as PINs on  the  command
	 line. If you specify '-' as PIN, it will be read from STDIN.

     --pkcs1
	 By default, pkcs15-crypt assumes that input data has been padded to the
	 correct  length  (i.e. when computing an RSA signature using a 1024 bit
	 key, the input must be  padded  to  128  bytes  to  match  the  modulus
	 length).  When  giving  the  --pkcs1 option, however, pkcs15-crypt will
	 perform the required padding using the algorithm outlined in  the  PKCS
	 #1 standard version 1.5.

     --raw, -R
	 Outputs raw 8 bit data.

     --reader arg, -r arg
	 Number  of  the  reader  to  use.  By	default, the first reader with a
	 present card is used. If arg is an ATR, the reader with a matching card
	 will be chosen.

     --md5 --sha-1 --sha-224 --sha-256 --sha-384 --sha-512
	 These options tell pkcs15-crypt that the input file is  the  result  of
	 the  specified  hash  operation.  By  default, an MD5 hash is expected.
	 Again, the data must be in binary representation.

     --sign, -s
	 Perform digital signature operation on the data read from a file speci-
	 fied using the --input option. By default, the contents of the file are
	 assumed  to  be  the  result  of  an  MD5  hash  operation.  Note  that
	 pkcs15-crypt expects the data in binary representation, not ASCII.

	 The  digital signature is stored, in binary representation, in the file
	 specified by the --output option. If this option is not given, the sig-
	 nature is printed on standard output, displaying non-printable  charac-
	 ters using their hex notation xNN (see also --raw).

     --signature-format, --f
	 When  signing	with ECDSA key this option indicates to pkcs15-crypt the
	 signature output format. Possible values are 'rs'(default) -- two  con-
	 catenated  integers  (PKCS#11),  'sequence' or 'openssl' -- DER encoded
	 sequence of two integers (OpenSSL).

     --wait, -w
	 Causes pkcs15-crypt to wait for a card insertion.

     --verbose, -v
	 Causes pkcs15-crypt to be more verbose. Specify this flag several times
	 to enable debug output in the OpenSC library.

SEE ALSO
     pkcs15-init(1), pkcs15-tool(1)

AUTHORS
     pkcs15-crypt was written by Juha YrjA<paragraph>lAx <juha.yrjola@iki.fi>.

opensc				   08/29/2026			 PKCS15-CRYPT(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pkcs15-crypt&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help