shufflepuck/pymacad

pymacad

Acknowledgments

This python package is based on KerbMinder (http://github.com/pmbuko/KerbMinder).

• Peter Bukowinski, author of KerbMinder
• Francois 'ftiff' Levaux-Tiffreau, who extracted this package
• Ben Toms, who gave ftiff the idea
• Allister Banks for pointing out an effective dig command to test for domain reachability.
• Kyle Crawshaw, who extended it significantly

pymacad.ad

I would suggest to use from pymacad import ad -- then call using ad.xxx

### Example

>>> from pymacad import ad
>>> ad.bound()
False
>>> ad.accessible('TEST.COM')
False
>>> ad.accessible('FTI.IO')
True

Functions

ad.bound()

checks if computer is bound to AD

• returns True or False
• raises subprocess.CalledProcessError

ad.principal(user)

gets principal from AD. If no user is specified, uses the current user.

• Returns principal
• Raises NotBound, NotReachable or subprocess.CalledProcessError

ad.accessible(domain)

checks if domain can be joined.

• Returns True or False
• raises subprocess.CalledProcessError

ad.searchnodes()

returns a list of available directories

ad.adnode()

returns the first Active Directory node or None

ad.get_domain_dns()

returns the DNS of domain, or raises NotBound

ad.membership(user)

Returns a list of groups belonging to this user Raises NotBound

ad.realms()

Returns a list of Kerberos realms, or NotBound

ad.smb_home()

Returns the home URL of the user, or an empty string.

Exceptions

• pymacad.ad.NotReachable
• pymacad.ad.NotBound
• subprocess.CalledProcessError

pymacad's Issues

ad.principal('missinguser') results in a traceback

>>> ad.principal('missinguser')
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/Library/Python/2.7/site-packages/pymacad/ad/__init__.py", line 56, in principal
    output = _cmd_dscl_search(user_path)
  File "/Library/Python/2.7/site-packages/pymacad/ad/__init__.py", line 25, in _cmd_dscl_search
    stderr=subprocess.STDOUT)
  File "/System/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/subprocess.py", line 573, in check_output
    raise CalledProcessError(retcode, cmd, output=output)
subprocess.CalledProcessError: Command '['dscl', '/Search', 'read', '/Users/missinguser', 'AuthenticationAuthority']' returned non-zero exit status 56

Should probably catch the error in case of typo or user not in AD.