README.md

Alfresco TOTP authenticator

Time-based One-Time Password two factor authentication for Alfresco

Distributed for free without any warranty. Use at your own risk.

Tested with Alfresco Community Edition 23.1 (for older Alfresco see previous releases).

Instructions

Build

Get the sources:

$ git clone https://github.com/saidone75/alfresco-totp-authenticator.git

build the JARs:

$ cd alfresco-totp-authenticator
$ mvn package
[INFO] Scanning for projects...
[INFO]
[INFO] ----------< org.saidone:alfresco-totp-authenticator-platform >----------
[INFO] Building alfresco-totp-authenticator-platform Platform/Repository JAR Module 3.0
[INFO]   from pom.xml
[INFO] --------------------------------[ jar ]---------------------------------

[...]

[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  3.420 s
[INFO] Finished at: 2023-12-26T08:44:13+01:00
[INFO] ------------------------------------------------------------------------

Installation

• Stop Alfresco
• Install the JARs by copying them to the proper module location (depending on your Content Services installation), e.g.:

$ cp alfresco-totp-authenticator-platform-3.0.jar /opt/alfresco/modules/platform
$ cp alfresco-totp-authenticator-share-3.0.jar /opt/alfresco/modules/share

• Start Alfresco

Configuration

• Log into Alfresco
• Go to your profile page and click on TOTP settings tab
• Click on Activate TOTP button to generate a secret and activate TOTP authentication
• Import the secret on your favourite OTP application (e.g. by scanning the QR Code), personally I use andOTP on Android but there's plenty of choices

Take a look at this short explanation video here.

Pre-built JARs

Stable releases include the related build. Java CI successful workflows on Actions will issue development artifacts.

License

Copyright (c) 2021-2023 Saidone

Distributed under the GNU General Public License v3.0