Registration Server Settings¶
Registration Server Settings can be changed in the Administration Console, via the Server Management -> Registration Server Settings page.
These settings are split up into several categories, which are listed below (in alphabetical order).
You can define a minimum password length to be used by a user. The default value is 8 characters. This parameter will only be checked by the API, since the Clients only send an MD5 hash of the password, which can not be checked on server side. A password complexity check is not implemented at the moment.
You can define a minimum username length to be used by a user. The default value is 5 characters.
These settings define how the Registration Server delivers outgoing email messages to an SMTP server (MTA).
The sender header can be defined to avoid spam classification (see sender field description in: http://en.wikipedia.org/wiki/Email#Header_fields). This is necessary in case that the invitations between the users don’t match to the domain which will be used by the registration server. If this value is empty, only the from header will be used.
This setting can be overridden by the provider setting
EMAIL/EMAIL_SENDER_EMAIL, to define a custom sender address on a
per-provider basis. See chapter EMAIL_SENDER_EMAIL for details.
As described in the SMTP protocol
there will be communication between the SMTP client on the registration server
and the SMTP server which will accept the email for delivery. To avoid spam
HELO command must match the servers
FQDN. If this
value is empty, the default hostname / IP address detection will be used which
127.0.0.1 instead of the hostname.
This is a security setting, since invitation mails can, potentially, also be used for spam mails from an user sent by your mail server. You can define how many mails the user can send per day. (-1 = unlimited, 0 = no mail)
The IP or DNS name of the SMTP server. It must be a SMTP server which can
sendmail requests without requiring any form of encryption
Timeout parameter in seconds for
A Provider will be identified by the IP address where an API request
originates from. If different Providers send requests coming from the same IP
address, this value must be changed to
True so that the Provider can be
set within the requests.
If you are using the Administration Console and have multiple providers using
the Registration Server, this value must be set to
To detect “man in the middle” attacks when sending API requests to the Registration Server, a random “salt value” is generated during the initial installation. The sender must add this salt value to his request before calculating the MD5 hash value of the API request content which will be sent to the Registration Server.
The checksum will be included in the URL, so that the Registration Server can check if the content was modified during the transport.
This setting is read-only and can not be changed via the Administration Console.
See chapter API Basics for details.
A log file that tracks API requests issued by the Administration Console. This
file needs to be owned and writeable by the apache user. (default:
The time in seconds that Registration Server configuration options are cached.
Changes to the Registration Server or Provider setting will be reloaded after
The default poll interval for clients (in seconds) to look for new invitations on the Registration Server.
These settings are sent to all Clients after login. Settings specified for a Provider can override the values defined here.
This setting can be overridden by the provider setting
CLIENT/CLIENT_SETTINGS on a per-provider basis. See chapter
CLIENT_SETTINGS for details.
Select the existing Provider account that acts as the default Provider (this is usually the first provider created on the Registration Server).
For more information about the Provider concept, please refer to Provider Concept.
A link to the Client software download page. This URL is optional and may be
overridden by the
REDIRECT_DOWNLOAD Provider setting.
DownloadURL is a “Redirect URL”, see Redirect URLs
This setting specifies whether a Registration Email address should be globally
unique or not. When set to
True, the Registration Server will check that
an email is unique over the entire TeamDrive Network.
By default this parameter is set to the value if
UserEmailUnique. In other
UserEmailUnique` is set to ``True, then
will be set to
True on upgrade to version 3.6.
An optional link to a FAQ page. This URL can be overridden by the
FAQURL is a “Redirect URL”, see Redirect URLs
An optional link to a Forum which can be overridden by the
ForumURL is a “Redirect URL”, see Redirect URLs
An optional link to a general Help page. This URL can be overridden by
REDIRECT_HELP Provider setting.
HelpURL is a “Redirect URL”, see Redirect URLs
An optional link to a privacy page which is required by the Google Play Store or the
Apple App-Store. This URL can be overridden by the
REDIRECT_PRIVACY Provider setting.
PrivayURL is a “Redirect URL”, see Redirect URLs
IP address or host name of the HTTP proxy server to be used for the Registration Server to Host Server communication.
TCP port of the HTTP proxy server to be used for Host Server requests.
True if outgoing Host Server requests must be sent via a HTTP
proxy server. This requires setting
Invitations will be stored on the server for a specified period of time. The default is 30 days (2592000 seconds). After that duration the server will automatically delete older invitations. If the value is to 0, invitations will never be deleted. Deletions are carried out by the background task described here: “Delete Old Messages” Task.
Within 14 days after the first registration, the client will send an invitation for each created Space to the registration server for devices the user may install in future. See Invitation for future devices for a detailed description.
Each new Client installation by a user will create a new device in the database. If the user were to get a new PC, it would be installed as a new device, but the first device will remain in the Registration Server database, even if the user no longer uses it. Invitations will only be sent to devices which were active within the defined period. Please notice, that the device active timestamp will only be updated once a day. So, the value should not be less than one day (86400 seconds). The default value is 96 days (8294400 seconds).
This an optional link to a page on which new licenses can be purchased. This URL may be overridden by the ``REDIRECT_PURCHASE` Provider setting.
LicensePurchaseURL is a “Redirect URL”, see Redirect URLs
Optional load balancer URL. This URL will be used by the client in place of
the standard registration Server URL. If empty
RegServerURL will be used.
This setting may contain multiple URLs separated by a ‘|’ character. In this case, the TeamDrive Clients will automatically use a different URL for each call the the Registration Server.
In case of errors on the Client side, the user can submit a support request by
uploading its log files to the Registration Server. The archive of log files
and additional debug information will be sent to a PHP script
recommend keeping the existing URL since in general it will only be possible for
TeamDrive Systems GmbH to understand the log output.
If you want to set up your own log upload service, you could direct the URL to
your server. The
upload.php will insert the log reports into the database
which could be viewed in
Manage Clients / Download Client Log Files.
The name of the Master Registration Server in your TeamDrive Network.
Default URL of the Master Registration Server.
For an inital connection or later on the online test, the client will ping the
PingURL. This will return a defined answer:
<?xml version='1.0' encoding='UTF-8' ?> <teamdrive> <intresult>0</intresult> </teamdrive>
back to the client, so that the client can check if he can reach the server,
or if there is a proxy or an other gateway which require additional steps
to get internet access. The
PingURL can be located on another server
and just requires a file
ping.xml with the above content.
Default should be the same domain as in
URL of the Provider information page which will describe all Provider codes available to the user. This link may be overridden by the ``REDIRECT_PROVIDERINFO` Provider setting.
IP address or host name of the HTTP proxy to be used for outgoing HTTP requests.
TCP Port of the HTTP proxy server to be used for outgoing HTTP requests.
The optional user-invite-user referral link, which can be overridden by the
REDIRECT_USERINVITEUSER Provider setting.
ReferralURL is a “Redirect URL”, see Redirect URLs
Optional Reg Server API URL, used by the Administration Console (e.g.
http://regserver.yourdomain.com/pbas/td2as/api/api.htm). Must be set, if HTTPS
should be used for API communication or if a dedicated API server is used. If
empty, it will be derived from
This is a description of the Registraton Server and should include the name of the owner or name of the company that hosts the server. The name and contact information of the administrator of the server should also be provided.
This information is transported to other Registration Servers in the TeamDrive network.
The name of your Registration Server which should be defined together with TeamDrive Systems GmbH. The name must be unique within the TDNS network, and it can not be changed later on without reinstalling all clients.
This is the main URL which will be used by the Clients to register and interact with the Registration Server. This URL must always be reachable by the Clients to offer the services. If the URL is no longer valid the Clients have no possibility to reach the server again.
Location of various server log files that can be viewed from within the Administration Console via Server Management -> View Server Logs. For security reason this setting can only be changed directly in the database to avoid unauthorized access to other than the allowed log files.
Timezone used for date functions in the Adminstration Console. Please ensure
that the timezone is valid (see
/usr/share/zoneinfo/ for available time
zone information)! (default:
Enables backward compatibility with TeamDrive 2 clients.
Each client registration will store the IP address which was used to register the client. In case of a hacked account, it may be possible to identify the source of the request. The default is 2592000 seconds (30 days) after which the IP will be removed. Other possible values are -1 (never store the value) or 0 (never delete it). All values greater than zero will be taken as seconds. The Delete Client IPs auto task as described in “Delete Client IPs” Task must be enabled.
Set this value to
True to enable new Registration Servers added to the TDNS
network automatically. By default this setting is set to
Registration Servers automatically whitelisted can be disabled manually
in the Admin Console. Note, that if you set this setting to
False, you must
ensure that the TeamDrive Master Registration Server is manually enabled.
If the Master Registration Server is not enabled then the standard TeamDrive Clients will not be able to connect to your Registration Server. In this case, a custom Client with a DISTRIBUTOR file that references your Registration Server is required.
This value will be used to activate the TDNS integration of the RegServer, so
that the users of your Registration Server can invite users of other
Registration Servers which are registered in the TDNS network. Each
Provider on a Registration Server needs an own
TDNS-ServerID and a
TDNS-Checksum value which will be defined by TeamDrive Systems. Without
these values your server can not communicate with the TDNS. The two values
must be set when for adding a new Provider on the Registration Server
(see TDNS Settings).
URL used to access the TeamDrive Name Server (TDNS).
An optional link used to purchase a license for TDPS (TeamDrive Personal Server). This URL can be overridden by the ``REDIRECT_ORDER` Provider setting.
TDPSOrderURL is a “Redirect URL”, see Redirect URLs
This is the location of the default email and HTML templates.
An optional link a tutorials page. This URL can be overridden by the ``REDIRECT_TUTORIALS` Provider setting.
TutorialURL is a “Redirect URL”, see Redirect URLs
True if outgoing requests must be sent via a HTTP proxy server.
This requires setting
ProxyPort as well. Note that Host
Server access uses different proxy settings (see
This setting specifies if email address must be unique for the entire
Registration Server. If set to
False then email address need only be
unique per Provider. The setting
EmailGloballyUnique specifies whether
email address must be unique over all TeamDrive Registration Servers.
$false if usernames should be case sensitive. By default usernames
are case insensitive. Since case-sensitive usernames can be a security risk,
this is the recommended setting.
These settings allow to enforce some security related restrictions on the Administration Console.
The number of failed login attempts to a particular account within
LoginMaxInterval before further login attempts are subjected to a delay.
Time interval used by
LoginMaxAttempts, in minutes. (default:
Period of idle time before you need to log in to the Administration Console
again, in minutes. (default:
Log security events to a local syslog, rather than
The maximum number of search results that will be shown for any given request (0 == unlimited)
If set to a non-zero value, this is the maximum number of user records that
can be viewed within the interval defined by
The time interval that
UserRecordLimit applies to.
There are a number of URLs that will be used by the TeamDrive Client to open web pages in response to clicks within the client. These are referred to as “Redirect URLs”.
The various target pages of the Redirect URLs can be set by providing value for the
These settings are optional. If no URL us provided the Registration server will return a HTML result containing an english error message.
In addition, all the settings can be overridden by Provider specific settings (see Provider Settings). This means that the Registration Server settings act as a default, if the Provider does not specify a particular URL.
A number of URL parameters are passed to the target pages. These parameters can be used within the target landing pages to generate the content.
- These parameters are used to determine the target page. These parameters are used by the Registration Server to select a target URL from the various Redirect URL settings.
- The international language code of the current language of the client.
- Specifies the platform of the client: mac, win, linux, ios, android or unknown.
- Base 64 encoded username. This parameter is only supplied for the
- Specifies the product ordered. Only provided for the
TDPSOrderURLURL. Currently the only possible value is TDPS.