forked from p15670423/monkey
Merge pull request #1529 from guardicore/1523/docs-update-password-reset
Docs: update password reset
This commit is contained in:
commit
81779cdfa1
|
@ -52,36 +52,38 @@ Monkey in the newly created folder.
|
||||||
|
|
||||||
## Reset/enable the Monkey Island password
|
## Reset/enable the Monkey Island password
|
||||||
|
|
||||||
When you first access the Monkey Island server, you'll be prompted to create an account.
|
|
||||||
To reset the credentials, edit the `server_config.json` file manually
|
|
||||||
(located in the [data directory](/reference/data_directory)).
|
|
||||||
|
|
||||||
{{% notice warning %}}
|
{{% notice warning %}}
|
||||||
If you reset the credentials, the database will be cleared. Any findings of the Infection Monkey from previous runs will be lost. <br/><br/>
|
If you reset the credentials, the database will be cleared. Any findings of the Infection Monkey from previous runs will be lost. <br/><br/>
|
||||||
However, you can save the Monkey's existing configuration by logging in with your current credentials and clicking on the **Export config** button on the configuration page.
|
However, you can save the Monkey's existing configuration by logging in with your current credentials and clicking on the **Export config** button on the configuration page.
|
||||||
{{% /notice %}}
|
{{% /notice %}}
|
||||||
|
|
||||||
|
### On Windows and Linux (AppImage)
|
||||||
|
|
||||||
|
When you first access the Monkey Island server, you'll be prompted to create an account.
|
||||||
|
To reset the credentials, edit the `server_config.json` file manually
|
||||||
|
(located in the [data directory]({{< ref "/reference/data_directory" >}})).
|
||||||
|
|
||||||
In order to reset the credentials, the following edits need to be made:
|
In order to reset the credentials, the following edits need to be made:
|
||||||
1. Delete the `user` field. It will look like this:
|
1. Delete the `user` field. It will look like this:
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
...
|
...
|
||||||
"user": "username",
|
"user": "username",
|
||||||
...
|
...
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
1. Delete the `password_hash` field. It will look like this:
|
1. Delete the `password_hash` field. It will look like this:
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
...
|
...
|
||||||
"password_hash": "$2b$12$d050I/MsR5.F5E15Sm7EkunmmwMkUKaZE0P0tJXG.M9tF.Kmkd342",
|
"password_hash": "$2b$12$d050I/MsR5.F5E15Sm7EkunmmwMkUKaZE0P0tJXG.M9tF.Kmkd342",
|
||||||
...
|
...
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
1. Set `server_config` to `password`. It should look like this:
|
1. Set `server_config` to `password`. It should look like this:
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
...
|
...
|
||||||
"environment": {
|
"environment": {
|
||||||
...
|
...
|
||||||
|
@ -89,12 +91,53 @@ In order to reset the credentials, the following edits need to be made:
|
||||||
...
|
...
|
||||||
},
|
},
|
||||||
...
|
...
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
Then, reset the Monkey Island process.
|
1. Restart the Monkey Island process:
|
||||||
On Linux, use `sudo systemctl restart monkey-island.service`.
|
* On Linux, simply kill the Monkey Island process and execute the AppImage.
|
||||||
On Windows, restart the program.
|
* On Windows, restart the program.
|
||||||
Finally, go to the Monkey Island's URL and create a new account.
|
|
||||||
|
1. Go to the Monkey Island's URL and create a new account.
|
||||||
|
|
||||||
|
If you are still unable to log into Monkey Island after following the above
|
||||||
|
steps, you can perform a complete factory reset by removing the entire [data
|
||||||
|
directory]({{< ref "/reference/data_directory" >}}) and then restarting the
|
||||||
|
Monkey Island process.
|
||||||
|
|
||||||
|
### On Docker
|
||||||
|
When you first access the Monkey Island server, you'll be prompted to create an account.
|
||||||
|
To reset the credentials, you'll need to perform a complete factory reset:
|
||||||
|
|
||||||
|
1. Kill the Monkey Island container:
|
||||||
|
```bash
|
||||||
|
sudo docker kill monkey-island
|
||||||
|
```
|
||||||
|
1. Kill the MongoDB container:
|
||||||
|
```bash
|
||||||
|
sudo docker kill monkey-mongo
|
||||||
|
```
|
||||||
|
1. Remove the MongoDB volume:
|
||||||
|
```bash
|
||||||
|
sudo docker volume rm db
|
||||||
|
```
|
||||||
|
1. Restart the MongoDB container:
|
||||||
|
```bash
|
||||||
|
sudo docker run \
|
||||||
|
--name monkey-mongo \
|
||||||
|
--network=host \
|
||||||
|
--volume db:/data/db \
|
||||||
|
--detach \
|
||||||
|
mongo:4.2
|
||||||
|
```
|
||||||
|
1. Restart the Monkey Island container
|
||||||
|
```bash
|
||||||
|
sudo docker run \
|
||||||
|
--name monkey-island \
|
||||||
|
--network=host \
|
||||||
|
guardicore/monkey-island:VERSION
|
||||||
|
```
|
||||||
|
1. Go to the Monkey Island's URL and create a new account.
|
||||||
|
|
||||||
|
|
||||||
## Should I run the Infection Monkey continuously?
|
## Should I run the Infection Monkey continuously?
|
||||||
|
|
||||||
|
@ -125,7 +168,7 @@ You can download the Monkey Island's log file directly from the UI. Click the "l
|
||||||
![How to download Monkey Island internal log file](/images/faq/download_log_monkey_island.png "How to download Monkey Island internal log file")
|
![How to download Monkey Island internal log file](/images/faq/download_log_monkey_island.png "How to download Monkey Island internal log file")
|
||||||
|
|
||||||
It can also be found as a local file on the Monkey Island server system in the specified
|
It can also be found as a local file on the Monkey Island server system in the specified
|
||||||
[data directory](/reference/data_directory).
|
[data directory]({{< ref "/reference/data_directory" >}}).
|
||||||
|
|
||||||
The log enables you to see which requests were requested from the server and extra logs from the backend logic. The log will contain entries like these:
|
The log enables you to see which requests were requested from the server and extra logs from the backend logic. The log will contain entries like these:
|
||||||
|
|
||||||
|
@ -161,7 +204,7 @@ The logs contain information about the internals of the Infection Monkey agent's
|
||||||
### How do I change the log level of the Monkey Island logger?
|
### How do I change the log level of the Monkey Island logger?
|
||||||
|
|
||||||
The log level of the Monkey Island logger is set in the `log_level` field
|
The log level of the Monkey Island logger is set in the `log_level` field
|
||||||
in the `server_config.json` file (located in the [data directory](/reference/data_directory)).
|
in the `server_config.json` file (located in the [data directory]({{< ref "/reference/data_directory" >}})).
|
||||||
Make sure to leave everything else in `server_config.json` unchanged:
|
Make sure to leave everything else in `server_config.json` unchanged:
|
||||||
|
|
||||||
```json
|
```json
|
||||||
|
|
Loading…
Reference in New Issue