Creating an Account: Difference between revisions

From Network for Advanced NMR
Jump to navigationJump to search
No edit summary
No edit summary
 
(5 intermediate revisions by the same user not shown)
Line 6: Line 6:
[[File:Lab-permissions.png|thumb|'''Figure 5.''' Lab Permission Matrix]]
[[File:Lab-permissions.png|thumb|'''Figure 5.''' Lab Permission Matrix]]


Creating an '''[https://nmrhub.org NMRhub]''' account provides access to both '''[https://nmrbox.org NMRbox]''' and the '''[https://usnan.org Network for Advanced NMR (NAN)]'''. These services share a common single sign-on (SSO) system. Before you begin, please note the following:
Creating an '''[https://nmrhub.org NMRhub]''' account provides access to both '''[https://nmrbox.org NMRbox]''' and the '''[https://usnan.org Network for Advanced NMR (NAN)]'''. These services share a common single sign-on (SSO) system.
 
Before you begin, please note:


* All account requests are reviewed for eligibility.   
* All account requests are reviewed for eligibility.   
* If you indicate that you are a '''Principal Investigator (PI)''', your status will be verified.   
* If you indicate that you are a '''Principal Investigator (PI)''', your status will be verified.   
* Account approvals may take up to '''three business days'''.   
* Account approvals may take up to '''three business days'''.   
* '''NAN uses a permission model:'''
* '''NAN uses a permission model:'''
** '''PIs''' manage access to datasets collected within their research groups.
** '''PIs''' manage access to datasets collected within their research groups.
Line 21: Line 20:


== Steps to Create an Account ==
== Steps to Create an Account ==
=== Start the Registration ===
# Go to the '''[https://nmrhub.org NMRhub]''' homepage and click '''Register''' under the "All together now" heading (see '''Figure 1''').
# Go to the '''[https://nmrhub.org NMRhub]''' homepage and click '''Register''' under the "All together now" heading (see '''Figure 1''').
# Alternatively, use the user icon in the top right-hand corner of the NMRhub, NMRbox, or NAN websites. Click the down arrow and select '''Register'''.
# Alternatively, click the user icon in the top-right corner of the NMRhub, NMRbox, or NAN websites. Click the down arrow and select '''Register''' (see '''Figure 2''').
# Enter your '''institutional email address'''. You may also enter a preferred email address, but it is not required.
 
#* '''Note:''' If you previously had an account under a different institutional email, please log in and update your email rather than creating a second account.
=== Enter Email Information ===
# Click the '''Next''' button.
# Enter your '''institutional email address'''. A preferred email address is optional.
# Link your '''ORCID iD'''.
#* '''Note:''' If you previously had an account under a different institutional email, log in and update it rather than creating a new account.
#* This helps verify your identity and ensures the ORCID iD is actually yours.
# Click '''Next'''.
#* It is useful if you later lose access to your institutional email, allowing us to verify and approve email change requests.
 
#* Only your first and last name are requested from your ORCID profile.
=== Link Your ORCID iD ===
#* If you do not have an ORCID iD, you can create one and link it during registration.
# Click the link to connect your ORCID iD.
# Complete the form by entering the following details:
#* This helps verify your identity and ensures the ORCID iD is valid and belongs to you.
#* First and last name
#* It allows us to confirm identity if you later lose access to your institutional email.
#* Institution (select from the dropdown menu as you begin typing)
#* Only your '''first and last name''' are requested from your ORCID profile.
#** Institutions are verified, and names may be normalized (e.g., "UConn Health Center" vs. "UCHC")
#* If you don’t have an ORCID iD, you may create one and link it during this step.
#* Department
 
#* Job title
=== Complete the Registration Form ===
#* Address (street, country, state/province, city, and zip code)
# Provide the following information (see '''Figure 3'''):
#* Account type:
#* '''First and last name'''
#** '''Academic / Government / Non-Profit''': Will be verified. Grants access to '''NMRbox production servers''', NAN, and other NMRhub resources.
#* '''Institution''' – select from the drop-down as you type
#** '''Commercial''': Grants access to NAN but '''not''' to NMRbox.
#** Institutions are validated and may be normalized (e.g., "UConn Health Center" vs. "UCHC")
#* '''Department'''
#* '''Job title'''
#* '''Mailing address''' (including country, state/province, city, and zip code)
#* '''Account type'''
#** '''Academic / Government / Non-Profit''' verified users get access to '''NMRbox production servers''', NAN, and other NMRhub resources.
#** '''Commercial''' access to NAN but not to NMRbox.
# Click '''Looks Good''' to proceed.
# Click '''Looks Good''' to proceed.
# Optionally provide a '''cell number''' and consent for text messages.
 
