aboutsummaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorPetr Svenda2019-12-08 22:04:28 +0100
committerPetr Svenda2019-12-08 22:04:28 +0100
commit4afd3ecc22021a3361ea89daf20cee230740a86f (patch)
treea24480bf1619905b9f98c5b62c348e7fd209ea06
parentfd871704ce306289689d1c6538111bc294c2d7ec (diff)
downloadsec-certs-4afd3ecc22021a3361ea89daf20cee230740a86f.tar.gz
sec-certs-4afd3ecc22021a3361ea89daf20cee230740a86f.tar.zst
sec-certs-4afd3ecc22021a3361ea89daf20cee230740a86f.zip
initial readme
-rw-r--r--README.md19
1 files changed, 19 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 00000000..86410b0d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,19 @@
+# sec-certs
+
+Analyzer of security certificates (Common Criteria, NIST FIPS140-2...)
+
+## Usage
+
+Steps:
+ 1. Run `search_certificate.py` to generate download scripts (download_cc_web.bat, download_cc_web.sh)
+ 2. Run `download_cc_web.bat` to download important files from Common Criteria website (requires `curl` installed)
+ 3. Run `search_certificate.py` to generate download scripts for separate pdf files with certificates (`download_active_certs.bat`...)
+ 4. Place all dowload scripts into folder on disk with at least 5GB free space (yes, there are A LOT of certificates) and run them
+ 5. Run `search_certificate.py` to process CSV, HTML and PDF files. Extracted information is stored in *.json files. The consolidated info is in `certificate_data_complete.json`
+ 6. Run `search_certificate.py` to analyze information extracted to `certificate_data_complete.json`. Information like graph of certificates dependency is produced
+
+## Extending the analysis
+
+The analysis can be extended in several ways:
+ 1. Additional keywords can be extracted from PDF files (modify `cert_rules.py`)
+ 2. Data from `certificate_data_complete.json` can be analyzed in novel way - this is why this project was concieved at first place