Uwierzytelnianie logowania Microsoft Azure¶
Uwierzytelnianie logowania OAuth Microsoft Azure to przydatna funkcja, która pozwala użytkownikom Odoo zalogować się do swojej bazy danych za pomocą konta Microsoft Azure.
Jest to szczególnie pomocne, jeśli organizacja korzysta z Azure Workspace i chce, aby pracownicy w organizacji łączyli się z Odoo przy użyciu swoich kont Microsoft.
Ostrzeżenie
Bazy danych hostowane na Odoo.com nie powinny używać logowania OAuth dla właściciela lub administratora bazy danych, ponieważ odłączyłoby to bazę danych od ich konta Odoo.com. Jeśli OAuth zostanie skonfigurowane dla tego użytkownika, baza danych nie będzie mogła być już duplikowana, zmieniana ani w inny sposób zarządzana z portalu Odoo.com.
Konfiguracja¶
Integracja funkcji logowania Microsoft wymaga konfiguracji w Microsoft i Odoo.
Parametr systemowy Odoo¶
Najpierw aktywuj tryb dewelopera, a następnie przejdź do .
Kliknij Nowy i w pustym wierszu, który się pojawi, dodaj następujący parametr systemowy auth_oauth.authorization_header do pola Klucz i ustaw Wartość na 1. Następnie kliknij Zapisz, aby zakończyć.
Konsola Microsoft Azure¶
Tworzenie nowej aplikacji¶
Teraz, gdy parametry systemowe w Odoo zostały skonfigurowane, czas utworzyć odpowiednią aplikację w Microsoft Azure. Aby rozpocząć tworzenie nowej aplikacji, przejdź do portalu Microsoft Azure. Zaloguj się przy użyciu konta Microsoft Outlook Office 365, jeśli takie posiadasz, w przeciwnym razie zaloguj się przy użyciu osobistego konta Microsoft.
Ważne
Użytkownik z uprawnieniami administracyjnymi do ustawień Azure musi się połączyć i wykonać poniższe kroki konfiguracji.
Następnie przejdź do sekcji Zarządzaj Microsoft Entra ID (wcześniej Azure Active Directory). Link ten znajduje się zazwyczaj na środku strony.
Teraz kliknij ikonę Dodaj (+) znajdującą się w górnym menu, a następnie wybierz Rejestracja aplikacji z menu rozwijanego. Na ekranie Zarejestruj aplikację zmień nazwę pola Nazwa na Odoo Login OAuth lub podobny, rozpoznawalny tytuł. W sekcji Obsługiwane typy kont wybierz opcję Konta tylko w tym katalogu organizacyjnym (tylko katalog domyślny - pojedyncza dzierżawa).
Ostrzeżenie
Opcja Obsługiwane typy kont może się różnić w zależności od typu konta Microsoft i docelowego użycia OAuth. Na przykład: Czy logowanie jest przeznaczone dla użytkowników wewnętrznych w organizacji, czy dla dostępu do portalu klienta? Powyższa konfiguracja jest używana dla użytkowników wewnętrznych w organizacji.
Wybierz Tylko osobiste konta Microsoft, jeśli docelową grupą są użytkownicy portalu. Wybierz Konta tylko w tym katalogu organizacyjnym (tylko katalog domyślny - pojedyncza dzierżawa), jeśli docelową grupą są użytkownicy firmowi.
W sekcji Adres URL przekierowania wybierz Sieć Web jako platformę, a następnie wprowadź https://<bazowy adres url odoo>/auth_oauth/signin w polu URL. Bazowy URL Odoo to kanoniczny adres domeny, pod którym można uzyskać dostęp do Twojej instancji Odoo (np. mojabaza.odoo.com, jeśli jesteś hostowany na Odoo.com) w polu URL. Następnie kliknij Zarejestruj, a aplikacja zostanie utworzona.
Uwierzytelnienie¶
Edytuj uwierzytelnianie nowej aplikacji, klikając pozycję menu Uwierzytelnianie w lewym menu po przekierowaniu do ustawień aplikacji z poprzedniego kroku.
Następnie zostanie wybrany typ tokenów potrzebnych do uwierzytelniania OAuth. Nie są to tokeny walutowe, ale tokeny uwierzytelniające przekazywane między Microsoft i Odoo. W związku z tym nie ma żadnych kosztów związanych z tymi tokenami; służą one jedynie do celów uwierzytelniania między dwoma API. Wybierz tokeny, które powinny być wydawane przez punkt końcowy autoryzacji, przewijając ekran w dół i zaznaczając pola: Tokeny dostępu (używane w przepływach niejawnych) oraz Tokeny ID (używane w przepływach niejawnych i hybrydowych).
Kliknij Zapisz, aby zapisać te ustawienia.
Zbierz dane uwierzytelniające.¶
Po utworzeniu i uwierzytelnieniu aplikacji w konsoli Microsoft Azure zostaną zebrane dane uwierzytelniające. W tym celu kliknij pozycję menu Przegląd w lewej kolumnie. Zaznacz i skopiuj Identyfikator aplikacji (klienta) w wyświetlonym oknie. Wklej te dane uwierzytelniające do schowka / notatnika, ponieważ będą one używane w konfiguracji Odoo później.
Po zakończeniu tego kroku kliknij Punkty końcowe w górnym menu i kliknij ikonę kopiowania obok pola Punkt końcowy autoryzacji OAuth 2.0 (v2). Wklej tę wartość do schowka / notatnika.
Uprawnienia API¶
Odoo potrzebuje uprawnień do odczytu informacji o profilu zalogowanego użytkownika z Microsoft Graph podczas procesu OAuth. Upewnij się, że delegowane uprawnienie User.Read jest przyznane w rejestracji aplikacji Azure. W przeciwnym razie proces logowania może zakończyć się niepowodzeniem lub nie być w stanie poprawnie powiązać konta Microsoft z użytkownikiem Odoo.
Informacja
User.Read jest często dodawane domyślnie przy nowych rejestracjach aplikacji, ale powinno zostać tutaj jawnie zweryfikowane.
Aby to skonfigurować, kliknij element menu Zarządzaj w lewej kolumnie, a następnie:
Kliknij Uprawnienia API w menu po lewej stronie.
Kliknij (+) Dodaj uprawnienie.
Wybierz Microsoft Graph w sekcji Często używane interfejsy API firmy Microsoft.
Wybierz Uprawnienia delegowane.
Wyszukaj User.Read, zaznacz je i kliknij Dodaj uprawnienia.
Konfiguracja Odoo¶
Na koniec, ostatnim krokiem w konfiguracji OAuth w Microsoft Azure jest zakończenie konfiguracji w Odoo. Przejdź do i zaznacz pole wyboru Uwierzytelnianie OAuth. Kliknij Zapisz, aby zapisać zmiany i odśwież stronę. Przewiń w dół do sekcji i kliknij Dostawcy OAuth. Następnie kliknij Nowy.
Wprowadź Nazwę dostawcy jako Azure. Wklej Identyfikator aplikacji (klienta) z poprzedniej sekcji do pola Identyfikator klienta. Po zakończeniu wklej nową wartość Punkt końcowy autoryzacji OAuth 2.0 (v2) do pola Adres URL autoryzacji.
W polu UserInfo URL wklej następujący adres URL: https://graph.microsoft.com/oidc/userinfo
W polu Scope wklej następującą wartość: openid profile email. Następnie logo Windows może zostać użyte jako klasa CSS na ekranie logowania poprzez wprowadzenie następującej wartości: fa fa-fw fa-windows w polu CSS class.
Zaznacz pole obok pola Allowed, aby włączyć dostawcę OAuth. Na koniec dodaj Microsoft Azure w polu Login button label. Ten tekst pojawi się obok logo Windows na stronie logowania.
Zapisz zmiany, aby zakończyć konfigurację uwierzytelniania OAuth w Odoo.
Proces działania dla użytkownika¶
Aby użytkownik mógł zalogować się do Odoo przy użyciu Microsoft Azure, musi znajdować się na . Jest to jedyny sposób, w jaki Odoo może połączyć konto Microsoft Azure i umożliwić użytkownikowi zalogowanie się.
Informacja
Istniejący użytkownicy muszą zresetować swoje hasło, aby uzyskać dostęp do . Nowi użytkownicy Odoo muszą kliknąć link z zaproszeniem wysłany e-mailem, a następnie kliknąć Microsoft Azure. Użytkownicy nie powinni ustawiać nowego hasła.
Aby zalogować się do Odoo po raz pierwszy przy użyciu dostawcy OAuth Microsoft Azure, przejdź do (używając linku z zaproszeniem dla nowego użytkownika). Powinna pojawić się strona resetowania hasła. Następnie kliknij opcję oznaczoną jako Microsoft Azure. Strona przekieruje do strony logowania Microsoft.
Wprowadź adres e-mail Microsoft i kliknij Dalej. Postępuj zgodnie z procesem logowania do konta. Jeśli włączone jest uwierzytelnianie dwuskładnikowe, może być wymagany dodatkowy krok.
Na koniec, po zalogowaniu się do konta, strona przekieruje do strony uprawnień, gdzie użytkownik zostanie poproszony o zaakceptowanie warunków, że aplikacja Odoo będzie miała dostęp do jego informacji Microsoft.