Snowflake Cortex Authentifizierung

Verbinden Sie UiPath mit Snowflake Cortex mithilfe eines programmgesteuerten Zugriffstokens, eines OAuth 2.0-Autorisierungscodes, von OAuth 2.0 Client-Anmeldeinformationen mit Microsoft Entra ID oder einem externen OAuth 2.0-Autorisierungscode mit PKCE. Dazu müssen Sie Ihren Kontobezeichner und die zugehörigen Anmeldeinformationen bereitstellen.

Voraussetzungen

Dieser Connector unterstützt vier Authentifizierungsmethoden: Token für programmgesteuerten Zugriff (Standard), OAuth 2.0 Autorisierungscode, OAuth 2.0 Client Credentials mit Microsoft Entra ID und Externer OAuth 2.0 Autorisierungscode mit PKCE.

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

• Token für programmgesteuerten Zugriff:
  • Kontobezeichner
  • Persönliches Zugriffstoken
• OAuth 2.0: Autorisierungscode:
  • Kontobezeichner
  • Client-ID
  • Geheimer Clientschlüssel
  • Scope – Standardmäßig auf session:role:SYSADMIN. Sie können dies in eine andere Rolle ändern, sofern diese Rolle dem verbindenden Benutzer gewährt wird.
• OAuth 2.0 Client-Anmeldeinformationen mit Microsoft Entra ID:
  • Kontobezeichner
  • Client-ID und Client-Geheimnis – Aus der Registrierung der Microsoft Entra ID-Anwendung.
  • Scope – Der Scope der Microsoft Entra ID-Anwendung, die Snowflake darstellt, im Format api://<application-id-uri>/.default.
  • Mandanten-ID – Die Microsoft Entra ID-Verzeichnis-ID (Mandant), verfügbar im Abschnitt Übersicht Ihrer Microsoft Entra ID-Anwendungsregistrierung.
• Externer OAuth 2.0-Autorisierungscode mit PKCE:
  • Kontobezeichner
  • Autorisierungs-URL, Token-URL und Aktualisierungstoken-URL – Die OAuth 2.0-Endpunkte Ihres Identitätsanbieters.
  • Client-ID – Aus der Anwendungsregistrierung bei Ihrem Identitätsanbieter. Diese Methode verwendet einen öffentlichen Client, sodass kein geheimer Clientschlüssel erforderlich ist.
  • Scope – offline_access ist immer enthalten, da die Verbindung ihn benötigt, um ihr Token zu aktualisieren. Fügen Sie die Scopes hinzu, die Ihr Identitätsanbieter für Snowflake benötigt.

Abrufen Ihrer Anmeldeinformationen

Sie können den Kontobezeichner aus Ihren Kontodetails oder aus der URL des Kontoservers extrahieren. In der URL YQXMADF-EWA19151.snowflakecomputing.com ist der Bezeichner beispielsweise YQXMADF-EWA19151.

Das persönliche Zugriffstoken (PAT) kann im Snowflake-Dashboard unter Einstellungen > Authentifizierung > Programmgesteuerte Zugriffstoken erstellt werden. Die PAT-Option wird nur angezeigt, wenn Ihre Rolle die Erstellung zulässt. Wenden Sie sich an Ihren Administrator, um weitere Informationen zu erhalten.

Es wird die Authentifizierungsmethode OAuth 2.0 mit Autorisierungscode verwendet

Hinweis:

Standardmäßig werden Benutzer mit der Rolle ACCOUNTADMIN, ORGADMIN oder SECURITYADMIN daran gehindert, die OAuth 2.0-Authentifizierung zum Erstellen einer Verbindung zu verwenden. Die Rolle, die Sie in Scope eingeben, muss dem verbindenden Benutzer gewährt werden und darf nicht eine dieser drei sein. Weitere Informationen finden Sie unter Snowflake OAuth-Autorisierungsflow.

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. Stellen Sie sicher, dass Sie die richtige Umleitungs-URL enthalten: https://{baseURL}/provisioning_/callback (z. B. https://cloud.uipath.com/provisioning_/callback für Automation Cloud).

   CREATE SECURITY INTEGRATION my_oauth_integration_uipath
      TYPE=OAUTH
      OAUTH_CLIENT=CUSTOM
      OAUTH_REDIRECT_URI='https://cloud.uipath.com/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 OAUTH_CLIENT_SECRET (nicht OAUTH_CLIENT_SECRET_2).

   select system$show_oauth_client_secrets('MY_OAUTH_INTEGRATION_UIPATH');
   

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

