More actions
m →SSH Tunnel: Formatting text. |
Added tab view for platforms. |
||
Line 1: | Line 1: | ||
== Preparing SSH key-pair == | == Preparing SSH key-pair == | ||
<tabs> | |||
= | <tab name="Windows">Open <u>Command Line</u> by typing <code>cmd</code> in menu start or in WIN+R.</tab> | ||
Open <u>Command Line</u> by typing <code>cmd</code> in menu start or in WIN+R. | <tab name="Linux">If GUI based, open <u>Terminal</u> from <u>Applications</u>/<u>Utilities</u> menu or usually CTRL+ALT+T key combination.</tab> | ||
<tab name="Mac">Look for <u>Terminal</u> in <u>Applications</u>/<u>Utilities</u> or type <code>terminal</code> in Search Spotlight.</tab> | |||
</tabs> | |||
If GUI based, open <u>Terminal</u> from <u>Applications</u>/<u>Utilities</u> menu or usually CTRL+ALT+T key combination. | |||
Look for <u>Terminal</u> in <u>Applications</u>/<u>Utilities</u> or type <code>terminal</code> in Search Spotlight | |||
=== Generate OpenSSH key === | === Generate OpenSSH key === |
Revision as of 11:45, 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
**[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.