Skip to content

Commit

Permalink
Merge pull request #41129 from owncloud/config_add_wnd
Browse files Browse the repository at this point in the history
docs: add config documentation for wnd
  • Loading branch information
mmattel authored Dec 5, 2023
2 parents 1214a50 + 411d971 commit 1a83b7a
Showing 1 changed file with 22 additions and 14 deletions.
36 changes: 22 additions & 14 deletions config/config.apps.sample.php
Original file line number Diff line number Diff line change
Expand Up @@ -671,11 +671,11 @@
* be for a service account with special privileges, in particular, it must
* be able to impersonate the users. It is highly recommended that the password
* for this service account doesn't expire, otherwise you will have to replace
* the file manually before the expiration.
* the file manually before the expiration. See the Kerberos documentation for details.
*
* - `ocservice` (required): The name of the service of the account. This matches
* the SPN of the Windows / Samba account. It usually is in the form "HTTP/<server>",
* but it might be different.
* the SPN of the Windows / Samba account. It usually is in the form "HTTP/<hostname>",
* but it might be different. See the Kerberos documentation for details.
*
* - `usermapping` (optional): The ownCloud-to-windows user mapping to be used. See below
* for available options. If no user mapping is provided, the `Noop` mapping will
Expand All @@ -699,25 +699,33 @@
* "[email protected]" will be mapped to the same windows user as
* "[email protected]".
*
* - `CustomFile`: This mapping is reserved and should only be used on explicit request of ownCloud support.
* - `EALdapAttr`: Use ownCloud's user extended attributes to map the ownCloud
* user to the target LDAP attribute. The mapping has an "attr" parameter in order
* to select the LDAP attribute you want to use. Note that it's required that
* the user_ldap app exposes the chosen attribute which requires user_ldap 0.19.0+.
* In case ownCloud can't map the user, an error will be thrown.
* The same will happen for non-LDAP users.
*/
'wnd.kerberos.servers' => [
'server1' => [
'ockeytab' => '/var/www/owncloud/octest1.mountain.tree.prv.keytab',
'ocservice' => 'HTTP/octest1.mountain.tree.prv',
'server_ID1' => [
'ockeytab' => '<keytab-file-location>/<user-name>.keytab',
'ocservice' => 'HTTP/<hostname_or_FQDN>',
'usermapping' => ['type' => 'Noop'],
'ccachettl' => 60 * 60 * 9,
],
'server11' => [
'ockeytab' => '/var/www/owncloud/octest1.mountain.tree.prv.keytab',
'ocservice' => 'HTTP/octest1.mountain.tree.prv',
'server_ID2' => [
'ockeytab' => '<keytab-file-location>/<user-name>.keytab',
'ocservice' => 'HTTP/<hostname_or_FQDN>',
'usermapping' => ['type' => 'RemoveDomain'],
'ccachettl' => 60 * 60 * 9,
],
'server2' => [
'ockeytab' => '/var/www/owncloud/octest0.desert.sand.prv.keytab',
'ocservice' => 'HTTP/octest0.desert.sand.prv',
'usermapping' => ['type' => 'CustomFile', 'params' => ['mapfile' => '/var/www/owncloud/ocwin_krb5_map.json']],
'server_ID3' => [
'ockeytab' => '<keytab-file-location>/<user-name>.keytab',
'ocservice' => 'HTTP/<hostname_or_FQDN>',
'usermapping' => [
'type' => 'EALdapAttr',
'params' => ['attr' => 'userPrincipalName']
],
'cachettl' => 3600,
],
],
Expand Down

0 comments on commit 1a83b7a

Please sign in to comment.