How to access fortrabbit services
Learn about the different authentication methods with fortrabbit.
So far so good: You are using your Account e-mail address and your Account password to login to the fortrabbit Dashboard. Beside that, there are these interaction channels with fortrabbit services:
Interactions requiring authentication¶
- Deploying code with Git
- Using SSH
- Using SFTP
- Accessing the MySQL database
- Viewing log files
- Execution SSH Remote commands
- Accessing the Object Storage
Of course these operations need to be protected. We need to make sure that only you and your team have access. You can choose between two authentication methods:
Available authentication methods¶
How to edit your access method¶
In the "Dashboard", go to "Your Account" (upper right). Under "Code access" you can find your current settings. If you have already added an SSH key this section will be called "SSH keys".
SSH key authentication¶
We recommend to use public SSH key authentication to identify yourself with fortrabbit services. It's more secure than password authentication and also more convenient, once you have set it up. SSH key authentication is commonly used with services like BitBucket and GitHub.
How to add public SSH keys¶
SSH keys are stored with your Account. In the "Dashboard" > "Your Account" > "Code access"/"SSH keys" you can add and remove SSH keys.
How to create a public SSH key locally¶
We have a dedicated article on setting up and troubleshooting your local SSH keys.
GitHub SSH key import¶
Automatic import: When signing up to fortrabbit, we'll check at GitHub if there are any public SSH keys associated with your e-mail. If we find any, we'll import them and install them with your account. This is a one time setup, your SSH keys will not be synced. You can manage the SSH keys like any other keys then.
Manual import: You can also tell the import helper your GitHub account, when using different e-mail addresses here and on GitHub. There is a small link which will take you
The direct Dashboard link (login and re-authentication maybe required) will take you there directly.
App-only SSH keys¶
In certain cases you might want to add code access to an App without the need to register a new Account with fortrabbit. One case is a hectic ad-hoc hotfix scenario (good luck!), another case is that you have some advanced deployment with a third party continuous integration service bot going on. So you can install additional App-only custom public SSH keys with each App. You manage those App-only SSH keys in the Dashboard with your App.
Troubleshooting SSH key access¶
Please see the dedicated SSH troubleshoot guide.
Password authentication¶
This is the default method when no public SSH keys are installed. Use this, when you just want to check out fortrabbit or when you have trouble setting up your SSH keys locally. Hobbyists are using Password authentication. Professionals are using SSH key authentication.
How to change from password to SSH key authentication¶
In the "Dashboard" > "Your Account" > "Code access" you can add an SSH key. Once you have added your first public SSH key, password authentication will be disabled and SSH key authentication will be enabled.
How to change from SSH key to password authentication¶
When for some reason SSH key authentication does not work for you, you can downgrade to password like so: In the "Dashboard" > "Your Account" > "SSH keys" you can click on your public SSH keys, this will bring up a view where you can delete the key. When deleting the last key, password authentication will be re-enabled.
When you change your Account password¶
When you change your Dashboard password, for instance when you regain access to the Dashboard in case of a forgotten password, all access to the services will change as well – the new password will be used.
How it works¶
Access schema¶
URLs and terminal commands depend on your chosen access method.
# Git clone example
$ git clone [[ssh-user]]@deploy.[[region]].frbit.com:[[your-app]].git
- [[your-app]] is the name of your App (see Dashboard)
- [[region]] is
eu2
orus1
, depending on the location of your App
With SSH key authentication¶
- No need to enter passwords, your public key will be used
- [[ssh-user]] will be: [[your-app]]
With password authentication¶
- You will need to enter your fortrabbit Account password (each time)
- [[ssh-user]] will be: [[your-app]].[[long-user-string]]
The code example helper¶
When you are currently logged in to the Dashboard (a cookie is stored), you will see a yellow box on the right side here - with a select to choose one of your Apps. This helper knows which authentication method your Account uses. It also changes all code examples on the current page according to the selected App. So you can literary copy/paste all code examples here.
Try it out yourself
# change the values on the right and see the below change
SSH user: {{ssh-user}}
Region: {{region}}
Your app: {{app-name}}
Authentication in teams¶
You manage your code access with your user Account on fortrabbit. This way you always have up-to-date code access on each App you own and collaborate on. It also makes managing the team easy — add/remove collaborators and code access is handled "automagically". Please mind that your team members might have a different access method and that your settings might not work for them. Also see our team work article.