VicentGJ/AD-webmanager: A Web Interface For ... - GitHub

Skip to content Dismiss alert {{ message }} This repository was archived by the owner on Mar 29, 2024. It is now read-only. VicentGJ / AD-webmanager Public archive

• Notifications You must be signed in to change notification settings
• Fork 22
• Star 64

• Code
• Issues 12
• Pull requests
• Discussions
• Actions
• Projects
• Security
• Insights

Additional navigation options

 masterBranchesTagsGo to fileCodeOpen more actions menu

Folders and files

Name		Name	Last commit message	Last commit date
Latest commit   History 363 Commits363 Commits
libs		libs
logs		logs
plugins		plugins
static		static
templates		templates
.gitignore		.gitignore
ADwebmanager.py		ADwebmanager.py
Dockerfile		Dockerfile
README.md		README.md
example.env		example.env
requirements.txt		requirements.txt
settings.py		settings.py
View all files

Repository files navigation

• README

Introduction

This project is a web interface for Active Directory made using Flask and python-ldap, focusing on ease of use and simplicity.

It's using the connecting user's credentials to connect to the directory and allow a variety of operations.

The goal is to be able to do most common directory operations directly through this web interface rather than have to rely on command tools or Windows interfaces.

It's compatible with both Windows Active Directory and Samba4 domain controllers.

History

This project started as a fork of samba4-manager, created by Stéphane Graber and the Edubuntu community. Was used internally at Havana's Technology University in 2017, and since it has received numerous updates, additions, and changes. We decided to release our version publicly since the original project was not being regularly updated. It has grown since to a much more capable application. The project is now maintained by GSI General Software Inc. We will keep updating the project for our organization and the community, and we are open to all kinds of feedback and contributions.

Install and run

Note: all code has only been tested and it's supported to run on Linux systems, contributions regarding compatibility with other platforms is welcomed.

Local config

• Create the .env file in the root directory
  • Put a random string in SECRET_KEY**
  • Set LDAP_DOMAIN to your Directory domain
  • Set SEARCH_DN to your Directory LDAP search base
  • Set LDAP_SERVER to your Domain Controller IP
  • Use DEBUG = True if you want the test server to immediately reload after changes
  • Set USE_LOGGING = True if you want to log to files and console, false logs to console only
  • Set ADMIN_GROUP to the security group with read/write permission (default should be Domain Admins)
• Create settings.py to configure**
• ADD to TREE_BLACKLIST the containers you want to hide in the root directory
• Add attribute pairs to SEARCH_ATTRS and TREE_ATTRIBUTES to customize the tree view

Setup Environment

Copy the .env.example file to .env and udpate the settings to match your environment.

cp .env.example .env

You can install the dependencies using pip and the supplied requirements.txt. Especial consideration to the python-ldap dependency, which depends on native C libraries and as such needs native compilers and tooling to be installed (check python-ldap docs here).

Installing dependencies in Ubuntu 20.04 or Debian 11

Note: We assume you are running those commands with in the procject root directory

apt update apt install python3-venv python3-pip apt install build-essential python3-dev libldap2-dev libsasl2-dev ldap-utils tox lcov valgrind python3 -m venv ./venv source ./venv/bin/activate pip install -r requirements.txt

For running in local

python3 ADwebmanager.py

For running with Docker

docker build -t <image name> . #after image succsessfully built docker run -d -p 8080:8080 <image name>

You may then connect through http://localhost:8080

Contributing

Contributions are always appreciated!

The project is under the MIT license.

About

A web interface for administration of Active Directory Domains, made in Python, with focus on easy of use and simplicity.

Topics

python flask ldap active-directory flask-application admin-ui python-ldap samba4-domain

Resources

Readme

Uh oh!

There was an error while loading. Please reload this page.

Activity

Stars

64 stars

Watchers

9 watching

Forks

22 forks Report repository

Releases 10

v1.5 Latest Jun 5, 2022 + 9 releases

Packages

Uh oh!

There was an error while loading. Please reload this page.

Contributors

Uh oh!

There was an error while loading. Please reload this page.

Languages

• Python 60.9%
• HTML 17.8%
• CSS 12.4%
• JavaScript 8.5%
• Dockerfile 0.4%

You can’t perform that action at this time.