Skip to main content
Version: 2.8

Active Directory Driver Configuration

Plugin Configuration​

The plugin configuration file is named settings.json located in <install directory>\Config\HumanOS.UHAL.ActiveDirectory\. It contains all global settings of the plugin.

See Generic Plugin Configuration for more details.

Device Information File​

The device information file is used to configure the access to the ActiveDirectory service. It contains:

  • Id: unique device id (GUID), which MUST match the device license id.
  • DriverId: C51BD624-BE93-458C-9F30-1DC12E0CCB24
  • Address: connection address
  • Commands

See Device Information Model for more details.

Connection Address​

The connection requires

  • IP address or host name
  • authentication

The address contains the ip address or hostname (excluding LDAP://).

Authentication parameter are passed as additional properties of the device.

info

Be Aware: Missing user credentials could lead to errors creating or updating users. If no credentials are given in the device schema, start the HumanOS® micro service in the context of the AD user.

Example with UserName and Password:

{
  "Id": "f0c09dff-4094-4647-b935-a73d08b4de2f",
  "Name": "ActiveDirectory Server",
  "DriverId": "C51BD624-BE93-458C-9F30-1DC12E0CCB24",
  "Address": "192.168.20.10",
  "Properties": [
    {
      "Name": "UserName",
      "Value": "<Your AD User>"
    },
    {
      "Name": "Password",
      "Value": "<Your Password>"
    }
  ]
}