Agent User Keys (setup)

Getting an Agent Key and a User Key:

DukeDSClient requires a config file containing an agent_key and a user_key. This requires a Duke NetID.

Steps To Create your Agent and User Keys

Go to the Duke Data Service Portal.

1. Click login

2. Click top left menu button

3. Click 'Software Agents'

4. Click 'ADD NEW AGENT' button

5. Fill in data for a new agent and click 'SUBMIT'.

Pick a descriptive name for your software agent as it will be associated with the projects you upload.

6. Click 'CREDENTIALS' on the software agent you just created.

7. Click 'COPY CREDENTIALS TO CLIPBOARD'.

You how have your user and agent key in your clipboard.

Create a file at ~/.ddsclient (do not add .txt or any other extension) and paste your clipboard contents into it. It should look similar to this:

{
    "agent_key": "<AGENT_KEY>",
    "user_key": "<USER_KEY>",
    "api_token": "<API_TOKEN"
}

If you need help creating the .ddsclient config file we have the following guides:

• Creating the ddsclient config file on a Mac
• Creating the ddsclient config file on a Windows

You should be able to now use ddsclient: README.md

Custom url configuration

If you are working with the uatest or dev server you will need to add the appropriate url to ~/.ddsclient.

{
    "url": "https://apidev.dataservice.duke.edu/api/v1",
    "agent_key": "<AGENT_KEY>",
    "user_key": "<USER_KEY>",
    "api_token": "<API_TOKEN"    
}