Gmail-Authentifizierung

Voraussetzungen

Um eine Verbindung zu erstellen, benötigen Sie die folgenden Anmeldeinformationen:

• Nutzen Sie Ihre eigene OAuth 2.0-App: Die Client-ID, der geheime Clientschlüssel und die Scopes Ihrer Anwendung.

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.

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

Scopes

Der Connector fordert die folgenden Berechtigungen/Scopes an:

• 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 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.

Fügen Sie die Gmail-Verbindung hinzu

1. Wählen Sie Integration Service in der Automation Suite aus.
2. Wählen Sie in der Liste Konnektoren die Option Gmail aus. Sie können auch die Suchleiste verwenden, um den Connector zu finden.
3. Select the Add connection button.
4. Sie werden nun zur Verbindungsseite umgeleitet. Wählen Sie Ihren bevorzugten Authentifizierungstyp aus. Wenn Sie Eigene OAuth 2.0-App mitbringen auswählen, müssen Sie eine Client-ID, einen geheimen Clientschlüssel und die Scopes angeben, die Sie möglicherweise zur Interaktion mit verschiedenen Aktivitäten benötigen. Sehen Sie sich die Dokumentation der Aktivitäten an, um zu erfahren, welche Scopes sie benötigen.
5. Ihre Verbindung wurde hinzugefügt.

Bringen Sie Ihre eigene OAuth 2.0-App mit

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

• Legen Sie beim Konfigurieren Ihrer Anwendung das Feld Autorisierte Umleitungs-URIs auf: https://{yourDomain}/provisioning\_/callback fest

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 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 .

Wichtig:

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