Gmail-Authentifizierung

Voraussetzungen

Je nach ausgewähltem Authentifizierungstyp benötigen Sie eine der folgenden Anmeldeinformationen:

• OAuth 2.0-Autorisierungscode: Ihre Google-E-Mail-Adresse und das Passwort, das Ihrem Google-Konto zugeordnet ist.
• Nutzen Sie Ihre eigene OAuth 2.0-App: Die Client-ID, der geheime Clientschlüssel und die Scopes Ihrer Anwendung.
• Dienstkonto: Dienstkontoschlüssel, Konto-E-Mail.

Wenn Ihr Konto nicht von Google aktiviert ist:

• Wenden Sie sich an Ihren Administrator, um Genehmigungen zum Erstellen von Verbindungen zu erhalten.
• Aktivieren Sie die Berechtigung, indem Sie die verfügbaren Optionen zum Erstellen einer Verbindung überprüfen.

Hinweis:

Weitere Informationen zu den verschiedenen Authentifizierungstypen finden Sie im Handbuch zum Herstellen einer Verbindung mit Google Workspace 365-Aktivitäten .

Weitere Informationen zu Gmail finden Sie auf der Website mit der Gmail-Dokumentation .

Scopes

Der Connector fordert die folgenden Berechtigungen/Scopes an:

• Standard-Scopes der öffentlichen UiPath-App: openid, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile, https://mail.google.com/, https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/gmail.settings.basic.
• Standard-Scopes für Google Dienstkonto: openid, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile, https://mail.google.com/, https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/gmail.settings.basic.
• Nutzen Sie Ihre eigene OAuth 2.0-App:
  • Obligatorische Scopes: openid, https://www.googleapis.com/auth/userinfo.email, https://mail.google.com/
  • Mindest-Scopes für das Erstellen einer Verbindung: openid, https://www.googleapis.com/auth/gmail.readonly.
  • Mindestliste der Scopes, die für Gmail-Trigger erforderlich sind:
    • openid, https://www.googleapis.com/auth/gmail.readonly – für Ereignisse für Postfächer.
    • openid, https://www.googleapis.com/auth/calendar.readonly – Für Ereignisse in Kalendern.

Hinweis:

Wenn Sie sich mit Bring your own OAuth 2.0-App authentifizieren, profitieren Sie standardmäßig von den Scopes, die bei der App-Erstellung konfiguriert wurden. Wenn Sie die Standard-App-Berechtigungen verwenden möchten, können Sie einen common -Scope deklarieren. Das bedeutet, dass Sie nur die Berechtigungen verwenden, die für diese Anwendung konfiguriert sind. Sie können auch zusätzliche Scopes bei der Verbindungserstellung mit dem Feld Scopes deklarieren. Sie werden dann bei der Anmeldung aufgefordert, die zusätzliche Zustimmung zu erteilen.

Durch das Herstellen einer Verbindung können UiPath-Produkte in Ihrem Namen mit Gmail-Daten interagieren. Dies kann das Lesen, Schreiben, Ändern und Löschen von Daten umfassen, je nach Ihren Gmail-Berechtigungen. Sie können jeden Zugriff in Ihrem Google-Konto jederzeit entfernen.

Einrichten eines Google Cloud-Projekts

Hinweis:

Dieser Abschnitt gilt nur, wenn Sie den Authentifizierungstyp Bring your own OAuth 2.0 für die App verwenden. Wenn Sie den OAuth 2.0-Autorisierungscode verwenden, fahren Sie mit Die Gmail-Verbindung hinzufügen fort.

Bevor Sie eine Verbindung mit Bring your own OAuth 2.0 app erstellen, konfigurieren Sie ein Google Cloud-Projekt, um die OAuth-Kommunikation mit Gmail zu autorisieren.

