#Konfiguracja Google

This feature is provided by the commercial plugin «Menedżer poczty e-mail», please purchase to use

#Wymagania wstępne

Aby umożliwić użytkownikom podłączenie ich kont Google Mail do NocoBase, należy wdrożyć system na serwerze, który ma dostęp do usług Google. Zaplecze NocoBase będzie bowiem korzystać z interfejsu Google API.

#Rejestracja konta

1. Proszę otworzyć https://console.cloud.google.com/welcome, aby przejść do Google Cloud.
2. Przy pierwszym wejściu należy zaakceptować odpowiednie warunki i zasady.

#Tworzenie aplikacji

1. Proszę kliknąć "Select a project" (Wybierz projekt) u góry strony.

2. Proszę kliknąć przycisk "NEW PROJECT" (Nowy projekt) w wyskakującym okienku.

3. Proszę uzupełnić informacje o projekcie.

4. Po utworzeniu projektu proszę go wybrać.

#Włączanie interfejsu Gmail API

1. Proszę kliknąć przycisk "APIs & Services" (Interfejsy API i usługi).

2. Proszę przejść do panelu "APIs & Services" (Interfejsy API i usługi).

3. Proszę wyszukać "mail".

4. Proszę kliknąć przycisk "ENABLE" (Włącz), aby włączyć interfejs Gmail API.

#Konfiguracja ekranu zgody OAuth

1. Proszę kliknąć menu "OAuth consent screen" (Ekran zgody OAuth) po lewej stronie.

2. Proszę wybrać "External" (Zewnętrzny).

3. Proszę uzupełnić informacje o projekcie (będą one wyświetlane na stronie autoryzacji) i kliknąć Zapisz.

4. Proszę uzupełnić dane kontaktowe dewelopera (Developer contact information) i kliknąć Kontynuuj.

5. Proszę kliknąć Kontynuuj.

6. Proszę dodać użytkowników testowych do testowania przed opublikowaniem aplikacji.

7. Proszę kliknąć Kontynuuj.

8. Proszę przejrzeć podsumowanie informacji i wrócić do panelu kontrolnego.

#Tworzenie danych uwierzytelniających

1. Proszę kliknąć menu "Credentials" (Dane uwierzytelniające) po lewej stronie.

2. Proszę kliknąć przycisk "CREATE CREDENTIALS" (Utwórz dane uwierzytelniające) i wybrać "OAuth client ID" (Identyfikator klienta OAuth).

3. Proszę wybrać "Web application" (Aplikacja internetowa).

4. Proszę uzupełnić informacje o aplikacji.

5. Proszę wprowadzić ostateczną domenę wdrożenia projektu (przykładem jest tutaj adres testowy NocoBase).

6. Proszę dodać autoryzowany adres URL przekierowania. Musi to być domena + "/admin/settings/mail/oauth2". Przykład: https://pr-1-mail.test.nocobase.com/admin/settings/mail/oauth2

7. Proszę kliknąć Utwórz, aby wyświetlić informacje OAuth.

8. Proszę skopiować Client ID i Client secret, a następnie wkleić je na stronie konfiguracji poczty e-mail.

9. Proszę kliknąć Zapisz, aby zakończyć konfigurację.

#Publikowanie aplikacji

Po zakończeniu powyższego procesu oraz przetestowaniu funkcji takich jak autoryzacja użytkownika testowego i wysyłanie wiadomości e-mail, mogą Państwo opublikować aplikację.

1. Proszę kliknąć menu "OAuth consent screen" (Ekran zgody OAuth).

2. Proszę kliknąć przycisk "EDIT APP" (Edytuj aplikację), a następnie przycisk "SAVE AND CONTINUE" (Zapisz i kontynuuj) na dole strony.

3. Proszę kliknąć przycisk "ADD OR REMOVE SCOPES" (Dodaj lub usuń zakresy), aby wybrać zakresy uprawnień użytkownika.

4. Proszę wyszukać "Gmail API", a następnie zaznaczyć "Gmail API" (proszę upewnić się, że wartość zakresu to Gmail API z "https://mail.google.com/").

5. Proszę kliknąć przycisk "UPDATE" (Aktualizuj) na dole strony, aby zapisać zmiany.

6. Proszę kliknąć przycisk "SAVE AND CONTINUE" (Zapisz i kontynuuj) na dole każdej strony, a na koniec przycisk "BACK TO DASHBOARD" (Wróć do panelu kontrolnego), aby powrócić do panelu kontrolnego.

7. Proszę kliknąć przycisk "PUBLISH APP" (Opublikuj aplikację). Pojawi się strona potwierdzenia, zawierająca listę wymaganych informacji do publikacji. Następnie proszę kliknąć przycisk "CONFIRM" (Potwierdź).

8. Po powrocie do strony konsoli zobaczą Państwo status publikacji jako "In production" (W produkcji).

9. Proszę kliknąć przycisk "PREPARE FOR VERIFICATION" (Przygotuj do weryfikacji), uzupełnić wymagane informacje i kliknąć przycisk "SAVE AND CONTINUE" (Zapisz i kontynuuj) (dane na obrazku służą wyłącznie celom demonstracyjnym).

10. Proszę kontynuować uzupełnianie niezbędnych informacji (dane na obrazku służą wyłącznie celom demonstracyjnym).

11. Proszę kliknąć przycisk "SAVE AND CONTINUE" (Zapisz i kontynuuj).

12. Proszę kliknąć przycisk "SUBMIT FOR VERIFICATION" (Prześlij do weryfikacji), aby przesłać aplikację do weryfikacji.

13. Proszę poczekać na wynik zatwierdzenia.

14. Jeśli zatwierdzenie jest nadal w toku, użytkownicy mogą kliknąć niebezpieczny link, aby autoryzować i zalogować się.