logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

pt-tls-client - Simple client using PT-TLS to collect integrity information

Description

pt-tls-client  is  a  simple  client  using the PT-TLS (RFC 6876) transport protocol to collect integrity
       measurements on the client platform. PT-TLS does an initial TLS handshake with  certificate-based  server
       authentication and optional certificate-based client authentication.  Alternatively simple password-based
       SASL client authentication protected by TLS can be used.

       Attribute  requests  and  integrity measurements are exchanged via the PA-TNC (RFC 5792) message protocol
       between any number of Integrity Measurement Verifiers (IMVs) residing on the  remote  PT-TLS  server  and
       multiple  Integrity  Measurement Collectors (IMCs) loaded dynamically by the PT-TLS client according to a
       list defined by /etc/tnc_config. PA-TNC messages that  contain  one  or  several  PA-TNC  attributes  are
       multiplexed  into  PB-TNC  (RFC 5793) client or server data batches which in turn are transported via PT-
       TLS.

Examples

       Connect to a PT-TLS server using certificate-based authentication, storing the private  ECDSA  key  in  a
       file:

         pt-tls-client --connect pdp.example.com --cert ca.crt \
                       --cert client.crt --key client.key --key-type ecdsa

       Connect to a PT-TLS server using certificate-based authentication, storing the private key in a smartcard
       or a TPM 2.0 Trusted Platform Module:

         pt-tls-client --connect pdp.example.com --cert ca.crt \
                       --cert client.crt --keyid 0x81010002

       Connect to a PT-TLS server listening on port 443, using SASL password-based authentication:

         pt-tls-client --connect pdp.example.com --port 443 --cert ca.crt \
                       --client jane --password p2Nl9trKlb

Files

       /etc/tnc_config

Name

       pt-tls-client - Simple client using PT-TLS to collect integrity information

Options

-h,--help
              Prints usage information and a short summary of the available commands.

       -c,--connecthostname|address
              Set the hostname or IP address of the PT-TLS server.

       -p,--portport
              Set the port of the PT-TLS server, default: 271.

       -x,--certfile
              Set the path to an X.509 certificate file. This option can be repeated to load multiple client and
              CA certificates.

       -X,--certidhex
              Set the handle of the certificate stored in a smartcard or a TPM 2.0 Trusted Platform Module.

       -k,--keyfile
              Set the path to the client's PKCS#1 or PKCS#8 private key file

       -t,--key-typetype
              Define the type of the private key if stored in PKCS#1 format. Can be omitted with PKCS#8 keys.

       -K,--keyidhex
              Set the keyid of the private key stored in a smartcard or a TPM 2.0 Trusted Platform Module.

       -i,--clientclient-id
              Set the username or client ID of the client required for password-based SASL authentication.

       -s,--secretpassword
              Set the preshared secret or client password required for password-based SASL authentication.

       -q,--mutual
              Enable mutual attestation between PT-TLS client and PT-TLS server.

       -v,--debuglevel
              Set debug level, default: 1.

       -q,--quiet
              Disable debug output to stderr.

       -+,--optionsfile
              Read command line options from file.

See Also

strongswan.conf(5)

5.9.13                                             2018-11-20                                   PT-TLS-CLIENT(1)

Synopsis

pt-tls-client--connecthostname|address [--portport] [--certidhex|--certfile]+ [--keyidhex|--keyfile] [--key-typersa|ecdsa] [--clientclient-id] [--secretpassword] [--mutual]
                     [--optionsfilename] [--quiet] [--debuglevel]

       pt-tls-client-h | --help

See Also