TYPO3 Install Tool: zapomniane hasło albo brak dostępu – jak wrócić

W skrócie: hasło TYPO3 Install Tool jest zapisane w pliku konfiguracyjnym jako hash, czyli nie otwartym tekstem. Żeby je zresetować, wystarczy wpisać w logowaniu Install Tool nowe, wybrane hasło. TYPO3 je odrzuci, ale pokaże pasujący hash. Ten hash trzeba wpisać przez FTP do konfiguracji. Warunkiem jest plik ENABLE_INSTALL_TOOL. Przez Install Tool można potem też utworzyć nowego administratora panelu.

Install Tool to obszar serwisowy TYPO3: czyszczenie cache, sprawdzanie bazy, aktualizacje, zmiana ustawień. Hasło ustala się przy instalacji i potem często latami nie jest potrzebne. Gdy dawna agencja jest nieosiągalna, nikt go już nie zna.

Nazwy menu dotyczą TYPO3 do wersji 13. W TYPO3 14 część modułów panelu ma nowe nazwy, np. „Admin Tools” to teraz „Administration” albo „System”.

Czy jest prostsza droga?

Tak, jeśli mają Państwo dostęp do panelu z uprawnieniami opiekuna systemu (System Maintainer). Wtedy narzędzia administracyjne są dostępne bezpośrednio w panelu w „Admin Tools”, bez hasła Install Tool. Droga przez plik konfiguracyjny jest potrzebna tylko wtedy, gdy to nie działa.

Krok 1: utworzyć ENABLE_INSTALL_TOOL

Ze względów bezpieczeństwa Install Tool działa tylko wtedy, gdy istnieje pusty plik o nazwie ENABLE_INSTALL_TOOL. Gdzie musi leżeć, zależy od wersji i sposobu instalacji:

• instalacja klasyczna: typo3conf/ENABLE_INSTALL_TOOL
• instalacja przez Composer do TYPO3 11: public/typo3conf/ENABLE_INSTALL_TOOL
• instalacja przez Composer od TYPO3 12: var/transient/ENABLE_INSTALL_TOOL albo config/ENABLE_INSTALL_TOOL

Plik tworzy się przez FTP. TYPO3 usuwa go automatycznie po godzinie, żeby Install Tool nie był stale otwarty. Następnie trzeba otworzyć https://twoja-domena.de/typo3/install.php.

Krok 2: wygenerować hash nowego hasła

W polu logowania proszę wpisać hasło, którego chcą Państwo używać w przyszłości, długie i bezpieczne. TYPO3 zgłosi, że się nie zgadza, ale jednocześnie pokaże obliczony hash tego hasła. Zaczyna się zwykle od $argon2i$ albo $argon2id$. Trzeba go skopiować w całości.

Krok 3: wpisać hash do konfiguracji

Proszę otworzyć przez FTP główny plik konfiguracyjny:

• TYPO3 12 i nowsze: config/system/settings.php (Composer) albo typo3conf/system/settings.php (klasycznie)
• TYPO3 11 i starsze: typo3conf/LocalConfiguration.php

W sekcji 'BE' trzeba znaleźć wpis 'installToolPassword' i zastąpić wartość skopiowanym hashem:

'BE' => [
    // …
    'installToolPassword' => '$argon2i$v=19$m=65536,t=16,p=1$…',
],

Wcześniej proszę zrobić kopię pliku. Brakujący przecinek albo apostrof wyłączy całą stronę. Zapisać, wgrać i zalogować się ponownie do Install Tool, tym razem się uda.

Hasło do panelu też zapomniane?

W Install Tool w sekcji „Maintenance” jest funkcja „Create Administrative User”. Tworzy ona nowego administratora, którym można zalogować się do panelu. Tam w „Backend Users” można ustawić nowe hasła pozostałych kont. Przy okazji warto sprawdzić, jacy administratorzy istnieją. Nieznane konta to sygnał ostrzegawczy.

Potem posprzątać

• Usunąć ENABLE_INSTALL_TOOL, jeśli jeszcze istnieje.
• Zapisać nowe hasło w menedżerze haseł, a nie w pliku tekstowym na serwerze.
• Wyłączyć stare konta administratorów byłych wykonawców.

Profesjonalna pomoc

Jeśli dawnej agencji już nie ma i nikt nie ma dostępów, przejmę stronę na TYPO3: zabezpieczę dostępy, sprawdzę stan, zaplanuję aktualizacje. Więcej w usługach pomoc TYPO3 i opieka TYPO3.