DataHUB access

The DataHUB allows you to share your ARCs with registered lab or project partners. After registration, you need to setup the ARC Commander for smooth ARC synchronization between your computer and the DataHUB.

Tip

This needs to be done only once per computer.

Enable Git to store credentials on your computer

Section titled Enable Git to store credentials on your computer

To avoid having to type in your DataHUB credentials, you can enable to store the information (e.g. a DataHUB password or token) on your computer. This leverages the password manager of you operating system.

Windows

1. Open a command prompt or powershell

2. Execute the following command

   git config --global credential.helper store

Macos

1. Open a terminal

2. Execute the following command

   git config --global credential.helper osxkeychain

Linux

1. Open a terminal

2. Execute the following command

   git config --global credential.helper store

Receive and store a DataHUB access token

Section titled Receive and store a DataHUB access token

arc remote accesstoken get -s https://git.nfdi4plants.org

A browser window will open asking for your DataPLANT login. After login you are asked to authorize your computer to communicate with the DataHUB. In case you are already logged in, the browser will directly display a plain Success message to you.

Tip

This authenticates your computer to communicate with your personal DataHUB account

Tip

After two hours you have to repeat this process as this token will expire. Have a look at the next section to learn how to create a longer lasting token (e.g. for large data uploads).

Store a configurable DataHUB access token for your project

Section titled Store a configurable DataHUB access token for your project

Access tokens created with the ARCommander expire after two hours. To create a longer-lasting access token for your project, follow these steps:

1. Create a project access token

   Note

   This guide shows you how to generate a Project Access Token.
   Project Access Tokens are scoped to a single ARC and cannot be used for other ARCs.

   1. Sign in to the DataHUB

   2. Open your Project (ARC)

   3. Navigate to the ARC’s settings

   4. Open the Access Tokens settings in the sidebar (1)

   5. Enter or adapt the required token information (2) (more about token information here)

   6. Click Create project access token (3)

      

   7. Your new project access token appears on top. Copy (4) and use it in the desired application.

      

2. Store the token in your local ARC

   arc remoteaccess accesstoken store --token <replaceWithYourToken>

Once set up, you will not need to authenticate yourself (e.g., by manually retrieving a token through ‘arc remote token get’) until the token expires. When switching to another machine you have to repeat the process.