Retrieve password windows

Author: jontyms

docs/guides/How to access Windows Instances.md

@@ -2,7 +2,7 @@
 
 There are 2 main ways to get access and control a Windows Instance on Openstack. This tutorial will cover both methods.
 
-## Prerequesites ## 
+## Prerequesites ##
 
 * A newly created Windows Server Instance on Openstack
 * Access to Infra via OpenVPN OR On the Cyberlab Secure Network
@@ -17,11 +17,11 @@ Openstack has a built-in console viewer for Instances which allows you to get a
 1. On the left plane, choose `Compute` and then `Instances`
 ![Instance page](../img/win-guide/instancespage.png)
 2. Click on the Instance to view
-![Instance page](../img/win-guide/instancespage2.png) 
+![Instance page](../img/win-guide/instancespage2.png)
 3. Click on the `Console` tab
-![Instance page](../img/win-guide/consoletab.png) 
+![Instance page](../img/win-guide/consoletab.png)
 4. You now have a console view of the Instance! From here you can add an Administrator password to Windows and use the Instance!
-![Instance page](../img/win-guide/consoleview.png) 
+![Instance page](../img/win-guide/consoleview.png)
 
 # Method 2: Using Remote Desktop Connection
 
@@ -34,7 +34,7 @@ Important Note: You cannot directly use this method on the very first time you s
 ## Step 1: Creating a security group
 1. Connect to Infra via OpenVPN or `Cyberlab Secure`
 2. Go to `horizon.hackucf.cloud` and log into your account
-3. Click on `Network` on the left-hand pane and then `Security Groups` 
+3. Click on `Network` on the left-hand pane and then `Security Groups`
 ![Instance page](../img/win-guide/network_secgroup.png)
 4. On the right-hand side, click on `Create Security Group` and give it a name and description, then press `Create Security Group`
 ![Instance page](../img/win-guide/creategroup.png)
@@ -81,4 +81,32 @@ RDP will now be allowed through the Openstack firewall for the instance!
 
 4. You will be successfully connected to the Instance!
 
-![Instance page](../img/win-guide/rdp_final.png)
+![Instance page](../img/win-guide/rdp_final.png)
+
+
+# Retrieving Windows Password
+
+To retrieve the Windows password for an instance in OpenStack Horizon, you need to follow these steps. This process assumes that you have created the instance with an SSH key, which is necessary for decrypting the password.
+
+## Step 1: Creating an Instance with an SSH Key
+
+1. On the left pane, choose `Compute` and then `Instances`.
+2. Click on `Launch Instance`.
+3. Fill in the necessary details for your instance, such as the instance name and flavor.
+4. Under the `Key Pair` section, select an existing key pair or create a new one. This key pair will be used to decrypt the Windows password. **Ensure the key is a RSA key.**
+![RSA_key](../img/win-guide/rsa_key.png)
+
+
+## Step 2: Retrieving the Windows Password
+
+1. On the left pane, choose `Compute` and then `Instances`.
+![Instance page](../img/win-guide/instancespage.png)
+2. Click on the instance for which you want to retrieve the password.
+![Instance page](../img/win-guide/instancespage2.png)
+3. Click on the `Actions` dropdown menu on the right and select `Retrieve Password`.
+![dropdown password](../img/win-guide/dropdown_password.png)
+4. In the `Retrieve Password` dialog, click on `Choose File` and upload the private key file associated with the SSH key pair used during instance creation.
+![retrieve password](../img/win-guide/retrieve_password.png)
+5. Click on `Decrypt Password`. The decrypted password will be displayed.
+
+You can now use this password to log in to your Windows instance via the OpenStack console or Remote Desktop Connection.