Difference between revisions of "stoney mail: OpenLDAP directory data organisation"

From stoney cloud
Jump to: navigation, search
[checked revision][checked revision]
(Mail)
(Mail)
Line 7: Line 7:
 
= Mail =
 
= Mail =
 
The following LDIF shows the '''mail''' entry of the whole OpenLDAP directory tree for the stoney cloud:
 
The following LDIF shows the '''mail''' entry of the whole OpenLDAP directory tree for the stoney cloud:
dn: ou=mail,ou=services,dc=stoney-cloud,dc=org
+
<source lang="ldif">
objectclass: organizationalUnit
+
dn: ou=mail,ou=services,dc=stoney-cloud,dc=org
objectclass: top
+
objectclass: organizationalUnit
ou: mail
+
objectclass: top
 +
ou: mail
 +
</source>
  
 
== Mail Configuration ==
 
== Mail Configuration ==
 
The sub tree for the configuration of the stoney mail service:
 
The sub tree for the configuration of the stoney mail service:
 
<source lang="ldif">
 
<source lang="ldif">
dn: ou=configuration,ou=mail,ou=services,dc=stoney-cloud,dc=org
+
dn: ou=configuration,ou=mail,ou=services,dc=stoney-cloud,dc=org
objectclass: top
+
objectclass: top
objectclass: organizationalUnit
+
objectclass: organizationalUnit
ou: configuration
+
ou: configuration
description: The sub tree for the configuration of the stoney mail service.
+
description: The sub tree for the configuration of the stoney mail service.
 
</source>
 
</source>
  
Line 48: Line 50:
 
=== Mail Reseller ===
 
=== Mail Reseller ===
 
The sub tree for the reseller specific stoney mail service configuration:
 
The sub tree for the reseller specific stoney mail service configuration:
dn: ou=reseller,ou=configuration,ou=mail,ou=services,dc=stoney-cloud,dc=org
+
<source lang="ldif">
objectclass: top
+
dn: ou=reseller,ou=configuration,ou=mail,ou=services,dc=stoney-cloud,dc=org
objectclass: organizationalUnit
+
objectclass: top
ou: reseller
+
objectclass: organizationalUnit
description: The sub tree for the reseller specific stoney mail service configuration.
+
ou: reseller
 +
description: The sub tree for the reseller specific stoney mail service configuration.
 +
</source>
  
 
The following table describes the different attributes:
 
The following table describes the different attributes:
Line 79: Line 83:
  
 
The sub tree for the specific stoney mail service settings for the reseller Reseller Ltd. with the uid 4000000.
 
The sub tree for the specific stoney mail service settings for the reseller Reseller Ltd. with the uid 4000000.
dn: uid=4000000,ou=reseller,ou=configuration,ou=mail,ou=services,dc=stoney-cloud,dc=org
+
<source lang="ldif">
objectclass: top
+
dn: uid=4000000,ou=reseller,ou=configuration,ou=mail,ou=services,dc=stoney-cloud,dc=org
objectclass: sstReseller
+
objectclass: top
objectclass: sstServiceConfigurationObjectClass
+
objectclass: sstReseller
uid: 4000000
+
objectclass: sstServiceConfigurationObjectClass
o: Reseller Ltd.
+
uid: 4000000
description: The sub tree for the specific stoney mail service settings for the reseller Reseller Ltd. with the uid 4000000.
+
o: Reseller Ltd.
sstIsActive: TRUE
+
description: The sub tree for the specific stoney mail service settings for the reseller Reseller Ltd. with the uid 4000000.
sstIsDefault: TRUE
+
sstIsActive: TRUE
sstBelongsToResellerUID: 4000000
+
sstIsDefault: TRUE
 +
sstBelongsToResellerUID: 4000000
 +
</source>
  
 
The following table describes the different attributes:
 
The following table describes the different attributes:
Line 170: Line 176:
 
=== Mail Reseller Logout-Redirection ===
 
=== Mail Reseller Logout-Redirection ===
 
