Snowflake-Authentifizierung

Voraussetzungen

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

• Nutzen Sie Ihre eigene OAuth 2.0-App:
  • Client-ID
  • Geheimer Clientschlüssel
  • Datenbankhost
  • Warehouse
  • Datenbankschemaname
  • Datenbankname
  • Rolle
• Persönliches Zugriffstoken
  • Benutzername
  • Persönliches Zugriffstoken
  • Warehouse
  • Database Schema Name
  • Database Name
  • Rolle
• Benutzerdefinierte Authentifizierung (JDBC-Authentifizierung):
  • Datenbankhost
  • Benutzername
  • Passwort
  • Warehouse
  • Datenbankschemaname
  • Datenbankname
• RSA (Schlüsselpaar-Authentifizierung und Schlüsselpaar-Rotation)
  • Datenbankhost
  • Benutzername
  • Privater RSA-Schlüssel
  • Warehouse
  • Datenbankschemaname
  • Datenbankname

Hinweis:

Bekannte Einschränkungen:

• Um sich mit RSA zu authentifizieren, müssen Sie einen unverschlüsselten privaten RSA-Schlüssel verwenden.

• Verbindungen über AWS PrivateLink werden nicht unterstützt.

• Wenn Ihre Snowflake-Instanz den Zugriff nach IP beschränkt, müssen Sie eine Zulassungsliste für die IPs konfigurieren, die vom Integration Service verwendet werden. Weitere Informationen finden Sie unter Konfigurieren einer Zulassungsliste für Connector-Domänen im Automation Suite-Installationshandbuch.

Abrufen Ihrer Anmeldeinformationen aus Snowflake

Um die Anmeldeinformationen aus Snowflake abzurufen, führen Sie die folgenden Schritte aus:

1. Der Datenbankhost ist in der URL verfügbar, die zum Herstellen einer Verbindung mit Ihrer Snowflake-App verwendet wird:

   Hinweis: Das Datenbankhostformat kann sich je nach Kontobezeichnertyp unterscheiden. Weitere Informationen finden Sie im Abschnitt Datenbankhost auf dieser Seite sowie in der offiziellen Snowflake-Dokumentation.
   
   

   

   
   
   Beispiel: Für die folgende URL https://app.snowflake.com/east-us-2.azure/za96341/dashboards ist accountID za96341 und region ist east-us-2.azure.
   Um einen Datenbankhost zu erstellen, müssen Sie das Format accountID.region.snowflakecomputing.com verwenden. Für die vorherige URL wäre der erstellte Datenbankhost also za96341.east-us-2.azure.snowflakecomputing.com.

2. Sobald Sie angemeldet sind, wählen Sie im Menü auf der linken Seite Daten und dann Datenbanken aus.

   • Datenbankname: Eine Liste der Datenbanken wird angezeigt:

     
     

     

     
     

   • Datenbankschemaname – Wählen Sie eine Datenbank aus, um die Liste der Datenbankschemanamen anzuzeigen:

     
     

     

     
     

3. Um das Warehouse abzurufen, wechseln Sie im Menü auf der linken Seite zu Admin > Warehouses:

   
   

   

   
   

Es wird die Authentifizierungsmethode OAuth 2.0 mit Autorisierungscode verwendet

Hinweis: Nur Benutzer mit einer ACCOUNTADMIN-Rolle können OAuth2-Anmeldeinformationen erstellen. Standardmäßig sind Benutzer mit den Rollen ACCOUNTADMIN, ORGADMIN und SEURityADMIN für die Verwendung der OAuth 2.0-Authentifizierung zum Erstellen einer Verbindung gehindert. Weitere Informationen finden Sie unter Snowflake: OAuth-Autorisierungsablauf.

Führen Sie die folgenden Schritte aus, um einen OAuth 2.0-Client für Snowflake zu erstellen:

1. Führen Sie die folgende Abfrage aus, um die OAuth-Integration zu erstellen.
   This query does not show the Client ID. You must run a second query to view the client details. Make sure to include the correct redirect URL in the query: https://{yourDomain}/provisioning_/callback.

   CREATE SECURITY INTEGRATION my_oauth_integration_uipath
   
      TYPE=OAUTH
      OAUTH_CLIENT= CUSTOM
      OAUTH_REDIRECT_URI='https://{yourDomain}/provisioning_/callback'
      OAUTH_CLIENT_TYPE='CONFIDENTIAL'
      OAUTH_ISSUE_REFRESH_TOKENS=true
      OAUTH_REFRESH_TOKEN_VALIDITY= 86400
      ENABLED=true;

2. Führen Sie die folgende Abfrage aus, um die Clientdetails anzuzeigen. Kopieren Sie die OAUTH_CLIENT_ID.

   DESCRIBE SECURITY INTEGRATION my_oauth_integration_uipath

3. Führen Sie die folgende Abfrage aus, um den geheimen Clientschlüssel anzuzeigen. Kopieren Sie die OAUTH_CLIENT_SECRET.
   Diese Abfrage gibt zwei Elemente aus: OAUTH_CLIENT_SECRET und OAUTH_CLIENT_SECRET_2. Sie müssen OAUTH_CLIENT_SECRET verwenden.

   select system$show_oauth_client_secrets('MY_OAUTH_INTEGRATION_UIPATH');

Weitere Informationen finden Sie unter Konfigurieren von Snowflake: OAuth für benutzerdefinierte Clients.

Hinzufügen der Snowflake-Verbindung

1. Wählen Sie Integration Service in der linken Leiste.
2. Wählen Sie in der Liste Connectors die Option Snowflake aus. Sie können auch die Suchleiste verwenden, um den Connector zu finden.
3. Klicken Sie auf die Schaltfläche Mit Snowflake verbinden und wählen Sie Ihre bevorzugte Authentifizierungsmethode aus.
4. Geben Sie die erforderlichen Snowflake-Anmeldeinformationen ein.
5. Wählen Sie Verbinden aus.

Berechtigungen

Durch die Verbindung kann UiPath Snowflake-Daten in Ihrem Namen lesen, schreiben, ändern und löschen.

Erforderliche Rollen für die Verbindung mit Snowflake

Beim Erstellen einer Verbindung für Snowflake aus dem Integration Service wählt der Connector immer die Standardrolle des Benutzers aus, wie in der folgenden Abbildung gezeigt.

Snowflake: Administratoren können benutzerdefinierte Rollen für Benutzer einrichten, da nicht jeder aus Sicherheitsgründen Administratorrollen erhält.

Das folgende Beispiel zeigt, was genau in Snowflake erforderlich ist, damit der Integration Service-Verbindungsprozess reibungslos funktioniert. In diesem Beispiel erstellen Sie eine Verbindung mit dem Datenbankschema DEAL_AMOUNT und der Datenbank JULY_DMO.

Der erste Schritt besteht darin, sicherzustellen, dass die Standardrolle, in diesem Fall SAMRAT, über die USAGE -Berechtigung sowohl für die Datenbank (JULY_DEMO) als auch für das Datenbankschema (DEAL_AMOUNT) in Snowflake verfügt.

Eine erfolgreiche Authentifizierung bei Snowflake ist von diesen Einstellungen abhängig. Einer Rolle können jederzeit zusätzliche Berechtigungen von einem Administrator zugewiesen werden.

Weitere Informationen dazu finden Sie unter Berechtigungen der Zugriffssteuerung in der Snowflake-Dokumentation.