URL: https://github.com/SSSD/sssd/pull/295
Author: jhrozek
 Title: #295: MAN: Document that the secrets provider can only be specified in 
a per-client section
Action: synchronized

To pull the PR as Git branch:
git remote add ghsssd https://github.com/SSSD/sssd
git fetch ghsssd pull/295/head:pr295
git checkout pr295
From 4e023b65f32b57bd4e90b2f931c65e67390202a8 Mon Sep 17 00:00:00 2001
From: Jakub Hrozek <jhro...@redhat.com>
Date: Thu, 1 Jun 2017 10:04:21 +0200
Subject: [PATCH] MAN: Document that the secrets provider can only be specified
 in a per-client section

Resolves:
    https://pagure.io/SSSD/sssd/issue/3417
---
 src/man/sssd-secrets.5.xml | 26 ++++++++++++++++++--------
 1 file changed, 18 insertions(+), 8 deletions(-)

diff --git a/src/man/sssd-secrets.5.xml b/src/man/sssd-secrets.5.xml
index d43dcf21c..19de60a73 100644
--- a/src/man/sssd-secrets.5.xml
+++ b/src/man/sssd-secrets.5.xml
@@ -128,19 +128,29 @@ systemctl enable sssd-secrets.service
             </citerefentry> manual page for a complete list. In addition,
             there are some secrets-specific options as well.
         </para>
+        <para>
+            The secrets responder is configured with a global
+            <quote>[secrets]</quote> section and an optional per-user
+            <quote>[secrets/users/$uid]</quote> section in sssd.conf. Please
+            note that some options, notably as the provider type, can only
+            be specified in the per-user subsections.
+        </para>
         <variablelist>
             <varlistentry>
                 <term>provider (string)</term>
                 <listitem>
                 <para>
-                    This option specifies where should the secrets
-                    be stored. The secrets responder can configure a
-                    per-user subsections that define which provider store
-                    the secrets for this particular user. The per-user
-                    subsections should contain all options for that user's
-                    provider. If a per-user section does not exist, the
-                    global settings from the secret responder's section
-                    are used.  The following providers are supported:
+                    This option specifies where should the secrets be
+                    stored. The secrets responder can configure a per-user
+                    subsections (e.g. <quote>[secrets/users/123]</quote>
+                    - see bottom of this manual page for a full example
+                    using Custodia for a particular user) that define
+                    which provider store the secrets for this particular
+                    user. The per-user subsections should contain all
+                    options for that user's provider. Please note that
+                    currently the global provider is always local, the
+                    proxy provider can only be specified in a per-user
+                    section. The following providers are supported:
                     <variablelist>
                         <varlistentry>
                             <term>local</term>
_______________________________________________
sssd-devel mailing list -- sssd-devel@lists.fedorahosted.org
To unsubscribe send an email to sssd-devel-le...@lists.fedorahosted.org

Reply via email to