The sub tree for the reseller logout-redirect specific stoney mail service configuration:
 
The sub tree for the reseller logout-redirect specific stoney mail service configuration:
dn: ou=logout-redirect, ou=reseller,ou=configuration,ou=mail,ou=services,dc=stoney-cloud,dc=org
+
<source lang="ldif">
objectclass: top
+
dn: ou=logout-redirect, ou=reseller,ou=configuration,ou=mail,ou=services,dc=stoney-cloud,dc=org
objectclass: organizationalUnit
+
objectclass: top
ou: logout-redirect
+
objectclass: organizationalUnit
description: The sub tree for the reseller logout-redirect specific stoney mail service configuration.
+
ou: logout-redirect
 +
description: The sub tree for the reseller logout-redirect specific stoney mail service configuration.
 +
</source>
  
 
The following table describes the different attributes:
 
The following table describes the different attributes:
Line 201: Line 209:
  
 
The sub tree for the reseller logout-redirect specific stoney mail service settings, coming from the fully qualified domain name (fqdn) groupware.stoney-cloud.org.
 
The sub tree for the reseller logout-redirect specific stoney mail service settings, coming from the fully qualified domain name (fqdn) groupware.stoney-cloud.org.
dn: ou=groupware.stoney-cloud.org,ou=logout-redirect, ou=reseller,ou=configuration,ou=mail,ou=services,dc=stoney-cloud,dc=org
+
<source lang="ldif">
objectclass: top
+
dn: ou=groupware.stoney-cloud.org,ou=logout-redirect, ou=reseller,ou=configuration,ou=mail,ou=services,dc=stoney-cloud,dc=org
objectclass: organizationalUnit
+
objectclass: top
objectclass: sstLogoutRedirect
+
objectclass: organizationalUnit
ou: groupware.stoney-cloud.org
+
objectclass: sstLogoutRedirect
description: The sub tree for the reseller logout-redirect specific stoney mail service settings, coming from the fully qualified domain name (fqdn) groupware.stoney-cloud.org.
+
ou: groupware.stoney-cloud.org
sstWebsiteURL: http://www.stoney-cloud.org/
+
description: The sub tree for the reseller logout-redirect specific stoney mail service settings, coming from the fully qualified domain name (fqdn) groupware.stoney-cloud.org.
 +
sstWebsiteURL: http://www.stoney-cloud.org/
 +
</source>
  
 
The following table describes the different attributes:
 
The following table describes the different attributes:

Revision as of 17:05, 21 January 2015

Abstract

This document describes the OpenLDAP directory data organisation for the stoney mail service, including groupware functionality based on Open-Xchange.

Data Organisation

The following chapters explain the data organisation of the stoney cloud OpenLDAP directory, in this case we looking at the stoney mail service.

Mail

The following LDIF shows the mail entry of the whole OpenLDAP directory tree for the stoney cloud:

dn: ou=mail,ou=services,dc=stoney-cloud,dc=org
objectclass: organizationalUnit
objectclass: top
ou: mail

Mail Configuration

The sub tree for the configuration of the stoney mail service:

dn: ou=configuration,ou=mail,ou=services,dc=stoney-cloud,dc=org
objectclass: top
objectclass: organizationalUnit
ou: configuration
description: The sub tree for the configuration of the stoney mail service.

The following table describes the different attributes:

Attribute
Existence
Mandatory
Description
ou
MUST
x
This configuration leaf (ou: Organizational Unit), collects the stoney mail service related configuration.
description
MAY
x
The description of this leaf.

Legend:

  • x: Mandatory in all cases.

Mail Reseller

The sub tree for the reseller specific stoney mail service configuration:

dn: ou=reseller,ou=configuration,ou=mail,ou=services,dc=stoney-cloud,dc=org
objectclass: top
objectclass: organizationalUnit
ou: reseller
description: The sub tree for the reseller specific stoney mail service configuration.

The following table describes the different attributes:

Attribute
Existence
Mandatory
Description
ou
MUST
x
This reseller leaf (ou: Organizational Unit), collects the stoney mail service reseller related configuration.
description
MAY
x
The description of this leaf.

