Skip to main content

Building a convenient CLI on top of LDAP3

Project description

Trying to obtain a decent openLDAP shell with scripting abilities by piggybacking IPython bringing history and documentation as a bonus, as well as python module to have an easy installation.

This project is a Dirty Hack.

How it works

All required files (including the tls pem/key for localhost at 127.0.0.1) are available here

example:

# activate your virtual env
python3 -mpip install blabing
# standalone ldap server for tests
standalone_ldap.sh slap
# calling bla with credentials for this server, and calling test.bla
# which creates ou=people,dc=home and create 3 users there
cat bla.test
 ldap.add("dc=home", [ "dcObject", "organization", "top"], dict(dc="home", o="home"))
 ldap.add("ou=people,dc=home",  'organizationalUnit', dict(ou="people"))
 [ user_add(i) for i in ( "boss", "manager", "louis" ) ]
 ldap.add("ou=group,dc=home",  'organizationalUnit', dict(ou="group"))
 ldap.add("cn=staff,ou=group,dc=home",  ['top', "groupOfNames"],attributes= dict(member=["uid=boss,ou=people,dc=home" ]))
 search("(uid=boss)", attributes="memberOf")
 list(walk("dc=home",lambda e:e.entry_dn))
 pe(get("uid=boss,ou=people,dc=home"))
 password("uid=boss,ou=people,dc=home")
 pe(get("uid=boss,ou=people,dc=home"))

bla bla.no_tls.json test.bla

# fill in a password has demanded
# try ldapvi("uid=boss") in the IPython shell
# exit

# browse the tree
lhl bla.no_tls.json
firefox http://127.0.0.1:5001
./img/screenshot.png

You should be focusing on the tree not on the options of the command line tools.

Synopsis

LDAP is a great extensible key/value storage with security in mind. It’s a great tool with a terrible User Experience when it comes to the tooling especially with openLDAP.

Why people (as I) are reluctant to use it ?

First problem CLI: tools

  • without kerberos CLI tools implies either to type password for every operations (search, add modify) or have it in seeable in history (if you don’t use secrets my bash tool to solve this problem);

  • who can remember what -b, -x, -W, -w, -s means ? CLI becames unreadable.

Why not have create a DSL? (Domain specific language)

We also want history since we often make the same operation over and over again.

BLA is an experimentation at brewing your own tooling for openLDAP

standalone_ldap.sh a standalone LDAP server to experiment locally. bla a CLI tools using ipython for history, completion and documentation lhl a web explorer

Design choices

  • GCU style to make a usable prototype illustrating the indented behaviour fast;

  • using an implicit local or global configuration to setup the ldap access/options;

  • helpers to recursively search for any entries bypassing the 500 items limits

  • COLORS because life is too short to have a monotone CLI (but actually does have it has a fallback mode)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

blabing-0.2.1.tar.gz (32.7 kB view details)

Uploaded Source

Built Distribution

blabing-0.2.1-py3-none-any.whl (23.1 kB view details)

Uploaded Python 3

File details

Details for the file blabing-0.2.1.tar.gz.

File metadata

  • Download URL: blabing-0.2.1.tar.gz
  • Upload date:
  • Size: 32.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.3

File hashes

Hashes for blabing-0.2.1.tar.gz
Algorithm Hash digest
SHA256 03f1548f41c41d1cf7322e9e0dbc79b5dfba31365386bc5ed816d7591ab5c16f
MD5 b65c60fe3412827fd0259cff83e6a88a
BLAKE2b-256 fa5504823ec2fd9191fc7cc562ea7f128bf840c69e356e0033ca42e8d5cf77de

See more details on using hashes here.

File details

Details for the file blabing-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: blabing-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 23.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.3

File hashes

Hashes for blabing-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 80290363c9ad9d054ea7eba00395f4082b0cea6d94d48e280c1a798cdfd4f7e7
MD5 612123fba4152da6e2582bf183d995a1
BLAKE2b-256 31b6fe8eb1a83a97ae08b73f4b09bb3570f820052d068e399bed6ed980128ea9

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page