Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added Installation Instructions and Troubleshooting for Windows + New SharpHound Flags #646

Closed
wants to merge 2 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions docs/data-collection/sharphound-all-flags.rst
Original file line number Diff line number Diff line change
Expand Up @@ -285,6 +285,22 @@ DisableKerberosSigning

Disables LDAP encryption. Not recommended.

DoLocalAdminSessionEnum
-----------------------

Tells SharpHound to use a dedicated local user to enumerate sessions in case admin privileges are needed.
Needs the other two options LocalAdminUsername and LocalAdminPassword to be set.

LocalAdminUsername
------------------

The local admin username to use for elevated session enumeration. Needs the doLocalAdminSessionEnum flag to be set.

LocalAdminPassword
------------------

The local admin password to use for elevated session enumeration. Needs the doLocalAdminSessionEnum flag to be set.

Performance Options
^^^^^^^^^^^^^^^^^^^

Expand Down
Binary file added docs/images/java_home_check.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/java_home_variable.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/neo4j_error_1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/neo4j_error_2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/neo4j_paths.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
58 changes: 51 additions & 7 deletions docs/installation/windows.rst
Original file line number Diff line number Diff line change
@@ -1,22 +1,46 @@
Windows
=======

Walkthrough Video
^^^^^^^^^^^^^^^^^
https://youtu.be/PgjtvxA-MMk


Install Java
^^^^^^^^^^^^

1. Download the Windows installer for Oracle JDK 11 from https://www.oracle.com/java/technologies/javase-jdk11-downloads.html
1. Download the Windows installer for Oracle JDK 11 from https://www.oracle.com/java/technologies/javase-jdk11-downloads.html (needs an Oracle account).

Alternatively download and install the Microsoft build of OpenJDK 11 without any registration or login: https://learn.microsoft.com/en-us/java/openjdk/download#openjdk-11

2. Use the according installer to setup JDK. The default options work fine. You want to make sure though that the `JAVA_HOME` System variable is set correctly.
In the Microsoft setup this is an option during installation:

.. image:: /images/java_home_variable.png
:align: center
:width: 900px
:alt: JAVA_HOME variable

.. note:: You want to make sure that the System variable `JAVA_HOME` is set correctly, pointing to you OpenJDK 11 by running the following command:

::

2. Use the installer to install Oracle JDK. The default options work fine.
rundll32.exe sysdm.cpl,EditEnvironmentVariables


.. image:: /images/java_home_check.png
:align: center
:width: 900px
:alt: JAVA_HOME variable

Install neo4j
^^^^^^^^^^^^^

.. Warning::

Neo4j 5 suffers from severe performance regression issues. Until further notice, please use Neo4j 4.4.13
Neo4j 5 suffers from severe performance regression issues. Until further notice, please use the latest Neo4j 4.4.x version

1. Download the neo4j Community Server Edition zip from https://neo4j.com/download-center/#community
1. Download the latest neo4j 4.x Community Server Edition zip from https://neo4j.com/download-center/#community

2. Unzip the neo4j zip file.

Expand All @@ -31,8 +55,28 @@ Install neo4j
C:\> neo4j.bat install-service

.. note:: At this point you may see an error about Java not being found, or the wrong
version of Java running. Ensure your JAVA_HOME environment variable is set to the
JDK folder (example: C:\\Program Files\\Java\\jdk-11.0.6
version of Java running. Make sure you followed the JAVA installation steps correctly.

.. note:: You might run into an error `Couldn't find prunsrv file for interacting with the windows service subsystem ...`. This happens if the System variables
`NEO4J_CONF` and `NEO4J_HOME` are not set (correctly). Both need to point to the root of the neo4j folder.

.. image:: /images/neo4j_error_1.png
:align: center
:width: 900px
:alt: JAVA_HOME variable

.. note:: You might run into an error `Could not find or load main class org.neo4j.server.startup.Neo4jCommand`. This happens if the System variables
`NEO4J_CONF` and `NEO4J_HOME` are not set (correctly). Both need to point to the root of the neo4j folder.

.. image:: /images/neo4j_error_2.png
:align: center
:width: 900px
:alt: JAVA_HOME variable

.. image:: /images/neo4j_paths.png
:align: center
:width: 900px
:alt: neo4j variables

6. neo4j is now installed as a Windows service. Run this command:

Expand All @@ -44,7 +88,7 @@ You should see the message, "The neo4j Graph Database - neo4j service was starte

7. Open a web browser and navigate to http://localhost:7474/. You should see the neo4j web console.

8. Authenticate to neo4j in the web console with username neo4j, password neo4j. You'll
8. Authenticate to neo4j in the web console with username `neo4j`, password `neo4j`. You'll
be prompted to change this password.

Download the BloodHound GUI
Expand Down