Uwierzytelnianie wieloskładnikowe (2FA/MFA) dla Roundcube

Ostatnia aktualizacja dnia August 12 2026

Uwierzytelnianie wieloskładnikowe (MFA) dla Roundcube to wielowarstwowe podejście do uwierzytelniania, które wymaga od użytkowników użycia dodatkowej metody uwierzytelniania przed uzyskaniem dostępu do konta Roundcube. Dzięki uwierzytelnianiu MFA dla Roundcube, nawet jeśli hakerzy zhakują Twoje hasło, nadal nie będą mogli uzyskać dostępu do Twojego konta.

Omówienie

Ten dokument wyjaśnia, jak włączyć uwierzytelnianie wieloskładnikowe Rublon MFA dla użytkowników logujących się do usługi Roundcube. Rozwiązanie Rublon MFA integruje się z usługą Roundcube za pomocą dedykowanego konektora. Ten dokument opisuje wszystkie wymagane kroki instalacji i konfiguracji.

Konektor Rublon MFA dla Roundcube włącza uwierzytelnianie wieloskładnikowe (MFA) / uwierzytelnianie dwuskładnikowe (2FA) podczas logowania użytkowników Roundcube. Po wprowadzeniu przez użytkownika prawidłowego loginu i hasła, konektor prosi użytkownika o wykonanie dodatkowej metody uwierzytelniania. Jeśli użytkownik nie może ukończyć tego dodatkowego kroku bezpieczeństwa, konektor odmawia dostępu do usługi Roundcube, uniemożliwiając potencjalnemu hakerowi uzyskanie dostępu do konta.

Wspierane metody uwierzytelniania

Metoda uwierzytelniania	Czy wspierana	Komentarz
Powiadomienie mobilne	✔	N/A
FIDO	✔	N/A
Kod dostępu	✔	N/A
Kod SMS	✔	N/A
Link SMS	✔	N/A
Połączenie telefoniczne	✔	N/A
Kod QR	✔	N/A
Link e-mail	–	N/A
YubiKey OTP	✔	N/A
RFID	–	N/A

Zanim zaczniesz

Przed skonfigurowaniem uwierzytelniania Rublon MFA dla Roundcube:

• Utwórz aplikację w konsoli Rublon Admin Console.
• Zainstaluj aplikację mobilną Rublon Authenticator.

Utwórz aplikację w konsoli Rublon Admin Console

1. Zarejestruj się w konsoli Rublon Admin Console. Oto jak to zrobić.

2. W konsoli Rublon Admin Console przejdź do zakładki Applications (Aplikacje) i kliknij Add Application (Dodaj aplikację).

3. Wprowadź nazwę swojej aplikacji, a następnie ustaw jej typ na Custom integration using PHP SDK.

4. Kliknij przycisk Save (Zapisz), aby dodać nową aplikację w konsoli Rublon Admin Console.

5. Skopiuj i zapisz wartości System Token (Token systemowy) i Secret Key (Tajny klucz). Te wartości będą Ci potrzebne później.

Zainstaluj aplikację Rublon Authenticator

Aby zwiększyć bezpieczeństwo uwierzytelniania wieloskładnikowego (MFA), użytkownicy końcowi powinni zainstalować aplikację mobilną Rublon Authenticator.

Pobierz aplikację Rublon Authenticator dla systemu:

• Android
• iOS
• HarmonyOS

Instalacja uwierzytelniania wieloskładnikowego (MFA) dla Roundcube

Opcja 1: istniejąca instalacja Roundcube

1. Przejdź do katalogu, z którego usługa Roundcube ładuje wtyczki, i wykonaj:

sudo git clone --depth 1 https://github.com/Rublon/rublon-roundcube.git rublon

2. Przejdź do katalogu głównego instalacji Roundcube i wykonaj:

composer require 'rublon/rublon-sdk-php:^4.1' --no-interaction

3. Utwórz kopię zapasową aktywnego pliku config.inc.php używanego przez usługę Roundcube.

4. Otwórz aktywny plik config.inc.php i dodaj na końcu następujące wiersze:

$config['session_storage'] = 'php';
$config['plugins'][] = 'rublon';

Obejście błędów zależności narzędzia Composer

Jeśli narzędzie Composer zgłasza brak pakietów, takich jak:

pear-pear.php.net/auth_sasl
pear-pear.php.net/mail_mime
pear-pear.php.net/net_smtp
pear-pear.php.net/net_sieve

Zainstaluj bibliotekę Rublon PHP SDK w oddzielnym katalogu:

sudo mkdir -p /opt/rublon-sdk
sudo chown "$USER":"$USER" /opt/rublon-sdk
cd /opt/rublon-sdk
composer require 'rublon/rublon-sdk-php:^4.1' --no-interaction
sudo chown -R root:root /opt/rublon-sdk

Następnie dodaj następujące wiersze do aktywnego pliku config.inc.php:

require_once '/opt/rublon-sdk/vendor/autoload.php';

$config['session_storage'] = 'php';
$config['plugins'][] = 'rublon'; 

Opcja 2: instalacja w kontenerze Docker

Użyj tej metody, jeśli usługa Roundcube działa w kontenerze Docker. Przed rozpoczęciem upewnij się, że usługa Roundcube działa poprawnie i użytkownicy mogą się zalogować bez uwierzytelniania MFA.

