Skip to content

Commit

Permalink
update default vals for paths + readme
Browse files Browse the repository at this point in the history
  • Loading branch information
ursachec committed Jan 15, 2023
1 parent d479ff9 commit 1d578c4
Show file tree
Hide file tree
Showing 2 changed files with 6 additions and 3 deletions.
7 changes: 5 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,13 +12,13 @@ CLI tool which triggers DNS based Canarytokens when `execve` syscalls are invoke

### Build & Run

First, generate a DNS Canarytoken at `https://canarytokens.org/generate`.
First, generate a DNS Canarytoken at https://canarytokens.org/generate.

Afterwards:
```shell
$ make generate
$ go build
$ sudo ./ectg -hostname 6j4n7c2flo71qa0r9g0simq2r.canarytokens.com -paths /usr/bin/whoami,/usr/bin/hostname
$ sudo ./ectg -hostname 6j4n7c2flo71qa0r9g0simq2r.canarytokens.com -paths /usr/bin/id,/usr/bin/whoami,/usr/bin/hostname
```

With `ectg` running, execute `whoami` in a separate shell session — the Canarytoken will trigger and an email will be sent to the address you entered when creating the token.
Expand All @@ -28,3 +28,6 @@ With `ectg` running, execute `whoami` in a separate shell session — the Canary
- https://github.com/cilium/ebpf
- https://blog.thinkst.com/2020/06/canarytokens-org-quick-free-detection-for-the-masses-2.html
- https://ebpf.io/
- https://github.com/thinkst/canaryfy
- https://blog.thinkst.com/2022/08/canaries-as-network-motion-sensors.html
- https://github.com/redcanaryco/redcanary-ebpf-sensor
2 changes: 1 addition & 1 deletion main.go
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,7 @@ func main() {
var canaryHostname string
flag.StringVar(&canaryHostname, "hostname", "", "DNS hostname to ping on events")
var pathNames string
flag.StringVar(&pathNames, "paths", "/usr/bin/whoami,/usr/bin/hostname", "CSV; match `execve` syscalls with these pathnames as a first arg")
flag.StringVar(&pathNames, "paths", "/usr/bin/id,/usr/bin/whoami,/usr/bin/hostname", "CSV; match `execve` syscalls with these pathnames as a first arg")
flag.Parse()

if len(canaryHostname) == 0 {
Expand Down

0 comments on commit 1d578c4

Please sign in to comment.