A tool to sync Active Directory (AD) groups with NetBird groups in a self-hosted enviroment, using LDAP for AD interaction and the NetBird API for group updates. It also manages user roles based on AD group membership.
-
Syncs Active Directory users and groups to NetBird.
-
Maps AD groups to NetBird groups.
-
Supports role synchronization based on AD groups.
-
Dry run mode to preview changes without applying them.
-
Debug mode for verbose logging.
-
Runs continuously, syncing at configurable intervals.
-
-debug will give you verbose of what it is doing with each user.
-
-dry-run will do a sync but will not do the actual changes.
-
-list-groups will print out all the Netbird groups you have and the group ID. You will need those IDs for the config file.
The config.yaml file MUST be in the same directory as the program.
You wil basically will be setting the LDAP server access info, Netbird URL and API key, Netbird group IDs to AD group mappings, and Netbird roles to AD group mappings. There is a example config.yaml in the repo.