1. Wechseln Sie zur Google Cloud Console und erstellen Sie ein Projekt oder wählen Sie ein vorhandenes aus. Geben Sie die grundlegenden Projektdetails ein und wählen Sie Speichern und Fortfahren aus.
2. Wählen Sie im Navigationsmenü APIs und Dienste und dann Bibliothek aus.
3. Suchen Sie nach Gmail-API und wählen Sie dann Aktivieren aus.
4. Wählen Sie Anmeldeinformationen aus, dann + Anmeldeinformationen erstellen und dann OAuth-Client-ID.
5. Wählen Sie unter Anwendungstyp die Option Webanwendung aus und geben Sie einen Namen ein.
6. Fügen Sie unter Autorisierte Umleitungs-URIs https://{baseURL}/provisioning_/callback hinzu und wählen Sie dann Erstellen aus.
7. Speichern Sie die Client-ID und den geheimen Clientschlüssel an einem sicheren Ort.
8. Wählen Sie OAuth-Zustimmungsbildschirm aus und konfigurieren Sie die App-Einstellungen. Ob die App intern oder extern ist, hängt von der Sicherheitsrichtlinie Ihrer Organisation ab.
9. Wählen Sie App bearbeiten aus, gehen Sie zum Abschnitt Scopes und wählen Sie dann Scopes hinzufügen oder entfernen aus.
10. Suchen Sie nach E-Mail und wählen Sie die entsprechenden Gmail API-Scopes aus. Den mindestens erforderlichen Satz finden Sie im Abschnitt „Scopes“ . Wenn Sie Scopes für zusätzliche APIs hinzufügen, wie z. B. Google Drive, stellen Sie sicher, dass diese mit den Richtlinien Ihres Unternehmens übereinstimmen.
11. Speichern Sie Ihre Änderungen. Wenn Ihre App extern ist, können Sie optional Testbenutzer im Schritt Testbenutzer hinzufügen, bevor Sie zum Projekt-Dashboard zurückkehren.

Ihre Client-ID und Ihr geheimer Clientschlüssel können jetzt beim Erstellen der Gmail-Verbindung im Integration Service verwendet werden.

Hinweis:

Informationen zum Verwalten von API-Zugriffsbeschränkungen oder App-Berechtigungen auf Organisationsebene finden Sie in der Dokumentation zu Drittanbietern und benutzerdefinierten Apps von Google.

Fügen Sie die Gmail-Verbindung hinzu

1. Wählen Sie Orchestrator im Produktstartprogramm aus.

2. Wählen Sie einen Ordner aus und navigieren Sie dann zur Registerkarte Verbindungen .

3. Wählen Sie Verbindung hinzufügen aus.

4. Um die Seite zur Erstellung der Verbindung zu öffnen, wählen Sie den Konnektor in der Liste aus. Sie können die Suchleiste verwenden, um den Connector zu finden.

5. Wählen Sie Ihren bevorzugten Authentifizierungstyp aus.

   Wenn Sie Mitbringen Ihrer eigenen OAuth 2.0-App auswählen, wählen Sie das Zahnradsymbol und dann Mitbringen Ihrer eigenen OAuth 2.0-App aus. Geben Sie dann die Client-ID und den geheimen Clientschlüssel aus Ihrem Google Cloud-Projekt-Setup ein. Sie müssen auch die Scopes angeben, die für die Aktivitäten erforderlich sind, die Sie verwenden möchten. Prüfen Sie die Dokumentation der einzelnen Aktivitäten, um zu erfahren, welche Scopes sie erfordert.

6. Geben Sie die erforderlichen Anmeldeinformationen ein und wählen Sie Verbinden aus .

   Für jedes Feld des geheimen Typs können Sie das Menü neben dem Feld auswählen und Anmeldeinformations-Asset verwenden auswählen, um auf ein Orchestrator-Anmeldeinformations-Asset zu verweisen, das mit einem externen Tresor verknüpft ist, anstatt den Wert direkt einzugeben. Weitere Informationen finden Sie unter Verwenden von Anmeldeinformationsassets für Verbindungen.

Verwenden der Verbindung in Studio Desktop

Nach dem Erstellen einer Gmail-Verbindung im Integration Service konfigurieren Sie Ihre Studio- oder StudioX-Automatisierung für die Verwendung dieser Verbindung.

1. Öffnen Sie in Studio Pakete verwalten und installieren Sie das Paket Google Workspace .

2. In Ihrer Automatisierung können Sie Gmail-Aktivitäten hinzufügen, indem Sie Installiert, dann Integrationen, Google, Workspace und dann Gmail auswählen.

   Hinweis:

   Verwenden Sie die Gmail-Aktivitäten aus dem Abschnitt „Integrationen“ anstelle der Legacy-Aktivität „Use Gmail“ . Die Legacy-Aktivität unterstützt keine Integration Service-Verbindungen und ist auf ein einzelnes hartcodiertes Benutzerkonto beschränkt.

