Z tego przewodnika dowiesz się, jak zadbać o bezpieczeństwo aplikacji i danych logowania użytkowników.
Przeprowadzanie weryfikacji aplikacji OAuth
Zakres protokołu OAuth 2.0 dla interfejsu Google Ads API jest klasyfikowany jako zakres ograniczony, co oznacza, że przed wprowadzeniem aplikacji do środowiska produkcyjnego musisz przejść proces weryfikacji aplikacji OAuth. Więcej informacji znajdziesz w dokumentacji Google Identity, artykule w Centrum pomocy na temat niezweryfikowanych aplikacji oraz dokumentacji dotyczącej konfigurowania ekranu zgody OAuth.
Zabezpieczanie danych logowania aplikacji
Zabezpiecz identyfikator klienta OAuth 2.0 i tajny klucz klienta aplikacji. Te dane uwierzytelniające pomagają użytkownikom i Google zidentyfikować Twoją aplikację, dlatego należy obchodzić się z nimi ostrożnie. Dane logowania do aplikacji należy traktować jak hasła. Nie udostępniaj ich za pomocą niezabezpieczonych mechanizmów, takich jak publikowanie na forach publicznych, wysyłanie plików konfiguracji zawierających te dane uwierzytelniające w załącznikach do e-maili, kodowanie danych uwierzytelniających na stałe lub zatwierdzanie ich w repozytorium kodu. Zalecamy, aby w miarę możliwości używać menedżera obiektów tajnych, takiego jak Google Cloud Secret Manager lub AWS Secrets Manager.
Jeśli Twoje tajne klucze klienta OAuth 2.0 zostaną przejęte, możesz je zresetować.
Zabezpieczanie kont usługi
Jeśli używasz kont usługi, zabezpiecz je w ten sposób:
Klucz konta usługi i plik JSON traktuj jak hasła. W miarę możliwości zabezpieczaj je za pomocą menedżera obiektów tajnych, takiego jak Google Cloud Secret Manager lub AWS Secrets Manager.
Postępuj zgodnie z dodatkowymi sprawdzonymi metodami Google Cloud, aby zabezpieczyć konta usługi i nimi zarządzać.
Zabezpieczanie tokenów użytkowników
Jeśli Twoja aplikacja autoryzuje wielu użytkowników, musisz podjąć dodatkowe kroki, aby chronić tokeny odświeżania i tokeny dostępu użytkowników. Przechowuj tokeny bezpiecznie w stanie spoczynku i nigdy nie przesyłaj ich w postaci zwykłego tekstu. Używaj bezpiecznego systemu pamięci masowej odpowiedniego dla Twojej platformy.
Obsługa unieważnienia i wygaśnięcia tokena odświeżania
Jeśli aplikacja żąda tokena odświeżania OAuth 2.0 w ramach autoryzacji, musisz też obsłużyć jego unieważnienie lub wygaśnięcie. Tokeny odświeżania mogą zostać unieważnione z różnych powodów. Twoja aplikacja powinna odpowiednio zareagować, ponownie autoryzując użytkownika podczas następnej sesji logowania lub odpowiednio czyszcząc jego dane. Zadania offline, takie jak zadania cron, powinny wykrywać i rejestrować konta, których tokeny odświeżania wygasły, zamiast wysyłać kolejne nieudane żądania. Google może ograniczać aplikacje, które przez dłuższy czas generują dużą liczbę błędów, aby utrzymać stabilność serwerów interfejsu API.
Zarządzanie zgodą na dostęp do wielu zakresów
Jeśli Twoja aplikacja prosi o autoryzację w przypadku wielu zakresów OAuth 2.0, użytkownik może nie przyznać wszystkich żądanych zakresów OAuth. Aplikacja powinna obsługiwać odmowę dostępu do zakresów przez wyłączenie odpowiednich funkcji. Możesz ponownie poprosić użytkownika o przyznanie dostępu dopiero wtedy, gdy wyraźnie wskaże on, że chce użyć konkretnej funkcji, która wymaga danego zakresu. W takich przypadkach użyj autoryzacji przyrostowej, aby poprosić o odpowiednie zakresy OAuth.
Jeśli podstawowe funkcje aplikacji wymagają wielu zakresów, wyjaśnij to użytkownikowi, zanim poprosisz go o zgodę.