Installation Guide for Alfresco Authentication plugin

Alfresco Authentication plugin

  • Download media from following link.

jirafresco-auth-for-repo.amp

  • In this page, the media is set at '~/jirafresco-auth-for-repo.amp'. Please use following commands according to your directory.

Alfresco5.0

Installation

  1. Stop Alfresco service.

    # service alfresco stop
  2. Confirm plugin after preview installing.

    # cd /opt/alfresco
    # java -jar bin/alfresco-mmt.jar install ~/jirafresco-auth-for-repo.amp tomcat/webapps/alfresco -preview
    Installing AMP '~/jirafresco-auth-for-repo.amp' into WAR 'tomcat/webapps/alfresco'
    Adding files relating to version '1.0.1510211731' of module 'jirafresco-auth-for-repo'
      <<skip >>
    - Directory '/WEB-INF/classes/alfresco/module/jirafresco-auth-for-repo' added to war
  3. Install plugin.

     # java -jar bin/alfresco-mmt.jar install ~/jirafresco-auth-for-repo.amp tomcat/webapps/alfresco
  4. Confirm plugin completely. 

    # java -jar bin/alfresco-mmt.jar list tomcat/webapps/alfresco
    Module 'org_alfresco_module_wcmquickstart' installed in 'tomcat/webapps/alfresco'
    - Title: Web Quick Start
    - Version: 1.0
    - Install Date: Tue Jun 16 01:50:30 UTC 2015
    - Description: Web Quick Start
    Module 'jirafresco-auth-for-repo' installed in 'tomcat/webapps/alfresco'
    - Title: jirafresco-auth-for-repo Repository AMP project
    - Version: 1.0.1510231456
    - Install Date: Fri Oct 23 09:20:43 UTC 2015
    - Description: Manages the lifecycle of the jirafresco-auth-for-repo Repository AMP (Alfresco Module Package)
    Module 'org.alfresco.integrations.google.docs' installed in 'tomcat/webapps/alfresco'
    - Title: Alfresco / Google Docs Integration
    - Version: 3.0.0
    - Install Date: Tue Jun 16 01:50:25 UTC 2015
    - Description: The Repository side artifacts of the Alfresco / Google Docs Integration.
  5. Delete alfresco,share backup files from tomcat deployment directry.

    # rm -Rf tomcat/webapps/alfresco.war-*.bak
    # rm -Rf tomcat/webapps/share.war-*bak
  6. Edit config file (web.xml).

    # vim ./tomcat/webapps/alfresco/WEB-INF/web.xml
    <servlet>
    <servlet-name>publicapiServlet</servlet-name>
    <servlet-class>org.alfresco.rest.api.PublicApiWebScriptServlet</servlet-class>
    <init-param>
    <param-name>authenticator</param-name>
    <param-value>publicapi.authenticator</param-value>
    </init-param>
    </servlet>
    ↓
    <servlet>
    <servlet-name>publicapiServlet</servlet-name>
    <servlet-class>org.alfresco.rest.api.PublicApiWebScriptServlet</servlet-class>
    <init-param>
    <param-name>authenticator</param-name>
    <param-value>publicapi.authenticator.wsse</param-value>
    </init-param>
    </servlet>
    
    
    <servlet>
    <servlet-name>apiServlet</servlet-name>
    <servlet-class>org.springframework.extensions.webscripts.servlet.WebScriptServlet</servlet-class>
    <init-param>
    <param-name>authenticator</param-name>
    <param-value>webscripts.authenticator.remoteuser</param-value>
    </init-param>
    </servlet>
    ↓
    <servlet>
    <servlet-name>apiServlet</servlet-name>
    <servlet-class>org.springframework.extensions.webscripts.servlet.WebScriptServlet</servlet-class>
    <init-param>
    <param-name>authenticator</param-name>
    <param-value>webscripts.authenticator.basic.wsse</param-value>
    </init-param>
    </servlet>
  7. Start Alfresco service.

    # service alfresco start

Uninstalling

  1. Stop Alfresco service.

    # service alfresco stop
  2. Edit and revert config file descriptions (web.xml).

    # vim ./tomcat/webapps/alfresco/WEB-INF/web.xml
    <servlet>
    <servlet-name>publicapiServlet</servlet-name>
    <servlet-class>org.alfresco.rest.api.PublicApiWebScriptServlet</servlet-class>
    <init-param>
    <param-name>authenticator</param-name>
    <param-value>publicapi.authenticator.wsse</param-value>
    </init-param>
    </servlet>
    ↓
    <servlet>
    <servlet-name>publicapiServlet</servlet-name>
    <servlet-class>org.alfresco.rest.api.PublicApiWebScriptServlet</servlet-class>
    <init-param>
    <param-name>authenticator</param-name>
    <param-value>publicapi.authenticator</param-value>
    </init-param>
    </servlet>
    
    <servlet>
    <servlet-name>apiServlet</servlet-name>
    <servlet-class>org.springframework.extensions.webscripts.servlet.WebScriptServlet</servlet-class>
    <init-param>
    <param-name>authenticator</param-name>
    <param-value>webscripts.authenticator.basic.wsse</param-value>
    </init-param>
    </servlet>
    ↓
    <servlet>
    <servlet-name>apiServlet</servlet-name>
    <servlet-class>org.springframework.extensions.webscripts.servlet.WebScriptServlet</servlet-class>
    <init-param>
    <param-name>authenticator</param-name>
    <param-value>webscripts.authenticator.remoteuser</param-value>
    </init-param>
    </servlet>
  3. Uninstall plugin.

     # java -jar bin/alfresco-mmt.jar uninstall jirafresco-auth-for-repo tomcat/webapps/alfresco
  4. Start Alfresco service.

     # service alfresco restart