1 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>idmap_ad</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="idmap_ad.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>idmap_ad — Samba's idmap_ad Backend for Winbind</p></div><div class="refsynopsisdiv"><h2>DESCRIPTION</h2><p>The idmap_ad plugin provides a way for Winbind to read
|
---|
2 | id mappings from an AD server that uses RFC2307/SFU schema
|
---|
3 | extensions. This module implements only the "idmap"
|
---|
4 | API, and is READONLY. Mappings must be provided in advance
|
---|
5 | by the administrator by adding the posixAccount/posixGroup
|
---|
6 | classes and relative attribute/value pairs to the user and
|
---|
7 | group objects in the AD.</p></div><div class="refsect1" lang="en"><a name="id2522919"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">range = low - high</span></dt><dd><p>
|
---|
8 | Defines the available matching UID and GID range for which the
|
---|
9 | backend is authoritative. Note that the range acts as a filter.
|
---|
10 | If specified any UID or GID stored in AD that fall outside the
|
---|
11 | range is ignored and the corresponding map is discarded.
|
---|
12 | It is intended as a way to avoid accidental UID/GID overlaps
|
---|
13 | between local and remotely defined IDs.
|
---|
14 | </p></dd><dt><span class="term">schema_mode = <rfc2307 | sfu ></span></dt><dd><p>
|
---|
15 | Defines the schema that idmap_ad should use when querying
|
---|
16 | Active Directory regarding user and group information.
|
---|
17 | This can be either the RFC2307 schema support included
|
---|
18 | in Windows 2003 R2 or the Service for Unix (SFU) schema.
|
---|
19 | </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483331"></a><h2>EXAMPLES</h2><p>
|
---|
20 | The following example shows how to retrieve idmappings from our principal and
|
---|
21 | and trusted AD domains. If trusted domains are present id conflicts must be
|
---|
22 | resolved beforehand, there is no
|
---|
23 | guarantee on the order conflicting mappings would be resolved at this point.
|
---|
24 |
|
---|
25 | This example also shows how to leave a small non conflicting range for local
|
---|
26 | id allocation that may be used in internal backends like BUILTIN.
|
---|
27 | </p><pre class="programlisting">
|
---|
28 | [global]
|
---|
29 | idmap backend = tdb
|
---|
30 | idmap uid = 1000000-1999999
|
---|
31 | idmap gid = 1000000-1999999
|
---|
32 |
|
---|
33 | idmap config CORP : backend = ad
|
---|
34 | idmap config CORP : range = 1000-999999
|
---|
35 | </pre></div><div class="refsect1" lang="en"><a name="id2483355"></a><h2>AUTHOR</h2><p>
|
---|
36 | The original Samba software and related utilities
|
---|
37 | were created by Andrew Tridgell. Samba is now developed
|
---|
38 | by the Samba Team as an Open Source project similar
|
---|
39 | to the way the Linux kernel is developed.
|
---|
40 | </p></div></div></body></html>
|
---|