Funkcjonalność znajduje się w zakładce Administracja -> Konfiguracja systemu -> Konfiguracja skrzynek pocztowych i umożliwia tworzenie oraz zarządzanie konfiguracjami skrzynek pocztowych w systemie.
Opcje konfiguracyjne skrzynki pocztowej:
W systemie do uwierzytelniania połączenia ze skrzynką pocztową można wykorzystać protokół OAuth2 z Authorization code grant type. Aby to zrobić należy stworzyć klienta OAuth2 oraz dodać mu połączenie.
Opcje konfiguracyjne klienta OAuth2:
Dodawanie połączenia:
Aby dodać nowe połączenie należy poprawnie skonfigurować klienta, a następnie kliknąć na przycisk Nowe połączenie, znajdujący się na górze sekcji Połączenia w zakładce Konfiguracja Klienta OAuth2. Wyskoczy nam okienko w którym musimy wpisać adres e-mail dla którego chcemy dodać połączenie. Gdy to zrobimy zostaniemy przeniesieni na stronę dostawcy skrzynki pocztowej np. Outlook i musimy się tam zalogować.
Konfigurowanie klienta na stronie dostawcy:
Przy konfigurowaniu klienta na stronie dostawcy należy pamiętać o ustawieniu odpowiedniego redirect_url. Url powinno wyglądać w ten sposób: Adres serwera plusworkflow + /PlusWorkflow/api/oauth/redirect
Konfiguracja znanych dostawców:
Outlook:
Poradnik tworzenia aplikacji: https://docs.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app
Ustawienia klienta w systemie PlusWorkflow:
| Scope | offline_access https://outlook.office.com/IMAP.AccessAsUser.All https://outlook.office.com/SMTP.Send |
| Authorization Url | https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/authorize |
| Token Url | https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token |
<tenant-id> należy zastąpić Identyfikatorem dzierżawy, który można znaleźć w ten sposób: https://docs.microsoft.com/en-us/azure/active-directory/fundamentals/active-directory-how-to-find-tenant
Jeśli do Authorization Url dopiszemy parametr prompt=select_account , będziemy mogli wybrać na które konto chcemy się zalogować.
Gmail:
Ustawienia klienta w systemie PlusWorkflow:
Poradnik tworzenia klienta: https://developers.google.com/identity/protocols/oauth2/web-server#creatingcred
| Scope | https://mail.google.com/ |
| Authorization Url | https://accounts.google.com/o/oauth2/v2/auth?access_type=offline&prompt=consent |
| Token Url | https://oauth2.googleapis.com/token |
Parametry access_type oraz prompt są potrzebne aby uzyskać refresh token.