.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ==================================== EXT: Readable name of your extension ==================================== :Created: 2010-02-18T17:33:18 :Changed: 2012-08-23T14:42:26 :Classification: extensionkey :Description: The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ---- :Keywords: keywords comma-separated :Author: Author Name :Email: your@email.com :Info 4: :Language: en |img-1| EXT: TYPO3 Security- a3\_securityEXT: TYPO3 Security .. _EXT-TYPO3-Security: EXT: TYPO3 Security =================== Extension Key: a3\_security Language: en, sl, si Keywords: security, aeris3, permissions Copyright 2012, Robert Ferencek, This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 - a GNU/GPL CMS/Framework available from www.typo3.org .. _Table-of-Contents: Table of Contents ----------------- `EXT: TYPO3 Security 1 <#__RefHeading__720_2028123520>`_ **`Introduction 3 <#__RefHeading__722_2028123520>`_** `What does it do? 3 <#__RefHeading__724_2028123520>`_ `Screenshots 3 <#__RefHeading__726_2028123520>`_ **`Users manual 4 <#__RefHeading__728_2028123520>`_** **`Administration 5 <#__RefHeading__730_2028123520>`_** **`Configuration 6 <#__RefHeading__732_2028123520>`_** `Reference 6 <#__RefHeading__734_2028123520>`_ **`Tutorial 7 <#__RefHeading__736_2028123520>`_** **`Known problems 8 <#__RefHeading__738_2028123520>`_** **`To-Do list 9 <#__RefHeading__740_2028123520>`_** **`ChangeLog 10 <#__RefHeading__742_2028123520>`_** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ This extension allows you to enable apache write permissions on on typo3conf/ext, typo3conf/localconf.php, typo3conf/extTables.php and other user defined files or folders with help of a bash script. .. _Screenshots: Screenshots ^^^^^^^^^^^ BE module |img-2| Key protection configuration |img-3| .. _Users-manual: Users manual ------------ - This extension allows you to enable apache write permissions on typo3conf/ext, typo3conf/localconf.php, typo3conf/extTables.php and other user defined files or folders with help of a bash script. - Only TYPO3 admins are allowed to run the BE module. .. _Administration: Administration -------------- - After installing the extension make sure to copy the typo3\_permission\_handler.sh.example to your scripts folder and rename the file to typo3\_permisson\_handler.sh. - Change the bash script configuration to your server specifications. - Add the bash script to servers cron job. .. _Configuration: Configuration ------------- - After installing the extension make sure to copy the a3\_security/res/typo3\_permission\_handler.sh.example file to your scripts folder and rename the file to typo3\_permisson\_handler.sh. - Change the bash script configuration to your server specifications. - Add the bash script to servers cron job. .. _Bash-script-reference: Bash script reference ^^^^^^^^^^^^^^^^^^^^^ .. ### BEGIN~OF~TABLE ### .. _bin-bash: #!/bin/bash """"""""""" .. container:: table-row Property #!/bin/bash Description Shell type Default #!/bin/bash .. _REPORT-MAIL: REPORT\_MAIL """""""""""" .. container:: table-row Property REPORT\_MAIL Description Email where to send the enable/disable reports to Default .. _MAIL-FROM: MAIL\_FROM """""""""" .. container:: table-row Property MAIL\_FROM Description From email Default .. _MAIL-TO-REPLY: MAIL\_TO\_REPLY """"""""""""""" .. container:: table-row Property MAIL\_TO\_REPLY Description Email to reply to Default .. _SEND-MAIL: SEND\_MAIL """""""""" .. container:: table-row Property SEND\_MAIL Description Send email after enable/disable apache write permissions Default 0 .. _CAT-CMD: CAT\_CMD """""""" .. container:: table-row Property CAT\_CMD Description Shell command “cat” Default /bin/cat .. _RM-CMD: RM\_CMD """"""" .. container:: table-row Property RM\_CMD Description Shell command “rm” Default /bin/rm .. _FIND-CMD: FIND\_CMD """"""""" .. container:: table-row Property FIND\_CMD Description Shell command “find” Default /bin/find .. _CLEAR-CMD: CLEAR\_CMD """""""""" .. container:: table-row Property CLEAR\_CMD Description Shell command “clear” Default /usr/bin/clear .. _LS-CMD: LS\_CMD """"""" .. container:: table-row Property LS\_CMD Description Shell command “ls” Default /bin/ls .. _SENDMAIL-CMD: SENDMAIL\_CMD """"""""""""" .. container:: table-row Property SENDMAIL\_CMD Description Shell command “sendmail” Default /usr/sbin/sendmail .. _CHOWN-CMD: CHOWN\_CMD """""""""" .. container:: table-row Property CHOWN\_CMD Description Shell command “shown” Default /bin/chown .. _CHMOD-CMD: CHMOD\_CMD """""""""" .. container:: table-row Property CHMOD\_CMD Description Shell command “chmod” Default /bin/chmod .. _ROOT-DIR: ROOT\_DIR """"""""" .. container:: table-row Property ROOT\_DIR Description Path to directory where the web pages are stored Default /var/www/vhosts .. _DISABLE-AFTER: DISABLE\_AFTER """""""""""""" .. container:: table-row Property DISABLE\_AFTER Description Disable the apache write permissions in X minutes Default 30 .. _PERMISSIONS-FILE: PERMISSIONS\_FILE """"""""""""""""" .. container:: table-row Property PERMISSIONS\_FILE Description Permissions file created by a3\_security extension (do not change!) Default ENABLE\_PERMISSIONS .. _MAIN-DIR: MAIN\_DIR """"""""" .. container:: table-row Property MAIN\_DIR Description Main TYPO3 directory Default typo3conf .. _TEMP-DIR: TEMP\_DIR """"""""" .. container:: table-row Property TEMP\_DIR Description TYPO3 temp directory Default typo3temp .. _EXT-DIR: EXT\_DIR """""""" .. container:: table-row Property EXT\_DIR Description TYPO3 a3\_security extension temp directory (do not change!) Default a3\_security .. _ENABLE-CMD: ENABLE\_CMD """"""""""" .. container:: table-row Property ENABLE\_CMD Description Shell command to enable apache write permissions Default “See typo3\_permisson\_handler.sh” .. _DISABLE-CMD: DISABLE\_CMD """""""""""" .. container:: table-row Property DISABLE\_CMD Description Shell command to disable apache write permissions Default “See typo3\_permisson\_handler.sh” .. _ENABLE-MAIL-SUBJECT: ENABLE\_MAIL\_SUBJECT """"""""""""""""""""" .. container:: table-row Property ENABLE\_MAIL\_SUBJECT Description Email subject when permissions are enabled Default TYPO3 write permissions - Priority 4 .. _DISABLE-MAIL-SUBJECT: DISABLE\_MAIL\_SUBJECT """""""""""""""""""""" .. container:: table-row Property DISABLE\_MAIL\_SUBJECT Description Email subject when permissions are disabled Default TYPO3 write permissions - Priority 5 .. _ENABLE-MAIL-MESSAGE: ENABLE\_MAIL\_MESSAGE """"""""""""""""""""" .. container:: table-row Property ENABLE\_MAIL\_MESSAGE Description Email message when permissions are enabled Default Write permissions enabled on .. _DISABLE-MAIL-MESSAGE: DISABLE\_MAIL\_MESSAGE """""""""""""""""""""" .. container:: table-row Property DISABLE\_MAIL\_MESSAGE Description Email message when permissions are disabled Default Write permissions disabled on .. ###### END~OF~TABLE ###### .. _Tutorial: Tutorial -------- - Install the a3\_security extension - Copy the a3\_security/res/typo3\_permission\_handler.sh.example file to your scripts folder and rename the file to permisson\_handler.sh. Make the file executable. - Change the bash script configuration to your server specifications. See b `ash script reference <#1.4.1.Bash%20script%20reference|outline>`_ . - Run the typo3\_permisson\_handler.sh manualy to see if the script runs without errors - Add the bash script to servers cron job to run every minute: \* \* \* \* \* /path-to-bash/bash /path-to-your-scripts- folder/typo3\_permission\_handler.sh > /dev/null 2>&1 Modify the crontab depending on your shell type. The script should run as root. .. _Known-problems: Known problems -------------- None for now. The extension was tested with LAMP on CentOS and FreeBSD. For any issues feel free to contact me on .. _To-Do-list: To-Do list ---------- None .. _ChangeLog: ChangeLog --------- .. ### BEGIN~OF~TABLE ### .. _1-0-0: 1.0.0 ^^^^^ .. container:: table-row Version 1.0.0 Changes Initial release. .. _1-1-0: 1.1.0 ^^^^^ .. container:: table-row Version 1.1.0 Changes New feature; Disabling Extension Manager if no write permissions. .. _1-1-1: 1.1.1 ^^^^^ .. container:: table-row Version 1.1.1 Changes Small bug fixes. .. _1-2-0: 1.2.0 ^^^^^ .. container:: table-row Version 1.2.0 Changes New feature; If enabled, admins have to enter the protection key to enable permissions. .. ###### END~OF~TABLE ###### 10 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.png .. :align: left .. :border: 0 .. :height: 107 .. :id: grafika1 .. :name: grafika1 .. :width: 339 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 180 .. :id: grafika2 .. :name: grafika2 .. :width: 455