AnyLawyerDokumentacja
Strona głównaPrzejdź do AnyLawyer

Przewodnik administratora: konfiguracja integracji Google Drive

Ten przewodnik krok po kroku pokazuje, jak administrator organizacji włącza integrację Google Drive w AnyLawyer. Większość pracy odbywa się po stronie Google Cloud Console — tam tworzysz poświadczenia OAuth, które następnie wklejasz w AnyLawyer. Całość zajmuje około 15 minut i wykonujesz ją tylko raz dla całej organizacji.

Jak to działa?

Każda organizacja korzysta z własnych poświadczeń Google OAuth. Oznacza to, że:

  • to Ty (organizacja) kontrolujesz aplikację, której użytkownicy udzielają dostępu,
  • na ekranie zgody Google użytkownicy zobaczą nazwę Waszej aplikacji,
  • AnyLawyer prosi wyłącznie o dostęp tylko do odczytu (drive.readonly) — nigdy nie modyfikuje plików na Dysku.

Po jednorazowej konfiguracji przez administratora każdy użytkownik łączy swoje konto Google samodzielnie, jednym kliknięciem.

Czego potrzebujesz?

  • Roli Administratora w organizacji AnyLawyer.
  • Konta Google z dostępem do Google Cloud Console. Jeśli Wasza firma korzysta z Google Workspace, użyj konta firmowego — pozwoli to ustawić aplikację jako „Internal" i uniknąć weryfikacji aplikacji przez Google (patrz Krok 4).

Nie widzisz pozycji „Google Drive" w panelu Administracja? Funkcja Google Drive musi być najpierw włączona dla Twojej organizacji przez zespół AnyLawyer. Skontaktuj się z nami.

