Export and Import Users and Groups

Since ProGet 6.0.6, you can export your built-in users and import them into another ProGet instance. This makes sharing and maintaining your built-in users and groups much easier.

Export Users & Groups

You can export all users and groups of your instance to a JSON file. This contains information about the users and an encrypted version of their password. After exporting, you can easily edit the file (add or remove users or groups) and import it. You can import these into BuildMaster and Otter as well.

To export your users and groups, navigate to Administration > Users & Tasks > Users and click the "Export" button below the user table.

The passwordBytes and saltBytes can also be hidden by clicking the "Hide Password Bytes" button.

Importing Users & Groups

The Import feature allows you to quickly configure ProGet's users and groups or make multiple changes by importing the JSON file exported from another instance of ProGet. In one of the next versions of BuildMaster and Otter you will be able to import users and groups into them as well.

To import your users and groups, navigate to Administration > Users & Tasks > Users and click the "Import" button below the user table.

The "dry run" option allows you to see the changes that will be made before you actively make the changes.

Updating passwords in bulk

You can also use the "Import users and groups" feature to update passwords in bulk. To do this, simply remove the passwordBytes and saltBytes for the users you would like to update and replace it with "password": "yourNewPassword".

Example:

{
  "users": [
    {
      "userName": "Admin",
      "displayName": "Administrator",
      "passwordBytes": "6R53UEz8LiA/yIyaWf0HAbc9zQ4=",
      "saltBytes": "sBaGqDLnTykFGQ==",
      "groups": [
        "Administrators"
      ]
    },
    {
        "userName": "jDoe",
        "displayName": "John Doe",
        "password": "MySecurePassword!",
        "groups": [
            "Developers"
        ]
    }
  ],
  "groups": [
    "Administrators",
    "Developers"
  ]
}