Verwendung der OAuth 2.0 Client-Anmeldeinformationen mit der Microsoft Entra ID-Authentifizierungsmethode

Diese Methode authentifiziert sich über Snowflake External OAuth mit Microsoft Entra ID anstelle von Snowflake: Der Connector tauscht die Client-ID und das Geheimnis der Microsoft Entra ID-Anwendung gegen ein Zugriffstoken aus und sendet dann dieses Token an Snowflake.

Um OAuth 2.0 Client Credentials mit Microsoft Entra ID-Authentifizierung einzurichten, konfigurieren Sie sowohl Microsoft Entra ID als auch Snowflake:

1. Registrieren Sie eine Anwendung in Microsoft Entra ID und erstellen Sie einen geheimen Clientschlüssel dafür. Dadurch werden die Client-ID und der Geheime Clientschlüssel bereitgestellt und die Mandanten-ID ist im Abschnitt „Übersicht“ der Anwendung verfügbar.
2. Identifizieren (oder registrieren) Sie in Microsoft Entra ID die Anwendung, die Snowflake darstellt, und notieren Sie ihren Anwendungs-ID-URI. Verwenden Sie sie, um den Scope -Wert zu erstellen: api://<application-id-uri>/.default.
3. Erstellen Sie in Snowflake eine Sicherheitsintegration für externe OAuth mit dem Anwendungstyp Azure, der Zielgruppe, die auf den Anwendungs-ID-URI aus Schritt 2 festgelegt ist, und einem Snowflake-Benutzer, der dem Tokenanspruch des Dienstprinzipals zugeordnet ist.

Die genaue Konfigurationssyntax finden Sie unter Snowflake External OAuth mit Microsoft Entra ID in der Snowflake-Dokumentation.

Verwenden des externen OAuth 2.0-Autorisierungscodes mit der PKCE-Authentifizierungsmethode

Diese Methode meldet sich über Ihren eigenen Identitätsanbieter mithilfe des OAuth 2.0-Autorisierungscodeflows mit Proof Key for Code Exchange (PKCE) ohne Clientgeheimnis an. Es funktioniert mit jedem Identitätsanbieter, dessen Token Snowflake über eine externe OAuth-Sicherheitsintegration akzeptiert. Microsoft Entra ID ist der Referenz-Identitätsanbieter.

Um diese Authentifizierungsmethode einzurichten, konfigurieren Sie Ihren Identitätsanbieter und Snowflake:

1. Registrieren Sie bei Ihrem Identitätsanbieter eine Anwendung als öffentlichen Client und fügen Sie den Umleitungs-URI https://{baseURL}/provisioning_/callback hinzu (z. B. für Automation Cloud https://cloud.uipath.com/provisioning_/callback). Die Client-ID der Anwendung ist die Client-ID für die Verbindung.
2. Erstellen Sie in Snowflake eine externe OAuth-Sicherheitsintegration für Ihren Identitätsanbieter. Die Integration ordnet einen Anspruch im Token, z. B. upn, einem Snowflake-Benutzer über die Variable LOGIN_NAME des Benutzers zu.
3. Stellen Sie sicher, dass das Token die Rolle gewährt, die die Verbindung verwendet. Die Rolle muss sich im Scope des Tokens befinden, z. B. session:role:<role>, es sei denn, die Integration legt EXTERNAL_OAUTH_ANY_ROLE_MODE auf ENABLE fest.
4. Wenn Sie die Verbindung erstellen, ersetzen Sie die Werte in Autorisierungs-URL, Token-URL und URL für Aktualisierungstoken durch die Endpunkte Ihres Identitätsanbieters.

Die genaue Konfigurationssyntax finden Sie unter Externe OAuth-Übersicht in der Snowflake-Dokumentation.

Fügen Sie die Snowflake Cortex -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 den Authentifizierungstyp aus: Programmgesteuertes Zugriffstoken, OAuth 2.0-Autorisierungscode, OAuth 2.0 Client-Anmeldeinformationen mit Microsoft Entra ID oder Externer OAuth 2.0-Autorisierungscode mit PKCE.

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

   Wenn verfügbar, wählen Sie das Menü neben einem Feld und dann Anmeldeinformations-Asset verwenden oder Orchestrator-Asset verwenden aus , um auf ein Orchestrator-Asset zu verweisen, anstatt den Wert direkt einzugeben. Weitere Informationen finden Sie unter Verwenden von Anmeldeinformationsassets für Verbindungen.