Pro administrátory
← Na rozcestník

Google Workspace: připojení schránek

Připojení účtem schránky (klient organizace), navíc servisní účet pro sdílené schránky — a co nastavit v Google Cloudu a Google Admin, krok za krokem.

Aby asistent mohl číst poštu v Google Workspace a zakládat v ní koncepty, potřebuje přístup přes Gmail API. K tomu si organizace něco založí ve svém Google Cloudu; draften nemá společnou aplikaci, které byste jen udělili souhlas. Platí to pro naši službu i pro instalaci na vlastním serveru.

Všechno tady platí jen pro účty Google Workspace s vlastní doménou. Osobním účtem @gmail.com se do draftenu přihlásit nejde; osobní Gmail ale připojíte přes IMAP s heslem aplikace — viz Podporovaní poskytovatelé a omezení.

Co chcete a co nastavit

Co chceteCo nastavit
Členové se přihlašují účtem Google a každý má vlastní schránkuklient organizace — to stačí
K tomu schránky, ke kterým se nikdo nepřihlašuje (třeba info@), nebo přístup ke schránkám nastavený centrálně, bez jejich vlastníkůnavíc registrace organizace (servisní účet)
Přihlašování účtem Google nechcetelidé se přihlašují heslem z pozvánky, poštu připojí registrace organizace (nebo IMAP)

Dvě různé věci v Googlu

Klient organizace a registrace organizace jsou dvě samostatné věci v Google Cloudu. Každá dělá něco jiného a navzájem se nezastoupí:

Klient organizaceRegistrace organizace
Co to jeOAuth klient s consent screen typu Internalservisní účet s klíčem a domain-wide delegation
Co dělápřihlašování členů tlačítkem Přihlásit přes Google a tlačítko Připojit Gmail u vlastní schránkypřístup asistenta ke schránkám bez přihlášení jejich vlastníků
Kde v draftenuOrganizace → Přihlašování a přístup k poště → karta Přihlášení účtem a připojení schránekOrganizace → Přihlašování a přístup k poště → karta Registrace pro sdílené schránky a centrální správu
Kdo ji v draftenu nastavujevlastník organizacevlastník nebo správce organizace
Kdo ji zakládá v Googlusprávce Google Cloudusprávce Google Cloudu a superadministrátor Google Admin
Kdo se ke schránce přihlašujevlastník každé schránky, jednounikdo
Na které schránky dosáhnejen na ty, které si lidé sami připojína všechny schránky domény

Jsou to záměrně dvě věci. Souhlas s klientem dává práva jen ke schránkám, které si lidé sami připojí — nikdy k poště celé domény. Servisní účet naopak dosáhne na každou schránku domény, a proto ho dostává jen draften pro přístup ke schránkám, ne přihlašování. Nespojujte je.

Každá schránka používá jeden z obou přístupů; obojí můžete mít zároveň. draften žádá jen rozsah gmail.modify — čtení a zakládání konceptů, nic neodesílá.

Klient organizace: přihlášení a Připojit Gmail

Vlastník schránky se přihlásí svým účtem Google a povolí přístup jen ke své poště. Tentýž klient slouží i k přihlašování do draftenu účtem Google.

V Google Cloudu

