Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/CISOfy/lynis.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorÉdouard Lopez <dev+github@edouard-lopez.com>2016-11-08 13:55:35 +0300
committerMichael Boelen <michael.boelen@cisofy.com>2016-11-08 13:55:35 +0300
commitc260be181847c96f00d58eb5381d79360a081b75 (patch)
tree631d213302830bd1aafd9a4219bb197a195fcf84 /README.md
parent3a1b5a960a58003f7e85da0c68babb7e70fdb01a (diff)
improve formatting and information structure (#319)
* improve formatting and information structure * Update README.md
Diffstat (limited to 'README.md')
-rw-r--r--README.md109
1 files changed, 67 insertions, 42 deletions
diff --git a/README.md b/README.md
index 060099e8..32b50d92 100644
--- a/README.md
+++ b/README.md
@@ -1,81 +1,106 @@
+
[![Build Status](https://travis-ci.org/CISOfy/lynis.svg?branch=master)](https://travis-ci.org/CISOfy/lynis)
+[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/96/badge)](https://bestpractices.coreinfrastructure.org/projects/96)
+[Documentation]
+
+[Documentation]: https://cisofy.com/documentation/lynis/
-lynis
-=====
+# lynis
-Lynis - Security auditing and hardening tool, for UNIX-based systems
+> Lynis - Security auditing and hardening tool, for UNIX-based systems.
-Lynis is a security auditing for UNIX derivatives like Linux, macOS, BSD, and Solaris. It performs an in-depth security scan on the system itself, with the goal to detect issues and provide tips for further system hardening. It will also scan for general system information, vulnerable software packages, and possible configuration issues. Lynis is commonly used by people in the "blue team" to assess the security defenses of their systems.
+Lynis is a security auditing for UNIX derivatives like Linux, macOS, BSD, and Solaris. It performs an **in-depth security scan** on the system itself, with the goal to detect issues and **provide tips for further system hardening**. It will also scan for general system information, vulnerable software packages, and possible configuration issues. Lynis is commonly used by people in the "blue team" to assess the security defenses of their systems.
-We believe software should be simple, updated on a regular basis, and open. You should be able to trust, understand, and have the option to change the software. Many agree with us, as the software is being used by thousands every day to protect their systems.
+We believe software should be **simple, updated on a regular basis, and open**. You should be able to trust, understand, and have the option to change the software. Many agree with us, as the software is being used by thousands every day to protect their systems.
-Main goals:
-- Automated security auditing
-- Compliance testing (e.g. ISO27001, PCI-DSS, HIPAA)
-- Detect vulnerabilities
+## Goals
+
+The main goals are:
+- Automated security auditing ;
+- Compliance testing (e.g. ISO27001, PCI-DSS, HIPAA) ;
+- Detect vulnerabilities.
The software aims to also assist with:
-- Configuration management
-- Software patch management
-- System hardening
-- Penetration testing
-- Intrusion detection
+- Configuration management ;
+- Software patch management ;
+- System hardening ;
+- Penetration testing ;
+- Intrusion detection.
-License:
-- GPLv3
-Typical users of the software:
-- System administrators
-- Auditors
-- Security officers
-- Security professionals
+### Audience
+Typical users of the software:
+- System administrators ;
+- Auditors ;
+- Security officers ;
+- Security professionals.
## Installation
### Git
-1. Clone or download the project files. No compilation or installation is required.
-2. Execute: `./lynis audit system`
+1. Clone or download the project files (**no compilation nor installation** is required) ;
+
+ git clone git@github.com:CISOfy/lynis.git
+
+2. Execute:
+
+ ./lynis audit system
-If you want to run the software as root, we suggest changing the ownership of the files. Use chown -R 0:0 to recursively alter the owner and group and set it to user ID 0 (root).
+If you want to run the software as `root`, we suggest changing the ownership of the files. Use `chown -R 0:0` to recursively alter the owner and group and set it to user ID `0` (`root`).
### Package
-Stable releases of Lynis are packaged and made available as RPM or DEB file. The [CISOfy software repository](https://packages.cisofy.com) can be used to install Lynis on systems running CentOS, Debian, Fedora, OEL, openSUSE, RHEL, Ubuntu, and others.
+Stable releases of Lynis are packaged and made available as `.rpm` or `.deb` file. The [CISOfy software repository](https://packages.cisofy.com) can be used to install Lynis on systems running :
+`CentOS`, `Debian`, `Fedora`, `OEL`, `openSUSE`, `RHEL`, `Ubuntu`, and others.
+
+### Enterprise version
+
+This software component is also part of an enterprise solution. Same quality, yet with more functionality.
+
+Focus areas include compliance (`PCI DSS`, `HIPAA`, `ISO27001`, and others). The Enterprise version comes with:
+* a web interface and features a dashboard ;
+* hardening snippets ;
+* and an improvement plan.
## Documentation
-Full documentation: https://cisofy.com/documentation/lynis/
+Full documentation: https://cisofy.com/documentation/lynis/.
## Customization
If you want to create your own tests, have a look at the [Lynis software development kit](https://github.com/CISOfy/lynis-sdk).
## Security
We participate in the badge program of the Linux Foundation. By clicking on the badge you will see the related details.
-[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/96/badge)](https://bestpractices.coreinfrastructure.org/projects/96)
-
-## Enterprise version
-This software component is also part of an enterprise solution. Same quality, yet with more functionality. Focus areas include compliance (PCI DSS, HIPAA, ISO27001, and others). The Enterprise version comes with a web interface and features a dashboard, hardening snippets, and an improvement plan.
## Awards
Lynis is collecting some awards and we are proud of that.
-### 2013
-[![ToolsWatch Best Tools (sixth place)](https://www.toolswatch.org/badges/toptools/2013.svg)](https://www.toolswatch.org/2013/12/2013-top-security-tools-as-voted-by-toolswatch-org-readers/)
+* 2016
+ * [Best of Open Source Software Awards 2016](http://www.infoworld.com/article/3121251/open-source-tools/bossie-awards-2016-the-best-open-source-networking-and-security-software.html#slide13).
-### 2014
-[![ToolsWatch Best Tools (third place)](https://www.toolswatch.org/badges/toptools/2014.svg)](https://www.toolswatch.org/2015/01/2014-top-security-tools-as-voted-by-toolswatch-org-readers/)
+* 2015
+ * [![ToolsWatch Best Tools (second place)](https://www.toolswatch.org/badges/toptools/2015.svg)](https://www.toolswatch.org/2016/02/2015-top-security-tools-as-voted-by-toolswatch-org-readers/)
+ * [Best of Open Source Software Awards 2015](http://www.idgenterprise.com/news/press-release/infoworld-announces-the-2015-best-of-open-source-software-awards/).
-### 2015
-[![ToolsWatch Best Tools (second place)](https://www.toolswatch.org/badges/toptools/2015.svg)](https://www.toolswatch.org/2016/02/2015-top-security-tools-as-voted-by-toolswatch-org-readers/)
+* 2014
+ * [![ToolsWatch Best Tools (third place)](https://www.toolswatch.org/badges/toptools/2014.svg)](https://www.toolswatch.org/2015/01/2014-top-security-tools-as-voted-by-toolswatch-org-readers/)
-[Best of Open Source Software Awards 2015](http://www.idgenterprise.com/news/press-release/infoworld-announces-the-2015-best-of-open-source-software-awards/)
-
-### 2016
-[Best of Open Source Software Awards 2016](http://www.infoworld.com/article/3121251/open-source-tools/bossie-awards-2016-the-best-open-source-networking-and-security-software.html#slide13)
+* 2013
+ * [![ToolsWatch Best Tools (sixth place)](https://www.toolswatch.org/badges/toptools/2013.svg)](https://www.toolswatch.org/2013/12/2013-top-security-tools-as-voted-by-toolswatch-org-readers/)
## Contribute
-We love contributors. Do you have something to share? Or help out with translating Lynis into your own language? Create an issue or pull request on GitHub, or send us an e-mail: lynis-dev@cisofy.com.
+
+> We love contributors.
+
+Do you have something to share? Or help out with translating Lynis into your own language? Create an issue or pull request on GitHub, or send us an e-mail: lynis-dev@cisofy.com.
+
More details can be found in the [Contributors Guide](https://github.com/CISOfy/lynis/blob/master/CONTRIBUTIONS.md).
-You can also simply contribute to the project by 'starring' the project and show your appreciation that way. Thanks!
+You can also simply contribute to the project by _starring_ the project and show your appreciation that way.
+
+Thanks!
+
+### License
+
+> GPLv3