Network for Advanced NMR - User contributions [en]

Account Update

2026-09-14T15:45:18Z

Jwedell: /* Step 1: Log into NMRhub to Generate the Magic Link */

Starting '''9/22/2026,''' NMRhub users will be required to use [[wikipedia:Multi-factor_authentication|Two factor authentication (2FA)]] to log into NMRhub services including NMRhub, NMRbox and NAN websites, connections to NMRbox servers via SSH or RealVNC, as well as FileZilla file copies to and from NMRbox servers. In addition, as part of the 2FA implementation, NMRhub accounts will be migrated to a new user account management system which requires a one-time password reset for all NMRhub accounts. All NMRhub users should follow the process below to complete the initial setup steps include resetting password, setting password recovery questions and adding NMRhub in an authenticator application.

== Step 1: Begin to log into NMRhub to Generate the Magic Link ==
Begin the log-in process on NMRhub with your current NMRhub account. An email from support@nmrhub.org that contains a magic link will be sent to the email address associated with your NMRhub account to start the 2FA set up process.

[[File:Email check.png|frameless|600x600px]]

The email is as below:<blockquote>''Dear <user>,''

''We received a request to reset your password for NMRhub username: <username>''

''Please click here and follow the prompts to update your password.''

''If you did not request a password reset, please contact us at: support@nmrhub.org''

''Thank you,''

''NMRhub Support Team''

''UConn Health''</blockquote>

== Step 2: Reset Password and Create Security Questions ==
Click on the link in the email. You will be guided through the following steps to complete the 2FA setup:

# Reset password. This step will be skipped if you've recently reset your password. The new password must meet the current password complexity rules.
# Create security questions and the answers to them:

=== Security questions ===
After setting your password (if required), complete security questions:

[[File:Questions.png|frameless|600x600px]]

== Step 3: Add NMRhub account to your authenticator application ==
Scan the QR code and add NMRhub to the authenticator app of your choosing.

[[File:Qrcode.png|frameless|600x600px]]

== Step 4: Log in ==
After you finish setting up the 2FA authenticator, log into NMRhub - You will be required to enter a One-Time-Password (OTP) generated in your phone authenticator app.

While you may save your password in a password manager, the OTP will be generated in real time and need to be entered after the previous 2FA authentication expires.

[[File:Keycloak.png|frameless|600x600px]]

Account Update

2026-09-10T19:19:44Z

Jwedell:

