Kerberized WebDAV client for Python
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
Bob Carroll 18e0722e8a converted license and read to markdown 8 years ago
.gitignore initial release 9 years ago
AUTHORS.md converted license and read to markdown 8 years ago
LICENSE.md converted license and read to markdown 8 years ago
MANIFEST.in initial release 9 years ago
README.md converted license and read to markdown 8 years ago
krb5dav.py fixed bug when server doesn't send back any cookies 9 years ago
setup.py fixed bug when server doesn't send back any cookies 9 years ago

README.md

WebDAV-Kerberos

WebDAV-Kerberos is a Kerberised subclass of the davlib.DAV class found in the Python_WebDAV_Library package. This module depends on Python_WebDAV_Library and PyKerberos. Python 3 is not (yet) supported. Installing and configuring Kerberos properly is left as an exercise for the reader.

Dependencies

  • Python_WebDAV_Library (tested with version 0.4.2)
  • PyKerberos (tested with revision 11110)

Usage

The interface is exactly the same as davlib.DAV.

Krb5DAV includes an extra constructor argument and an extra function. Specify the principal constructor argument to set the client user principal name you wish to connect as. Omitting this argument will cause the Kerberos client to use the principal of the current user.

The Krb5DAV.whoami() function will return the authenticated user principal name. If called before authentication the function will return the value of the principal constructor argument, which may be the empty string if you omitted the argument.

Examples

from krb5dav import Krb5DAV

# Connect to SharePoint with the credentials of the current user. You must
# have a fresh ticket in your Kerberos credentials cache for this to work.
dav = Krb5DAV('sharepoint.example.com', protocol='http')

response = dav.get('/MySite/Home/Shared%20Documents/foo.docx')
with open('/tmp/foo.docx', 'wb') as outfile:
    outfile.write(response.read())
dav.close()

# Connect to SharePoint with specific credentials. You must have a Kerberos
# keytab file with the principal's key, and the current user must have read
# access to it.
dav = Krb5DAV('sharepoint.example.com', protocol='http', principal='jdoe@EXAMPLE.COM')

with open('/tmp/foo.docx', 'rb') as infile:
    buf = infile.read()
dav.put('/MySite/Home/Shared%20Documents/foo2.docx', buf)
dav.close()