/usr/share/doc/python-django-auth-ldap-doc/html/install.html is in python-django-auth-ldap-doc 1.4.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Installation — django-auth-ldap 1.4.0 documentation</title>
<link rel="stylesheet" href="_static/classic.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '1.4.0',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Authentication" href="authentication.html" />
<link rel="prev" title="Django Authentication Using LDAP" href="index.html" />
</head>
<body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="authentication.html" title="Authentication"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="index.html" title="Django Authentication Using LDAP"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">django-auth-ldap 1.4.0 documentation</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="installation">
<h1>Installation<a class="headerlink" href="#installation" title="Permalink to this headline">¶</a></h1>
<p>Install the package with pip:</p>
<div class="highlight-sh"><div class="highlight"><pre><span></span>$ pip install django-auth-ldap
</pre></div>
</div>
<p>It requires <a class="reference external" href="https://pypi.python.org/pypi/python-ldap">python-ldap</a> >= 3.0. You’ll need the <a class="reference external" href="https://www.openldap.org/">OpenLDAP</a> libraries and
headers available on your system.</p>
<p>To use the auth backend in a Django project, add
<code class="docutils literal"><span class="pre">'django_auth_ldap.backend.LDAPBackend'</span></code> to
<code class="xref std std-setting docutils literal"><span class="pre">AUTHENTICATION_BACKENDS</span></code>. Do not add anything to
<code class="xref std std-setting docutils literal"><span class="pre">INSTALLED_APPS</span></code>.</p>
<div class="highlight-python"><div class="highlight"><pre><span></span><span class="n">AUTHENTICATION_BACKENDS</span> <span class="o">=</span> <span class="p">[</span>
<span class="s1">'django_auth_ldap.backend.LDAPBackend'</span><span class="p">,</span>
<span class="p">]</span>
</pre></div>
</div>
<p><a class="reference internal" href="reference.html#django_auth_ldap.backend.LDAPBackend" title="django_auth_ldap.backend.LDAPBackend"><code class="xref py py-class docutils literal"><span class="pre">LDAPBackend</span></code></a> should work with custom user
models, but it does assume that a database is present.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p><a class="reference internal" href="reference.html#django_auth_ldap.backend.LDAPBackend" title="django_auth_ldap.backend.LDAPBackend"><code class="xref py py-class docutils literal"><span class="pre">LDAPBackend</span></code></a> does not inherit from
<code class="xref py py-class docutils literal"><span class="pre">ModelBackend</span></code>. It is possible to use
<a class="reference internal" href="reference.html#django_auth_ldap.backend.LDAPBackend" title="django_auth_ldap.backend.LDAPBackend"><code class="xref py py-class docutils literal"><span class="pre">LDAPBackend</span></code></a> exclusively by configuring it
to draw group membership from the LDAP server. However, if you would like to
assign permissions to individual users or add users to groups within Django,
you’ll need to have both backends installed:</p>
<div class="last highlight-python"><div class="highlight"><pre><span></span><span class="n">AUTHENTICATION_BACKENDS</span> <span class="o">=</span> <span class="p">[</span>
<span class="s1">'django_auth_ldap.backend.LDAPBackend'</span><span class="p">,</span>
<span class="s1">'django.contrib.auth.backends.ModelBackend'</span><span class="p">,</span>
<span class="p">]</span>
</pre></div>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h4>Previous topic</h4>
<p class="topless"><a href="index.html"
title="previous chapter">Django Authentication Using LDAP</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="authentication.html"
title="next chapter">Authentication</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/install.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<div><input type="text" name="q" /></div>
<div><input type="submit" value="Go" /></div>
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="authentication.html" title="Authentication"
>next</a> |</li>
<li class="right" >
<a href="index.html" title="Django Authentication Using LDAP"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">django-auth-ldap 1.4.0 documentation</a> »</li>
</ul>
</div>
<div class="footer" role="contentinfo">
© Copyright 2018, Peter Sagerson.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.6.7.
</div>
</body>
</html>
|