Anyone can browse public content on Synapse, but you will need to register for an account to download and add content. To create an account, you must be over the age of 13 and have an email address. You will receive an email message for verification to complete the registration process.
Certain actions in Synapse require additional steps, such as certification or validation. Explore the different Synapse user account types to learn more about which account type you need.
Managing Your Profile
Visit your Profile Page, which can be accessed by clicking your name in the top right corner and selecting Profile from the menu. From there, you can click on Edit Profile in order to take any of the following actions:
Change your Synapse username
Add or edit your first and last names
Add or edit additional information, such as your affiliation or title
Upload a profile picture
Include a brief biography
Link your ORCID credentials
You can also find a link to edit your profile under Settings, which can be accessed by clicking your name in the top right corner and selecting Settings from the menu. From your Setting page, you can manage your password, preferred email, your preferred date/time format, and your Synapse API key.
Important: Do not reuse passwords from other sites. We recommend generating a unique password and using a secure password manager to protect your Synapse account.
Adding Additional Email Addresses
Your Synapse account can have multiple email addresses associated with it. For each new email that you add, a notification will be sent to the chosen email address with a confirmation link. Follow the link to confirm ownership of the email account.
Adding Google Email Addresses to Enable SSO
Synapse integrates with Google’s Single Sign On (SSO) using OAuth 2.0, allowing you to sign in with your Google credentials. If you are already signed in to Google in your web browser, then you can sign in to Synapse without entering a password once you have connected your Google account.
To enable SSO, create your Synapse account using your Google email address, or add a Google email address as a secondary email. You can use a Gmail address, or an institutional email address configured to be used with Google Suite. To add a secondary Google email, go go to your accounts settings by clicking your name in the upper right of any Synapse page (you must be logged in to Synapse) and select Settings. Scroll down to the Email section of your account settings and add your Google-recognized email address (as shown in Gmail ) to your account.
Sometimes it is not obvious what your Google-recognized email is, and you may have more than one alias. One way to check is to open Gmail in your browser and click on your photo or icon in in the upper right corner. The dialog that pops up will show the correct address.
Once you have created your Synapse account and added your Google email address, sign out of Synapse and sign back in using Google by clicking “Sign in with Google” on the Synapse login page.
Synapse Email and Notifications
Synapse creates an email alias for you when you create an account, <your username>@synapse.org. Synapse uses this email as a relay to send and receive messages, keeping your registered email address private.
To send email to <someone>@synapse.org, you must send the email from an address that is registered with Synapse. Messages sent from an unregistered email address will bounce back. Synapse will forward your message to your recipient’s registered email address. When that message is received, your email address will be replaced with your Synapse email alias (<your username>@synapse.org).
Synapse also sends platform notifications via email, such as @mentions in discussion forums, but it only sends them to the single email address you have selected to be your primary email. You can manage this preference on your Settings page.
Logging in
Personal Access Tokens
You can log in to the Synapse command line, Python or R clients using a personal access token instead of your username and password. Using a token is highly recommended over a username and password since a token can be easily revoked if it is compromised. Additionally, each token can be scoped so that it only grants permission to certain parts of your Synapse account, whereas your username and password have access to your whole account.
To generate a personal access token in the web client, navigate to your Settings page, scroll to the bottom of the screen, and click the Manage Personal Access Tokens button. You can view a list of the existing tokens and their permissions, or click Create New Token to generate a new personal access token with customized access to your Synapse account.
See Client Configuration for more information on configuring Synapse clients using an access token.
API Key
Synapse also currently supports a legacy API key that can be used in place of a password, however api key support is considered deprecated in favor of personal access tokens.
Should you need it, you can find your API key through the user icon in the top right corner of the web client, selecting Profile and Settings. Your Synapse API key is available in the box furthest to the bottom of Settings and can be made visible with Show API Key.
Deactivating Your Account
All user activity on Synapse is recorded for auditing purposes. So, although they can be updated, Synapse accounts cannot be deleted. All of your public activities are and will remain publicly viewable. All of your activities within private projects are and will remain viewable to the people within that project. If you wish to deactivate your account, please contact us.
Related articles:
User Types, /wiki/spaces/DOCS/pages/1985904796