mirror of
https://github.com/valitydev/osquery-1.git
synced 2024-11-08 18:33:54 +00:00
124 lines
5.7 KiB
Markdown
124 lines
5.7 KiB
Markdown
osquery
|
|
=======
|
|
|
|
<p align="center">
|
|
<img align="center" src="https://osquery.io/assets/logo-dark.png" alt="osquery logo" width="200"/>
|
|
|
|
<p align="center">
|
|
osquery is an operating system instrumentation framework for OS X and Linux. <br/>
|
|
The tools make low-level operating system analytics and monitoring both performant and intuitive.
|
|
|
|
| Platform | Build status | | | |
|
|
|----------|---------------|---|---|---|
|
|
RHEL 6.5 | [](https://jenkins.osquery.io/job/osqueryMasterBuildRHEL6Package/) | | |
|
|
RHEL 7.0 | [](https://jenkins.osquery.io/job/osqueryMasterBuildRHEL7Package/) | | **Homepage:** | https://osquery.io
|
|
CentOS 6.5 | [](https://jenkins.osquery.io/job/osqueryMasterBuildCentOS6Package/) | | **Downloads:** | https://osquery.io/downloads
|
|
CentOS 7.0 | [](https://jenkins.osquery.io/job/osqueryMasterBuildCentOS7Package/) | | **Tables:** | https://osquery.io/tables
|
|
Ubuntu 12.04 | [](https://jenkins.osquery.io/job/osqueryMasterBuildUbuntu12Package/) | | **Guide:** | https://osquery.readthedocs.org
|
|
Ubuntu 14.04 | [](https://jenkins.osquery.io/job/osqueryMasterBuildUbuntu14Package/) | | **Homebrew:** | `brew install osquery`
|
|
OS X 10.10 | [](https://jenkins.osquery.io/job/osqueryMasterBuildOSXPackage/) | | |
|
|
|
|
#### What is osquery?
|
|
|
|
osquery exposes an operating system as a high-performance relational database. This allows you to write SQL-based queries to explore operating system data. With osquery, SQL tables represent abstract concepts such as running processes, loaded kernel modules, open network connections, browser plugins, hardware events or file hashes.
|
|
|
|
SQL tables are implemented via a simple plugin and extensions API. A variety of tables already exist and more are being written: [https://osquery.io/tables](https://osquery.io/tables). To best understand the expressiveness that is afforded to you by osquery, consider the following SQL queries:
|
|
|
|
|
|
List the the users:
|
|
```sql
|
|
SELECT * FROM users;
|
|
```
|
|
|
|
Check the processes that have a deleted executable:
|
|
```sql
|
|
SELECT * FROM processes WHERE on_disk = 0;
|
|
```
|
|
|
|
Get the process name, port, and PID, which are listening on all interfaces:
|
|
```sql
|
|
SELECT DISTINCT process.name, listening.port, process.pid
|
|
FROM processes AS process
|
|
JOIN listening_ports AS listening ON process.pid = listening.pid
|
|
WHERE listening.address = '0.0.0.0';
|
|
```
|
|
|
|
Find every OS X LaunchDaemon that launches an executable and keeps it running:
|
|
```sql
|
|
SELECT name, program || program_arguments AS executable
|
|
FROM launchd
|
|
WHERE
|
|
(run_at_load = 'true' AND keep_alive = 'true')
|
|
AND
|
|
(program != '' OR program_arguments != '');
|
|
```
|
|
|
|
Check for ARP anomalies from the host's perspective:
|
|
|
|
```sql
|
|
SELECT address, mac, count(mac) AS mac_count
|
|
FROM arp_cache GROUP BY mac
|
|
HAVING count(mac) > 1;
|
|
```
|
|
|
|
Alternatively, you could also use a SQL sub-query to accomplish the same result:
|
|
|
|
```sql
|
|
SELECT address, mac, mac_count
|
|
FROM
|
|
(SELECT address, mac, count(mac) AS mac_count FROM arp_cache GROUP BY mac)
|
|
WHERE mac_count > 1;
|
|
```
|
|
|
|
These queries can be:
|
|
* performed on an ad-hoc basis to explore operating system state using the [osqueryi](https://osquery.readthedocs.org/en/latest/introduction/using-osqueryi/) shell
|
|
* executed via a [scheduler](https://osquery.readthedocs.org/en/latest/introduction/using-osqueryd/) to monitor operating system state across a set of hosts
|
|
* launched from custom applications using osquery Thrift APIs
|
|
|
|
#### Downloads / Install
|
|
|
|
For latest stable and nightly builds for OS X and Linux (deb/rpm), as well as yum and apt repository information visit [https://osquery.io/downloads](https://osquery.io/downloads/).
|
|
|
|
##### FreeBSD
|
|
|
|
The easiest way to install osquery on FreeBSD is via the ports tree. Check [FreshPorts](http://www.freshports.org/sysutils/osquery) for the latest version information.
|
|
|
|
```bash
|
|
# from ports
|
|
cd /usr/ports/sysutils/osquery && make install clean
|
|
|
|
# from binary package
|
|
pkg install osquery
|
|
|
|
# using portmaster
|
|
portmaster sysutils/osquery
|
|
```
|
|
|
|
##### OS X (Homebrew)
|
|
|
|
The easiest way to install osquery on OS X is via Homebrew. Check the [Homebrew](http://brew.sh/) homepage for installation instructions.
|
|
|
|
```bash
|
|
# if you've never installed osquery
|
|
brew update
|
|
brew install osquery
|
|
|
|
# don't forget to update osquery!
|
|
brew update
|
|
brew upgrade osquery
|
|
```
|
|
|
|
##### Building from source
|
|
|
|
[Building](https://osquery.readthedocs.org/en/latest/development/building/) osquery from source is encouraged! Join our developer community by giving us feedback in Github issues or submitting pull requests!
|
|
|
|
#### Vulnerabilities
|
|
|
|
Facebook has a [bug bounty](https://www.facebook.com/whitehat/) program that includes osquery. If you find a security vulnerability in osquery, please submit it via the process outlined on that page and do not file a public issue. For more information on finding vulnerabilities in osquery, see a recent blog post about [bug-hunting osquery](https://www.facebook.com/notes/facebook-bug-bounty/bug-hunting-osquery/954850014529225).
|
|
|
|
#### Learn more
|
|
|
|
Read the [launch blog post](https://code.facebook.com/posts/844436395567983/introducing-osquery/) for background on the project.
|
|
|
|
If you're interested in learning more about osquery, visit the [users guide](https://osquery.readthedocs.org/) and browse our RFC-labeled Github issues.
|