More actions
m →PuTTY Setup: Formatting text. |
|||
(4 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
== Preparing SSH key-pair == | == Preparing SSH key-pair == | ||
<!-- Needs https://www.mediawiki.org/wiki/Extension:Tabs to work --> | |||
<tabs> | <tabs> | ||
<tab name="Windows">Open <u>Command Line</u> by typing <code>cmd</code> in menu start or in WIN+R.</tab> | <tab name="Windows">Open <u>Command Line</u> by typing <code>cmd</code> in menu start or in WIN+R.</tab> | ||
Line 57: | Line 58: | ||
# Select your converted .ppk private key. If you cant see <u>Browse</u> in <u>Auth</u>, expand it and click <u>Credentials</u>. Its first field <u>Browse</u>. | # Select your converted .ppk private key. If you cant see <u>Browse</u> in <u>Auth</u>, expand it and click <u>Credentials</u>. Its first field <u>Browse</u>. | ||
# In <u>SSH</u> click <u>Tunnels</u>. | # In <u>SSH</u> click <u>Tunnels</u>. | ||
# Set <u>Source Port</u> to [[Server# | # Set <u>Source Port</u> to [[Server#Server Connection|server port]]. | ||
# Set <u>Destination</u> to `127.0.0.1:5432`. | # Set <u>Destination</u> to `127.0.0.1:5432`. | ||
# Click <u>Add</u>. | # Click <u>Add</u>. | ||
# In left panel click <u>Session</u>. | # In left panel click <u>Session</u>. | ||
# Set <u>Host Name (or IP address)</u> to [[Server# | # Set <u>Host Name (or IP address)</u> to [[Server#Server Connection|server ip]]. | ||
# Set <u>Port</u> to <code>22</code>. | # Set <u>Port</u> to <code>22</code>. | ||
# In <u>Saved Sessions</u> field type in configuration name to store settings. For example <code>RenewalSSH</code>. | # In <u>Saved Sessions</u> field type in configuration name to store settings. For example <code>RenewalSSH</code>. | ||
Line 84: | Line 85: | ||
# Browse to '''CSM''' directory after unpacking. | # Browse to '''CSM''' directory after unpacking. | ||
# Open <code>/www/config.sample.php</code> with editor of choice, like notepad. | # Open <code>/www/config.sample.php</code> with editor of choice, like notepad. | ||
# Change <u>DBNAME</u>, <u>DBUSER</u> and <u>DBPASS</u> to match values given by admin or editor access #📕┃ editor-guides. | # Change <u>DBNAME</u>, <u>DBUSER</u> and <u>DBPASS</u> to match values given by admin or editor access #📕┃ editor-guides / # setup. | ||
# Save. | # Save. | ||
# Rename <code>config.sample.php</code> to <code>config.php</code>. | # Rename <code>config.sample.php</code> to <code>config.php</code>. | ||
# Go back to main folder and run <code>phpdesktop-chrome.exe</code> | # Go back to main folder and run <code>phpdesktop-chrome.exe</code> | ||
# Optionally create shortcut to it on your desktop. | # Optionally create shortcut to it on your desktop. | ||
[[Category:Server Guides]] |
Latest revision as of 21:41, 4 September 2024
Preparing SSH key-pair
cmd
in menu start or in WIN+R.terminal
in Search Spotlight.Generate OpenSSH key
NOTE: Providing your personal info is not mandatory and not advised. Skip through questions with enter leaving them blank.
- In terminal window type:
ssh-keygen -b 4096
- You will be asked to "Enter file in which to save the key". Press enter for default location. (Advanced Users can customise that to their own ability).
- If you already have key in given location don't agree to Override (Skip to Account Setup and Verification section).
- Set passphrase when asked to, this will encrypt your key and act as a password. (Not mandatory step but highly recommended.
- On success you will see:
Your identification has been saved in .../.../username/.ssh/id_rsa. Your public key has been saved in .../.../username/.ssh/id_rsa.pub. The key fingerprint is: SHA256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx username@hostname The key's randomart image is
Proceed to Account Setup and Verification section.
Account Verification
NOTE: Private key id_rsa
is your unique identity, this file should be kept secret and never shared with anyone. Public key from pair is stored in id_rsa.pub
file. This will be used to setup ssh authentication.
Notify @🧰 Server Admin in #💠┃community-chat. Provide your id_rsa.pub
key in direct message to admin handling your request.
While account is being set up head to PuTTY to prepare tunnel.
PuTTY Setup
Convert OpenSSH key to PPK
- Download PuTTY Package for your system and install.
- Open puttygen.exe from PuTTY installation directory.
- Click File > Load private key.
- Change type of browsed file in bottom right from PuTTY Private Key Files (*.ppk) to All Files (*.*) and select your private
id_rsa
key file. - Enter passphrase if asked to. On sucess you will see:
Successfully imported foreign key OpenSSH SSH-2 private key (old PEM format)). To use this key with PuTTY, you need to use the "Save private key" command to save it in PuTTY's own format.
- Click Save private key.
- Save as .ppk preferably in same directory as your OpenSSH key.
SSH Tunnel
- Open PuTTY.
- Expand SSH list on left panel.
- In left panel expand Connection > SSH and click Auth.
- Click Browse.
- Select your converted .ppk private key. If you cant see Browse in Auth, expand it and click Credentials. Its first field Browse.
- In SSH click Tunnels.
- Set Source Port to server port.
- Set Destination to `127.0.0.1:5432`.
- Click Add.
- In left panel click Session.
- Set Host Name (or IP address) to server ip.
- Set Port to
22
. - In Saved Sessions field type in configuration name to store settings. For example
RenewalSSH
. - Click Save.
Alternatively if you don't plan to use PuTTY for anything else:
- Click Default Settings.
- Click Save.
After configuration is done use Open to start SSH session. When asked to "Login as", type in your given username, then passphrase. If you see -bash
in last line then it works. If Tunnel is working you can proceed to Chakrator Save Manager Setup.
Terminal SSH
NOTE: If you can't use PuTTY or want to use terminal.
- Open Terminal application on your system (refer to your platform).
- Connect by typing
ssh -L server_port:localhost:5432 username@server_ip
where username is your account name. - If you set passphrase to your key, enter passphrase.
Chakratos Save Manager
- Download Chakratos Save Manager referred to as CSM.
- Browse to CSM directory after unpacking.
- Open
/www/config.sample.php
with editor of choice, like notepad. - Change DBNAME, DBUSER and DBPASS to match values given by admin or editor access #📕┃ editor-guides / # setup.
- Save.
- Rename
config.sample.php
toconfig.php
. - Go back to main folder and run
phpdesktop-chrome.exe
- Optionally create shortcut to it on your desktop.