Zum Hauptinhalt gehen
Anmelden
English (United States) Español Français Italiano

GSuite APIs & Services registration

GSuite bietet eine Integration über oAuth-2 APIs. Diese Anleitung beschreibt die Schritte, die erforderlich sind, um Ihrem Libraesva Email Security Gateway Berechtigungen für Ihren Gsuite Tenant zu erteilen. Am GSuite Tenant selbst werden durch das Libraesva Email Security Gateway keine Änderungen vorgenommen.

GSuite Tenant vorbereiten

  1. Öffnen Sie die Google Developer Console (https://console.developers.google.com/) und melden Sie sich mit Ihren GSuite-Zugangsdaten an
  2. Wählen Sie im Dropdown-Menü Ihre Organisation aus und klicken Sie dann auf CREATE a PROJECT
  3. Erstellen Sie ein neues Projekt mit dem Namen Libraesva ESG S
  4. Wählen Sie das soeben erstellte Projekt aus
  5. Aktivieren Sie die Admin SDK API
    1. Suchen Sie über die obere Suchleiste nach „Admin SDK API“
    2. Klicken Sie auf das erste Ergebnis „Admin SDK API“
    3. Aktivieren Sie sie
  6. Aktivieren Sie die Gmail API, wenn Sie die Threat Remediation nutzen möchten
    1. Suchen Sie über die obere Suchleiste nach „Gmail API“
    2. Klicken Sie auf das erste Ergebnis „Gmail API“
    3. Aktivieren Sie sie
  7. Aktivieren Sie den „OAuth consent screen“
    1. Gehen Sie im Navigationsmenü zu API and Services -> OAuth consent screen
    2. Wählen Sie den Benutzertyp „Internal“ und klicken Sie auf „Create“
    3. Geben Sie den Anwendungsnamen ein und nennen Sie ihn „Libraesva ESG“
    4. Geben Sie eine „User support email“ und die „Developer contact information“ an
    5. Klicken Sie auf Save & Continue
    6. Geben Sie keine Scopes an und klicken Sie erneut auf „Save & Continue“
    7. Klicken Sie auf BACK TO DASHBOARD

OAuth2 Client ID und Secret

  1. Gehen Sie zum Menü „APIs and Services -> Credentials“
  2. Wählen Sie „Create Credentials“ -> „OAuth Client ID“
  3. Wählen Sie als Typ „Web application“
  4. Nennen Sie es „Libraesva ESG Authentication“
  5. Fügen Sie HTTPS://<esg public fqdn>/oauth-login als „Authorized redirect URI“ hinzu und klicken Sie auf Create
  6. Notieren Sie sich die Client ID und das Client Secret

Service Account

×Schritt 3 wird auch auf dieser offiziellen Google-Dokumentationsseite beschrieben: https://developers.google.com/admin-sdk/directory/v1/guides/delegation
  1. Erstellen Sie einen neuen Service Account
    1. Gehen Sie im Navigation Menu zu IAM & Admin – Service Accounts
    2. Klicken Sie auf Create Service Account
    3. Nennen Sie ihn libraesvaesg
    4. Fahren Sie mit den Standardeinstellungen fort und speichern Sie
    5. Notieren Sie sich die Service Account Email
  2. Beschaffen Sie einen Key für den Service Account
    1. Klicken Sie auf den oben erstellten „Service Account“
    2. Notieren Sie sich die Unique Id
    3. Wählen Sie „ADD KEY“ -> „Create new key“
    4. Wählen Sie den Typ „JSON“
    5. Generieren Sie den JSON-Key und laden Sie ihn herunter
    6. Öffnen Sie die JSON-Datei mit einem Texteditor und notieren Sie sich den private_key innerhalb der Anführungszeichen
  3. Erlauben Sie dem Service Account den Zugriff auf Ihr Directory
    1. Gehen Sie zu Ihrer GSuite Administration Console (https://admin.google.com/)
    2. Klicken Sie auf „Security -> Access and data control->API Controls ->Manage Domain Wide Delegation“
    3. Fügen Sie über „Add New“ einen Eintrag hinzu
    4. Tragen Sie im Feld „Client ID“ die zuvor kopierte Unique Id ein
    5. Kopieren Sie den folgenden Text und fügen Sie ihn in das Feld „Oauth Scopes“ ein https://www.googleapis.com/auth/admin.directory.user,https://www.googleapis.com/auth/admin.directory.group
    6. Geben Sie auch den Scope https://mail.google.com/ an, um die für die Threat Remediation erforderlichen Berechtigungen zu erteilen
    7. Klicken Sie auf Authorize

G Suite Tenant ID

Sie finden Ihre Organization Id, indem Sie diese Seite aufrufen: https://play.google.com/work/adminsettings?pli=1 (Sie finden sie auch in der Admin Console; siehe hierzu die folgende Anleitung https://krypted.com/uncategorized/get-your-customerid-from-g-suite/ )

Einstellungen für Threat Remediation

×HINWEIS: Folgen Sie dieser Anleitung, wenn Sie bereits einen G Suite Connector erstellt haben und lediglich die für die Threat Remediation benötigte Berechtigung hinzufügen möchten
  1. Aktivieren Sie die Gmail API
    1. Öffnen Sie die Google Developer Console (https://console.developers.google.com/) und melden Sie sich mit Ihren GSuite-Zugangsdaten an
    2. Wählen Sie im Dropdown-Menü das für den G Suite Connector erstellte Projekt aus
    3. Suchen Sie über die obere Suchleiste nach „Gmail API“
    4. Klicken Sie auf das erste Ergebnis „Gmail API“
    5. Aktivieren Sie sie
  2. Fügen Sie den für den E-Mail-Rückruf benötigten Scope hinzu
    1. Gehen Sie zu Ihrer GSuite Administration Console (https://admin.google.com/)
    2. Klicken Sie auf „Security -> API Controls -> Manage Domain Wide Delegation“
    3. Suchen Sie den bereits erstellten Service Account anhand der „Client ID“ und klicken Sie auf Edit
    4. Fügen Sie den Scope https://mail.google.com/ hinzu
    5. Klicken Sie auf Authorize

Verwandte Beiträge