More actions
m Formatting text. |
m Formatting text. |
||
Line 76: | Line 76: | ||
Alternatively if you don't plan to use PuTTY for anything else: | Alternatively if you don't plan to use PuTTY for anything else: | ||
# Click <u>Default Settings</u>. | |||
# Click <u>Save</u>. | |||
After configuration is done use <u>Open</u> to start SSH session. When asked to ''"Login as"'', type in your given username, then passphrase. If you see <code>-bash</code> in last line then it works. If Tunnel is working you can proceed to [[Server Editor Account Setup#Chakratos Save Manager\|Chakrator Save Manager Setup]]. | |||
After configuration is done use | |||
== Terminal SSH == | == Terminal SSH == | ||
''NOTE: If you can't use [PuTTY] | ''NOTE: If you can't use [[Server Editor Account Setup#PuTTY Setup|PuTTY]] or want to use terminal.'' | ||
# Open Terminal application on your system (refer to [[Server Editor Account Setup#Preparing SSH key-pair|your platform]]). | |||
# Connect by typing <code>ssh -L server_port:localhost:5432 username@server_ip</code> where username is your account name. | |||
# If you set passphrase to your key, enter passphrase. | |||
== Chakratos Save Manager == | == Chakratos Save Manager == | ||
# Download [https://github.com/Chakratos/mhf-save-manager/releases Chakratos Save Manager] referred to as '''CSM'''. | |||
# Browse to '''CSM''' directory after unpacking. | |||
# 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 #channel. | |||
# Save. | |||
# Rename <code>config.sample.php</code> to <code>config.php</code>. | |||
# Go back to main folder and run <code>phpdesktop-chrome.exe</code> | |||
# Optionally create shortcut to it on your desktop. | |||
Revision as of 11:30, 4 September 2024
Preparing SSH key-pair
Windows
Open Command Line by typing cmd
in menu start or in WIN+R.
Linux
If GUI based, open Terminal from Applications/Utilities menu or usually CTRL+ALT+T key combination.
Mac
Look for Terminal in Applications/Utilities or type 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
**[Terminal SSH Session]** will work only when admin is done.
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 #channel.
- 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.