Integracja z Google

System posiada możliwość integracji z pocztą Gmail i kalendarzem Google.

Wymagania

1. Aplikacja integrująca kalendarz na koncie Google
2. Aplikacja integrująca pocztę na koncie Google
3. Licencja: #205 - Integracja z Google OAuth

Rejestracja aplikacji

Aby móc korzystać z integracji kalendarza należy utworzyć aplikację w panelu Google Cloud Platform i uzyskać identyfikator oraz klucz aplikacji.

Włączanie interfejsów API w projekcie

1. Zaloguj się do panelu Google Cloud Platform: https://console.cloud.google.com/
2. Utwórz projekt
3. Przejdź do zakładki: Interfejsy API i usługi -> Włączone interfejsy API i usługi
4. Wybierz opcję Włącz interfejsy API i usługi
5. Do integracji z kalendarzem na liście interfejsów API znajdź: Google Calendar API i włącz go
6. Do integracji z pocztą na liście interfejsów API znajdź: Gmail API i włącz go

Konfiguracja ekranu zgody

1. Zaloguj się do panelu Google Cloud Platform: https://console.cloud.google.com/
2. Przejdź do zakładki: Platforma uwierzytelniania Google -> Przegląd
3. Jeżeli platforma została już skonfigurowana pomiń kolejne kroki i przejdź do punktu Uzyskanie identyfikatora i klucza)
4. Jeżeli widzisz komunikat 'Platforma uwierzytelniania Google nie została jeszcze skonfigurowana' rozpocznij konfigurację.
5. Uzupełnij nazwę aplikacji i pomocniczy adres email
6. W dalszych krokach wybierz Odbiorców i Dane kontaktowe, następnie zakończ konfigurację.
7. Przejdź do zakładki: Platforma uwierzytelniania Google -> Odbiorcy
8. Twoja aplikacja znajduje się w stanie 'Testowanie'.
   1. Możesz ją opublikować (może to wymagać przesłania aplikacji do weryfikacji Googla).
   2. Możesz pozostawić w tym stanie, ale należy wtedy podać adresy email użytkowników mających do niej dostęp.

Uzyskanie identyfikatora i klucza

1. Zaloguj się do panelu Google Cloud Platform: https://console.cloud.google.com/
2. Przejdź do zakładki: Interfejsy API i usługi -> Dane logowania
3. Wybierz opcję Utwórz dane logowania -> Identyfikator klienta OAuth
   1. Wybierz 'Typ aplikacji': Aplikacja internetowa
   2. Wprowadź nazwę aplikacji
   3. W polu 'Autoryzowane źródła JavaScriptu' wprowadź adres systemu
   4. W polu 'Autoryzowane identyfikatory URI przekierowania' wprowadź adres zwrotny w formacie: https://domena/_/oauth2/callback/google
   5. Kliknij Utwórz
   6. Na ekranie podsumowania zostaną wyświetlone identyfikator oraz klucz aplikacji. Zapisz je w bezpiecznym miejscu.

Konfiguracja systemu

Konfiguracja integracji

Wartości identyfikatorów oraz klucz należy wprowadzić do systemu.

1. Przejdź do zakładki konfiguracji: Ustawienia->Synchronizacja->OAuth2->Google
2. Wprowadź wymagane dane:
   1. Identyfikator aplikacji => Identyfikator aplikacji (klienta)
   2. Klucz aplikacji => Wartość tajnego klucza
3. Zapisz

Konfiguracja konta pocztowego

1. Zaloguj się jako pracownik z uprawnieniami do tworzenia skrzynek email
2. Przejdź do listy kont pocztowych: Ustawienia->Wiadomości email->Konta pocztowe
3. Utwórz nowe lub edytuj istniejące konto pocztowe
4. Wybierz 'Typ logowania: OAUTH2'
5. Uzupełnij pozostałe dane dostępowe do konta i zapisz zmiany
6. Po zapisie kliknij w przycisk 'Skonfiguruj połączenie z Google'. System otworzy stronę logowania Google
7. Zaloguj się na konto Google i zaakceptuj uprawnienia potrzebne do działania integracji poczty
8. Po akceptacji system przekieruje z powrotem na widok edycji konta pocztowego

Konfiguracja kalendarza

1. Zaloguj się jako pracownik
2. Przejdź do ustawienia swojego konta
3. Kliknij, w przycisk 'Skonfiguruj połączenie'. System otworzy stronę logowania Google
4. Zaloguj się na konto Google i zaakceptuj uprawnienia potrzebne do działania integracji
5. Po akceptacji system przekieruje z powrotem na widok karty pracownika

Wyłącznie dostępu

Na widoku edycji konta pocztowego lub osoby, zalogowanej do konta Google, wyświetla się przycisk 'Rozłącz'. Jego użycie spowoduje wylogowanie użytkownika z systemu Google. Dane nie będą dalej synchronizowane.