diff --git a/doc/xca-doc.tgz b/doc/xca-doc.tgz index d447c76d..92ab36bf 100644 Binary files a/doc/xca-doc.tgz and b/doc/xca-doc.tgz differ diff --git a/doc/xca.sgml b/doc/xca.sgml index 64b7c17f..5f4fe251 100644 --- a/doc/xca.sgml +++ b/doc/xca.sgml @@ -7,7 +7,7 @@ (c) by Christian Hohnstädt, christian@hohnstaedt.de -August 2015 - Version 1.3.1 +January 2018 - Version 1.4.1 @@ -90,7 +90,7 @@ other applications. -Copyright (C) 2001 - 2015 Christian Hohnstaedt. +Copyright (C) 2001 - 2018 Christian Hohnstaedt. All rights reserved. @@ -124,10 +124,10 @@ ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. This program links to software with different licenses from: - - http://www.openssl.org which includes cryptographic software + - https://www.openssl.org which includes cryptographic software written by Eric Young (eay@cryptsoft.com)" - - http://www.trolltech.com + - https://www.qt.io/ @@ -207,6 +207,44 @@ It does neither need nor use the parameters. Applications like OpenVPN however need them and so XCA provides this functionality for users convenience. +Entropy sources for XCA + +

+ +Entropy is a very important topic for key generation. +OpenSSL comes with a good pseudo random number generator. +XCA seeds it very thoroughly. + + During startup + + The OpenSSL seeding mechanism RAND_poll(). + It uses /dev/urandom where possible and the + screen content on Windows. + XCA also tries to pull at most 256bit from /dev/random and /dev/hwrng each. + A .rnd state file in the XCA application directory is + read on startup and erased afterwards to avoid replays. + + Before any key or parameter generation a "reseeding" + is done. Some say reseeding is not neccessary, but + all say it does not harm. + + XCA collects entropy by mouse and keyboard events and its timing. + (See main.cpp: bool XCA_application::eventFilter()) + We are on a desktop host after all. + 256bit from /dev/urandom (unix/Mac) + + A .rnd state file in the XCA application directory + is written whenever XCA finishes. + + When managing a token or generating a key on a token that supports + C_GenerateRandom and C_SeedRandom, XCA will: + + Seed the token with own random data. + Seed the OpenSSL CSPRNG by random bytes from the token. + + + + @@ -1406,6 +1444,11 @@ The oids.txt file is searched in reversed order and all Installation directory e.g.: C:\Programs\xca +

+ +New OIDs

All Object IDs that are not official, but belong to your company or organisation can be added in the file oids.txt. All possible locations for this file are searched and all oids.txt files @@ -1418,6 +1461,10 @@ Lines starting with a # are ignored.

+OID lists + +

+ The files containing OID lists (eku.txt, dn.txt, aia.txt) are handled in a different way, only the first one found is used. The format of this files is one entry per line. The entry can be either the @@ -1427,6 +1474,25 @@ Lines starting with a # are ignored. If this files shall contain new inofficial OIDs, they must be also mentioned in one of the oids.txt files. +

+ +Adding your company specific Subject entry + +

+ +If you want to / need to add your own company specific subject +entry to your certificate it can be done without recompiling XCA. + + + Add its OID with short name and long name to one + of the oids.txt file listed in like: + 1.3.6.1.4.1.12345.1: zodiacSign: Zodiac Sign + Add the OID, short name or long name to the first read dn.txt + On linux: cp /usr/share/xca/dn.txt ~/.xca/dn.txt && echo "zodiacSign" >> ~/.xca/dn.txt + Start XCA, open your database and goto Options->Distinguished name. In the Explicit subject entries select Zodiac Sign, click Add, move it by dragging it in the list and click OK when satisfied. + Create a new certificate and see. + + Step by Step guides