stoney core: OpenLDAP directory data organisation
Contents
Abstract
This document describes the OpenLDAP directory data organisation for the stoney cloud. This directory is the only database for all the services, which are manageable through the web interface of the stoney cloud.
Some titles have numbers in brackets. These numbers reflect the stoney cloud version, in which these entries have been added or modified.
Introduction
All Service-, User- and Billing-Data ist stored in the OpenLDAP directory. The directory runs in Multi-Master Mirror-Mode for high availability.
Data Organisation
The following chapters explain the data organisation of the stoney cloud OpenLDAP directory.
root
The following LDIF shows the root entry of the whole OpenLDAP directory tree for the stoney cloud:
dn: dc=stoney-cloud,dc=org objectclass: top objectclass: dcObject objectclass: organization dc: stoney-cloud o: stoney-cloud
The following LDIF shows the root of the whole OpenLDAP directory tree for the stoney cloud modified for the company stepping stone GmbH in Switzerland:
dn: o=stepping-stone,c=ch objectclass: top objectclass: organization o: stepping-stone
The entry c=ch stands for the country code of Switzerland while o=stepping-stone stands for the the organisation stepping-stone. The entry stepping-stone is in the process of being reserved at the Federal Office of Communications. With the reservation of the name, all the directory entries will be unique over the whole world.
The root entry can be chosen during the installation process of the stoney cloud. If you decide to use the default entry, you'll end up with dc=stoney-cloud,dc=org.
Administration
Configuration
Customers
The sub tree ou=customers,dc=stoney-cloud,dc=org contains all the customers. Each customer has a unique uid, which is used for later reference.
Customers uid (per customer) CURRENT
We have two kinds of customers:
- Company customer: This is the normal case, as we target companies.
- Private customer: A private customer does not have a company/organisation name.
The following LDIF examples will show both cases where necessary. The first LDIF shows you the default company customer entry after a fresh stoney cloud installation. All relevant data belonging to this reseller is stored below this dn.
dn: uid=4000001,ou=customers,dc=stoney-cloud,dc=org objectclass: top objectclass: sstCustomerCompany uid: 4000001 organizationName: Customer Ltd. sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 sstIsActive: TRUE
The following table describes the different attributes:
Attribute | |
|
Description |
uid | |
|
A unique integer value with 7 digits or more. For example: 4000000. |
organizationName | |
|
The organisation name of the reseller. For example: Customer Ltd.. |
sstBelongsToResellerUID | |
|
Stores the reseller UID the leaf belongs to. A unique value with 7 digits or more. For example: 4000000. |
sstBelongsToCustomerUID | |
|
Stores the customer UID the leaf belongs to. A unique value with 7 digits or more, must correspond with the uid entry. For example: 4000001. |
sstExternalID | |
|
The ID (or number) of a customer, person or product in an external database (for example: 234567). |
sstIsActive | |
|
Is the entry active? Either true (yes) or false (no). |
Legend:
- x: Mandatory in all cases.
The following LDIF shows you the private customer entry. All relevant data belonging to this reseller are stored below this dn.
dn: uid=4000001,ou=customers,dc=stoney-cloud,dc=org objectclass: top objectclass: sstCustomerPerson uid: 4000001 givenName: Name surname: Surname sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 sstIsActive: TRUE
The following table describes the different attributes:
Attribute | |
|
Description |
uid | |
|
A unique integer value with 7 digits or more. For example: 4000000. |
givenName | |
|
Givenname, example: Hans. |
surname | |
|
Surname, example: Muster. |
sstBelongsToResellerUID | |
|
Stores the reseller UID the leaf belongs to. A unique value with 7 digits or more, must correspond with the uid entry. For example: 4000000. |
sstBelongsToCustomerUID | |
|
Stores the customer UID the leaf belongs to. A unique value with 7 digits or more, must correspond with the uid entry. For example: 4000001. |
sstExternalID | |
|
The ID (or number) of a customer, person or product in an external database (for example: 234567). |
sstIsActive | |
|
Is the entry active? Either true (yes) or false (no). |
Legend:
- x: Mandatory in all cases.
Customers uid (per customer) NEW
We have two kinds of customers:
- Company customer: This is the normal case, as we target companies.
- Private customer: A private customer does not have a company/organisation name.
The following LDIF examples will show both cases where necessary. The first LDIF shows you the default company customer entry after a fresh stoney cloud installation. All relevant data belonging to this reseller is stored below this dn.
dn: uid=4000001,ou=customers,dc=stoney-cloud,dc=org objectclass: top objectclass: sstCustomer objectclass: sstRelationship uid: 4000001 organizationName: Customer Ltd. sstIsCompany: TRUE sstIsActive: TRUE sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001
The following LDIF shows you the private customer entry. All relevant data belonging to this reseller are stored below this dn.
dn: uid=4000001,ou=customers,dc=stoney-cloud,dc=org objectclass: top objectclass: sstCustomer objectclass: sstRelationship uid: 4000001 givenName: Name surname: Surname sstIsCompany: FALSE sstIsActive: TRUE sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001
The following table describes the different attributes:
Attribute | |
|
Description |
uid | |
|
A unique integer value with 7 digits or more. For example: 4000000. |
organizationName | |
|
The organisation name of the reseller. For example: Customer Ltd.. |
givenName | |
|
Givenname, example: Hans. |
surname | |
|
Surname, example: Muster. |
sstIsCompany | |
|
Is the entry active? Either true (yes) or false (no). |
sstIsActive | |
|
Is the entry active? Either true (yes) or false (no). |
sstExternalID | |
|
The ID (or number) of a customer, person or product in an external database (for example: 234567). |
sstBelongsToResellerUID | |
|
Stores the reseller UID the leaf belongs to. A unique value with 7 digits or more. For example: 4000000. |
sstBelongsToCustomerUID | |
|
Stores the customer UID the leaf belongs to. A unique value with 7 digits or more, must correspond with the uid entry. For example: 4000001. |
Legend:
- x: Mandatory in all cases.
- x1: If
sstIsCompany
is set toTRUE
, theorganizationName
must be set. OtherwisegivenName
andsurname
must be set.
Customers Billing Address CURRENT
The sub tree ou=address,uid=4000001,ou=customers,dc=stoney-cloud,dc=org contains the billing address for a company customer:
dn: ou=address,uid=4000001,ou=customers,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstAddressCompany ou: address organizationName: Reseller Ltd. sstGender: m givenName: Name surname: Surname postalAddress: Street Number countryName: CH postalCode: Postal Code localityName: Locality preferredLanguage: en-GB mail: name.surname@example.com telephoneNumber: +41 00 000 00 00 mobileTelephoneNumber: +41 00 000 00 00 sstWebsiteURL: https://www.example.com/
The following table describes the different attributes:
Attribute | |
|
Description |
organizationName | |
|
Company name, example: stepping stone GmbH |
sstGender | |
|
Either 'm' for male or 'f' for female. |
givenName | |
|
Givenname, example: Hans. |
surname | |
|
Surname, example: Muster. |
postalAddress | |
|
Street Number, example: Neufeldstrasse 9. Multi-lined field. |
postOfficeBox | |
|
Postbox, example: 3456. |
stateOrProvinceName | |
|
This pulldown menu is only active (appears to the user), if the country is set to Canada or the USA. |
countryName | |
|
Country code according to ISO 3166-1 (for the web interface) and the corresponding ISO 3166-1-alpha-2 code (as the LDAP entry). Example: For Switzerland the value is CH. |
postalCode | |
|
Zipcode, example: 3012 |
localityName | |
|
City, example: Bern. |
preferredLanguage | |
|
Display language of the user according to RFC 1766, example: de-CH. Currently supported:
|
|
|
E-mail address of the user, example: hans.muster@example.com. | |
telephoneNumber | |
|
Fixnet phone number, example: +41 31 222 33 44. |
mobileTelephoneNumber | |
|
Mobile phone number, example: +41 76 222 33 44. |
sstWebsiteURL | |
URL gemäss RFC-3986 http://tools.ietf.org/html/rfc3986. For example http://www.stepping-stone.ch/. |
Legend:
- x1: Either telephoneNumber or mobileTelephoneNumber need to be present. Both attributes can exist together.
- x2: Either postalAddress or postOfficeBox need to be present. Both attributes can exist together.
- x3: If the countryName is either Canada or the USA, the stateOrProvinceName needs to be present.
The sub tree ou=address,uid=4000001,ou=customers,dc=stoney-cloud,dc=org contains the billing address for a private customer:
dn: ou=address,uid=4000001,ou=customers,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstAddressPerson ou: address sstGender: m givenName: Name surname: Surname postalAddress: Street Number countryName: CH postalCode: Postal Code localityName: Locality preferredLanguage: en-GB mail: name.surname@example.com telephoneNumber: +41 00 000 00 00 mobileTelephoneNumber: +41 00 000 00 00 sstWebsiteURL: https://www.example.com/
The following table describes the different attributes:
Attribute | |
|
Description |
sstGender | |
|
Either 'm' for male or 'f' for female. |
givenName | |
|
Givenname, example: Hans. |
surname | |
|
Surname, example: Muster. |
postalAddress | |
|
Street Number, example: Neufeldstrasse 9. Multi-lined field. |
postOfficeBox | |
|
Postbox, example: 3456. |
stateOrProvinceName | |
|
This pulldown menu is only active (appears to the user), if the country is set to Canada or the USA. |
countryName | |
|
Country code according to ISO 3166-1 (for the web interface) and the corresponding ISO 3166-1-alpha-2 code (as the LDAP entry). Example: For Switzerland the value is CH. |
postalCode | |
|
Zipcode, example: 3012 |
localityName | |
|
City, example: Bern. |
preferredLanguage | |
|
Display language of the user according to RFC 1766, example: de-CH. Currently supported:
|
|
|
E-mail address of the user, example: hans.muster@example.com. | |
telephoneNumber | |
|
Fixnet phone number, example: +41 31 222 33 44. |
mobileTelephoneNumber | |
|
Mobile phone number, example: +41 76 222 33 44. |
sstWebsiteURL | |
URL gemäss RFC-3986 http://tools.ietf.org/html/rfc3986. For example http://www.stepping-stone.ch/. |
Legend:
- x1: Either telephoneNumber or mobileTelephoneNumber need to be present. Both attributes can exist together.
- x2: Either postalAddress or postOfficeBox need to be present. Both attributes can exist together.
- x3: If the countryName is either Canada or the USA, the stateOrProvinceName needs to be present.
Customers Billing Address NEW
The sub tree ou=address,uid=4000001,ou=customers,dc=stoney-cloud,dc=org contains the billing address for a company customer:
dn: ou=address,uid=4000001,ou=customers,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstAddress ou: address organizationName: Reseller Ltd. sstGender: m givenName: Name surname: Surname postalAddress: Street Number countryName: CH postalCode: Postal Code localityName: Locality preferredLanguage: en-GB mail: name.surname@example.com telephoneNumber: +41 00 000 00 00 mobileTelephoneNumber: +41 00 000 00 00 sstWebsiteURL: https://www.example.com/
The sub tree ou=address,uid=4000001,ou=customers,dc=stoney-cloud,dc=org contains the billing address for a private customer:
dn: ou=address,uid=4000001,ou=customers,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstAddress ou: address sstGender: m givenName: Name surname: Surname postalAddress: Street Number countryName: CH postalCode: Postal Code localityName: Locality preferredLanguage: en-GB mail: name.surname@example.com telephoneNumber: +41 00 000 00 00 mobileTelephoneNumber: +41 00 000 00 00 sstWebsiteURL: https://www.example.com/
The following table describes the different attributes:
Attribute | |
|
Description |
organizationName | |
|
Company name, example: stepping stone GmbH |
sstGender | |
|
Either 'm' for male or 'f' for female. |
givenName | |
|
Givenname, example: Hans. |
surname | |
|
Surname, example: Muster. |
postalAddress | |
|
Street Number, example: Neufeldstrasse 9. Multi-lined field. |
postOfficeBox | |
|
Postbox, example: 3456. |
stateOrProvinceName | |
|
This pulldown menu is only active (appears to the user), if the country is set to Canada or the USA. |
countryName | |
|
Country code according to ISO 3166-1 (for the web interface) and the corresponding ISO 3166-1-alpha-2 code (as the LDAP entry). Example: For Switzerland the value is CH. |
postalCode | |
|
Zipcode, example: 3012 |
localityName | |
|
City, example: Bern. |
preferredLanguage | |
|
Display language of the user according to RFC 1766, example: de-CH. Currently supported:
|
|
|
E-mail address of the user, example: hans.muster@example.com. | |
telephoneNumber | |
|
Fixnet phone number, example: +41 31 222 33 44. |
mobileTelephoneNumber | |
|
Mobile phone number, example: +41 76 222 33 44. |
sstWebsiteURL | |
URL according RFC-3986 http://tools.ietf.org/html/rfc3986. For example http://www.stepping-stone.ch/. |
Legend:
- x1: If the attribute
sstIsCompany
of the parent entry is set toTRUE
, theorganizationName
must be set. - x2: Either telephoneNumber or mobileTelephoneNumber need to be present. Both attributes can exist together.
- x3: Either postalAddress or postOfficeBox need to be present. Both attributes can exist together.
- x4: If the countryName is either Canada or the USA, the stateOrProvinceName needs to be present.
Customers Shipping Address (optional)
The sub tree ou=shipping,uid=4000001,ou=customers,dc=stoney-cloud,dc=org contains the shipping address and is optional (it is only needed, if the shipping address differs from the billing Address).
dn: ou=shipping,uid=4000001,ou=customers,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstAddress ou: address organizationName: Reseller Ltd. sstGender: m givenName: Name surname: Surname postalAddress: Street Number countryName: CH postalCode: Postal Code localityName: Locality preferredLanguage: en-GB mail: name.surname@example.com telephoneNumber: +41 00 000 00 00 mobileTelephoneNumber: +41 00 000 00 00 sstWebsiteURL: https://www.example.com/
Customers Billing
The sub tree ou=billing,uid=4000001,ou=customers,dc=stoney-cloud,dc=org contains billing relevant data:
dn: ou=billing,uid=4000001,ou=customers,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstBillingReseller ou: billing sstResellerBill: TRUE
This entry need to be described in detail. TBD.
The following table describes the different attributes:
Attribute | |
|
Description |
attribure | |
|
TBD. |
Legend:
- x: Mandatory in all cases.
Customers Employees
The sub tree ou=employees,uid=4000001,ou=customers,dc=stoney-cloud,dc=org contains the employees belonging to the reseller Customer Ltd. (all the employees with the the attribute sstBelongsToEmployeeUID=4000001). With the attribute labeledURI we use the functionality of the dynamic lists overlay to automatically give us a list of employees belonging to this customer. The number of employees is always the same or smaller than the number of people belonging to a customer (they are a subset).
dn: ou=employees,uid=4000001,ou=customers,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: labeledURIObject ou: employees labeledURI: ldap:///ou=people,dc=stoney-cloud,dc=org??one?(sstEmployeeOfUID=4000001) member: uid=4000002,ou=people,dc=stoney-cloud,dc=org
In this example, the customer Customer Ltd. has one employee (with the uid=4000002).
The following table describes the different attributes:
Attribute | |
|
Description |
attribure | |
|
TBD. |
Legend:
- x: Mandatory in all cases.
Customers People
The sub tree ou=people,uid=4000001,ou=customers,dc=stoney-cloud,dc=org contains the all the people belonging to the customer Customer Ltd. (all the people, including the employees, with the the attribute sstBelongsToCustomerUID=4000001). With the attribute labeledURI we use the functionality of the dynamic lists overlay to automatically give us a list of employees belonging to this reseller. The number of people is always the same or larger than the number of employees belonging to a reseller.
dn: ou=people,uid=4000001,ou=customers,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: labeledURIObject ou: employees labeledURI: ldap:///ou=people,dc=stoney-cloud,dc=org??one?(sstBelongsToCustomerUID=4000001) member: uid=4000002,ou=people,dc=stoney-cloud,dc=org member: uid=4000064,ou=people,dc=stoney-cloud,dc=org member: uid=4000066,ou=people,dc=stoney-cloud,dc=org member: uid=4000069,ou=people,dc=stoney-cloud,dc=org
In this example, four people the customer Customer Ltd. (including the employee with the uid=4000002).
The following table describes the different attributes:
Attribute | |
|
Description |
attribure | |
|
TBD. |
Legend:
- x: Mandatory in all cases.
Groups
People
The sub tree ou=people,dc=stoney-cloud,dc=org contains all the people. Each person has a unique uid, which is used for later reference.
People uid (per person)
The following LDIF shows you the default person entry after a fresh stoney cloud installation. All relevant data belonging to this person is stored below this dn.
dn: uid=4000002,ou=people,dc=stoney-cloud,dc=org objectclass: top objectclass: sstPerson uid: 4000002 sstGender: m sstTitle: CEO givenName: Name surname: Surname preferredLanguage: en-GB userPassword: {SSHA}UgrBHVhKxFQInWWpzf1ddgEVmSg5vKUm mail: name.surname@example.com cn: admin telephoneNumber: +41 00 000 00 00 mobileTelephoneNumber: +41 00 000 00 00 sstTimeZoneOffset: UTC+01 sstIsActive: TRUE sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 sstEmployeeOfUID: 4000000 sstEmployeeOfUID: 4000001
The person Name Surname (with the uid=4000002) belongs to the reseller Reseller Ltd. (with sstBelongsToResellerUID=4000000) and is an employee of the same company (sstEmployeeOfUID=4000000). The person also belongs the customer Customer Ltd. (with sstBelongsToCustomerUID=4000001) and is an employee of the same company (sstEmployeeOfUID=4000001).
The following table describes the different attributes:
AttributeType | |
|
|
Description |
uid | |
|
|
Unique Identifier. |
sstGender | |
|
|
Either 'm' for male or 'f' for female |
sstTitle | |
|
|
The title of a person in the form of CEO or Technician. |
givenName | |
|
|
Givenname, example: Hans |
surname | |
|
|
Surname, example: Meier |
preferredLanguage | |
|
|
Display language of the user according to RFC 1766, example: de-CH |
userPassword | |
|
|
SSHA user password. {SSHA} is a RFC 2307 password scheme which uses the SHA1 secure hash algorithm. The {SSHA} is the seeded varient. {SSHA} is recommended over other RFC 2307 schemes. |
|
|
|
E-mail address of the user, example: hans@example.com | |
cn | |
|
|
Common name of the user, for instance admin or user1. |
telephoneNumber | |
|
|
Fixnet phone number, example: +41 31 222 33 44 |
mobileTelephoneNumber | |
|
|
Mobile phone number, example: +41 76 222 33 44 |
sstTimeZoneOffset | |
|
|
Time zone as an offset from UTC, example: UTC+01 |
sstIsActive | |
|
|
Is the entry active? Either true (yes) or false (no). |
sstBelongsUID | |
|
|
Wenn dieser Wert vorhanden ist und der Wert "1" aufweist, ist diese Person Superuser und hat Zugriff über das gesamte System. In der Regel wird der Superuser nur benötigt, um neue Wiederverkäufer (Reseller) aufzuschalten. |
sstBelongsToResellerUID | |
|
|
Die UID des Wiederverkäufers (Reseller) zu der die Person gehört. Das heisst, die Person ist Mitarbeiter des Wiederverkäufers. |
sstBelongsToCustomerUID | |
|
|
Die UID des Kunden (Customer) zu der die Person gehört. Das heisst, die Person ist Mitarbeiter des Kunden. |
sstExternalID | |
|
|
The ID (or number) of a customer, person or product in an external database (for example: 234567). |
Legende zur Mandatory Spalte:
- x1: Entweder telephoneNumber oder mobileTelephoneNumber müssen ausgefüllt sein.
- (x): Noch nicht definiert, ob der Benutzer (User) diese Werte ändern darf.
People Roles
This must be documented. TBD.
dn: ...,uid=4000002,ou=people,dc=stoney-cloud,dc=org
Reseller
The sub tree ou=reseller,dc=stoney-cloud,dc=org contains all the resellers. Each reseller has a unique uid, which is used for later reference.
Reseller uid (per Reseller) CURRENT
The following LDIF shows you the default reseller entry after a fresh stoney cloud installation. All relevant data belonging to this reseller is stored below this dn.
dn: uid=4000000,ou=reseller,dc=stoney-cloud,dc=org objectclass: top objectclass: sstReseller uid: 4000000 organizationName: Reseller Ltd. sstBelongsToResellerUID: 4000000 sstIsActive: TRUE
The following table describes the different attributes:
Attribute | |
|
Description |
uid | |
|
A unique integer value with 7 digits or more. For example: 4000000. |
organizationName | |
|
The organisation name of the reseller. For example: Reseller Ltd.. |
sstBelongsToResellerUID | |
|
Stores the reseller UID the leaf belongs to. A unique value with 7 digits or more, must correspond with the uid entry. For example: 4000000. |
sstExternalID | |
|
The ID (or number) of a customer, person or product in an external database (for example: 234567). |
sstIsActive | |
|
Is the entry active? Either true (yes) or false (no). |
Legend:
- x: Mandatory in all cases.
Reseller uid (per Reseller) NEW
The following LDIF shows you the default reseller entry after a fresh stoney cloud installation. All relevant data belonging to this reseller is stored below this dn.
dn: uid=4000000,ou=reseller,dc=stoney-cloud,dc=org objectclass: top objectclass: sstReseller uid: 4000000 organizationName: Reseller Ltd. sstIsCompany: TRUE sstIsActive: TRUE sstBelongsToResellerUID: 4000000
The following table describes the different attributes:
Attribute | |
|
Description |
uid | |
|
A unique integer value with 7 digits or more. For example: 4000000. |
organizationName | |
|
The organisation name of the reseller. For example: Reseller Ltd.. |
sstBelongsToResellerUID | |
|
Stores the reseller UID the leaf belongs to. A unique value with 7 digits or more, must correspond with the uid entry. For example: 4000000. |
sstExternalID | |
|
The ID (or number) of a customer, person or product in an external database (for example: 234567). |
sstIsActive | |
|
Is the entry active? Either true (yes) or false (no). |
Legend:
- x: Mandatory in all cases.
Reseller Billing Address
The sub tree ou=address,uid=4000000,ou=reseller,dc=stoney-cloud,dc=org contains the billing address:
dn: ou=address,uid=4000000,ou=reseller,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstAddressCompany ou: address organizationName: Reseller Ltd. sstGender: m givenName: Name surname: Surname postalAddress: Street Number countryName: CH postalCode: Postal Code localityName: Locality preferredLanguage: en-GB mail: name.surname@example.com telephoneNumber: +41 00 000 00 00 mobileTelephoneNumber: +41 00 000 00 00 sstWebsiteURL: https://www.example.com/
The following table describes the different attributes:
Attribute | |
|
Description |
organizationName | |
|
Company name, example: stepping stone GmbH |
sstGender | |
|
Either 'm' for male or 'f' for female. |
givenName | |
|
Givenname, example: Hans. |
surname | |
|
Surname, example: Muster. |
postalAddress | |
|
Street Number, example: Neufeldstrasse 9. Multi-lined field. |
postOfficeBox | |
|
Postbox, example: 3456. |
stateOrProvinceName | |
|
This pulldown menu is only active (appears to the user), if the country is set to Canada or the USA. |
countryName | |
|
Country code according to ISO 3166-1 (for the web interface) and the corresponding ISO 3166-1-alpha-2 code (as the LDAP entry). Example: For Switzerland the value is CH. |
postalCode | |
|
Zipcode, example: 3012 |
localityName | |
|
City, example: Bern. |
preferredLanguage | |
|
Display language of the user according to RFC 1766, example: de-CH. Currently supported:
|
|
|
E-mail address of the user, example: hans.muster@example.com. | |
telephoneNumber | |
|
Fixnet phone number, example: +41 31 222 33 44. |
mobileTelephoneNumber | |
|
Mobile phone number, example: +41 76 222 33 44. |
sstWebsiteURL | |
URL gemäss RFC-3986 http://tools.ietf.org/html/rfc3986. For example http://www.stepping-stone.ch/. |
Legend:
- x1: Either telephoneNumber or mobileTelephoneNumber need to be present. Both attributes can exist together.
- x2: Either postalAddress or postOfficeBox need to be present. Both attributes can exist together.
- x3: If the countryName is either Canada or the USA, the stateOrProvinceName needs to be present.
Reseller Shipping Address (optional)
The sub tree ou=shipping,uid=4000000,ou=reseller,dc=stoney-cloud,dc=org contains the shipping address and is optional (it is only needed, if the shipping address differs from the billing Address).
dn: ou=shipping,uid=4000000,ou=reseller,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstAddressCompany ou: shipping organizationName: Reseller Ltd. sstGender: m givenName: Name surname: Surname postalAddress: Street Number countryName: CH postalCode: Postal Code localityName: Locality preferredLanguage: en-GB mail: name.surname@example.com telephoneNumber: +41 00 000 00 00 mobileTelephoneNumber: +41 00 000 00 00 sstWebsiteURL: https://www.example.com/
Reseller Billing
The sub tree ou=billing,uid=4000000,ou=reseller,dc=stoney-cloud,dc=org contains billing relevant data:
dn: ou=billing,uid=4000000,ou=reseller,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstBillingReseller ou: billing sstResellerBill: TRUE
This entry need to be described in detail. TBD.
The following table describes the different attributes:
Attribute | |
|
Description |
attribure | |
|
TBD. |
Legend:
- x: Mandatory in all cases.
Reseller Customers
The sub tree ou=customers,uid=4000000,ou=reseller,dc=stoney-cloud,dc=org contains the customers belonging to the reseller Reseller Ltd. (all the customers with the the attribute sstBelongsToResellerUID=4000000). With the attribute labeledURI we use the functionality of the dynamic lists overlay to automatically give us a list of customers belonging to this reseller.
dn: ou=customers,uid=4000000,ou=reseller,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: labeledURIObject ou: customers labeledURI: ldap:///ou=customers,dc=stoney-cloud,dc=org??one?(sstBelongsToResellerUID=4000000) member: uid=4000001,ou=customers,dc=stoney-cloud,dc=org
In this example, the reseller Reseller Ltd. has one customer (with the uid=4000001).
The following table describes the different attributes:
Attribute | |
|
Description |
attribure | |
|
TBD. |
Legend:
- x: Mandatory in all cases.
Reseller Employees
The sub tree ou=employees,uid=4000000,ou=reseller,dc=stoney-cloud,dc=org contains the employees belonging to the reseller Reseller Ltd. (all the employees with the the attribute sstBelongsToEmployeeUID=4000000). With the attribute labeledURI we use the functionality of the dynamic lists overlay to automatically give us a list of employees belonging to this reseller. The number of employees is always the same or smaller than the number of people belonging to a reseller (they are a subset).
dn: ou=employees,uid=4000000,ou=reseller,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: labeledURIObject ou: employees labeledURI: ldap:///ou=people,dc=stoney-cloud,dc=org??one?(sstEmployeeOfUID=4000000) member: uid=4000002,ou=people,dc=stoney-cloud,dc=org
In this example, the reseller Reseller Ltd. has one employee (with the uid=4000002).
The following table describes the different attributes:
Attribute | |
|
Description |
attribure | |
|
TBD. |
Legend:
- x: Mandatory in all cases.
Reseller People
The sub tree ou=people,uid=4000000,ou=reseller,dc=stoney-cloud,dc=org contains the all the people belonging to the reseller Reseller Ltd. (all the people, including the employees, with the the attribute sstBelongsToResellerUID=4000000). With the attribute labeledURI we use the functionality of the dynamic lists overlay to automatically give us a list of employees belonging to this reseller. The number of people is always the same or larger than the number of employees belonging to a reseller.
dn: ou=people,uid=4000000,ou=reseller,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: labeledURIObject ou: employees labeledURI: ldap:///ou=people,dc=stoney-cloud,dc=org??one?(sstBelongsToResellerUID=4000000) member: uid=4000002,ou=people,dc=stoney-cloud,dc=org member: uid=4000064,ou=people,dc=stoney-cloud,dc=org member: uid=4000066,ou=people,dc=stoney-cloud,dc=org member: uid=4000069,ou=people,dc=stoney-cloud,dc=org
In this example, four people the reseller Reseller Ltd. (including the employee with the uid=4000002).
The following table describes the different attributes:
Attribute | |
|
Description |
attribure | |
|
TBD. |
Legend:
- x: Mandatory in all cases.
Services
The sub tree ou=services,dc=stoney-cloud,dc=org contains all the stoney cloud services like backup or mail.
dn: ou=services,dc=stone-cloud,dc=org objectclass: organizationalUnit objectclass: top ou: services
The actual services are described in the following chapters.
Backup
The (Online) Backup service consists of two areas:
- Server: The actual backup space with some extra functionality like informing the user when the backup space runs full or if a back was not executed at the planned time.
- Client: The backup client (for example Sepiola), which is responsible to regularly copy the local data to the backup server.
On the back server the data copied to the backup space ist compared each day to the previous day's backup. If there are any changes found, a copy of the data will be made (a snapshot taken). Thus the user has access to 7 daily, 4 weekly and 3 monthly backups. During each snapshot, only the modified data is copied - thereby making optimal use of the available disk space.
This OpenLDAP related section of the Backup service is described on the Backup (OpenLDAP) page.