Metadata-Version: 2.1
Name: adleastcli
Version: 0.0.1
Summary: Simple user management CLI for Active Directory
Home-page: https://github.com/nobrin/adleastcli
Author: Nobuo Okazaki
Author-email: nobrin@biokids.org
License: MIT
Platform: any
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: System :: Systems Administration :: Authentication/Directory :: LDAP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Dist: ldap3

=============================
 ADLeastCLI: AD User Manager
=============================

Overview
========

*ADLeastCLI* provides least operations for managing users/groups on Active
Directory(AD).

When you want to use an AD for only authentication (i.e. AWS Client VPN with
Directory Service), it can manage users/groups with very simple procedure.

Example::

    Create a user
    $ adleastcli -S example.com user create testuser Password123#

    Create a group
    $ adleastcli -S example.com group create mygroup

    Add the user to the group
    $ adleastcli -S example.com user join testuser mygroup

    Remove the user from the group
    $ adleastcli -S example.com user leave testuser mygroup

    Delete a group
    $ adleastcli -S example.com group delete mygroup

    Delete a user
    $ adleastcli -S example.com user delete testuser

    List users
    $ adleastcli -S example.com user

    Show user details
    $ adleastcli -S example.com user info testuser

    List groups
    $ adleastcli -S example.com group

    Show group details
    $ adleastcli -S example.com group info mygroup

    Set password(as administrator)
    $ adleastcli -S example.com user setpw testuser NewPass123#

    Change password(as a user)
    $ adleastcli -S example.com -U testuser user passwd
    Enter password for testuser:
    Enter new password:
    Confirm new password:

Installation
============

Install the latest release with ``pip install adleastcli`` or simply downloading
`adleastcli.py <https://github.com/nobrin/adleastcli/raw/master/adleastcli.py>`_.

Installing with ``pip`` store ``adleastcli`` to your bin path, but it is only
copy of ``adleastcli.py``. If you get ``adleastcli.py`` with downloading, you
can rename it to ``adleastcli``.