W poniższych przykładach przyjęto następujące założenia:

• /opt/roundcube-lab to katalog środowiska Roundcube.
• /opt/rublon-roundcube to katalog wtyczki Rublon MFA dla Roundcube.

1. Pobierz wtyczkę Rublon MFA dla Roundcube:

cd /opt
sudo git clone https://github.com/Rublon/rublon-roundcube.git

2. Przejdź do katalogu środowiska Roundcube i utwórz własny plik Dockerfile:

cd /opt/roundcube-lab
sudo nano Dockerfile.roundcube

3. Dodaj:

FROM roundcube/roundcubemail:1.7.2-apache
RUN cd /usr/src/roundcubemail \
    && composer require rublon/rublon-sdk-php:^4.1 --no-interaction --update-no-dev

4. Utwórz katalog na dodatkową konfigurację Roundcube:

sudo mkdir -p /opt/roundcube-lab/config

5. Utwórz następujący plik:

sudo nano /opt/roundcube-lab/config/rublon.inc.php

6. Dodaj:

<?php
$config['session_storage'] = 'php';

7. Otwórz plik Compose:

sudo nano /opt/roundcube-lab/compose.yml

8. W usłudze roundcube skonfiguruj własny obraz:

build:
  context: .
  dockerfile: Dockerfile.roundcube
image: roundcube-rublon:1.7.2

9. Dodaj rublon do zmiennej ROUNDCUBEMAIL_PLUGINS.

Na przykład:

ROUNDCUBEMAIL_PLUGINS: archive,zipdownload,rublon

Jeśli nie używasz innych wtyczek:

ROUNDCUBEMAIL_PLUGINS: rublon

10. Dodaj następujące woluminy:

- /opt/rublon-roundcube:/var/www/html/plugins/rublon:ro
- ./config/rublon.inc.php:/var/roundcube/config/rublon.inc.php:ro

11. Sprawdź poprawność konfiguracji Compose:

cd /opt/roundcube-lab
sudo docker compose config

Konfiguracja MFA dla Roundcube

Po ukończeniu jednej z powyższych metod instalacji skonfiguruj wtyczkę Rublon MFA dla Roundcube.

1. Przejdź do katalogu wtyczki Rublon MFA dla Roundcube.

• W przypadku istniejącej instalacji Roundcube jest to katalog rublon w katalogu wtyczek Roundcube.
• W przypadku instalacji w kontenerze Docker wykonaj:

cd /opt/rublon-roundcube

2. Utwórz plik konfiguracyjny wtyczki:

sudo cp config.inc.php.dist config.inc.php

3. Otwórz plik config.inc.php, aby go edytować.

4. Wprowadź dane uwierzytelniające aplikacji utworzonej w konsoli Rublon Admin Console:

<?php

$config['client'] = 'SYSTEM_TOKEN';
$config['secret'] = 'SECRET_KEY';
$config['rublonApi'] = 'https://core.rublon.net';

Zastąp:

• SYSTEM_TOKEN wartością System Token (Token systemowy) aplikacji w konsoli Rublon Admin Console.
• SECRET_KEY wartością Secret Key (Tajny klucz) aplikacji w konsoli Rublon Admin Console.

5. W przypadku istniejącej instalacji Roundcube dodaj również:

$config['rcubeUrl'] = 'https://mail.example.com/roundcube';

Wprowadź dokładny adres URL używany do otwierania Roundcube, razem ze ścieżką aplikacji i bez ukośnika na końcu.

6. Zastosuj wprowadzone zmiany:

• W przypadku istniejącej instalacji Roundcube zrestartuj usługę WWW/PHP obsługującą usługę Roundcube. W przypadku serwera Apache:

sudo systemctl restart apache2

• W przypadku instalacji w kontenerze Docker zbuduj obraz i uruchom kontenery:

cd /opt/roundcube-lab
sudo docker compose up -d --build

Testowanie uwierzytelniania wieloskładnikowego (MFA) dla Roundcube

1. Wprowadź swój login i hasło do usługi Roundcube i kliknij Login.

2. Pojawi się okno z możliwością wyboru różnych opcji uwierzytelniania Rublon MFA. Wybierzmy metodę uwierzytelniania Powiadomienie mobilne.

3. Otrzymasz żądanie uwierzytelniania na swój telefon za pomocą metody Powiadomienie mobilne. Wybierz ZATWIERDŹ.

4. Nastąpi pomyślne logowanie do usługi Roundcube.

Rozwiązywanie problemów

W przypadku wdrożenia w kontenerze Docker, jeśli nie pojawia się MFA lub usługa Roundcube zwraca błąd, sprawdź dzienniki kontenera:

sudo docker logs roundcube --tail 100

Możesz również sprawdzić, czy wtyczka Rublon MFA dla Roundcube jest dostępna w kontenerze:

sudo docker exec -it roundcube ls -la /var/www/html/plugins/rublon

Sprawdź, czy biblioteka Rublon PHP SDK jest zainstalowana:

sudo docker exec -it roundcube composer show rublon/rublon-sdk-php

Jeśli napotkasz jakiekolwiek problemy z integracją Rublon MFA, skontaktuj się z pomocą techniczną Rublon Support.