aljaz/cowrie
1
0
Fork 0
mirror of https://github.com/aljazceru/cowrie.git synced 2026-01-31 12:04:24 +01:00
Code Issues Packages Projects Releases Wiki Activity

doc updates

Browse Source
This commit is contained in:
Michel Oosterhof
2016-11-14 11:19:31 +04:00
parent a6ee37b4b9
commit 2fdd0b177a
2 changed files with 12 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
INSTALL.md
View File

@@ -123,27 +123,19 @@ $ cd ..
## Step 6: Turning on cowrie
Cowrie is implemented as a module for Twisted, but to properly
import everything the top-level source directory needs to be in
python's os.path. This sometimes won't happen correctly, so make
it explicit:
If you use a virtual environment and it uses the default name of
'cowrie-env' it will be activated automatically.
If you use another virtual environment activate it first:
```
# or whatever path to the top-level cowrie folder
$ export PYTHONPATH=/home/cowrie/cowrie
$ source venv/bin/activate
```
In the absence of a virtual environment, you may run:
To start Cowrie:
```
$ ./start.sh
```
When using Python Virtual Environments you can add the name of the
venv as the first argument or activate it before starting.
```
$ ./start.sh cowrie-env
$ bin/cowrie start
Starting cowrie in the background...
```
@@ -176,7 +168,7 @@ $ sudo chown cowrie:cowrie /etc/authbind/byport/23
$ sudo chmod 770 /etc/authbind/byport/23
```
* Edit start.sh and modify the AUTHBIND_ENABLED setting
* Edit bin/cowrie and modify the AUTHBIND_ENABLED setting
* Change listen_port to 22 in etc/cowrie.cfg
## Troubleshooting
@@ -210,5 +202,5 @@ there's a missing or broken dependency. If there's no stack trace,
double check that your PYTHONPATH is set to the source code directory.
* Default file permissions
To make Cowrie logfiles public readable, change the ```--umask 0077``` option in start.sh into ```--umask 0022```
To make Cowrie logfiles public readable, change the ```UMASK=0077``` variable in bin/cowrie to ```UMASK=0022```

5
bin/cowrie
View File

@@ -45,9 +45,9 @@ cowrie_start() {
echo "Starting cowrie with extra arguments [$XARGS] ..."
if [ $AUTHBIND_ENABLED = "no" ]
then
twistd $XARGS -l ${LOGFILE} --umask 0077 --pidfile ${PIDFILE} cowrie
twistd $XARGS -l ${LOGFILE} --umask ${UMASK} --pidfile ${PIDFILE} cowrie
else
authbind --deep twistd $XARGS -l ${LOGFILE} --umask 0077 --pidfile ${PIDFILE} cowrie
authbind --deep twistd $XARGS -l ${LOGFILE} --umask ${UMASK} --pidfile ${PIDFILE} cowrie
fi
}
@@ -79,6 +79,7 @@ cd ${COWRIEDIR}
export PYTHONPATH=${PYTHONPATH}:${COWRIEDIR}
PIDFILE=var/run/cowrie.pid
LOGFILE="var/log/cowrie/cowrie.log"
UMASK=0077
set -e
key=$1