Obsługa kont pocztowych Office 365

W wersji 2022.0.4 umożliwiono korzystanie w Comarch DMS z kont pocztowych w usłudze Microsoft Office 365. Autoryzacja odbywa się poprzez wymianę tokenów i nie wymaga każdorazowego podawania loginu i hasła.

Aby móc korzystać z konta Office365 w Comarch DMS do wysyłania powiadomień mailowych, konieczne jest, żeby w aplikacji desktop Comarch DMS w ramach zakładki [Ustawienia], w zakładce „Serwer pocztowy”, w polu „Do wysyłania wiadomości email zastosuj” wybrać opcję „Komponent mailowy na serwerze IIS”. Nie jest możliwe korzystanie z konta Office365, jeśli wybrano opcję „Profil na serwerze SQL”.

W celu umożliwienia obsługi kont pocztowych Office 365 wprowadzono zmianę w ramach zakładki [Ustawienia], w zakładce „Serwer pocztowy”, po wybraniu w polu „Do wysyłania wiadomości email zastosuj” opcji „Komponent mailowy na serwerze IIS” – w sekcji „Ustawienia konta pocztowego” dodano pole „Metoda uwierzytelniania”, w którym można wybrać jedną z dwóch opcji: „Login i hasło” lub „OAuth2”.

 

Wybór opcji „OAuth2” w ramach pola „Metoda uwierzytelniania”

 

Aby dokonać konfiguracji obsługi konta pocztowego Office 365, należy wybrać jako metodę uwierzytelniania OAuth2. Po wyborze opcji „OAuth2” pod polem „Login” pojawia się przycisk [Autoryzacja], który należy nacisnąć po poprawnym uzupełnieniu pozostałych pól.

 

Wybór metody uwierzytelniania „OAuth2” i przycisk „Autoryzacja”

 

Wtedy zostanie otwarta domyślna przeglądarka w systemie Windows, z oknem logowania do usługi Office 365. W oknie należy uzupełnić hasło i nacisnąć przycisk „Zaloguj”.

 

Przykładowe okno logowania do usługi Office 365

 

Jeżeli użytkownik nie przyznał wcześniej uprawnień do pracy z Comarch DMS dla danego konta pocztowego (np. w punkcie konfiguracyjnym ACD współpracującym ze skrzynką pocztową), wtedy w ramach przeglądarki zostaje otwarte okno, w którym należy wyrazić zgodę na dostęp aplikacji Comarch DMS do skrzynki pocztowej. Aby możliwe było korzystanie ze skrzynki pocztowej w ramach usługi Office 365 należy wybrać przycisk „Tak”.

Okno zgody na dostęp Comarch DMS do skrzynki pocztowej

 

Wówczas w przeglądarce zostaje wyświetlone okno informujące o zalogowaniu. Jeśli uprawnienia dla Comarch DMS były już wcześniej przyznane, przejście do tego ekranu następuje bezpośrednio po logowaniu.

Okno informujące o zalogowaniu

 

Jeżeli autoryzacja przebiegła pomyślnie, wówczas po zamknięciu okna przeglądarki w aplikacji Comarch DMS w ustawieniach serwera pocztowego zostaje wyświetlony komunikat „Zalogowano użytkownika [login użytkownika poczty]”.

 

Przykładowy komunikat wyświetlany, gdy autoryzacja przebiegła pomyślnie

 

Kiedy użytkownik zostanie zalogowany, autoryzacja w usłudze Office 365 będzie wykonywana za pomocą tokenów, które będą przekazywane przez API.

 

Uwaga
Jeśli tokeny wygasną, może być konieczne ponowne zalogowanie się użytkownika w usłudze Office 365, aby móc znów korzystać z autoryzacji z zastosowaniem tokenów.

 

Wprowadzone zmiany należy zapisać.

 

Analogicznie, w zakładce [Automatyczne generowanie dokumentów] w ustawieniach typów punktów konfiguracyjnych „ Współpraca ze skrzynką pocztową (generowanie dokumentów DMS)” i „ Współpraca ze skrzynką pocztową (pobieranie załączników)” w zakładce „Tryb współpracy” dodano pole „Metoda uwierzytelniania” z 2 opcjami do wyboru: „Login i hasło” lub „OAuth2”.

 

Pole „Metoda uwierzytelniania” i wybór opcji „OAuth2”

 

Po wyborze opcji „OAuth2” pod polem „Login” pojawia się przycisk [Autoryzacja], który należy nacisnąć po poprawnym uzupełnieniu pozostałych pól.

 

Wybór metody uwierzytelniania „OAuth2” i przycisk „Autoryzacja”

 

W otwartym oknie przeglądarki w oknie logowania do usługi Office 365 należy uzupełnić hasło i kliknąć przycisk „Zaloguj”.

 

Przykładowe okno logowania do usługi Office 365

 

Jeżeli użytkownik nie przyznał wcześniej uprawnień do pracy z Comarch DMS dla danego konta pocztowego (np. w zakładce „Serwer pocztowy”), wtedy w ramach przeglądarki zostaje otwarte okno, w którym należy wyrazić zgodę na dostęp aplikacji Comarch DMS do skrzynki pocztowej. Aby możliwe było korzystanie ze skrzynki pocztowej w ramach usługi Office 365 należy wybrać przycisk „Tak”.

 

Okno zgody na dostęp Comarch DMS do skrzynki pocztowej

 

Wówczas w przeglądarce zostaje wyświetlone okno informujące o zalogowaniu. Jeśli uprawnienia dla Comarch DMS były już wcześniej przyznane, przejście do tego ekranu następuje bezpośrednio po logowaniu.

Okno informujące o zalogowaniu

 

Jeżeli autoryzacja przebiegła pomyślnie, wówczas po zamknięciu okna przeglądarki w aplikacji Comarch DMS w oknie konfiguracji punktu ACD zostaje wyświetlony komunikat „Zalogowano użytkownika [login użytkownika poczty]”.

 

Przykładowy komunikat wyświetlany, gdy autoryzacja przebiegła pomyślnie