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

Open a command prompt or terminal and execute the following command(s)

Windows / Linux

Section titled Windows / Linux

git config --global credential.helper store

MacOS

Section titled MacOS

git config --global credential.helper osxkeychain

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

   This guide shows you how to generate a Project Access Token. Project Access Token are similar to Personal Access Token, but Project Access Tokens are scoped to a project, so you cannot use them to access resources from other projects.

   1. Sign in to the DataHUB
   2. Open your Project (ARC)
   3. Navigate to ‘Settings’ (1), then ‘Access Tokens’ (2):
   4. Choose a name for your token (1), set an expiration date (optional) (2), assign a role (3), configure permissions (4), and create your token (5):
   5. Once created, you can copy the token:

   Note

   Make sure you save your token, because it is only displayed once.

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.