{"id":2569,"date":"2015-10-23T15:31:18","date_gmt":"2015-10-23T15:31:18","guid":{"rendered":"https:\/\/twproject.com\/support\/using-twproject\/configuration\/basic-system-configuration-2\/"},"modified":"2022-04-29T13:07:03","modified_gmt":"2022-04-29T13:07:03","slug":"basic-configuration","status":"publish","type":"page","link":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/","title":{"rendered":"Basic configuration"},"content":{"rendered":"

HTTP Server \/\u00a0File System<\/h2>\n

The first two links will lead to the same configuration page:<\/p>\n

\"\"<\/p>\n

 <\/p>\n

First three lines are use to define paths. Parameters have a detailed description. The third parameter: \u201cfile storages paths allowed\u201d, is intended to allow administrators to limit the creation of file storages starting with specified paths.<\/p>\n

The following parameters are used for configuring how user access Twproject through the network. Proxy, firewall, https, NATting may make things incredibly complex in large organizations, but Twproject gives a good support, notice https.<\/p>\n

Security policies<\/h2>\n

\"\"<\/p>\n

you can define Twproject\u2019 password, lenght, complexity and security policies.<\/p>\n

Multi-factor authentication: Time-based one time password (T-OTP)<\/h3>\n

<\/a>
\nChecking “enable otp authentication” users will be enforced to setup its T-OTP app at the first login.<\/p>\n

T-OTP authentication consists on insert a one-time password (OTP) after your login name and password. This OTP is a pseudo-random number generated by an authentication app\u00a0(e.g.: Google authenticator) installed on you mobile.
\nThis number is based on current time and a secret code that is stored on your authentication app; usually such code is inserted by scanning e QR Code using the authentication app. This number changes every minute, so your mobile phone date and time MUST be set correctly, otherwise you cannot validate the OTP.<\/p>\n

At first login, after login name and password has been inserted, you have to setup T-OTP app.<\/p>\n

Install your preferred T-OTP authentication app (e.g.: Google authenticator) and open it. Follow the app instructions to create a new login (usually just click on a + button) and the scan the\u00a0the QR Code:<\/p>\n

\"\"<\/p>\n

If you cannot scan the QR Code using the camera, for example because you are using Twproject mobile for the first login, you can insert it manually on your T-OTP app. Just click on QR and the code will be show:<\/p>\n

\"\"<\/p>\n

Click again and the code will be on your clipboard.<\/p>\n

Then save the new login on you authentication app.<\/p>\n

Click next and insert the generated code:<\/p>\n

\"\"<\/p>\n

If the code matches the T-OTP authentication will be activated.<\/p>\n

Every time you will log-in you will be requested to inserted the OTP code.<\/p>\n

Users can reset the T-OTP key from their security panel on resource editor.<\/p>\n

LDAP Authentication<\/h3>\n

<\/a>
\nFollowing \u201cLdap integration\u201d link:<\/p>\n

\"global-settings-security-ldap-1\"<\/p>\n

Twproject supports three different types of authentication:<\/p>\n

Standard authentication<\/h3>\n

In this case users and passwords are managed by Twproject; it\u2019s the default after setup.<\/p>\n

Twproject does not store the real password but only an hash, so you can only reset a password but not recovery it.<\/p>\n

The login screen is supplied by Twproject.<\/p>\n

Http authentication<\/h3>\n

This means that the authentication is provided by the container (by default, Tomcat).<\/p>\n

In this case Tomcat checks user credentials (eventually by a SSO) and then passes the authenticated user name to Twproject.<\/p>\n

Twproject will get the authenticated user from the container context, search by its login name in its people list, and if the user is found and is an enabled one, it will not ask to login again in Twproject.<\/p>\n

So users MUST be present on Twproject; in this case, Twproject passwords are not used.<\/p>\n

The login screen is supplied by the container.<\/p>\n

For example, the distributed Tomcat has commented out in the server xml file various sources of authentication, JDBC, JNDI (and hence LDAP), memory etc..<\/p>\n

Details are in the container documentation, for example<\/p>\n

http:\/\/tomcat.apache.org\/tomcat-6.0-doc\/realm-howto.html<\/a><\/p>\n

LDAP authentication \/ with fallback<\/h3>\n

\"global-settings-security-ldap-2\"<\/p>\n

In this case Twproject will check user credentials with an LDAP server.<\/p>\n

User credential are validated on a LDAP server and if validation goes well Twproject checks if the user is in its archives and enabled, otherwise it will perform a standard authentication.<\/p>\n

Login screen is supplied by Twproject.<\/p>\n

Notice that users\u2019 rights in Twproject and in LDAP are totally disconnected.<\/p>\n

You can eventually import and\/or schedule synchronization with an LDAP\/AD server<\/p>\n

By selecting \u201cenable ldap auth.\u201d you will have to configure connection parameters. Go to section LDAP\/Active Directory<\/a> for details.<\/p>\n

If you enable the fallback, failed LDAP authentication will fallback to Twproject\u2019s, giving access to Twproject in any case.<\/p>\n

Twproject e-mail<\/h2>\n

E-mail flow can go in two directions: from Twproject to the users, and from users to Twproject. Different configurations are needed for the two directions; you may activate one and not the other, at your choice. Of course having both directions is the ideal situation.<\/p>\n

For all configurations, log in with administrator rights and go to admin page and follow the e-mail configuration link:<\/p>\n

\"\"<\/p>\n

 <\/p>\n

Configuration of e-mail from Twproject to users<\/h2>\n

This is quite simple, as it amounts to configuring \u201csend e-mail\u201d from the server where Twproject is installed. This consists in setting an SMTP server, and an e-mail from which e-mails will be sent. These two parameters are all is generally needed to set up send e-mail from Twproject.<\/p>\n

\"global-settings-smtp\"<\/p>\n

In case you use \u201cauthenticated SMTP\u201d, a bit more parameters may be needed.<\/p>\n

This done, users will receive e-mail only if they have an e-mail address set on their profile:<\/p>\n

\"global-settings-email-detail-1\"<\/p>\n

Configuration of e-mail from users to Twproject<\/h2>\n

In this direction, you have to create a new e-mail account, which will be used (exclusively) by Twproject: Twproject will connect to such account, and download and parse e-mail, just like your local e-mail client does.<\/p>\n

\"global-settings-pop3\"<\/p>\n

All configurations are extensively commented on the interface, which on save will also test the accessibility of the e-mail account.<\/p>\n

In order to make this feature running you must configure it AND the e-mail downloader scheduler must is running. To check follow the \u201cverify that downloader is running: e-mail downloader\u201d link.<\/p>\n

Using Gmail as SMTP and POP3 (IMAP) server<\/h2>\n

You can use Google\u2019s Gmail service to receive and send e-mail from Twproject.<\/p>\n

You absolutely must<\/b> use a NEW Gmail account for your Twproject.<\/pre>\n
Here is an example configuration to use Gmail as server:<\/p>\n
\"global-settings-gmail\"<\/p>\n
Notice that for SMTP, smtps is used, and for pop3, pop3s is used.<\/p>\n
Imap support is currently experimental:<\/i> To connect to Gmail using the IMAP protocol instead of the POP3 protocol, simply change the host name “pop.gmail.com” to “imap.gmail.com” and change the protocol name “pop3s” to “imaps” in the above instructions.<\/p>\n
Maintenance:<\/i> Google Gmail engine will keep all messages available in the web interface, even when Java API has downloaded and \u201cdeleted\u201d them from the inbox. This is nice because it is a backup, but you may get really a lot of e-mail in there, so maybe clear it once in a while.<\/pre>\n
Debugging e-mail configuration<\/h2>\n
To test sending e-mail from Twproject to the clients – do these tests sequentially:<\/p>\n
– check that you\u2019ve set an SMTP server<\/p>\n
– check that you\u2019ve set an e-mail on your resources\/users<\/p>\n
– a simple way to test that it works is by doing a “send message” from docs&tools -> send message and checking “e-mail<\/p>\n
– check that the scheduler is running (admin -> monitoring -> scheduler monitor)<\/p>\n
– if your aim is to send appointments to you e-mail client, check that in your user options you have checked \u201csend appointments to my e-mail client\u201d<\/p>\n
For errors check the email log in WEB-INF\/log\/email.log<\/pre>\n
To test receiving e-mail from clients in Twproject – do these tests sequentially:<\/p>\n
– check that you\u2019ve set and checked a POP server<\/p>\n
– check that you\u2019ve set unique e-mails on your resources\/users<\/p>\n
– check that the scheduler is running (admin -> monitoring -> scheduler monitor)<\/p>\n
For errors check the email log in WEB-INF\/log\/email.log<\/pre>\n
Customizing e-mail<\/h2>\n
You can customize the e-mail subject prefix by going to admin -> configure SMTP -> e-mail subject prefix.
\nIn the case of assignment notifications, this get combined with the labels
\nASSIGNMENT_NOTIFICATION
\nAnd
\nASSIG_AS
\nWhich you can change in the label editor.<\/p>\n
Language, dates, currency<\/h2>\n
\"\"<\/p>\n
Here you can define the default interface language (every user can then pick a different one).<\/p>\n
You can set some holidays, currency, date and time formats.<\/p>\n
You can customize you reports by changing Twproject logo. Insert here a new file name and copy the file in the suggested folder.<\/p>\n
 <\/p>\n","protected":false},"excerpt":{"rendered":"
HTTP Server \/\u00a0File System The first two links will lead to the same configuration page:   First three lines are use to define paths. Parameters have a detailed description. The third parameter: \u201cfile storages paths allowed\u201d, is intended to allow administrators to limit the creation of file storages starting with specified paths. The following parameters […]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":2556,"menu_order":9,"comment_status":"closed","ping_status":"open","template":"","meta":{"footnotes":""},"class_list":["post-2569","page","type-page","status-publish","hentry"],"yoast_head":"\nBasic configuration | Twproject support<\/title>\n<meta name=\"description\" content=\"HTTP Server \/\u00a0File System The first two links will lead to the same configuration page:   First three lines are use to define paths. Parameters have\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Basic configuration | Twproject support\" \/>\n<meta property=\"og:description\" content=\"HTTP Server \/\u00a0File System The first two links will lead to the same configuration page:   First three lines are use to define paths. Parameters have\" \/>\n<meta property=\"og:url\" content=\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/\" \/>\n<meta property=\"og:site_name\" content=\"Twproject support\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/twproject\" \/>\n<meta property=\"article:modified_time\" content=\"2022-04-29T13:07:03+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/twproject.com\/support\/wp-content\/uploads\/base-settings.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1583\" \/>\n\t<meta property=\"og:image:height\" content=\"764\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"7 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/\",\"url\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/\",\"name\":\"Basic configuration | Twproject support\",\"isPartOf\":{\"@id\":\"https:\/\/twproject.com\/support\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/twproject.com\/support\/wp-content\/uploads\/base-settings.png\",\"datePublished\":\"2015-10-23T15:31:18+00:00\",\"dateModified\":\"2022-04-29T13:07:03+00:00\",\"description\":\"HTTP Server \/\u00a0File System The first two links will lead to the same configuration page:   First three lines are use to define paths. Parameters have\",\"breadcrumb\":{\"@id\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/#primaryimage\",\"url\":\"https:\/\/twproject.com\/support\/wp-content\/uploads\/base-settings.png\",\"contentUrl\":\"https:\/\/twproject.com\/support\/wp-content\/uploads\/base-settings.png\",\"width\":1583,\"height\":764},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/twproject.com\/support\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Advanced usage\",\"item\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Configuration\",\"item\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Basic configuration\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/twproject.com\/support\/#website\",\"url\":\"https:\/\/twproject.com\/support\/\",\"name\":\"Twproject support\",\"description\":\"Twproject documentation online\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/twproject.com\/support\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Basic configuration | Twproject support","description":"HTTP Server \/\u00a0File System The first two links will lead to the same configuration page:   First three lines are use to define paths. Parameters have","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/","og_locale":"en_US","og_type":"article","og_title":"Basic configuration | Twproject support","og_description":"HTTP Server \/\u00a0File System The first two links will lead to the same configuration page:   First three lines are use to define paths. Parameters have","og_url":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/","og_site_name":"Twproject support","article_publisher":"https:\/\/www.facebook.com\/twproject","article_modified_time":"2022-04-29T13:07:03+00:00","og_image":[{"width":1583,"height":764,"url":"https:\/\/twproject.com\/support\/wp-content\/uploads\/base-settings.png","type":"image\/png"}],"twitter_misc":{"Est. reading time":"7 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/","url":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/","name":"Basic configuration | Twproject support","isPartOf":{"@id":"https:\/\/twproject.com\/support\/#website"},"primaryImageOfPage":{"@id":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/#primaryimage"},"image":{"@id":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/#primaryimage"},"thumbnailUrl":"https:\/\/twproject.com\/support\/wp-content\/uploads\/base-settings.png","datePublished":"2015-10-23T15:31:18+00:00","dateModified":"2022-04-29T13:07:03+00:00","description":"HTTP Server \/\u00a0File System The first two links will lead to the same configuration page:   First three lines are use to define paths. Parameters have","breadcrumb":{"@id":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/#primaryimage","url":"https:\/\/twproject.com\/support\/wp-content\/uploads\/base-settings.png","contentUrl":"https:\/\/twproject.com\/support\/wp-content\/uploads\/base-settings.png","width":1583,"height":764},{"@type":"BreadcrumbList","@id":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/basic-configuration\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/twproject.com\/support\/"},{"@type":"ListItem","position":2,"name":"Advanced usage","item":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/"},{"@type":"ListItem","position":3,"name":"Configuration","item":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/configuration\/"},{"@type":"ListItem","position":4,"name":"Basic configuration"}]},{"@type":"WebSite","@id":"https:\/\/twproject.com\/support\/#website","url":"https:\/\/twproject.com\/support\/","name":"Twproject support","description":"Twproject documentation online","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/twproject.com\/support\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/pages\/2569","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/comments?post=2569"}],"version-history":[{"count":0,"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/pages\/2569\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/pages\/2556"}],"wp:attachment":[{"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/media?parent=2569"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}