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.

Note: For more details regarding the different authentication types, see the How to connect to Google Workspace 365 activities guide.

Weitere Informationen zu Gmail finden Sie auf der Gmail-Dokumentationswebsite .

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 Dienstkonten: 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:
  • 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 eigener 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 deklarieren, indem Sie das Feld Scopes verwenden. 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.

Fügen Sie die Gmail-Verbindung hinzu

1. Wählen Sie Integration Service in der Automation Cloud^TM aus.

2. Wählen Sie in der Liste Connectors die Option Gmail aus. Sie können auch die Suchleiste verwenden, um den Connector zu finden.
3. Wählen Sie die Schaltfläche Verbindung hinzufügen aus.

4. Sie werden nun zur Verbindungsseite weitergeleitet. Wählen Sie Ihren bevorzugten Authentifizierungstyp aus.

   Wenn Sie Ihre eigene OAuth 2.0-App mitbringen auswählen, müssen Sie eine Client-ID und einen geheimen Clientschlüssel sowie die Scopes angeben, die Sie möglicherweise für die Interaktion mit verschiedenen Aktivitäten benötigen. Lesen Sie die Dokumentation der Aktivitäten, um zu sehen, welche Scopes sie erfordern.

5. Ihre Verbindung wurde hinzugefügt.

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 – der eine Verbindung zur öffentlichen UiPath-Anwendung herstellt.

• Bringen Sie Ihre eigene OAuth 2.0-App mit, die sich mit einer privaten Anwendung verbindet, die Sie erstellen.

Um zu erfahren, wie Sie eine Anwendung erstellen, aufrufen Sie die offizielle Dokumentation von Google und führen Sie die beschriebenen Schritte aus: Authentifizierung – Anmelden mit Google für Web.

• Legen Sie beim Konfigurieren Ihrer Anwendung das Feld Autorisierte Umleitungs-URIs auf https://cloud.uipath.com/provisioning_/callbackfest

Konfigurieren von Scopes

Wenn Sie eine Verbindung mit Bring Ihre eigene OAuth 2.0-App erstellen, müssen Sie die Option auswählen, Anwendungs-Scopes anzupassen.

Aktualisierungstokens für OAuth-Anwendungen

Google hat Aktualisierungstokenbeschränkungen für einzelne OAuth 2.0 Client-IDs. Wenn der Grenzwert erreicht ist, wird beim Erstellen eines neuen Aktualisierungstokens das älteste Aktualisierungstoken automatisch und ohne Warnung ungültig. Diese Begrenzung gilt nicht für Dienstkonten (siehe Verwenden von OAuth 2.0 für Server-to-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 auf Ihre 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 könnte überschritten worden sein.

Hinweis: Das Limit ist derzeit auf 100 Aktualisierungstoken pro Google-Konto pro OAuth 2.0-Client-ID festgelegt. Diese Zahl kann sich ändern. Aktuelle 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.

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

Warnung: Tokenannullierung führt zu fehlgeschlagenen Verbindungen, und Automatisierungen können nicht ausgeführt werden, ohne Verbindungen zu reparieren.