Klienci OAuth Google, którzy żądają określonych wrażliwych zakresów OAuth, podlegają weryfikacji przez Google.
Jeśli nie zweryfikujesz klienta OAuth projektu skryptu, użytkownicy spoza Twojej domeny zobaczą ekran niezweryfikowanej aplikacji, gdy spróbują autoryzować skrypt. Niezweryfikowany proces autoryzacji umożliwia tym użytkownikom autoryzowanie niezweryfikowanych aplikacji i korzystanie z nich, ale tylko po potwierdzeniu, że rozumieją związane z tym ryzyko. Łączna liczba niezweryfikowanych użytkowników aplikacji jest również ograniczona.
Więcej informacji można znaleźć w następujących artykułach:
- Niezweryfikowane aplikacje
- Najczęstsze pytania dotyczące weryfikacji aplikacji OAuth
- Usługi interfejsu API Google: zasady dotyczące danych użytkownika
Ta zmiana dotyczy klientów internetowych Google OAuth, w tym tych, których używają wszystkie projekty Apps Script. Przekazując aplikację do weryfikacji w Google, możesz usunąć ekran niezweryfikowanej aplikacji z procesu autoryzacji i zapewnić użytkownikom, że aplikacja nie jest szkodliwa.
Niezweryfikowane aplikacje
W przypadku dodatków, aplikacji internetowych i innych wdrożeń (np. aplikacji korzystających z interfejsu Apps Script API) może być konieczna weryfikacja.
Obowiązywanie
Jeśli aplikacja używa zakresów OAuth wrażliwych, w ramach procesu autoryzacji może się wyświetlić ekran niezweryfikowanej aplikacji. Jej obecność (i wynikający z tego proces autoryzacji niesprawdzonej aplikacji) zależy od tego, z którego konta została opublikowana aplikacja i które konto próbuje z niej korzystać. Na przykład aplikacje opublikowane wewnętrznie w określonej organizacji Google Workspace nie powodują procesu autoryzacji niesprawdzonej aplikacji w przypadku kont w tej domenie, nawet jeśli aplikacja nie została zweryfikowana.
W tabeli poniżej wyjaśniamy, w jakich sytuacjach uruchamia się proces autoryzacji aplikacji bez weryfikacji:
| Klient został zweryfikowany | Wydawca to konto Google Workspace klienta A | Skrypt znajduje się na dysku współdzielonym klienta A. | wydawca jest kontem Gmail, | |
|---|---|---|---|---|
| Użytkownik jest użytkownikiem konta Google Workspace klienta A | Normalny proces uwierzytelniania | Normalny proces uwierzytelniania | Normalny proces uwierzytelniania | Proces uwierzytelniania bez weryfikacji |
| Użytkownik ma konto Google Workspace, które nie należy do klienta A. | Normalny proces uwierzytelniania | Proces uwierzytelniania bez weryfikacji | Proces uwierzytelniania bez weryfikacji | Proces uwierzytelniania bez weryfikacji |
| Użytkownik ma konto Gmail1 | Normalny proces uwierzytelniania | Proces uwierzytelniania bez weryfikacji | Proces uwierzytelniania bez weryfikacji | Proces uwierzytelniania bez weryfikacji |
1 Dowolny adres Gmail, w tym konto użyte do opublikowania aplikacji.
Limit liczby użytkowników
Liczba użytkowników, którzy mogą autoryzować aplikację w ramach procesu niezweryfikowanej aplikacji, jest ograniczona, aby ograniczyć możliwość nadużyć. Więcej informacji znajdziesz w artykule Ograniczenia dotyczące użytkowników aplikacji OAuth.
Prośba o weryfikację
Możesz poprosić o weryfikację klienta OAuth używanego przez Twoją aplikację i powiązanego z nią projektu Cloud Platform (GCP). Gdy aplikacja zostanie zweryfikowana, użytkownicy nie będą już widzieć ekranu niezweryfikowanej aplikacji. Aplikacja nie będzie też już podlegać limitowi użytkowników.
Wymagania
Aby przesłać klienta OAuth do weryfikacji, musisz spełnić te wymagania:
Musisz być właścicielem witryny w domenie. Witryna musi zawierać publicznie dostępne strony z informacjami o aplikacji i polityką prywatności. Musisz też potwierdzić w Google swoje prawo własności do witryny.
Projekt Google Cloud, którego używa Twój projekt skryptu, musi być standardowym projektem Google Cloud, do którego masz uprawnienia do edycji. Jeśli skrypt używa domyślnego projektu Google Cloud, musisz przełączyć się na standardowy projekt Google Cloud.
Dodatkowo musisz mieć te wymagane zasoby:
- Nazwa aplikacji. Nazwa aplikacji wyświetlana na ekranie zgody. Nazwa powinna być taka sama jak nazwa aplikacji w innych miejscach, takich jak lista aplikacji z Google Workspace Marketplace.
- Logo aplikacji. Logo aplikacji w formacie JPEG, PNG lub BMP do użycia na ekranie zgody. Rozmiar pliku nie może przekraczać 1 MB.
- Adres e-mail do zespołu pomocy. Jest to adres e-mail wyświetlany na ekranie zgody, pod którym użytkownicy mogą się skontaktować, jeśli potrzebują pomocy dotyczącej aplikacji. Może to być Twój adres e-mail lub grupa dyskusyjna Google, której jesteś właścicielem lub którą zarządzasz.
- Zakresy. Lista wszystkich zakresów używanych przez Twoją aplikację. Zakresy uprawnień możesz wyświetlić w edytorze Apps Script.
- Autoryzowane domeny. Oto lista domen zawierających informacje o aplikacji. Wszystkie linki do aplikacji (np. do wymaganej strony polityki prywatności) muszą być hostowane w autoryzowanych domenach.
- URL strony głównej aplikacji. Lokalizacja strony głównej opisującej aplikację. Ta lokalizacja musi być hostowana w autoryzowanej domenie.
- Adres URL polityki prywatności aplikacji. Lokalizacja strony z opisem polityki prywatności aplikacji. Ta lokalizacja musi być hostowana w autoryzowanej domenie.
Oprócz wymaganych zasobów wymienionych powyżej możesz opcjonalnie podać adres URL warunków korzystania z aplikacji, który wskazuje na stronę z opisem warunków korzystania z aplikacji. Jeśli została podana, lokalizacja musi znajdować się w autoryzowanej domenie.
Kroki
- Jeśli jeszcze tego nie zrobiono, potwierdź własność wszystkich autoryzowanych domen, które są używane do hostowania polityki prywatności i innych informacji projektu skryptu. Zweryfikowani właściciele domen muszą być edytorami lub właścicielami projektu skryptu.
- W projekcie Apps Script kliknij Informacje ogólne . W sekcji Zakresy OAuth projektu skopiuj zakresy, których używa Twój projekt skryptu.
Wypełnij ekran zgody OAuth w projekcie Google Cloud Twojej aplikacji, używając zebranych zasobów tekstowych i adresów URL.
- Wymień autoryzowane domeny, w których są hostowane informacje o aplikacji (np. polityka prywatności).
Aby dodać zakresy aplikacji, kliknij Dodaj lub usuń zakresy. W wynikającym oknie nastąpi automatyczne wykrywanie zakresów interfejsów API włączonych w konsoli Google Cloud (np. usług zaawansowanych). Możesz wybrać zakresy z tej listy, zaznaczając odpowiednie pola.
Ta lista automatycznie wykrywana nie zawsze zawiera zakresy używane przez wbudowane usługi Apps Script. Musisz je wpisać w sekcji Ręczne dodawanie zakresów.
Gdy skończysz, kliknij Aktualizuj.
Po wpisaniu wszystkich wymaganych informacji kliknij Zapisz.
Aby rozpocząć proces weryfikacji, kliknij Prześlij do weryfikacji.
Większość próśb o weryfikację rozpatrujemy w ciągu 24–72 godzin. Stan weryfikacji możesz sprawdzić u góry formularza zgody OAuth. Gdy weryfikacja klienta OAuth zostanie potwierdzona, Twoja aplikacja zostanie zweryfikowana.