There are multiple ways one can login to Synapse. We recommend users to choose the method that fits their workflow.
Use username and password to login as follows:
For writing code using the
synapser client, that is easy to share with others, please do not include your credentials in the code. Instead, please use
.synapseConfig file. You can refer your collaborators to the following documentation on how to set up a
First, create a
.synapseConfig file in your home directory with the following content:
[authentication] username = your_username apikey = your_apikey
You can choose to specify either
apikey. For security purposes, we recommend that you use Synapse apikey instead of your password.
Then login without specifying your username and password:
For users who would like to save their credentials and let other OS configured applications (like keychain in Mac) manage credentials for them, when logging in for the first time, use:
The application (keychain in Mac) will then prompt you to allow other applications including Python and R to access these credentials. Please choose “Yes” or “OK”.
The second time you login, you will not have to enter your username or password: