Skip to content

ioerror/tlsdate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ae396da · May 28, 2015
Jan 7, 2013
Oct 30, 2013
Apr 29, 2015
Sep 17, 2014
May 7, 2013
Apr 29, 2015
Apr 29, 2015
Oct 25, 2014
Sep 18, 2014
Oct 30, 2013
Apr 19, 2013
Oct 22, 2014
May 28, 2015
Apr 20, 2013
Apr 24, 2013
Oct 13, 2014
Jan 18, 2012
Apr 29, 2015
Apr 12, 2013
Nov 1, 2013
Aug 2, 2012
Oct 25, 2014
Oct 22, 2014
Apr 25, 2013
May 28, 2015
Oct 30, 2013
Apr 15, 2013
Sep 18, 2014
Jul 8, 2013
Feb 14, 2013
Jan 4, 2013
Jan 4, 2013
Jan 4, 2013

Repository files navigation

tlsdate: secure parasitic rdate replacement

 tlsdate sets the local clock by securely connecting with TLS to remote
 servers and extracting the remote time out of the secure handshake. Unlike
 ntpdate, tlsdate uses TCP, for instance connecting to a remote HTTPS or TLS
 enabled service, and provides some protection against adversaries that try to
 feed you malicious time information.

On Debian GNU/Linux and related systems, we provide an init.d script that
controls the tlsdated daemon. It will notice network changes and regularly
invoke tlsdate to keep the clock in sync. Start it like so:

  /etc/init.d/tlsdate start


Here is an example an unprivileged user fetching the remote time:

  % tlsdate -V -n -H encrypted.google.com
  Fri Apr 19 17:56:46 PDT 2013


This is an example run - starting as root and dropping to nobody, setting the
clock and printing it:

  % sudo tlsdate -V
  Fri Apr 19 17:57:49 PDT 2013


Here is an example with a custom host and custom port without verification:

  % sudo tlsdate --skip-verification -p 80 -H rgnx.net

Here is an example where a system may not have any kind of RTC at boot. Do the
time warp to restore sanity and do so with a leap of faith:

  % sudo tlsdate -V -l -t
  Fri Apr 19 18:08:03 PDT 2013


Some SSL/TLS services do not provide accurate time in their handshake process;
tlsdate may also be used to fetch time by processing the HTTP Date headers of
HTTP services:

  % sudo tlsdate -V -l -t -w
  Wed Oct 30 18:08:46 CET 2013