| 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.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="idmap_ad"><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" title="DESCRIPTION"><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" title="IDMAP OPTIONS"><a name="id286385"></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" title="EXAMPLES"><a name="id291270"></a><h2>EXAMPLES</h2><p>
|
|---|
| 20 | The following example shows how to retrieve idmappings from our principal and
|
|---|
| 21 | 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" title="AUTHOR"><a name="id298766"></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>
|
|---|
