For developers

Setting up a new user

3min

Developer accounts are created by the hosting administrators. For each developer account, administrators should provide the following:

  • Username, password and URL to log into AWS account. These credentials will be used only for the two-factor authenciation set up and access/secret API keys management.
  • VPN configuration file. This file comforms with Open VPN standard and is used to access development and production environments deployed to the hosting.

When this information is received by a developer, they should perform the initial set up using the following instructions:

  • Log into the AWS Console using the credentials provided by the hosting administrators
  • Go to your IAM account to set up MFA (multi-factor auth). Select "Authenticator App" option and follow the AWS guidance to finish the configuration.
  • Open your IAM account in AWS and switch to the Security credentials tab
  • Click on Create access key button
  • Select Other use case and click Next
  • Set Description value (or keep it empty) and click Create access key
  • Copy generated Access key and Secret access key values into a secure place

Put the credentials into a credentials file inside of your ~/.aws folder (the folder location can be other than ~/.aws, it's just the default folder name and location recommended by AWS CLI guidelines):

Linux


Developers should download and install any Open VPN client of their preference (we recommend OpenVPN Connect).

For each user, the hosting administrator will provide a VPN configuration file (<userName>.<clusterName>.ovpn). Developers need to create a new connection profile from the provided file. For example, for OpenVPN Connect developers can just drag & drop the .ovpn file to OpenVPN Connect application and hit "Save" to the imported profile.

This VPN connection does NOT change public IP address of the device. It only allows to connect to the private network where the cluster with the project is located, to interact with the project environments.