Skip to main content
Version: FCP 25.11

AD Domain Controller Configuration

This document describes how to configure the AD domain controller service and user attributes so that the Fastone platform can correctly retrieve user properties.

The configuration steps are as follows.

Notes

  • Ensure that port 389 on the AD server is reachable over the network.
  • User passwords in AD cannot be modified from the Fastone platform.
  • When creating a user, do not select "User must change password at next logon". Otherwise, the user will not be able to log in to the Fastone platform with that password.
  • Group names and user names in AD cannot be identical.
    To keep the user name consistent with the user's primary group name, you can make the user's logon name different from the display name when creating the user. Also place all groups in one OU and all users in one OU.
    Example: ed85d70b9171bb62ca0fe821fad19bb436dbad34a36749324dc2ff659c407d0b 6fb2239a910bf947050d6b8937f8b17f67c05effd0bf8f3596587a500b960f3f

AD Domain Controller Configuration

Log in to the Windows Server that will act as the AD server, open Server Manager, and install the required features.

cf4ca75775fed0ac76168106abe20fb1f1afd2437e3aa7e17f30f2ed4366fd13.png

After the installation is complete, make sure the server has been promoted to a domain controller.

31d6e7c8056120b73f54e8e00afa767276197ae564701d190f7117a432793f5a

Entry Configuration

tip

Make sure users and user groups in the AD authentication system include the attributes specified by the RFC2307 standard.
Once this standard is met, users and user groups in AD can be correctly mapped into the Linux system.

For details about RFC2307, refer to rfc2307.

For user groups, ensure the following attributes are present:

  • objectClass: posixGroup
    This value is fixed.
  • gidNumber
    The group GID in Linux. By convention, it starts from 1000, for example: 1500.
  • cn
    The group name in Linux, for example: mawu.
  • memberUid
    The members of the Linux group, used to declare which users belong to the group, for example: mawu.

For users, ensure the following attributes are present:

  • objectClass: posixAccount
    This value is fixed.
  • objectClass: shadowAccount
    This value is fixed.
  • cn
    The user name in Linux, for example: mawu.
  • uid
    The user name in Linux, for example: mawu.
  • uidNumber
    The user's uidNumber in Linux. By convention, it starts from 1000, for example: 1500.
  • homeDirectory
    The user's home directory. The path must be unique. You can use a prefix such as xxx followed by the user name, for example: /fastone/users/mawu.
  • gidNumber
    The GID of the user's primary group in Linux, for example: 1500.
  • loginshell
    The user's default login shell, for example: /bin/csh.

User Groups

Open Active Directory Users and Computers.

40db9f3ff36a50ce53ea5b84aba3fdda634749925d94b331f67bb65ab63083cf

Add a group by right-clicking the OU and selecting New -> Group.

9c3c2ad90e59539293ed9f0694afbbf838e7b1fed95466bed3bd2ef42d9f4508

Enable advanced features by selecting View -> Advanced Features.

739f4d5e749bc1fe83df1491f07ef871af2fa290fa5d5fe7ca956ee3984eabcb

Select the group entry and open Attribute Editor.

5e74f3d9fc03897b3130b811ad4b1d347b05adede5ef38be9089dcefe20d199f

RFC2307 Attribute Configuration Reference

a82ea4fb7dc30c02c74d097046ed8e63eac2e82c8b851b7cf619edc991e715a6 c9cd3ca4eb88f5a100f80a924918c23d9105e2a3f11ad0921f575575b59381bf

To add a user to a supplementary group, add the corresponding user uid to the memberUid attribute of the group.

d89cdc2872373d53cb42365e7f200ceaca1fcbad3921c3b58b7d6d0cd5fb03c6

Users

tip

Make sure the user's logon name matches the uid value defined by the RFC2307 attribute specification so that the same user name is presented consistently in both Windows and Linux.

Right-click to create a new user. Because Windows AD does not allow user names and group names to be identical, while LDAP does allow this, the logon name must be changed to a unique string.

975757befeaf4b7789b12883c8e74586762ff8f440af6d6a8b32604674f4356f

Set the password.

ab62b6501a03b36e8046dc5a042c1d6c3fa5b96fa157b7d5f5ec671026031431

Right-click the user and select Properties -> Attribute Editor.

f8948a00cbc4ae8d0c604dfce2bff972922f73eff504ba68c199cf82afb52bad

RFC2307 Attribute Configuration Reference

0443d8536ec42beacfbe6ba621020d359dc62c9b8e628236c4a1e3ffa853c115 702d9bc0a15819237f11afc3ff50cab9911b3db03bea31a5cb6191721bf1c2fb 3d5c625cc26259df13ab61b5cbbaa343fd03895abc6b272c71652d89f6ad4eea 9f668593cd9de4acdf0baece3a9cadc60d22641b39658ac2b7d12894ef642c65 ba335a049961fa93779a426f0ab560aafb77ae3ae2