UWAGA

Opisywany w tym artykule sposób konfiguracji danej funkcjonalności wymaga szerokiej wiedzy z zakresu administracji serwerami opartymi o system Windows Server. Jeśli opisane tutaj czynności nie są zrozumiałe lub napotkany został problem podczas konfiguracji, prosimy o zwrócenie się do działu wdrożeń w celu przeprowadzenia profesjonalnej i poprawnej konfiguracji.

Konfiguracja logowania automatycznego

Przed przystąpieniem do konfiguracji należy upewnić się, że spełnione zostały wszystkie wymagania. Aby automatyczne logowanie działało poprawnie:

Użytkownicy muszą logować się do systemu eDokumenty dzięki autoryzacji domenowej, czyli Active Directory.

Użytkownicy logują się do swoich stacji roboczych wykorzystując domenę.

Na kontrolerze domeny musi być uruchomiony serwer IIS, port jest dowolny.

Kontroler domeny oraz serwer eDokumentów muszą mieć dostęp do siebie nawzajem.

Konfiguracja serwera IIS

Z katalogu /var/tpl (Panel sterowania > Szablony systemowe) należy skopiować plik sso.aspx.tpl do katalogu na serwerze IIS, zmieniając mu nazwę na sso.aspx lub inną (nazwa sso.aspx zostanie używa w dalsze części instrukcji). Plik ten musi być dostępny z zewnątrz poprzez protokół HTTP lub HTTPS.

Następnie należy wyłączyć anonimowy dostęp do pliku sso.aspx i wymusić autoryzację NTLM podczas dostępu do niego.

Konfiguracja systemu eDokumenty

W pliku config.inc należy ustawić pewne stałe.

EXT_ACTIONS_ENGINE_URL - Adres główny systemu eDokumenty z kończącym slashem, np. ​http://mojafirma.biznes.biz/edokumenty/

SSO_REMOTE_SERVICE - Pełny adres do pliku sso.aspx, np. ​http://domena.firma/sso.aspx

SSO_SALT - Losowy ciąg znaków który dodatkowo zabezpieczy system logowania, np. abcd1234

SSO_LOGIN_ENABLED - Na tym etapie konfiguracji należy zostawić wartość FALSE aby nie zaburzyć działania systemu.

EDOK_API_LOGIN - Login, który umożliwi zalogowanie do API, dowolny.

EDOK_API_PASSWORD - Hasło do API, dowolne.

Konfiguracja pliku sso.aspx

Należy otworzyć plik sso.aspx w edytorze tekstu w trybie UTF-8 bez BOM - np. w darmowym Notepad++.

Następnie znajdujemy deklarację zmiennych api_user, api_pass, api_host, entity oraz salt i ustawiamy je na poprawne wartości. Opis zmiennych:

api_host - Pełny adres do pliku eDokumentyApi.php, np. ​http://serwer/edokumenty/eDokumentyApi.php

api_user - użytkownik API, taki sam jak w config.inc

api_pass - Suma md5 hasła EDOK_API_PASSWORD generowanego przy pomocy md5 oraz solenie jej i ponowne liczenie sumy. Pseudokod generujący sumę:

md5(md5('HASLO').'_SOAP_eDok_api');

entity - Symbol jednostki organizacyjnej, np. beta

salt - Wartość soli, czyli wartość SSO_SALT z config.inc

Uruchomienie funkcjonalności

Aby uruchomić logowanie automatyczne należy w pliku config.inc systemu eDokumenty zmienić wartość stałej SSO_LOGIN_ENABLED na TRUE.

Aby wyłączyć - wystarczy ustawić na FALSE.

Uwaga: zmiany są natychmiastowe.

Konfiguracja funkcji logowania automatycznego w popularnych przeglądarkach

Firefox

Należy otworzyć stronę about:config, w wyszukiwarce wpisać ntlm-auth.trust, następnie podwójnie kliknąć na network.automatic-ntlm-auth.trusted-uris i po przecinku wpisać adres zarówno systemu eDokumenty jak i serwera IIS. Przykład: ​http://moja.firma.biz/,http://kontroler.firma/

Google Chrome i Internet Explorer

W systemie Windows należy otworzyć komponent Opcje internetowe, przejść na zakładkę Zabezpieczenia, kliknąć przycisk Poziom niestandardowy i na dole listy, w sekcji Uwierzytelnianie użytkownika wybrać opcję Zaloguj automatycznie z bieżącą nazwą użytkownika i hasłem i zaakceptować przyciskiem OK. Następnie kliknąć na Zaufane witryny w górnej części okna, następnie na przycisk Witryny, a następnie dodać do listy adres serwera eDokumenty jak i serwera IIS.