#* '''Note:''' The number is only used by facility staff to contact you regarding sample submissions. It will not be used for any other purpose.
=== Optional: Phone Number ===
# Check the '''I am a Principal Investigator''' box if applicable.
# Optionally, provide a cell number and indicate whether you consent to text messages.
#* PI status will be verified by NMRhub staff. Please only select if you are a PI.
#* '''Note:''' This number is used only by facility staff to contact you about sample submissions.
# Use the '''Add an additional PI''' button to associate your account with one or more PIs.
 
#* You may be linked to multiple PIs.
=== Select PI Status or Add PIs ===
#* You can also request or manage PI associations later using the '''Manage Account''' option in the '''NMRhub widget''' (see '''Figure 2''').
# Check the '''I am a Principal Investigator''' box if applicable (see '''Figure 4''').
#* PI status is verified by NMRhub staff. Only select if appropriate.
# Add one or more PIs using the '''Add an additional PI''' button (see '''Figure 4''').
#* You may associate with multiple PIs.
#* You can also manage PI associations later via the '''Manage Account''' option in the NMRhub widget (see '''Figure 2''').
#* PIs may also be associated with other PIs.
#* PIs may also be associated with other PIs.
# Click the '''Finish''' button to submit your registration.
# Click '''Finish''' to submit your registration.


== What Happens Next? ==
== What Happens Next? ==


* You will receive a confirmation email indicating that your account request has been submitted.
=== Account Review ===
* Your request will enter our system for review. We will verify:
* You will receive an email confirming that your request has been submitted.
** Your institutional affiliation,
* Your registration will be reviewed for:
** PI status (if requested),
** Institutional affiliation
** And academic / government / non-profit status (if selected).
** PI status (if applicable)
* If you added one or more PIs to your account, they will receive an email from '''support@nmrhub.org''' with a request to approve the association.
** Account type (academic / government / non-profit vs. commercial)
** The email includes a link to the '''Lab Permission''' page (see '''Figure 5''').
 
** PIs may approve the association before your account is fully approved.
=== PI Verification Process ===
** If a PI does not yet have an account, they will be prompted to create one before they can approve your request. Your original request will still be valid.
* If you added PIs, they will receive an email from '''support@nmrhub.org''' requesting their approval.
** '''Important:''' Use the same institutional email address for PI requests as the PI used when creating their account. If your PI cannot see your request, verify that the email matches exactly (e.g., '''markm@uchc.edu''' vs. '''markm@biochem.uchc.edu''').
* The email links to the '''Lab Permission''' page (see '''Figure 5''') where they can approve or deny your request.
* Once your account is approved, you will receive an email with instructions for setting your password and accessing services for the first time.
** PIs may approve your request even before your account is fully approved.
** If a PI does not have an account yet, they’ll be prompted to create one first. Your original request will remain valid.
** '''Important:''' Make sure the PI email address you enter matches the one they used to create their NMRhub account. Otherwise, they won’t see your request (e.g., '''markm@uchc.edu''' vs. '''markm@biochem.uchc.edu''').
 
=== Final Approval ===
* Once your account is approved, you’ll receive an email with instructions for setting your password and logging in for the first time.
 
== Common Issues ==
 
==== PI does not have an NMRhub account ====
 
* If you need to link your account with your PI and they do not have an account the best option is to prod them a bit. This is only relevant for NAN, but is important as the datasets are controlled by the PI.
 
==== Your PI takes too long to approve PI requests ====
 
* We added a PI delegate role where a PI can designate a user as a PI delegate to act on their behalf. In this way the PI only needs to go through the process of creating their account and then can hand off duties to someone in the lab or an administrator.
 
==== Your PI has an account, but did not get your PI request ====
 
* The most likely cause of this is that either your PIs account is not selected as a PI in our system or you used a different institutional email for your PI then they used when they created their account. If they are not listed as a PI in our system ask them to go to the Manage Account from the NMRhub widget found on the NMRhub, NMRbox, and NAN sites and check the "I am a PI" checkbox. Once we verify the PI status your PI request will be visible immediately for them to approve.

Latest revision as of 18:57, 14 July 2025

Introduction

Figure 1. NMRhub registration page
Figure 2. NMRhub widget
Figure 3. Registration form
Figure 4. Adding a PI during registration
Figure 5. Lab Permission Matrix