Legend:

  • x: Mandatory in all cases.

The sub tree for the specific stoney mail service settings for the reseller Reseller Ltd. with the uid 4000000.

dn: uid=4000000,ou=reseller,ou=configuration,ou=mail,ou=services,dc=stoney-cloud,dc=org
objectclass: top
objectclass: sstReseller
objectclass: sstServiceConfigurationObjectClass
uid: 4000000
o: Reseller Ltd.
description: The sub tree for the specific stoney mail service settings for the reseller Reseller Ltd. with the uid 4000000.
sstIsActive: TRUE
sstIsDefault: TRUE
sstBelongsToResellerUID: 4000000

The following table describes the different attributes:

Attribute
Existence
Mandatory
Self-Service
Changeable
Description
uid
MUST
x
A unique integer value with 7 digits or more. For example: 4000000.
organizationName
MAY
x
The organisation name of the reseller. For example: Reseller Ltd. when sstIsCompany: TRUE). Or in case of a person (sstIsCompany: FALSE), the organisation name would be set to: Surname, Name (The content of the attributes surname and givenName).
description
MAY
The description of the leaf.
sstIsCompany
MUST
x
Is the entry a company? Either TRUE (yes) or FALSE (no).
sstIsActive
MUST
x
Is the entry active? Either TRUE (yes) or FALSE (no).
sstExternalID
MAY
The ID (or number) of a customer, person or product in an external database (for example: 234567).
sstIsDefault
MAY
Contains the leaf a default entry? Either TRUE (yes) or FALSE (no). If sstIsDefault is set to TRUE, this entry acts as a fall back configuration. In other words: If a reseller doesn't have his own (online) backup service configuration, then this on will be used.
sstBelongsToResellerUID
MUST
x
Stores the reseller UID the leaf belongs to. A unique value with 7 digits or more. For example: 4000000. In this case, the attribute uid and sstBelongsToResellerUID must match with each other!

Legend:

  • x: Mandatory in all cases.

Mail Reseller Logout-Redirection

The sub tree for the reseller logout-redirect specific stoney mail service configuration:

dn: ou=logout-redirect, ou=reseller,ou=configuration,ou=mail,ou=services,dc=stoney-cloud,dc=org
objectclass: top
objectclass: organizationalUnit
ou: logout-redirect
description: The sub tree for the reseller logout-redirect specific stoney mail service configuration.

The following table describes the different attributes:

Attribute
Existence
Mandatory
Description
ou
MUST
x
This logout-redirect leaf (ou: Organizational Unit), collects the stoney mail service reseller logout-redirect related configuration.
description
MAY
x
The description of this leaf.

Legend:

  • x: Mandatory in all cases.

The sub tree for the reseller logout-redirect specific stoney mail service settings, coming from the fully qualified domain name (fqdn) groupware.stoney-cloud.org.

dn: ou=groupware.stoney-cloud.org,ou=logout-redirect, ou=reseller,ou=configuration,ou=mail,ou=services,dc=stoney-cloud,dc=org
objectclass: top
objectclass: organizationalUnit
objectclass: sstLogoutRedirect
ou: groupware.stoney-cloud.org
description: The sub tree for the reseller logout-redirect specific stoney mail service settings, coming from the fully qualified domain name (fqdn) groupware.stoney-cloud.org.
sstWebsiteURL: http://www.stoney-cloud.org/

The following table describes the different attributes:

Attribute
Existence
Mandatory
Self-Service
Changeable
Description
ou
MUST
x
This leaf (ou: Organizational Unit), contains the logout-redirect related configuration for a specific fully qualified domain name (fqdn). For example: groupware.stoney-cloud.org.
description
MAY
The description of the leaf.
sstWebsiteURL
MUST
x
The URI the user is redirected to, after they log out from the groupware application. For example: http://www.stoney-cloud.org/ or https://www.stoney-cloud.org/.

Legend:

  • x: Mandatory in all cases.