Zum Inhalt springen

Gmail einrichten

Die Gmail-Integration von Intric verwendet Google OAuth 2.0 mit dem Bereich https://www.googleapis.com/auth/gmail.readonly, um im Namen angemeldeter Nutzer auf Gmail-Daten zuzugreifen. Google stuft diesen Bereich als sensibel ein, was bedeutet:

  • Admin-Genehmigung in Google Workspace kann erforderlich sein: Organisationen, die den Drittanbieter-App-Zugriff einschränken, müssen der Intric-App explizit vertrauen, bevor Nutzer sich verbinden können
  • Persönliche Google-Konten sind nicht betroffen: Nutzer mit persönlichen Google-Konten (außerhalb von Google Workspace) können sich direkt ohne Administratoraktion verbinden
  • Nur delegierter Zugriff: Intric handelt immer im Namen des angemeldeten Nutzers und kann nur auf das Postfach dieses Nutzers zugreifen

Die gesamte Konfiguration erfolgt in der Google Workspace Admin-Konsole (https://admin.google.com). Du musst Super-Administrator sein oder die Rolle Dienste-Administrator haben, um diese Schritte durchzuführen.

Hast Du bereits die Google Calendar-Integration eingerichtet? Die Intric-App ist wahrscheinlich bereits in deinen Google Workspace API-Steuerelementen hinzugefügt. Prüfe, ob sie bereits als vertrauenswürdig eingestuft ist, bevor Du Schritt 1 wiederholst — wenn die App bereits vertrauenswürdig ist, ist nur Schritt 2 erforderlich.

Schritt 1: Intric als vertrauenswürdige App in Google Workspace hinzufügen

Abschnitt betitelt „Schritt 1: Intric als vertrauenswürdige App in Google Workspace hinzufügen“
  1. Gehe zu https://admin.google.com und melde dich als Administrator an
  2. Navigiere zu SicherheitZugriff und DatenkontrolleAPI-Steuerungen
  3. Klicke auf Drittanbieter-App-Zugriff verwalten
  4. Klicke auf App hinzufügenOAuth-App-Name oder Client-ID
  5. Suche nach Intric oder gib die Intric OAuth-Client-ID ein:
FeldWert
OAuth-Client-ID(Kontaktiere den Intric-Support für die Client-ID deines Deployments)
App-NameIntric
  1. Wähle die App aus den Ergebnissen aus und klicke auf Auswählen
  2. Wähle, für welche Organisationseinheiten die App vertrauenswürdig sein soll (oder wähle alle Nutzer)
  3. Setze die Zugriffsebene auf Vertrauenswürdig und bestätige

Nach dem Speichern können Nutzer in den ausgewählten Organisationseinheiten ihre Gmail-Konten über Meine Integrationen in Intric verbinden.

Sobald das Google Workspace-Vertrauen eingerichtet ist:

  1. Navigiere zu Admin im Hauptmenü
  2. Gehe zu Integrationen im Adminbereich
  3. Suche und wähle Gmail aus der Liste der verfügbaren Integrationen
  4. Bestätige, dass die Integration aktiviert ist

Nutzer können dann ihre Google-Konten individuell über Meine Integrationen verbinden.

So entfernst Du das Vertrauen für alle Nutzer (verhindert, dass alle Nutzer in der Domain sich verbinden):

  1. Gehe zu https://admin.google.comSicherheitZugriff und DatenkontrolleAPI-Steuerungen
  2. Finde die Intric-App unter Drittanbieter-App-Zugriff
  3. Klicke auf die App und ändere die Vertrauensstufe auf Blockiert oder entferne sie vollständig

Nutzer, die ihre Google-Konten bereits verbunden haben, verlieren sofort den Zugriff.

So widerrufst Du den Zugriff eines einzelnen Nutzers: Der Nutzer kann die Verbindung über Meine Integrationen trennen. Ein Administrator kann das Token auch über die Google Workspace Admin-Konsole widerrufen: Nutzer → Nutzer auswählen → SicherheitVerbundene Anwendungen → Intric entfernen.

Für den Endbenutzer-Leitfaden siehe Gmail.