Krok 1: Otwórz stronę konfiguracji w AnyLawyer i skopiuj Redirect URI

  1. Zaloguj się do AnyLawyer jako administrator.
  2. W menu bocznym kliknij Administracja, a następnie w sekcji Integracje wybierz Google Drive (w wersji angielskiej interfejsu: Admin Tools → Integrations → Google Drive).
  3. Na stronie zobaczysz ramkę z adresem Redirect URI, np. https://anylawyer.com/api/google-drive/callback.
  4. Skopiuj ten adres — będzie potrzebny w Kroku 5. Musi zostać wklejony w Google Cloud Console znak w znak (protokół https://, domena, ścieżka, bez ukośnika na końcu).

Strona konfiguracji Google OAuth w AnyLawyer

Krok 2: Utwórz projekt w Google Cloud Console

  1. Otwórz console.cloud.google.com/projectcreate.
  2. W polu Project name wpisz np. AnyLawyer Integration.
  3. Jeśli korzystasz z Google Workspace, w polu Organization wybierz swoją organizację.
  4. Kliknij Create i poczekaj kilkanaście sekund, aż projekt się utworzy.
  5. Upewnij się, że nowy projekt jest wybrany — jego nazwa powinna być widoczna na górnym pasku konsoli, obok logo Google Cloud.

Krok 3: Włącz Google Drive API

  1. Otwórz console.cloud.google.com/apis/library/drive.googleapis.com (lub w menu: APIs & Services → Library i wyszukaj „Google Drive API").
  2. Upewnij się, że na górnym pasku wybrany jest Twój nowy projekt.
  3. Kliknij niebieski przycisk Enable.

Krok 4: Skonfiguruj ekran zgody OAuth

Ekran zgody to okno, które użytkownicy zobaczą przy łączeniu konta Google („Aplikacja X prosi o dostęp do…").

  1. W menu konsoli przejdź do APIs & Services → OAuth consent screen (w nowszej wersji konsoli sekcja nazywa się Google Auth Platform; przy pierwszym wejściu kliknij Get started).
  2. Wpisz nazwę aplikacji, np. AnyLawyer, oraz adres e-mail wsparcia (Twój adres).
  3. Wybierz typ odbiorców (Audience / User Type):
    • Internal — zalecane, dostępne tylko w Google Workspace. Z aplikacji mogą korzystać wyłącznie osoby z Waszej domeny i Google nie wymaga weryfikacji aplikacji.
    • External — jedyna opcja dla zwykłych kont Gmail. Uwaga: zakres drive.readonly jest przez Google traktowany jako wrażliwy, więc aplikacja External w trybie produkcyjnym wymaga procesu weryfikacji. W trybie testowym („Testing") możesz dodać do 100 adresów jako „Test users" — tylko te osoby będą mogły połączyć Dysk.
  4. Zaakceptuj politykę i kliknij Create / Save and continue.

W skrócie: macie Google Workspace → wybierz Internal i nie martw się weryfikacją. Nie macie → wybierz External i dodaj wszystkich pracowników jako test users.

Krok 5: Utwórz identyfikator klienta OAuth (Client ID i Client Secret)

  1. Przejdź do APIs & Services → Credentials (console.cloud.google.com/apis/credentials).
  2. Kliknij + Create credentials → OAuth client ID.
  3. W polu Application type wybierz Web application.
  4. W polu Name wpisz np. AnyLawyer Web.
  5. W sekcji Authorized redirect URIs kliknij + Add URI i wklej adres skopiowany w Kroku 1, np.: 
    https://anylawyer.com/api/google-drive/callback
    ⚠️ Adres musi być identyczny co do znaku — najczęstszy błąd na tym etapie to literówka lub dodatkowy ukośnik na końcu.
  6. Kliknij Create.
  7. Wyświetli się okno z dwoma wartościami:
    • Client ID — długi ciąg zakończony na .apps.googleusercontent.com,
    • Client Secret — krótszy ciąg zaczynający się zwykle od GOCSPX-.
  8. Skopiuj obie wartości (możesz też pobrać plik JSON). Client Secret traktuj jak hasło — nie wysyłaj go e-mailem ani na czacie.

Krok 6: Wklej poświadczenia w AnyLawyer

  1. Wróć do AnyLawyer: Administracja → Integracje → Google Drive.
  2. W polu Google OAuth Client ID wklej Client ID z Kroku 5.
  3. W polu Google OAuth Client Secret wklej Client Secret.
  4. Kliknij Zapisz ustawienia OAuth.
  5. Status obok tytułu strony powinien zmienić się na zielony: „Google OAuth skonfigurowane".

Zapisane poświadczenia Google OAuth w AnyLawyer

Krok 7: Sprawdź, czy działa

  1. Otwórz dowolny projekt w AnyLawyer.
  2. W panelu bocznym projektu znajdź sekcję Google Drive i kliknij Połącz.
  3. Zostaniesz przekierowany na stronę Google — wybierz konto i kliknij Zezwól / Allow.
  4. Po powrocie do AnyLawyer przy integracji pojawi się zielony wskaźnik połączenia.

Od tej chwili każdy użytkownik w organizacji może połączyć własne konto Google w ten sam sposób. Szczegóły pracy z plikami opisuje przewodnik Integracje chmurowe.

Rozwiązywanie problemów

Błąd redirect_uri_mismatch po kliknięciu „Połącz". Redirect URI w Google Cloud Console nie jest identyczny z tym pokazanym w AnyLawyer. Wejdź w Credentials → Twój klient OAuth i porównaj adresy znak po znaku (protokół https://, pełna ścieżka /api/google-drive/callback, brak ukośnika na końcu). Po poprawce odczekaj kilka minut — Google propaguje zmiany z opóźnieniem.

Błąd invalid_client. Client ID lub Client Secret zostały wklejone z błędem (np. ze spacją na końcu). Wklej je ponownie w AnyLawyer i zapisz.

Komunikat „Google hasn't verified this app" / „Aplikacja niezweryfikowana". Aplikacja jest w trybie External + Testing. Dodaj użytkownika jako „Test user" na ekranie zgody OAuth albo — jeśli macie Google Workspace — przełącz aplikację na Internal.

Błąd access_denied z informacją o administratorze Workspace. Administrator Google Workspace zablokował aplikacje firm trzecich. W konsoli administracyjnej Google (admin.google.com) należy zezwolić na dostęp dla utworzonego Client ID (Security → API controls → App access control).

Zmieniłem Client ID/Secret, a użytkownicy widzą błędy. Po każdej zmianie poświadczeń użytkownicy muszą kliknąć Rozłącz i połączyć konto ponownie.

Bezpieczeństwo

  • AnyLawyer prosi wyłącznie o zakres tylko do odczytu (https://www.googleapis.com/auth/drive.readonly) — nie może niczego zmienić ani usunąć na Dysku.
  • Tokeny dostępu są przechowywane w zaszyfrowanej bazie, oddzielnie dla każdego użytkownika.
  • Pliki z Dysku nie są synchronizowane ani indeksowane — są odczytywane na żądanie w momencie zadania pytania. W pamięci podręcznej zapisywane są tylko pliki PDF otwarte w podglądzie lub odczytane przez AI za pomocą OCR, a użytkownik otrzymuje taki plik dopiero wtedy, gdy jego własne połączenie z Dyskiem potwierdzi dostęp do pliku (szczegóły).
  • Użytkownik może w każdej chwili kliknąć Rozłącz, co usuwa jego tokeny.