This document aims to help users resolve common issues they may encounter while using SentinelEye. Before seeking further assistance, please go through the common troubleshooting steps provided below.
Symptom: The program doesn't start or crashes during startup.
Solution:
Ensure that all required dependencies are installed. Refer to the Installation Instructions
section of the README.md for details on how to install necessary dependencies.
sudo apt-get update
sudo apt-get install aircrack-ng crunch xterm wordlists reaver pixiewps bully wifite bettercap wifipumpkin3
Symptom: Error messages referring to lack of permissions, like 'Permission Denied'.
Solution: Make sure you’re running SentinelEye with sufficient permissions. This usually requires running the software as the root user.
sudo python wifi.py
Symptom: The interface does not go into monitor mode when using the start option.
Solution:
- Check that your wireless card supports monitor mode.
- Make sure the proper driver is installed and loaded.
- Check that no other processes are interfering with the wireless card. You can attempt to stop other processes with:
sudo airmon-ng check kill
Symptom: The program isn’t capturing handshakes even when there is network traffic.
Solution:
- Ensure that you are within range of the wireless access point.
- Check to see there is ongoing traffic between the AP and its clients.
- Try targeting a network with a stronger signal.
Symptom: The WPS attack options don’t seem to be having any effect.
Solution:
- Make sure the network BSSID supports WPS.
- Confirm that the WPS pin is correct.
- Not all routers are vulnerable to WPS attacks - the inability to perform such attacks may not be an issue with the software.
If the steps above do not solve your problem, more in-depth troubleshooting may be required. This could include:
- Reviewing log files generated by the tools.
- Verifying your network card’s chipset and driver support.
- Researching your issue in online forums or the tool’s official documentation.
If after following the above steps you are unable to resolve the issue, please gather the following information:
- A clear description of the problem.
- Steps to reproduce the issue.
- Any error messages that are displayed.
With this information, reach out to the community support forums or submit an issue on the SentinelEye issues page.
If you have encountered a problem and solved it in a way not documented here, please consider contributing your solution to this guide by submitting a pull request to this document, so that future users may benefit from your experiences.