DOKUMENTACJA · EDO MANAGER
Procedura jednorazowej konfiguracji aplikacji eDo Manager oraz połączenia jej ze skrzynką w systemie edoreczenia.gov.pl. Po jej zakończeniu aplikacja działa jak klasyczny klient poczty.
Cel konfiguracji. W aplikacji generowany jest specjalny plik z kluczem (tzw. CSR) — cyfrowy identyfikator informujący system eDoręczeń, że dana instancja aplikacji ma prawo łączyć się z konkretną skrzynką. Plik ten wgrywa się następnie do portalu edoreczenia.gov.pl. Po jego zatwierdzeniu i powrocie do aplikacji skrzynka jest gotowa do użycia.
Co będzie potrzebne. Zainstalowana aplikacja eDo Manager, dostęp do skrzynki w systemie edoreczenia.gov.pl (z możliwością zalogowania się do portalu) oraz około 10 minut. Konfiguracja nie wymaga wiedzy technicznej — wystarczy uważne przejście przez kolejne ekrany.
Istotne zastrzeżenie. eDo Manager obsługuje wyłącznie skrzynki firmowe oraz zawodowe (m.in. adwokatów, radców prawnych). Aplikacja nie obsługuje skrzynek osobistych — ograniczenie to wynika z systemu eDoręczeń, a nie z samej aplikacji.
Część A · z 4
Przy pierwszym uruchomieniu aplikacja nie posiada jeszcze skonfigurowanej skrzynki, w związku z czym wyświetli pytanie, czy dodać nową. Należy kliknąć „Tak" — otworzy się okno z listą skrzynek.
Do okna listy skrzynek można w każdej chwili powrócić z menu programu — np. w razie potrzeby dodania kolejnej skrzynki.
Okno „Lista skrzynek" przy pierwszym uruchomieniu jest puste. Należy kliknąć przycisk „+ Nowa Skrzynka".
Otworzy się okno konfiguracji skrzynki. Należy wypełnić kolejne pola — poniżej omówienie każdego z nich.
AE:PL.... Można go skopiować z portalu edoreczenia.gov.pl.edomanager — wartość tę można pozostawić bez zmian. Pole MUSI być identyczne z wartością wprowadzaną później w portalu eDoręczeń (krok 10). W przypadku rozbieżności konfiguracja nie zadziała.*.kuczynski.biz. Zaleca się pozostawienie wartości domyślnej.Należy kliknąć przycisk „Generuj nowe klucze". Pola „klucz publiczny", „klucz prywatny" oraz Certificate Signing Request (CSR) wypełnią się automatycznie ciągami znaków — wartości te nie wymagają samodzielnego wprowadzania.
Należy kliknąć „Eksportuj plik CSR" i zapisać plik w łatwo dostępnym miejscu — np. na pulpicie. Plik ten zostanie wykorzystany w następnym etapie, w portalu eDoręczeń.
Na tym etapie nie należy zamykać okna „Konfiguracja skrzynki" w aplikacji. Powrót do niego nastąpi w kroku 16. Zaleca się zminimalizowanie aplikacji albo pozostawienie jej otwartej w tle.
Część B · z 4
W przeglądarce należy otworzyć stronę edoreczenia.gov.pl i przejść do firmowej/zawodowej skrzynki eDoręczeń, której dotyczy aktualnie prowadzona konfiguracja w aplikacji.
W menu po lewej stronie należy kliknąć zakładkę „Uprawnienia".
W górnej części strony „Uprawnienia" widoczne są zakładki. Należy kliknąć „Systemy".
Po prawej stronie ekranu widoczny jest przycisk „Dodaj system", w który należy kliknąć.
Otworzy się formularz „Dodaj system". Należy wypełnić go w następujący sposób:
edomanager). Najwygodniej skopiować wartość bezpośrednio z aplikacji i wkleić w portalu.W przypadku gdy po zakończeniu konfiguracji skrzynka nie łączy się prawidłowo — w pierwszej kolejności należy zweryfikować wartość pola „Nazwa systemu" w obu miejscach. Wartości muszą być identyczne.
Po wgraniu pliku widoczna jest zielona ikona z nazwą wgranego pliku — stanowi to potwierdzenie, że portal przyjął plik. Następnie należy kliknąć „Zapisz".
Wyświetlone zostanie okno z prośbą o potwierdzenie. Należy kliknąć „Dodaj system".
Portal przekieruje na stronę „Szczegóły systemu". Bez wprowadzania zmian należy kliknąć „Zapisz".
Portal ponownie poprosi o potwierdzenie zapisu. Należy kliknąć „Zapisz zmiany".
Portal powróci na stronę „Systemy". Na liście — zwykle w dolnej części — widoczny będzie nowo dodany system wraz z datą ważności (zazwyczaj 2 lata od daty rejestracji).
Warto odnotować datę ważności. Po jej upływie konieczne będzie odświeżenie konfiguracji — wygenerowanie nowego klucza i ponowne wgranie go do portalu.
Część C · z 4
Należy powrócić do otwartego cały czas okna „Konfiguracja skrzynki" w aplikacji eDo Manager i kliknąć „Zapisz i zamknij".
Aplikacja powróci do okna „Lista skrzynek". Tym razem widnieje na niej skonfigurowana skrzynka wraz z adresem. Należy kliknąć „Zamknij".
Wyświetlone zostanie główne okno aplikacji eDo Manager. Po lewej stronie widoczna jest skonfigurowana skrzynka. Kliknięcie w nią spowoduje załadowanie wiadomości z systemu eDoręczeń w głównym widoku.
Od tego momentu logowanie do portalu eDoręczeń przy zwykłym odbieraniu wiadomości nie jest już konieczne. Aplikacja sama je pobiera, prezentując korespondencję w jednym, spójnym widoku — analogicznie do klasycznego klienta poczty elektronicznej.
Część D · z 4
Funkcja przekazywania wiadomości na adresy email (forward) wymaga wskazania w aplikacji własnego serwera poczty wychodzącej (SMTP). To z tego serwera aplikacja wysyła wiadomości przy przekazywaniu korespondencji z systemu eDoręczeń na wskazane adresy mailowe.
Konfiguracja SMTP jest opcjonalna — bez niej eDo Manager nadal obsługuje skrzynkę eDoręczeń (odczyt, foldery, załączniki). Funkcja przekazywania jest jednak wówczas niedostępna.
Okno konfiguracji serwera poczty wychodzącej dostępne jest z menu programu: Ustawienia → Serwer poczty email. Otwiera się wówczas okno „Konfiguracja skrzynki email", w którym wprowadza się parametry połączenia z serwerem SMTP.
W oknie tym dostępny jest przycisk „Testuj połączenie", który pozwala na bieżąco zweryfikować poprawność wprowadzonych danych — bez konieczności zapisywania konfiguracji ani próby wysyłki rzeczywistej wiadomości.
W oknie „Konfiguracja skrzynki email" wypełnia się następujące pola:
smtp.gmail.com).587 (STARTTLS) lub 465 (SSL/TLS).AutoSelect. W razie trudności można wybrać konkretną metodę zgodnie z dokumentacją dostawcy (najczęściej Login lub Plain).
Implicit (TLS Connection) stosuje się z portem 465, natomiast Explicit (STARTTLS) z portem 587. Wartość None (połączenie nieszyfrowane) nie jest zalecana i bywa blokowana przez współczesnych dostawców.
U większości popularnych dostawców (Google, Microsoft, Apple) zwykłe hasło konta nie wystarczy, jeśli włączona jest weryfikacja dwuetapowa — wymagane jest wówczas tzw. hasło aplikacji (App Password). Jest to osobne hasło generowane w ustawieniach konta, przeznaczone wyłącznie dla aplikacji zewnętrznych. Procedura jego utworzenia jest opisana w dokumentacji każdego z dostawców.
W dalszej części okna „Konfiguracja skrzynki email" znajdują się pola definiujące wygląd wiadomości email zawierającej przekazaną korespondencję z eDoręczeń:
W polach „Temat" oraz „Nagłówek wiadomości" dozwolone są znaczniki, które przy wysyłce zostaną automatycznie zastąpione wartościami pobranymi z oryginalnej wiadomości eDoręczeń:
Poniżej zestawienie typowych parametrów SMTP dla najczęściej spotykanych dostawców poczty. W razie wątpliwości aktualne dane warto zweryfikować w dokumentacji danego dostawcy — parametry mogą się zmieniać.
Google · konta prywatne i Workspace
Wymagana jest włączona weryfikacja dwuetapowa oraz wygenerowanie hasła do aplikacji w ustawieniach konta Google (myaccount.google.com/apppasswords). Standardowe hasło do konta nie zadziała. Pełna procedura opisana: Logowanie się za pomocą haseł do aplikacji
Microsoft
Przy włączonej weryfikacji dwuetapowej wymagane jest wygenerowanie hasła aplikacji w ustawieniach konta Microsoft (go.microsoft.com/fwlink/?linkid=2274139). Standardowe hasło do konta nie zadziała. Szczegóły: How to get and use app passwords
Microsoft
Przy włączonej weryfikacji dwuetapowej wymagane jest wygenerowanie hasła aplikacji w ustawieniach konta Microsoft i włączenie SMTP AUTH. Więcej informacji: How to set up a multifunction device or application to send email using Microsoft 365 or Office 365
Proton AG · SMTP submission
Funkcja SMTP submission dostępna jest dla użytkowników płatnych planów Proton Mail i wymaga jednorazowej aktywacji w ustawieniach konta. W panelu Proton generuje się dedykowany token SMTP, który stanowi hasło dla aplikacji zewnętrznej (standardowe hasło konta nie zadziała). Pełna procedura: How to set up SMTP to use business applications or devices with Proton Mail.
Onet.pl
Należy upewnić się czy protokół SMTP został odblokowany. W tym celu należy zalogować się do konta przez www, następnie w Ustawienia poczty – > Konto główne i spraedzić pozycje suwaków u dołu strony. Onet dodatkowo poleca aktowowanie Haseł do aplikacji. Więcej informacji dostępny: pomoc.poczta.onet.pl/baza-wiedzy/hasla-do-aplikacji
Apple
Konto Apple musi mieć włączone uwierzytelnianie dwuskładnikowe. Hasło aplikacyjne generuje się na stronie appleid.apple.com w sekcji „Logowanie i zabezpieczenia" → „Hasła aplikacji".
Jeśli próba wysyłki kończy się błędem uwierzytelniania, w pierwszej kolejności należy zweryfikować trzy elementy: (1) czy podany login to pełny adres email, (2) czy podane hasło to faktyczne hasło aplikacji (a nie zwykłe hasło konta), oraz (3) czy w panelu dostawcy włączona jest zgoda na logowanie z programów zewnętrznych / SMTP AUTH.
Najczęstszą przyczyną nieprawidłowości jest niezgodność pola „Nazwa systemu" pomiędzy aplikacją a portalem eDoręczeń. W pierwszej kolejności zaleca się weryfikację, czy w obu miejscach widnieje identyczna nazwa.