3. Wählen Sie in den Eigenschaften jeder Aktivität die Gmail-Verbindung aus, die Sie im Integration Service erstellt haben.

Wenn nicht alle Gmail-Scopes in Ihrem Google Cloud-Projekt aktiviert wurden, können einige Aktivitäten fehlschlagen. Überprüfen Sie die Dokumentation jeder Aktivität auf die erforderlichen Scopes.

Bringen Sie Ihre eigene OAuth 2.0-App mit

Im Integration Service können Sie beim Erstellen einer Verbindung mit einem unserer Google API-basierten Connectors zwischen zwei Authentifizierungsoptionen wählen:

• OAuth 2.0: Autorisierungscode – stellt eine Verbindung mit der öffentlichen UiPath-Anwendung her.
• Bringen Sie Ihre eigene OAuth 2.0-App mit – stellt eine Verbindung mit einer privaten Google Cloud-Anwendung her, die Sie erstellen.

Konfigurieren von Scopes

Wenn Sie eine Verbindung mit Bring your own OAuth 2.0-App erstellen, haben Sie die Möglichkeit, Anwendungs-Scopes anzupassen.

Aktualisierungstokens für OAuth-Anwendungen

Google hat Aktualisierungstokenbeschränkungen für einzelne OAuth 2.0-Client-IDs. Wenn der Grenzwert erreicht wird, macht das Erstellen eines neuen Aktualisierungstokens das älteste Aktualisierungstoken automatisch ohne Warnung ungültig. Diese Grenze gilt nicht für Dienstkonten (; siehe Verwenden von OAuth 2.0 für Server-zu-Server-Anwendungen). Weitere Informationen finden Sie in der offiziellen Dokumentation von Google .

Eine Liste der Gründe, die zum Ablauf des Tokens führen können:

• Sie haben den Zugriff Ihrer App widerrufen.
• Das Aktualisierungstoken wurde seit sechs Monaten nicht mehr verwendet.
• Sie müssen Kennwörter ändern, und das Aktualisierungstoken enthält Gmail-Scopes.
• Ihr Konto hat eine maximale Anzahl von gewährten (Live-)Aktualisierungstokens überschritten.
  • Wenn Sie ein neues Token anfordern, nachdem der Grenzwert überschritten wurde, läuft Ihre alte Verbindung, die auf einem zuvor gewährten Token basiert, ab. Nur die neue Verbindung oder die zuletzt bearbeitete/erneut authentifizierte Verbindung (mit dem neuesten Token) funktioniert.
• Ein Administrator hat einen der in den Scopes Ihrer Anwendung angeforderten Dienste auf Eingeschränkt festgelegt (der Fehler ist admin_policy_enforced).
• Bei Google Cloud Platform-APIs: Die vom Administrator festgelegte Sitzungslänge wurde möglicherweise überschritten.

Hinweis:

Das Limit ist derzeit auf 100 Aktualisierungstoken pro Google-Konto pro OAuth 2.0 Client-ID festgelegt. Diese Anzahl kann sich ändern. Die neuesten Informationen finden Sie immer in der Google-Dokumentation.

Es gibt eine höhere Grenze für die Gesamtanzahl der Aktualisierungstokens, die ein Benutzer- oder Dienstkonto für alle Clients haben kann. Reguläre Benutzer werden diesen Grenzwert nicht überschreiten, bei einem Entwicklerkonto jedoch, das zum Testen einer Implementierung verwendet wird, möglicherweise.

Damit dieser Grenzwert nicht überschritten wird, bietet UiPath den Benutzern die Möglichkeit, eigene OAuth-Anwendungen zu erstellen und eine Verbindung mithilfe des Authentifizierungstyps Bring your own App herzustellen. Stellen Sie sicher, dass Sie beim Erstellen Ihrer OAuth-Anwendung die Best Practices von Google befolgen. Weitere Informationen zum Erstellen einer OAuth-Anwendung finden Sie in der offiziellen Dokumentation von Google .

Hinweis:

Die Ungültigkeit von Token führt zu fehlgeschlagenen Verbindungen und Automatisierungen können nicht ausgeführt werden, ohne Verbindungen zu reparieren.