cisextractor

KO | EN

gitlite — search

#react #llm #machine-learning #deep-learning #linux #windows #cli #kubernetes #awesome-list #vue #pytorch #security #ios #open-source

(★ 16)

Extract CIS benchmarks from PDFs

cisextractor 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

> :warning: **DEPRECATED:** Please be aware that as of now, this tool is MOST likely deprecated. There are alternatives more up-to-date.

# cisextractor
Tool to extract rules from any CIS benchmark PDF, written in Go.

The tool had a success rate of 100% for all of the tested PDFs as of May 2022 (considering the amount of rules found and successful content extraction). Some rules might still be missed. Also, if there are structural changes made by CIS for the PDFs, this tool will need to be updated.

Supports CSV and YAML output, preserves linebreaks by default. I made this primarily to improve my Regex skills.

**Please report any issues and create a pull request if you have any improvements :)**

> :warning: **Note:** Some anti virus softwares detect Go executables as a trojan virus, especially on Windows machines (see [official statement](https://go.dev/doc/faq#virus) from Go). This is a **false positive**. Please check the source and build script for yourself if you want to be extra sure.

## Installation
1.  Download the prebuilt executable for your OS (see [Releases](https://github.com/lartsch/cisextractor/releases)) or build from source yourself (see below)
### Linux (Tested + Recommended)
2.  Add execution permissions to the file (```chmod +x <file>```)
3.  Install poppler-utils:
	-  ```sudo apt install poppler-utils``` or
	-  ```sudo pacman -S poppler```
4.  Run the tool in your favourite console
### Windows (Tested)
2.  Unblock the file in Powershell (```Unblock-File <file>```)
3.  Install poppler-utils:
	- Download + extract the latest package from [here](https://github.com/oschwartz10612/poppler-windows/releases/)
	- Add the *bin/* directory to your $PATH
4.  Run the tool in your favourite console
    -  If you have any anti virus software, it might take some time for it to run (whitelist it / confirm the notification)
### Mac (Untested)
2.  Add execution permissions to the file (```chmod +x <file>```)
3.  Install poppler-utils:
	-  ```brew install poppler```
4.  Run the tool in your favourite console

## Usage
```
usage: cisextractor_windows_amd64.exe --in=IN [<flags>]                                                                                                                 Flags:                   
        --help          Show context-sensitive help (also try --help-long and --help-man).
    -i, --in=IN         Filepath to parse (PDF)
    -o, --out=OUT       Optional: Output to filepath (default: ./<pdfname>.<csv|yaml>)
    -t, --trimsections  Optional: Remove all new line characters from section content (default=disabled)
    -c, --csv           Optional: Export in CSV format (default=YAML)
    -d, --details       Optional: Shows details for identification errors if needed (default=disabled)
```

**Additional notes:**  
- It can happen that some rules are not identified or there are issues with extracting their respective contents - especially when there are fundamental changes to the PDF files that break the tool's (quite complex) regular expressions. No issues were found for the latest CIS PDFs as of June 2022.
- Formatting of section contents does not always look good, even though lots of processing is done
	- Use the ```-t``` flag if you want to remove all linebreaks (this will lead to confusion when actually reading the content for some sections)
- Formatting of the "CIS Controls" table is not good yet - maybe additional processing will be added in the future
- ONLY the pdftotext executable found in poppler-utils will work!

## Notes for Excel import
1.  Add the ```-c``` flag when running the tool to use CSV mode
2.  In Excel, go to the *Data* tab and select *From text/CSV* then choose the generated CSV file
3.  In the import dialogue, choose *UTF-8 Unicode* as charset, make sure *Comma* is selected as delimiter and then click *Transform data*
4.  In the PowerQuery editor, select the first column (ID), go to the *Transform* tab and then choose *Text* as the *Data type*
5.  Return to the *Start* tab and hit *Close & load* to load the data to the current worksheet

![preview](https://github.com/lartsch/cisextractor/blob/main/preview.png?raw=true)

## Notes for compilation
- This tool was developed with Go version 1.17
- Simply clone this repository, run ```go mod tidy``` in the source folder and you should be good to go.
    - In case of issue, delete go.mod and run ```go mod init <modulename>``` first
- Use ```go run cisextractor.go``` to run directly or ```go build``` to build the executable for your OS
	- You can build for other architectures using the usual Go flow.

cisextractor

cisextractor 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

cisextractor

cisextractor 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README