Enhance JWT docs (ntp, new expiration time) (#3709)

* JWT-Docs: Note our longer expiration time.
* Suggest using tlsdate instead of NTP for security reasons.

Fixes #3689
This commit is contained in:
Christopher Grebs 2016-10-10 18:06:53 +02:00 коммит произвёл GitHub
Родитель 714de8c1e0 ad307c697e
Коммит c4fac768ba
1 изменённых файлов: 8 добавлений и 2 удалений

Просмотреть файл

@ -58,12 +58,18 @@ iat
exp
This is a `standard JWT claim`_ indicating
the *expiration time*. It should be a Unix epoch timestamp in UTC time
and must be **no longer than 60 seconds** past the issued at time.
and must be **no longer than five minutes** past the issued at time.
.. versionchanged:: 2016-10-06
We increased the expiration time from 60 seconds to five minutes
to workaround support for large and slow uploads.
.. note::
If you're having trouble authenticating, make sure your system
clock is correct and consider synchronizing it with something like
`NTP (Network Time Protocol) <http://www.ntp.org/>`_.
`tlsdate <https://github.com/ioerror/tlsdate>`_.
Take this JSON object and sign it with the **API secret** you generated on the
`credentials management page`_. You must sign the JWT using the ``HMAC-SHA256``