Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(656)

Unified Diff: net/tools/ct_mapper/README

Issue 1238413004: Framework for iterating over certificates in CT database from Chromium code. (not for review) (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: Make samples page work Created 3 years, 6 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « net/tools/ct_mapper/FILE_FORMAT.txt ('k') | net/tools/ct_mapper/ct_mapper_main.cc » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: net/tools/ct_mapper/README
diff --git a/net/tools/ct_mapper/README b/net/tools/ct_mapper/README
new file mode 100644
index 0000000000000000000000000000000000000000..7e2f185a366e0912edc3798fad128a5dc249272f
--- /dev/null
+++ b/net/tools/ct_mapper/README
@@ -0,0 +1,53 @@
+h
+==================
+One time setup
+===================
+
+---------------------------
+1. Apply this patch
+---------------------------
+
+$ git new-branch CERT_MAPPER
+$ git cl patch 1238413004
+
+---------------------------
+2. Download CT database
+---------------------------
+
+If you haven't already, you need to download the full CT database. This takes a
+long time (order of hours), and will save a file about 22GB large. (If you know
+someone that has already downloaded this, you may want to copy it from them
+instead of fetching it yourself.)
+
+$ cd src
+$ ./net/tools/ct_mapper/sync-ct-database.sh CT.db
+
+---------------------------
+3. Dump all the certificates from CT database
+---------------------------
+
+Rather than operate directly on the CT database, the cert mapper iterates over
+a simpler (and smaller) file, which just contains the DER for each certificate.
+This file is about half the size of the CT.db (making it around 11GB).
+
+$ cd src
+$ ./net/tools/ct_mapper/dump-ct.sh CT.db CERTS_DUMP_PATH
+
+This will take about 20 minutes to run, after which CERTS.bin will have been
+written. This is the input file that you pass to the cert_mapper.
+
+======================================================
+How to run code over the certificates in CT database (or a PEM file)
+======================================================
+
+Add your code into:
+ net/tools/ct_mapper/my_visitor.cc
+
+And then execute:
+
+ $ cd src
+ $ ninja -C out/Release cert_mapper
+ $ ./out/Release/cert_mapper CERTS_DUMP_PATH
+
+NOTE: If you get "ninja: error: unknown target 'cert_mapper'" then you need to
+re-generate the ninja files with "gn gen out/Release"
« no previous file with comments | « net/tools/ct_mapper/FILE_FORMAT.txt ('k') | net/tools/ct_mapper/ct_mapper_main.cc » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698