Snowflake-Authentifizierung

Voraussetzungen

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

• OAuth 2.0-Autorisierungscode:
  • Client-ID
  • Geheimer Clientschlüssel
  • Datenbankhost
  • Warehouse
  • Datenbankschemaname
  • Datenbankname
  • 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.
   Diese Abfrage zeigt nicht die Client-ID an. Sie müssen eine zweite Abfrage ausführen, um die Clientdetails anzuzeigen. Stellen Sie sicher, dass Sie die richtige Umleitungs-URL in die Abfrage aufnehmen: 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 von der Automation Suite aus.

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.

6. Ihre Verbindung wurde hinzugefügt.

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.