Zmiany pomiędzy wersją 1 and wersją 2 dla AdminGuide/SSOAuth
- Data i czas:
- 02/19/14 15:00:11 (11 years temu)
Legend:
- Bez zmian
- Dodane
- Usunięte
- Zmienione
-
AdminGuide/SSOAuth
v1 v2 1 1 == UWAGA == 2 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żenw celu przeprowadzenia profesjonalnej i poprawnej konfiguracji.2 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. 3 3 4 4 == Konfiguracja logowania automatycznego == 5 5 Przed przystąpieniem do konfiguracji należy upewnić się, że spełnione zostały wszystkie wymagania. Aby automatyczne logowanie działało poprawnie: 6 6 7 Użytkownicy muszą logować się do systemu eDokumenty dzięki autoryzacji domenowej, czyli Active Directory.7 Użytkownicy muszą logować się do systemu eDokumenty dzięki autoryzacji domenowej, czyli '''Active Directory'''. 8 8 9 Na kontrolerze domeny musi być uruchomiony serwer IIS, port jest dowolny.9 Użytkownicy logują się do swoich stacji roboczych wykorzystując domenę. 10 10 11 Kontroler domeny oraz serwer eDokumentów muszą mieć dostęp do siebie nawzajem. 11 Na kontrolerze domeny musi być uruchomiony serwer '''IIS''', port jest dowolny. 12 13 Kontroler domeny oraz serwer eDokumentów '''muszą''' mieć dostęp do siebie nawzajem. 12 14 13 15 14 16 == Konfiguracja serwera IIS == 15 Z katalogu /var/tpl 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.17 Z katalogu '''/var/tpl''' 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'''. 16 18 17 19 Następnie należy wyłączyć anonimowy dostęp do pliku sso.aspx i wymusić autoryzację NTLM podczas dostępu do niego. 18 20 19 21 == Konfiguracja systemu eDokumenty == 20 W pliku config.incnależy ustawić pewne stałe.22 W pliku '''config.inc''' należy ustawić pewne stałe. 21 23 22 EXT_ACTIONS_ENGINE_URL- Adres główny systemu eDokumenty z kończącym slashem, np. http://mojafirma.biznes.biz/edokumenty/24 '''EXT_ACTIONS_ENGINE_URL''' - Adres główny systemu eDokumenty z kończącym slashem, np. http://mojafirma.biznes.biz/edokumenty/ 23 25 24 SSO_REMOTE_SERVICE- Pełny adres do pliku sso.aspx, np. http://domena.firma/sso.aspx26 '''SSO_REMOTE_SERVICE''' - Pełny adres do pliku sso.aspx, np. http://domena.firma/sso.aspx 25 27 26 SSO_SALT- Losowy ciąg znaków który dodatkowo zabezpieczy system logowania, np. abcd123428 '''SSO_SALT''' - Losowy ciąg znaków który dodatkowo zabezpieczy system logowania, np. abcd1234 27 29 28 SSO_LOGIN_ENABLED- Na tym etapie konfiguracji należy zostawić wartość FALSE aby nie zaburzyć działania systemu.30 '''SSO_LOGIN_ENABLED''' - Na tym etapie konfiguracji należy zostawić wartość FALSE aby nie zaburzyć działania systemu. 29 31 30 EDOK_API_LOGIN- Login, który umożliwi zalogowanie do API, dowolny.32 '''EDOK_API_LOGIN''' - Login, który umożliwi zalogowanie do API, dowolny. 31 33 32 EDOK_API_PASSWORD- Hasło do API, dowolne.34 '''EDOK_API_PASSWORD''' - Hasło do API, dowolne. 33 35 34 36 == Konfiguracja pliku sso.aspx == 35 Należy otworzyć plik sso.aspx w edytorze tekstu w trybie UTF-8 bez BOM- np. w darmowym Notepad++.37 Należy otworzyć plik '''sso.aspx''' w edytorze tekstu w trybie '''UTF-8 bez BOM''' - np. w darmowym Notepad++. 36 38 37 39 Następnie znajdujemy deklarację zmiennych '''api_user''', '''api_pass''', '''api_host''', '''entity''' oraz '''salt''' i ustawiamy je na poprawne wartości. Opis zmiennych: 38 40 39 api_host- Pełny adres do pliku eDokumentyApi.php, np. http://serwer/edokumenty/eDokumentyApi.php41 '''api_host''' - Pełny adres do pliku eDokumentyApi.php, np. http://serwer/edokumenty/eDokumentyApi.php 40 42 41 api_user- użytkownik API, taki sam jak w config.inc43 '''api_user''' - użytkownik API, taki sam jak w config.inc 42 44 43 api_pass- hasło API, takie same jak w config.inc45 '''api_pass''' - hasło API, takie same jak w config.inc 44 46 45 entity- Symbol jednostki organizacyjnej, np. beta47 '''entity''' - Symbol jednostki organizacyjnej, np. beta 46 48 47 salt- Wartość soli, czyli wartość SSO_SALT z config.inc49 '''salt''' - Wartość soli, czyli wartość SSO_SALT z config.inc 48 50 49 51 == Uruchomienie funkcjonalności == 50 52 51 Aby uruchomić logowanie automatyczne należy w pliku config.inc systemu eDokumenty zmienić wartość stałej SSO_LOGIN_ENABLED na TRUE.53 Aby uruchomić logowanie automatyczne należy w pliku '''config.inc''' systemu eDokumenty zmienić wartość stałej '''SSO_LOGIN_ENABLED''' na '''TRUE'''. 52 54 53 55 Aby wyłączyć - wystarczy ustawić na FALSE.