|
 |
cdf651 |
From 731f098767ce352722dc4d4525c6a520cc5b5dab Mon Sep 17 00:00:00 2001
|
|
|
cdf651 |
From: Jakub Hrozek <jhrozek@redhat.com>
|
|
|
cdf651 |
Date: Wed, 27 Jun 2018 09:59:42 +0200
|
|
|
cdf651 |
Subject: [PATCH] MAN: Document the options available for AD trusted domains
|
|
|
cdf651 |
|
|
|
cdf651 |
Related:
|
|
|
cdf651 |
https://pagure.io/SSSD/sssd/issue/3291
|
|
|
cdf651 |
|
|
|
cdf651 |
Reviewed-by: Sumit Bose <sbose@redhat.com>
|
|
|
cdf651 |
(cherry picked from commit 014e7d8ab6aa4cf3051764052326258230c0bc86)
|
|
|
cdf651 |
---
|
|
|
cdf651 |
src/man/sssd-ipa.5.xml | 92 ++++++++++++++++++++++++++++++++++++++++++
|
|
|
cdf651 |
1 file changed, 92 insertions(+)
|
|
|
cdf651 |
|
|
|
cdf651 |
diff --git a/src/man/sssd-ipa.5.xml b/src/man/sssd-ipa.5.xml
|
|
|
cdf651 |
index e4e58afaf6616f759ef82c77e339bdc738939dbe..e46957d5f742bafc11774992afe08d32443d061f 100644
|
|
|
cdf651 |
--- a/src/man/sssd-ipa.5.xml
|
|
|
cdf651 |
+++ b/src/man/sssd-ipa.5.xml
|
|
|
cdf651 |
@@ -728,6 +728,98 @@
|
|
|
cdf651 |
</para>
|
|
|
cdf651 |
</refsect1>
|
|
|
cdf651 |
|
|
|
cdf651 |
+ <refsect1 id='trusted_domains'>
|
|
|
cdf651 |
+ <title>TRUSTED DOMAINS CONFIGURATION</title>
|
|
|
cdf651 |
+ <para>
|
|
|
cdf651 |
+ Some configuration options can be also set for a trusted domain.
|
|
|
cdf651 |
+ A trusted domain configuration can either be done using
|
|
|
cdf651 |
+ a subsection, for example:
|
|
|
cdf651 |
+<programlisting>
|
|
|
cdf651 |
+[domain/ipa.domain.com/ad.domain.com]
|
|
|
cdf651 |
+ad_server = dc.ad.domain.com
|
|
|
cdf651 |
+</programlisting>
|
|
|
cdf651 |
+ </para>
|
|
|
cdf651 |
+ <para>
|
|
|
cdf651 |
+ In addition, some options can be set in the parent domain
|
|
|
cdf651 |
+ and inherited by the trusted domain using the
|
|
|
cdf651 |
+ <quote>subdomain_inherit</quote> option. For more details,
|
|
|
cdf651 |
+ see the
|
|
|
cdf651 |
+ <citerefentry>
|
|
|
cdf651 |
+ <refentrytitle>sssd.conf</refentrytitle>
|
|
|
cdf651 |
+ <manvolnum>5</manvolnum>
|
|
|
cdf651 |
+ </citerefentry> manual page.
|
|
|
cdf651 |
+ </para>
|
|
|
cdf651 |
+ <para>
|
|
|
cdf651 |
+ Different configuration options are tunable for a trusted
|
|
|
cdf651 |
+ domain depending on whether you are configuring SSSD on an
|
|
|
cdf651 |
+ IPA server or an IPA client.
|
|
|
cdf651 |
+ </para>
|
|
|
cdf651 |
+ <refsect2 id='server_configuration'>
|
|
|
cdf651 |
+ <title>OPTIONS TUNABLE ON IPA MASTERS</title>
|
|
|
cdf651 |
+ <para>
|
|
|
cdf651 |
+ The following options can be set in a subdomain
|
|
|
cdf651 |
+ section on an IPA master:
|
|
|
cdf651 |
+ <itemizedlist>
|
|
|
cdf651 |
+ <listitem>
|
|
|
cdf651 |
+ <para>ad_server</para>
|
|
|
cdf651 |
+ </listitem>
|
|
|
cdf651 |
+ <listitem>
|
|
|
cdf651 |
+ <para>ad_backup_server</para>
|
|
|
cdf651 |
+ </listitem>
|
|
|
cdf651 |
+ <listitem>
|
|
|
cdf651 |
+ <para>ad_site</para>
|
|
|
cdf651 |
+ </listitem>
|
|
|
cdf651 |
+ <listitem>
|
|
|
cdf651 |
+ <para>ldap_search_base</para>
|
|
|
cdf651 |
+ </listitem>
|
|
|
cdf651 |
+ <listitem>
|
|
|
cdf651 |
+ <para>ldap_user_search_base</para>
|
|
|
cdf651 |
+ </listitem>
|
|
|
cdf651 |
+ <listitem>
|
|
|
cdf651 |
+ <para>ldap_group_search_base</para>
|
|
|
cdf651 |
+ </listitem>
|
|
|
cdf651 |
+ <listitem>
|
|
|
cdf651 |
+ <para>use_fully_qualified_names</para>
|
|
|
cdf651 |
+ </listitem>
|
|
|
cdf651 |
+ </itemizedlist>
|
|
|
cdf651 |
+ </para>
|
|
|
cdf651 |
+ </refsect2>
|
|
|
cdf651 |
+ <refsect2 id='client_configuration'>
|
|
|
cdf651 |
+ <title>OPTIONS TUNABLE ON IPA CLIENTS</title>
|
|
|
cdf651 |
+ <para>
|
|
|
cdf651 |
+ The following options can be set in a subdomain
|
|
|
cdf651 |
+ section on an IPA client:
|
|
|
cdf651 |
+ <itemizedlist>
|
|
|
cdf651 |
+ <listitem>
|
|
|
cdf651 |
+ <para>ad_server</para>
|
|
|
cdf651 |
+ </listitem>
|
|
|
cdf651 |
+ <listitem>
|
|
|
cdf651 |
+ <para>ad_site</para>
|
|
|
cdf651 |
+ </listitem>
|
|
|
cdf651 |
+ </itemizedlist>
|
|
|
cdf651 |
+ </para>
|
|
|
cdf651 |
+ <para>
|
|
|
cdf651 |
+ Note that if both options are set, only
|
|
|
cdf651 |
+ <quote>ad_server</quote> is evaluated.
|
|
|
cdf651 |
+ </para>
|
|
|
cdf651 |
+ <para>
|
|
|
cdf651 |
+ Since any request for a user or a group identity from a
|
|
|
cdf651 |
+ trusted domain triggered from an IPA client is resolved
|
|
|
cdf651 |
+ by the IPA server, the <quote>ad_server</quote> and
|
|
|
cdf651 |
+ <quote>ad_site</quote> options only affect which AD DC will
|
|
|
cdf651 |
+ the authentication be performed against. In particular,
|
|
|
cdf651 |
+ the addresses resolved from these lists will be written to
|
|
|
cdf651 |
+ <quote>kdcinfo</quote> files read by the Kerberos locator
|
|
|
cdf651 |
+ plugin. Please refer to the
|
|
|
cdf651 |
+ <citerefentry>
|
|
|
cdf651 |
+ <refentrytitle>sssd_krb5_locator_plugin</refentrytitle>
|
|
|
cdf651 |
+ <manvolnum>8</manvolnum>
|
|
|
cdf651 |
+ </citerefentry> manual page for more details on the Kerberos
|
|
|
cdf651 |
+ locator plugin.
|
|
|
cdf651 |
+ </para>
|
|
|
cdf651 |
+ </refsect2>
|
|
|
cdf651 |
+ </refsect1>
|
|
|
cdf651 |
+
|
|
|
cdf651 |
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/failover.xml" />
|
|
|
cdf651 |
|
|
|
cdf651 |
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/service_discovery.xml" />
|
|
|
cdf651 |
--
|
|
|
cdf651 |
2.17.1
|
|
|
cdf651 |
|