.. _provider / distributor settings: Provider Settings ================= When a Provider (formerly known as a "Distributor") is created, the Provider settings are specified in an XML file in the ```` XML block. The Provider is then created using this XML file. After this point, the Provider settings can be changed using the Admin Console. In the sections below each setting is identified by the name used in the Admin Console. The associated XML tag used during setup follows the name in parenthesis. To secure the login to the Admin Console you could setup a single IP in the Admin Console using the ``LOGIN_IP`` setting. Only logins from this IP address are allowed (that also provide correct user login credentials). .. _provider / distributor settings/api settings: API Settings ( XML block) ------------------------------------ You can define whether a Provider is allowed to access the Registration Server using the API interface as described in the API documentation. If the ```` tag is set to ``$false`` all settings in this section will be ignored. NOTE: This setting must be enabled to use the Admin Console. .. _provider / distributor settings/api settings/api_ip_access: API_IP_ACCESS ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ API access is only allowed from a single IP address. Two different providers can not use the same IP address, because the IP address will be used to identify the Provider. This is done for security reasons, as you may only access your own customers, licenses, and other data belonging to your Provider. Exception: The Admin Console (which uses API functions) allows each Provider to login if the above value ```` is enabled. It's also possible to add more than one IP address if you want to access the API from different machines. .. _provider / distributor settings/api settings/api_redirect: API_REDIRECT ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This value will be returned for various API calls if the calling user belongs to another Provider. For more details, please look in the API documentation. .. _provider / distributor settings/api settings/api_create_default_license: API_CREATE_DEFAULT_LICENSE ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ By default each user will get a default license. You can disable this if you want the possibility of creating or assigning a license created by an API call. .. _provider / distributor settings/api settings/reg_name_complexity: REG_NAME_COMPLEXITY ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This value must be identical to the value set in the ``DISTRIBUTOR file``. For further details, see :ref:`provider concept/login and registration settings/reg-name-complexity`\ . .. _provider / distributor settings/api settings/api_send_email: API_SEND_EMAIL ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If set to``$true``, the user will be sent an activation email if registered via the API. .. _provider / distributor settings/api settings/api_allow_checksumerr: API_ALLOW_CHECKSUMERR ~~~~~~~~~~~~~~~~~~~~~ When developing or testing the API functions it may be easier to disable checksum checks. This value can only be set in the admin console (see *Administrative Guide*). .. _provider / distributor settings/api settings/api_use_ssl_for_host: API_USE_SSL_FOR_HOST ~~~~~~~~~~~~~~~~~~~~ If your host server can communicate using HTTPS, you could enable SSL communication between the admin console and host server API. This value can only be set in the admin console (see *Administrative Guide*). .. _provider / distributor settings/api settings/api_adminconsole_lic_ref: API_ADMINCONSOLE_LIC_REF ~~~~~~~~~~~~~~~~~~~~~~~~ License reference value when creating licenses using the admin console. .. _provider / distributor settings/email settings: EMAIL Settings ( XML block) ---------------------------------- .. _provider / distributor settings/email settings/email_sender_email: EMAIL_SENDER_EMAIL ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The activation mail will list this email address as the sender. .. _provider / distributor settings/email settings/email_replyto: EMAIL_REPLYTO ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This address will be used for invitation mails. Its usage depends on the value in ````. .. _provider / distributor settings/email settings/email_default_lang: EMAIL_DEFAULT_LANG ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If the user is using a language which is not listed in ````, the ```` will be used instead. .. _provider / distributor settings/email settings/email_allowed_lang: EMAIL_ALLOWED_LANG ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Each Provider Code defines a comma separated list of languages allowed for the emails. A set of templates is required for each language. The language used depends on the language setting of the user's record. .. _provider / distributor settings/activation settings: ACTIVATION Settings ( XML block) -------------------------------------------- .. _provider / distributor settings/activation settings/activation_default_lang: ACTIVATION_DEFAULT_LANG ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The activation page's language depends on the chosen language of the user. If the language of the user is not supported, the default language specified here will be used. The default HTML pages must always be available. .. _provider / distributor settings/activation settings/activation_allowed_lang: ACTIVATION_ALLOWED_LANG ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This is a comma separated list of languages allowed. .. _provider / distributor settings/banner settings: BANNER Settings ( XML block) ------------------------------------ The client can display two different banners. One in the main window and one in the Space creation wizard. The banner feature in the user's license specifies whether a banner is displayed. A default banner will be shipped together with the installation package. Banners can be updated using the Admin Console, see chapter "Manage Banner" ToDo: links setzen. You have to set the ``MediaURL`` as described in :ref:`registration server settings/general settings/mediaurl` which will be used by the TeamDrive clients to download the banner data. .. _provider / distributor settings/banner settings/banner_enabled: BANNER_ENABLED ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Specifies whether the Banner update function of the Registration Server is enabled. .. _provider / distributor settings/banner settings/banner_default_lang: BANNER_DEFAULT_LANG ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Banners depend on the chosen language of the user. If the language of the user is not supported, the default language will be used. This banner must always be available. .. _provider / distributor settings/banner settings/banner_allowed_lang: BANNER_ALLOWED_LANG ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This is a comma separated list of allowed banner languages. .. _provider / distributor settings/tdns settings: TDNS Settings ( XML block) -------------------------------- If TDNS access is enabled for the Registration Server, each Provider needs its own ``ServerID`` and ``Checksum``. .. _provider / distributor settings/tdns settings/tdns_serverid: TDNS_SERVERID ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The ID of the Provider's entry in the TDNS. .. _provider / distributor settings/tdns settings/tdns_checksumkey: TDNS_CHECKSUMKEY ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The checksum which will be added to the checksum over the request which will be send to the TDNS. For more details please look at :ref:`teamdrive name server (tdns)`. .. _provider / distributor settings/client settings: CLIENT Settings ( XML block) ------------------------------------ .. _provider / distributor settings/client settings/use_email_as_reference: USE_EMAIL_AS_REFERENCE ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Enable if you want to use the email address to reference your users between your own system and the Registration Server. In this case usernames will be automatically generated when using the API. All further API requests which require the username can then use the email instead. .. _provider / distributor settings/client settings/allowed_dist_codes: ALLOWED_DIST_CODES ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ A list of allowed Client Provider Codes, besides the Provider's own code (value specified in the ```` tag). This refers to the Provider Code in the TeamDrive Client's ``DISTRIBUTOR`` file. The default value is '\*', which means all codes are allowed. '\*.' means all Provider which exists on this Registration Server are allowed. This setting caters for Provider that have a specific version of the TeamDrive Client and want to ensure that only this type of client is used by the Provider's users. Such versions are identified by the Provider Code specified in the ``DISTRIBUTOR`` file. Since the ``DISTRIBUTOR`` file is signed it cannot be manipulated on the client side, and therefore, this value can be trusted. .. note:: It is highly recommended that Provider always allows the standard TeamDrive Client (which has the TMDR code) in addition to any others. .. _provider / distributor settings/client settings/client_defaultlicref: CLIENT_DEFAULTLICREF ~~~~~~~~~~~~~~~~~~~~ License reference value for default licenses. .. _provider / distributor settings/client settings/client_networks: CLIENT_NETWORKS ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This is a list of networks (in CIDR notation) or IP addresses that identify users of the Provider. Using this setting, a Provider can determine that certain networks "belong" to the Provider. For example, any company that has been allocated a Provider Code can take ownership of own networks (as determined by global IP address ranges), and use this fact to control TeamDrive Clients started in those networks. When a TeamDrive Client connects to the Registration Server, and before the user has logged in, the server determines the client's IP address and checks whether the client is running in a network that has been specifically allocated to a Provider. If so, then the Provider Code is sent to the client and this overrides Provider Code in the ``DISTRIBUTOR`` file. This way, if the user registers after this point, the user will be automatically allocated to the Provider that owns the network in which the client was started. .. _provider / distributor settings/client settings/pre_login_settings: PRE_LOGIN_SETTINGS ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ These settings are sent to the TeamDrive Client before login or registration. As a result, they can be used to configure login and registration in the same manner as settings within the ``DISTRIBUTOR`` file. Settings from the server always override client-side settings, so these settings will also override the values in the ``DISTRIBUTOR`` file. The Provider of the user must be ascertained before the pre-login settings can be sent to the client. Before login or registration, the Provider of the user is either determined by the Provider Code in the ``DISTRIBUTOR`` file or the IP address of the client, if it is found to be in a network belonging to a specific Provider. The IP address has priority over the ``DISTRIBUTOR`` file. .. _provider / distributor settings/client settings/client_settings: CLIENT_SETTINGS ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ These settings are sent to the client after registration or login. Theses settings can be used to configure the behaviour of the TeamDrive Client as required by the Provider. They will override any settings made on the client-side, and also override the global Registration Server ``ClientSettings`` setting as describe in :ref:`registration server settings/client settings`. Note that after registration or login, the user's Provider is fixed, and therefore the Provider Code in the ``DISTRIBUTOR`` file, or the network (see :ref:`registration server settings/client settings`\ ) in which the client is stated doesn't play a role any more. .. _provider / distributor settings/free client settings: FREE CLIENT Settings ( XML block) --------------------------------------------- This block will handle the free client limitations. Because we support both WebDAV servers and the TDPS, it's not enough to use the storage account limitation of the Hosting Service. To limit the amount of data which can be administrated using a non full licensed client, you must define the limits here. The value also depends on the Provider. .. _provider / distributor settings/free client settings/default_free_feature: DEFAULT_FREE_FEATURE ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Numerous features can be bound to a license. The default features are set using this parameter. This value uses a bit-mask for enabling or disabling the individual feature; each feature has an assigned value (which is a power of 2) and the value of this setting is equal to the sum of all enabled feature values: | **1** = Banner | **2** = WebDAV | **4** = Personal | **8** = Professional **Example:** For TeamDrive Systems, the Banner and WebDAV features are set for a free client. The Banner feature has the value 1 and WebDAV feature has the value 2. So to use both, the parameter value would be 1 + 2 = **3**. For more details about the features, please have a look at :ref:`teamdrive client <--> server interaction`. .. _provider / distributor settings/free client settings/free_limit_size: FREE_LIMIT_SIZE ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This is the value in bytes to limit the amount of data which can be handled by a free client over all Spaces. The limitation will be shown in the client if he is reaching the 75 % border. A progress bar will be visible right above the status bar in the client. If the user will reach the 100 % he can still synchronize data, but the client is switching to meta data synchronisation. Downloading the contents of the files must be initiated manually by the user for each single file and version. .. _provider / distributor settings/free client settings/default_licensekey: DEFAULT_LICENSEKEY ~~~~~~~~~~~~~~~~~~ This value can only be set in the Admin Console, because the license key must be created after the server was setup. This value overrides the ``DEFAULT_FREE_FEATURE`` setting (```` tag). .. _provider / distributor settings/update settings: UPDATE Settings ( XML block) ------------------------------------------ The TeamDrive Client checks if there are updates available for its version. You can use the following settings to define the supported languages for the update notification. How the update notification will be configured using the Admin Console is described in chapter. .. _provider / distributor settings/update settings/minimum_client_version: MINIMUM_CLIENT_VERSION ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Any clients with a version below this may not register a new device. .. _provider / distributor settings/update settings/update_default_lang: UPDATE_DEFAULT_LANG ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Which update information HTML page will be displayed for the user, depends on the chosen language of the user. The language of the displayed update information HTML page depends on the user's language. If the language of the user is not supported, the default language specified here will be used. The default HTML pages must always be available. .. _provider / distributor settings/update settings/update_allowed_lang: UPDATE_ALLOWED_LANG ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ A comma separated list of allowed languages. .. _provider / distributor settings/update settings/update_test_user: UPDATE_TEST_USER ~~~~~~~~~~~~~~~~ A test user can be defined using the Admin Console. This user will always get the update notification in their client even if they are already using a newer version. This allows you to test the update notification without up- and downgrading a TeamDrive client version. .. _provider / distributor settings/hostserver settings: HOSTSERVER Settings ------------------- A TeamDrive Enterprise Host-Server is registered using a provider code and the URL of the Registration Server. You can also use the Admin Console to define a default Host-Server for clients which register using said provider code. The main provider of a Registration Server is allowed to configure any host-server on the Registration Server to accept users with different provider codes. This way it's possible to use only one host server for multiple providers on a Registration Server. .. _provider / distributor settings/hostserver settings/host_server_name: HOST_SERVER_NAME ~~~~~~~~~~~~~~~~ Please choose a server from the list to use as the default depot server for new clients. .. _provider / distributor settings/hostserver settings/host_server_url: HOST_SERVER_URL ~~~~~~~~~~~~~~~ The URL of the Host-Server will automatically be entered in this field after you have selected a host server from the ``HOST_SERVER_NAME`` list above. .. _provider / distributor settings/hostserver settings/host_depot_size: HOST_DEPOT_SIZE ~~~~~~~~~~~~~~~ The size of the depot for the user in bytes. Default is: ``2 GB = 2147483648 Bytes`` .. _provider / distributor settings/hostserver settings/host_traffic_size: HOST_TRAFFIC_SIZE ~~~~~~~~~~~~~~~~~ The monthly allowed traffic for the user in bytes. Default is: ``20 GB = 21474836480 Bytes`` .. _provider / distributor settings/referral settings: REFERRAL Settings ----------------- You can configure a Referral-Program for users which got invited by an existing user. .. note:: A "referral" is only valid if: a) The invited user did not have an account before being invited b) The user was invited by email c) The invited user registered with the email address the invitation was sent to (so that a match can be made) The background task as described in :ref:`registration server setup/autotasks/"move store forward messages"-task` will do the matching, increasing the depot values and sending the notification mails (see :ref:`html and email templates/email templates/templates for client actions`). The background task must be running and be active. You also need an active host server and default depots for your users (see above :ref:`provider / distributor settings/hostserver settings`). .. _provider / distributor settings/referral settings/max_promotion_user: MAX_PROMOTION_USER ~~~~~~~~~~~~~~~~~~ The maximum amount of new users which can be invited by an existing user. .. _provider / distributor settings/referral settings/promotion_upgrade: PROMOTION_UPGRADE ~~~~~~~~~~~~~~~~~ The promotions upgrade size in bytes. The depot limit and free client limit are increased for both the new and for the existing user. .. _provider / distributor settings/csvimport settings: CSVIMPORT Settings ------------------ The settings for the CSV import can only be set using the Admin Console. Users can be created using a CSV import. The CSV file is uploaded using the Admin Console and will be stored in the database. A cronjob must be configured (see *Administrative Guide*) so that the uploaded files will processed. The success or error logs can be downloaded using the Admin Console. For backward compatibility you can still use the upload folder in the file system by defining the following optional CSV folders. The file will be imported into the database and then processed from the database entry. .. _provider / distributor settings/csvimport settings/csv_import_active: CSV_IMPORT_ACTIVE ~~~~~~~~~~~~~~~~~ Controls whether CSV import will be used. .. _provider / distributor settings/csvimport settings/csv_upload_dir: CSV_UPLOAD_DIR (optional) ~~~~~~~~~~~~~~~~~~~~~~~~~ CSV hot folder. If not defined, the CSV processing will just use the database. If defined, the contained files will be imported to the database and processed from the database record. Processed CSV files can be downloaded again from the admin console, if necessary. .. _provider / distributor settings/csvimport settings/csv_error_dir: CSV_ERROR_DIR (optional) ~~~~~~~~~~~~~~~~~~~~~~~~ Error logs for not imported users will be written to this folder. If not defined, you will find the value in the database using the admin console. .. _provider / distributor settings/csvimport settings/csv_success_dir: CSV_SUCCESS_DIR (optional) ~~~~~~~~~~~~~~~~~~~~~~~~~~ Success logs for imported users will be written to this folder. If not defined, you will find the value in the database using the admin console. .. _provider / distributor settings/csvimport settings/disable_missing_csv_users: DISABLE_MISSING_CSV_USERS ~~~~~~~~~~~~~~~~~~~~~~~~~ This value will control, whether users not present in the CSV file are disabled. The additional "department" column must be filled in the CSV file. Username and department must match the existing record in the database. .. _provider / distributor settings/authservice settings: AUTHSERVICE Settings ( XML block) ---------------------------------------------- These settings are used to configure access to an external Authentication Service (see :ref:`external authentication`). When referenced by the TeamDrive Client, all URLs (except ``VERIFY_AUTH_TOKEN_URL``) below include the parameters specified for all ``REDIRECT URL``\ s (see below). .. _provider / distributor settings/authservice settings/use_auth_service: USE_AUTH_SERVICE ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Set to ``$true`` if you want to use an external Authentication Service. .. _provider / distributor settings/authservice settings/auth_login_url: AUTH_LOGIN_URL ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This URL points to the Login page of the external Authentication Service. .. _provider / distributor settings/authservice settings/auth_register_url: AUTH_REGISTER_URL ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This URL points to the Registration page of the external Authentication Service. .. _provider / distributor settings/authservice settings/auth_lost_pwd_url: AUTH_LOST_PWD_URL ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This URL points to the Lost Password page of the external Authentication Service. .. _provider / distributor settings/authservice settings/auth_change_email_url: AUTH_CHANGE_EMAIL_URL ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This URL points to the Change Email page of the external Authentication Service. .. _provider / distributor settings/authservice settings/verify_auth_token_url: VERIFY_AUTH_TOKEN_URL ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This URL is used by the Registration Server to verify an Authentication Token, sent by the client after login using the Authentication Service. .. _provider / distributor settings/authservice settings/auth_verify_pwd_freq: AUTH_VERIFY_PWD_FREQ ( tag) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Maximum length of time (in minutes) user may remain logged in before they are required to enter their password again. If this value is 0, users are never promoted to re-enter their password. .. _provider / distributor settings/redirect settings: REDIRECT Settings ----------------- The ``REDIRECT`` settings determine the landing pages reached when links are clicked or activated in the TeamDrive Client. These settings cannot be configured in the XML configuration file when creating a Provider. The banner URLs are not covered by these settings. The HTML document that defines any given banner specifies where its links lead. The first stop reached when a link is clicked or activated in the client is the determined by the ``RedirectorURL`` setting. The Registration Server implementation of this page re-directs the user as specified by the settings below. A number of URL parameters are passed to the landing pages. These parameters can be used within the target landing pages to generate the content. * ``page`` and ``distr``\ : These parameters are used to determine the target page of the re-direct. Normally you will not need to evaluate these parameters because the target page is specified by the settings below. * ``lang``\ : The international language code of the current language of the client. * ``platf``\ : Specifies the platform of the client: mac, win, linux, ios, android or unknown. * ``size``\ : The size of the display area for the requested page: width x height in pixels (ex: ``400x500``\ ). * ``user``\ : Base 64 encoded username. This parameter is only supplied for the ``REDIRECT_PURCHASE`` URL. * ``product``\ : Specifies the product ordered. Only provided for the ``REDIRECT_ORDER`` URL. Currently the only possible value is TDPS. * ``cookie``\ : This is the cookie stored by the client which was passed to the client after a successful external user authentication (see :ref:`external authentication/login procedure`). .. _provider / distributor settings/redirect settings/redirect_download: REDIRECT_DOWNLOAD ~~~~~~~~~~~~~~~~~ This URL redirects to a page where the Provider's version of TeamDrive can be downloaded. .. _provider / distributor settings/redirect settings/redirect_forum: REDIRECT_FORUM ~~~~~~~~~~~~~~ This URL redirects to the Provider's forum page. .. _provider / distributor settings/redirect settings/redirect_tutorials: REDIRECT_TUTORIALS ~~~~~~~~~~~~~~~~~~ This URL redirects to the Provider's tutorials page. .. _provider / distributor settings/redirect settings/redirect_faq: REDIRECT_FAQ ~~~~~~~~~~~~ This URL redirects to the Provider's FAQ (frequently asked questions) page. .. _provider / distributor settings/redirect settings/redirect_purchase: REDIRECT_PURCHASE ~~~~~~~~~~~~~~~~~ This URL redirects to the Provider's page for ordering licenses (parameter '``user``' is the base 64 encoded user name). .. _provider / distributor settings/redirect settings/redirect_userinviteuser: REDIRECT_USERINVITEUSER ~~~~~~~~~~~~~~~~~~~~~~~ This URL redirects to the Provider's ``user-invite-user`` page. .. _provider / distributor settings/redirect settings/redirect_order: REDIRECT_ORDER ~~~~~~~~~~~~~~ This URL redirects to the Provider's product order page (parameter '``product``' can currently only be 'tdps'). .. _provider / distributor settings/redirect settings/redirect_uninstall: REDIRECT_UNINSTALL ~~~~~~~~~~~~~~~~~~ Will be opened after an uninstall operation to present a survey to the user asking why they uninstalled the software.