Pracujete v https://console.cloud.google.com, přihlášení účtem správce vaší domény Workspace. Všechno se odehrává v jednom projektu — vybraný projekt je vidět nahoře vlevo vedle loga Google Cloud; tam ho i přepnete nebo založíte nový. Hlavní nabídku otevřete ikonou ☰ vlevo nahoře.

  1. V draftenu si nejdřív otevřete Organizace → Přihlašování a přístup k poště, kartu Přihlášení účtem a připojení schránek. Ukazuje dvě redirect URI přesně pro vaši adresu draftenu — končí na /auth/google/callback a /mailboxes/connect/google/callback. Zkopírujte je odtud; musí sedět znak po znaku.
  2. Vyberte projekt, nebo založte nový (třeba draften), a zapněte v něm Gmail API: ☰ → APIs & Services → Library, vyhledejte Gmail API, otevřete ji a klikněte na Enable. Přímo: https://console.cloud.google.com/apis/library/gmail.googleapis.com
  3. Nastavte, jak se aplikace představí uživatelům (consent screen): ☰ → APIs & Services → OAuth consent screen. Otevře se stránka Google Auth Platform; přímo: https://console.cloud.google.com/auth/overview (zkontrolujte, že je nahoře vybraný správný projekt). Klikněte na Get started a projděte průvodce:
    • App Information — App name draften a User support email (váš e-mail nebo skupina správců). Next.
    • Audience — zvolte Internal. Přihlásit se pak může jen účet vaší domény Workspace a aplikaci nemusí ověřovat Google. Next.
    • Contact Information — e-mail, na který vám Google pošle upozornění k aplikaci. Next.
    • Finish — zaškrtněte políčko se souhlasem se zásadami Googlu (I agree to the Google API Services: User Data Policy), klikněte na Continue a pak na Create.
  4. Povolte aplikaci rozsahy. V Google Auth Platform v nabídce vlevo otevřete Data Access (přímo: https://console.cloud.google.com/auth/scopes) → Add or remove scopes. V seznamu zaškrtněte openid, .../auth/userinfo.email a .../auth/userinfo.profile. Rozsah pro Gmail vložte do pole Manually add scopes: https://www.googleapis.com/auth/gmail.modify → Add to table. Klikněte na Update a dole na Save.
  5. Vytvořte klienta. V Google Auth Platform v nabídce vlevo otevřete Clients (přímo: https://console.cloud.google.com/auth/clients) → Create client. Application type: Web application, název třeba draften. U Authorized redirect URIs klikněte na Add URI a vložte první adresu z karty, pak znovu Add URI a druhou. Klikněte na Create.
  6. Zobrazí se Client ID a Client secret — zkopírujte si hned obojí. Client secret Google později už znovu neukáže; kdybyste ho ztratili, vytvoříte u klienta nový.

V draftenu

  1. Vlastník organizace otevře Organizace → Přihlašování a přístup k poště, v kartě Přihlášení účtem a připojení schránek vyplní u Google OAuth klient hodnoty Client ID a Client secret z kroku 6 a klikne na Uložit.
  2. Přihlašování účtem Google zapne na téže stránce v kartě Přihlašování členů: do E-mailové domény organizace napíše svou doménu Workspace — primární, ne aliasovou (tu Google při přihlášení neposílá). Jakmile má organizace klienta i doménu, členové se přihlašují účtem Google a jejich hesla přestanou platit — viz Přihlašování členů.
  3. Vlastník schránky otevře stránku schránky a v kartě Přístup k poště v řádku Připojit účtem schránky: klikne na Připojit Gmail. Přihlásí se účtem té schránky — jiný účet draften odmítne — a povolí přístup. Tlačítko vidí jen vlastník schránky, a jen když organizace klienta má; bez něj karta místo tlačítka napíše, že připojení účtem půjde, až vlastník organizace klienta přidá.
  4. Pak Otestovat spojení.

Když se schránka odpojí

Registrace organizace: přístup bez přihlášení

Servisní účet s domain-wide delegation dá asistentovi přístup ke schránkám domény, aniž by se kdokoli přihlašoval. Hodí se pro schránky, ke kterým se nikdo nepřihlašuje (třeba info@), a pro organizace, které chtějí přístup spravovat centrálně. S přihlašováním do draftenu nesouvisí.

V Google Cloudu

Pracujete v https://console.cloud.google.com, ve stejném projektu, kde je zapnuté Gmail API (krok 2 u klienta organizace; bez klienta ho zapněte stejně). Projekt zkontrolujte nahoře vlevo vedle loga Google Cloud.

  1. Otevřete seznam servisních účtů: ☰ → IAM & Admin → Service accounts. Přímo: https://console.cloud.google.com/iam-admin/serviceaccounts
  2. Nahoře klikněte na + Create service account a projděte tři kroky:
    • Service account details — Service account name třeba draften-posta (ID se doplní samo). Klikněte na Create and continue.
    • Permissions (optional) — nic nevybírejte; žádné role v projektu nepotřebuje, přístup k poště mu dá až delegace v Google Admin. Klikněte na Continue.
    • Principals with access (optional) — nic nevyplňujte, klikněte na Done.
  3. V seznamu klikněte na nový servisní účet. Na záložce Details si zkopírujte Unique ID — dlouhé číslo; to je Client ID pro Google Admin.
  4. Záložka Keys → Add key → Create new key → Key type: JSON → Create. Prohlížeč stáhne soubor s klíčem (….json).

Když Google vytvoření klíče odmítne, má vaše organizace zapnutou zásadu Disable service account key creation (iam.disableServiceAccountKeyCreation; nové organizace ji mají ve výchozím stavu). Správce organizace ji pro tento projekt vypne: ☰ → IAM & Admin → Organization policies (https://console.cloud.google.com/iam-admin/orgpolicies), vyhledá iam.disableServiceAccountKeyCreation → Manage policy → Override parent's policy → Enforcement: Off → Set policy. Pak krok 4 zopakujte.

V Google Admin

Potřebujete účet superadministrátora Google Workspace.

  1. Otevřete https://admin.google.com → v nabídce vlevo Security → Access and data control → API controls → dole Domain wide delegation → Manage domain wide delegation. Přímo: https://admin.google.com/ac/owl/domainwidedelegation
  2. Klikněte na Add new a vyplňte:
    • Client ID — číselné Unique ID z kroku 3,
    • OAuth scopes (comma-delimited) — https://www.googleapis.com/auth/gmail.modify.

    Klikněte na Authorize. Delegace se objeví v seznamu. Projeví se obvykle do pár minut, výjimečně až za několik hodin.

V draftenu

  1. Otevřete Organizace → Přihlašování a přístup k poště, kartu Registrace pro sdílené schránky a centrální správu. Registrace spravuje vlastník nebo správce organizace.
  2. Systém: Google Workspace. Vyplňte Název, u Klíč servisního účtu (JSON) vyberte stažený soubor a klikněte na Přidat registraci. Klíč se uloží zašifrovaný; v kartě je pak vidět jen e-mail servisního účtu a jeho Client ID.
  3. Na stránce každé schránky v kartě Přístup k poště vyberte u Registrace organizace tuto registraci, klikněte na Nastavit a pak na Otestovat spojení. Postup se snímky ukazuje návod Přidání a připojení schránky.

Stažený soubor s klíčem pak smažte. Kdo ho má, dostane se do každé schránky domény. Nový klíč téhož servisního účtu (krok 4 výše) nahrajete u registrace volbou nový klíč (JSON); klíč jiného servisního účtu přidejte jako novou registraci. Starý klíč pak v Google Cloudu smažte: servisní účet → záložka Keys → ikona koše u starého klíče.

Se zapnutou automatickou schránkou (Přihlašování členů) se nová schránka na registraci naváže sama, když je pro Google Workspace právě jedna aktivní.

Chyby testu spojení

Test ověří tři kroky: Přístup, Token a oprávnění a Čtení Inboxu.

V hlášceCo to znamenáCo udělat
delegace pro rozsah není povolená (unauthorized_client)v Google Admin chybí domain-wide delegation, nebo má jiné Client ID či rozsahzkontrolovat delegaci v Google Admin: číselné ID a přesný rozsah gmail.modify
invalid_grant u servisního účtutaková schránka v doméně Workspace nenízkontrolovat adresu schránky
„Gmail API has not been used…“v projektu není zapnuté Gmail APIzapnout Gmail API
token bez gmail.modifydelegace nebo consent screen nemá rozsah gmail.modifydoplnit rozsah
invalid_grant, deleted_client u připojeného účtupřipojení bylo odvoláno nebo klient smazánZnovu připojit Gmail

Další chyby popisuje Řešení potíží.

Textová verze