On '''TBD,''' NMRhub will switch over to requiring [https://en.wikipedia.org/wiki/Multi-factor_authentication Two factor authentication]. This will require setting up an authenticator and setting recovery questions.

== Update process ==
When logging in to website after update, you will receive a notification to check your institution email

[[File:Email check.png|frameless|600x600px]]

Look for email similar to<blockquote>''Hello <user>,''

''NMRbox is moving to a new account system, and your account needs a few minutes of your''

''attention before you can sign in again. Nothing has gone wrong, and you have not been''

''locked out -- but this has to be done before the changeover, or you will lose access to''

''NMRbox, including SSH and VNC.''

''Use this link to finish setting up your account:''

''<nowiki>https://nmrhub.org/forgot-password/</nowiki><long string>''

''It will walk you through whatever is still outstanding: setting a password, choosing two''

''security questions, and setting up an authenticator app for two-factor sign-in. Have your''

''phone to hand -- you will need to install an authenticator app if you do not already have''

''one. The link is good for 24 hours; if it expires, just start signing in again and we''

''will send you a fresh one.''

''If you have any trouble, reply to this message or write to''

''support@nmrbox.org and we will help you through it.''

''— The NMRbox team''</blockquote>

If you've completed any of the following three steps, it will automatically be skipped if you resume this process again later.

== Password ==
Following the link, you will likely be prompted to set a new password (unless you have recently changed your password). f your old password meets our complexity rules, you can continue using it, but you must still go through this process to set it again. This is required as we are migrating to a new user management system and cannot automatically migrate your existing password.

== Security questions ==
After setting your password (if required), complete security questions:

[[File:Questions.png|frameless|600x600px]]

== OTP QR code ==
You will then be prompted to add a QR (quick-response) code to your authenticator app and verify the code it returns.

[[File:Qrcode.png|frameless|600x600px]]

== Logging in ==
Finally, you'll be taken to the logon page for the website and Opensearch Dashboards.

While you can save your password in a password manager, the OTP will change and will need to entered.

[[File:Keycloak.png|frameless|600x600px]]

As long as you are using the same browser on the same machine, website logon will only be needed periodically.

Public and Publishing

2025-12-31T16:05:15Z

Jwedell: Add a section on ARK identifiers.

{{Datasets}}

= Overview =
NAN distinguishes between public and published as described below. Note that all published datasets are also public and that public datasets are viewable by everyone, even those who are not authenticated with an NMRhub account.

== Public Datasets ==
A dataset marked as '''public''' is viewable through the data browser by anyone, including users without a NAN account. Authorized users may continue to edit public datasets.

* Users with proper permissions may manually mark datasets as public at any time.
* By policy, datasets are automatically made public three years after archival.
* Within six months of the scheduled public release date, users may opt to extend the release by one additional year.
* The public release date is displayed in the data browser and can be used for sorting and filtering.

== Published Datasets ==
'''Publishing''' a dataset performs the following:

* Makes the dataset public
* Creates an immutable, versioned snapshot of the dataset
* Assigns an ARK persistent unique identifier (PUI)

The published version includes:

* All dataset files
* Metadata and database records
* Associated samples
* Any supplemental data

The original (parent) dataset remains fully editable. A reference is maintained between the parent and all published versions. If a user requests to publish a dataset that has not changed since the last publication, a new version is not created.

== Publishing Dataset Collections ==
Dataset collections may also be published. When a collection is published:

* Each dataset within the collection is individually published following the same process
* The collection itself receives a dedicated ARK identifier
* The ARK resolves to the published collection view in the data browser

== Versioning and Provenance ==

* When re-publishing a dataset a new version number is created (e.g. V1, V2, V3)
** If no changes to the dataset have been made since it was last published a new version is not created.
* All changes to datasets are tracked in a provenance record.
* All published versions and the original dataset are linked together so that users can see all versions of a given dataset

== ARK Identifiers ==

* We issue ARK identifiers as our persistent identifier. ARKs behave similarly to DOIs. Documentation on how to interpret an ARK identifier is available [https://arks.org/about/ here].
* They key points to know are that you should provide the entire string when you copy an ARK identifier on the NAN web site. In other words, don't strip off the domain (technically the "name mapping authority") from the ARK when publishing.
** An example full ARK: https://usnan.org/ark:/83454/c16be2f687-3f23-4986-9181-d1fd71cffc56
* Note that it is possible to track down a resource with just the `ark:/83454/c16be2f687-3f23-4986-9181-d1fd71cffc56` portion of the identifier, but this requires extra manual steps.
** For example, you can use <nowiki>https://n2t.net/</nowiki> as the "name mapping authority" to resolve these ARK fragments ([https://n2t.net/ark:/83454/c16be2f687-3f23-4986-9181-d1fd71cffc56 example]) as well as DOIs ([https://n2t.net/doi:10.3390/s23218689 example]) and other identifiers.

How do I get access to NAN

2025-07-10T18:55:13Z

Jwedell: Created FAQ on getting access to datasets on NAN

==== Register ====
[https://nmrhub.org/register Register] for an NMRhub account if you don't already have one. If you have one (but have lost access) please contact support rather than making a duplicate registration.

==== Add your PI ====
Once your account is approved - which can take up to three business days (you will be notified via e-mail when it is created) - head to your [https://nmrhub.org/user-dashboard user dashboard] and at the bottom of the page ensure you have added your PI. Please ensure you use the same e-mail they use for their NMRhub account when you add them. Click save.

It is also possible to link your PI when creating your NMRhub account. If so (and you used the correct e-mail address) you should skip this step.

==== Have your PI approve the request ====
Your PI (or their PI delegate if they have assigned one) must head to their [https://usnan.nmrhub.org/data-browser/lab-administration/permissions/lab lab administration page] and approve your PI-link request, which should be visible to them if you've used the correct e-mail. At this point you will have access to any datasets assigned to you in NAN, but not datasets assigned to your PI or other lab group members. If your PI wants to share access to these datasets with you, then they need to complete the "Share lab data" instructions below.

==== Share lab data ====
Your PI (or their PI delegate if they have assigned one) must head to the [https://usnan.nmrhub.org/data-browser/lab-administration/permissions/lab lab administration page] and ensure that the checkbox for the yellow "Read" column is clicked for you, and click save. This gives you read access to all datasets in the lab group. If they don't want to give you read access to all datasets owned by any member of the lab group they can create a new project, put the datasets to share in the project, and then head to the projects permissions page to give you access just to that project. Most lab groups share their datasets and therefore this FAQ doesn't cover that process.

==== Ensure your datasets are assigned to you ====
If you don't have your own datasets, you just access to lab datasets - you don't need to worry about this. If you have datasets that you collected or a facility collected for you, read on.

Each dataset has both a person of record (the experimenter) and a PI (who has ultimately ownership of the dataset). If you didn't have an account when your experiments were ran, you will need someone to assign your datasets to you. Your facility manager has the ability to perform this action upon your request, and your PI (or their delegate) can also reassign datasets amongst lab group members. If your datasets were not assigned to any member of your PIs lab, only your facility manager can assign them to you.

Frequently Asked Questions

2025-07-10T18:40:46Z

Jwedell: /* Data Browser */ Add new FAQ for getting first access (and PI link)

__NOTOC__
{{search}}


== Facility Dashboard ==
<div class="mw-collapsible" style="margin-bottom: 1em;">
<div style="background: #f9f9f9; border: 1px solid #ccc; padding: 0.5em; border-radius: 6px;">
* [[How to edit an instrument if the console or magnet have changed?|How do I edit an instrument if the console or magnet has changed?]]
</div>
</div>


== Data Browser ==
<div class="mw-collapsible" style="margin-bottom: 1em;">
<div style="background: #f9f9f9; border: 1px solid #ccc; padding: 0.5em; border-radius: 6px;">
*[[How do I get access to NAN|How do I gain access to NAN (and to my datasets)?]]

* [[Why do my datasets not appear in the data browser?]]
* [[What is the difference between public and published datasets|What is the difference between public and published datasets?]]
</div>
</div>


== NAN Data Transport System (NDTS) ==
<div class="mw-collapsible" style="margin-bottom: 1em;">
<div style="background: #f9f9f9; border: 1px solid #ccc; padding: 0.5em; border-radius: 6px;">
* [[Why can I not select my NAN username from the NDTS GUI on the spectrometer?|Why can't I select my NAN username in the NDTS GUI?]]
* [[NAN GUI loses track of user|Why are datasets not associated with my NAN username even though my name is shown on the front of the NAN GUI?]]
* [[How do I suppress the harvesting of calibration experiments?]]
</div>
</div>


== UHF Access ==
<div class="mw-collapsible" style="margin-bottom: 1em;">
<div style="background: #f9f9f9; border: 1px solid #ccc; padding: 0.5em; border-radius: 6px;">
* [[Why can't I create a New Request for UHF access?|Why can't I create a New Request for UHF Access?]]
</div>
</div>


== Mediahub ==
<div class="mw-collapsible" style="margin-bottom: 1em;">
<div style="background: #f9f9f9; border: 1px solid #ccc; padding: 0.5em; border-radius: 6px;">
* [[What is Mediahub?]]
</div>
</div>

[[Category:FAQ]]