1. Wchodzimy na stronę https://portal.azure.com/ następnie w pasku wyszukiwania wpisujemy Azure Active Directory i przechodzimy do tej usługi
2.Przechodzimy do zakładki Rejestracje aplikacji i klikamy na Nowa rejestracja
3.Uzupełniamy nazwę aplikacji oraz w identyfikatorze przekierowania wybieramy opcje Internet, następnie klikamy przycisk Rejestruj
4. Zapisujemy Client id oraz Tenant id, ponieważ będą potrzebne do konfiguracji w systemie PlusWorkflow
5. Przechodzimy do zakładki Uwierzytelnianie, klikamy przycisk Dodaj platformę i wybieramy Opcje Internet
6.Uzupełniamy Identyfikator URI przekierowania (nie może być to adres IP!!) adresem do naszego systemu PlusWorkflow + "/api/oauth/redirect" i klikamy Konfiguruj (Adres ten nie musi być widoczny przez Azure, wystarczy aby użytkownik który będzie się logował na swoje konto w Azure miał do niego dostęp, ponieważ zostanie on później na niego przekierowany).
7. Przechodzimy do zakładki Certyfikaty i klucze tajne i klikamy przycisk Nowy klucz tajny klienta
8. Uzupełniamy Opis i wybieramy Wygasanie klucza, następnie klikamy Dodaj
9. Zapisujemy Client secret, ponieważ będzie potrzebny do konfiguracji w systemie PlusWorkflow
10. W systemie PlusWorkflow przechodzimy do zakładki Konfiguracja OAuth2 znajdującej się w Administracja -> Konfiguracja Systemu -> Konfiguracja skrzynek pocztowych -> Konfiguracja OAuth2, i klikamy Dodaj klienta
11. Uzupełniamy odpowiednio dane i klikamy Dodaj
Client id: Client id uzyskany podczas konfiguracji aplikacji na Azure
Client secret: Client secret uzyskany podczas konfiguracji aplikacji na Azure
Scope: tutaj musimy podać jakie uprawnienia ma posiadać nasza aplikacja. Dla skrzynek pocztowych ważne są następujące wartości:
- offline_access - wymagane aby automatycznie odświeżać token dostępu
- https://outlook.office.com/IMAP.AccessAsUser.All - wymagane aby mieć dostęp do skrzynki przez IMAP
- https://outlook.office.com/POP.AccessAsUser.All - wymagane aby mieć dostęp dostęp do skrzynki przez POP
- https://outlook.office.com/SMTP.Send - wymagane aby móc wysyłać wiadomości przez SMTP
Poszczególne wartości oddzielamy spacją
Authorization url: https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/authorize?prompt=select_account - wartość <tenant-id> należy zastąpić wartością uzyskaną podczas konfiguracji aplikacji na Azure
Token url: https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token - wartość <tenant-id> należy zastąpić wartością uzyskaną podczas konfiguracji aplikacji na Azure
12. Aby dodać nowe połączenie klikamy Nowe połączenie, wpisujemy z jakim adresem email ma być ono skojarzone i klikamy Dodaj
13. Powinniśmy zostać przeniesieni na stronę Outlooka. Tam będziemy musieli się zalogować na konto które ma dostęp do wpisanej wcześniej skrzynki email. Po zalogowaniu wyskoczy nam okienko zawierające informacje o tym jakich uprawnień wymaga nasza aplikacja i czy chcemy udzielić do nich dostęp. Musimy kliknąć przycisk Akceptuj.
14. Jeśli wszystko się powiodło powinniśmy zostać przekierowani do systemu PlusWorflow i dostać komunikat o poprawnym dodaniu połączenia.
Przykładowa konfiguracja z wykorzystaniem połączenia OAuth2
Aby można się było poprawnie połączyć, upewnij się że dana skrzynka ma włączoną możliwość logowania się za pomocą SMTP/IMAP/POP. Jeśli nie ma można, to można to włączyć w następujący sposób:
Wykorzystanie połączenia w konfiguracji Efaktura
Aby wykorzystać to połączenia w efakturze w EmailsPasswords należy podać Id połączenia a parametr OAuth ustawić na true