Creating an NMRhub account provides access to both NMRbox and the Network for Advanced NMR (NAN). These services share a common single sign-on (SSO) system.

Before you begin, please note:

  • All account requests are reviewed for eligibility.
  • If you indicate that you are a Principal Investigator (PI), your status will be verified.
  • Account approvals may take up to three business days.
  • NAN uses a permission model:
    • PIs manage access to datasets collected within their research groups.
    • Users must be associated with a PI to view datasets in the NAN data browser.
    • Accounts can be linked to multiple PIs, and PIs can be associated with other PIs for collaborative data management.
    • If your account is not linked to a PI, or you are not a PI yourself, you will not be able to see datasets within the NAN data browser.

Steps to Create an Account

Start the Registration

  1. Go to the NMRhub homepage and click Register under the "All together now" heading (see Figure 1).
  2. Alternatively, click the user icon in the top-right corner of the NMRhub, NMRbox, or NAN websites. Click the down arrow and select Register (see Figure 2).

Enter Email Information

  1. Enter your institutional email address. A preferred email address is optional.
    • Note: If you previously had an account under a different institutional email, log in and update it rather than creating a new account.
  2. Click Next.

Link Your ORCID iD

  1. Click the link to connect your ORCID iD.
    • This helps verify your identity and ensures the ORCID iD is valid and belongs to you.
    • It allows us to confirm identity if you later lose access to your institutional email.
    • Only your first and last name are requested from your ORCID profile.
    • If you don’t have an ORCID iD, you may create one and link it during this step.

Complete the Registration Form

  1. Provide the following information (see Figure 3):
    • First and last name
    • Institution – select from the drop-down as you type
      • Institutions are validated and may be normalized (e.g., "UConn Health Center" vs. "UCHC")
    • Department
    • Job title
    • Mailing address (including country, state/province, city, and zip code)
    • Account type
      • Academic / Government / Non-Profit – verified users get access to NMRbox production servers, NAN, and other NMRhub resources.
      • Commercial – access to NAN but not to NMRbox.
  2. Click Looks Good to proceed.

Optional: Phone Number

  1. Optionally, provide a cell number and indicate whether you consent to text messages.
    • Note: This number is used only by facility staff to contact you about sample submissions.

Select PI Status or Add PIs

  1. Check the I am a Principal Investigator box if applicable (see Figure 4).
    • PI status is verified by NMRhub staff. Only select if appropriate.
  2. Add one or more PIs using the Add an additional PI button (see Figure 4).
    • You may associate with multiple PIs.
    • You can also manage PI associations later via the Manage Account option in the NMRhub widget (see Figure 2).
    • PIs may also be associated with other PIs.
  3. Click Finish to submit your registration.

What Happens Next?

Account Review

  • You will receive an email confirming that your request has been submitted.
  • Your registration will be reviewed for:
    • Institutional affiliation
    • PI status (if applicable)
    • Account type (academic / government / non-profit vs. commercial)

PI Verification Process

  • If you added PIs, they will receive an email from support@nmrhub.org requesting their approval.
  • The email links to the Lab Permission page (see Figure 5) where they can approve or deny your request.
    • PIs may approve your request even before your account is fully approved.
    • If a PI does not have an account yet, they’ll be prompted to create one first. Your original request will remain valid.
    • Important: Make sure the PI email address you enter matches the one they used to create their NMRhub account. Otherwise, they won’t see your request (e.g., markm@uchc.edu vs. markm@biochem.uchc.edu).

Final Approval

  • Once your account is approved, you’ll receive an email with instructions for setting your password and logging in for the first time.

Common Issues

PI does not have an NMRhub account

  • If you need to link your account with your PI and they do not have an account the best option is to prod them a bit. This is only relevant for NAN, but is important as the datasets are controlled by the PI.

Your PI takes too long to approve PI requests

  • We added a PI delegate role where a PI can designate a user as a PI delegate to act on their behalf. In this way the PI only needs to go through the process of creating their account and then can hand off duties to someone in the lab or an administrator.

Your PI has an account, but did not get your PI request

  • The most likely cause of this is that either your PIs account is not selected as a PI in our system or you used a different institutional email for your PI then they used when they created their account. If they are not listed as a PI in our system ask them to go to the Manage Account from the NMRhub widget found on the NMRhub, NMRbox, and NAN sites and check the "I am a PI" checkbox. Once we verify the PI status your PI request will be visible immediately for them to approve.