Amazon Redshift unterstützt UDFs ab Patch 198 nicht mehr die Erstellung von neuem Python. Das bestehende Python UDFs wird bis zum 30. Juni 2026 weiterhin funktionieren. Weitere Informationen finden Sie im Blog-Posting.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Stellen Sie über identitätserweiterte IAM-Rollensitzungen eine Connect zu Redshift her

Sie können IAM Identity Center verwenden, um Verbundzugriff auf Ihre Amazon Redshift Redshift-Cluster und serverlosen Arbeitsgruppen bereitzustellen. Dieser Ansatz ermöglicht es Benutzern, sich mit ihren Identity Center-Anmeldeinformationen zu authentifizieren.

Amazon Redshift bietet GetIdentityCenterAuthToken API-Operationen zur Generierung eines autorisierten Tokens, das Benutzeridentitätsinformationen enthält. Diese APIs sind sowohl für bereitgestellte Cluster als auch für serverlose Arbeitsgruppen verfügbar. Die Token ermöglichen einen nahtlosen Single Sign-On-Zugriff auf Amazon Redshift Redshift-Datenbanken unter Verwendung Ihrer vorhandenen Identity Center-Setup.

Voraussetzungen

Bevor Sie die Identity Center-Authentifizierung mit Amazon Redshift verwenden, stellen Sie sicher, dass Sie über Folgendes verfügen:

Wie funktioniert die Identity Center-Authentifizierung

Die Identity Center-Authentifizierung für Amazon Redshift verwendet den folgenden Workflow:

GetIdentityCenterAuthToken API-Operationen

Amazon Redshift bietet zwei separate GetIdentityCenterAuthToken API-Operationen: einen für bereitgestellte Cluster und einen für serverlose Arbeitsgruppen. Beide Operationen haben denselben Namen, akzeptieren jedoch je nach Zielressourcentyp unterschiedliche Parameter.

GetIdentityCenterAuthToken für bereitgestellte Cluster

Verwenden Sie für bereitgestellte Amazon Redshift Redshift-Cluster die GetIdentityCenterAuthToken API im Amazon Redshift Redshift-Service, um autorisierte Token zu generieren.

Erforderliche Syntax

{
   "ClusterIds": [ "string" ]
}
                

Anforderungsparameter

CLI-Beispiele

Beispiel: Holen Sie sich ein autorisiertes Token für einen einzelnen Cluster

aws redshift get-identity-center-auth-token \
    --cluster-ids my-redshift-cluster

Beispiel: Holen Sie sich ein autorisiertes Token für mehrere Cluster

aws redshift get-identity-center-auth-token \
    --cluster-ids my-cluster-1 my-cluster-2

GetIdentityCenterAuthToken für serverlose Arbeitsgruppen

Verwenden Sie für Amazon Redshift Serverless-Arbeitsgruppen die GetIdentityCenterAuthToken API im Amazon Redshift Serverless-Service, um autorisierte Token zu generieren.

Erforderliche Syntax

{
   "WorkgroupNames": [ "string" ]
}
                

Anforderungsparameter

CLI-Beispiele

Beispiel: Holen Sie sich ein autorisiertes Token für eine einzelne Arbeitsgruppe

aws redshift-serverless get-identity-center-auth-token \
    --workgroup-names my-workgroup

Beispiel: Holen Sie sich ein autorisiertes Token für mehrere Arbeitsgruppen

aws redshift-serverless get-identity-center-auth-token \
    --workgroup-names workgroup-1 workgroup-2

Antwortsyntax

Beide APIs geben dieselbe Antwortstruktur zurück:

{
   "AuthorizedToken": "string",
   "ExpirationTime": "timestamp"
}
            

Antwortparameter

Beispielantwort

{
    "AuthorizedToken": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyQGV4YW1wbGUuY29tIiwiaWF0IjoxNjQwOTk1MjAwLCJleHAiOjE2NDA5OTg4MDAsImNsdXN0ZXJzIjpbIm15LWNsdXN0ZXIiXX0...",
    "ExpirationTime": "2024-01-01T12:00:00Z"
}

Integration von Treibern

Amazon Redshift Redshift-Treiber unterstützen die Identity Center-Authentifizierung durch direkte Token-Verwendung:

Direkte Token-Verwendung

Nachdem Sie die GetIdentityCenterAuthToken API aufgerufen haben, um ein Token zu erhalten, verwenden Sie das IdpTokenAuthPlugin mit dem SUBJECT_TOKEN Tokentyp.

Konfiguration der Verbindung:

plugin_name = com.amazon.redshift.plugin.IdpTokenAuthPlugin
token_type = SUBJECT_TOKEN
token = {encrypted_token_from_api_response}
            

Ausführliche Informationen zu Identity Center-Authentifizierungs-Plug-ins und zur Treiberkonfiguration finden Sie unter Verbindung zu einem Amazon Redshift Redshift-Cluster herstellen.

Beispiel für Java-Code

Java-Beispielcode für die Verbindung mithilfe der Identity Center-Authentifizierung:

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;
import java.util.Properties;

// Get token from GetIdentityCenterAuthToken API
String token = "your_encrypted_token_from_api_response";

// Configure connection properties
Properties props = new Properties();
props.setProperty("user", "your_username");
props.setProperty("plugin_name", "com.amazon.redshift.plugin.IdpTokenAuthPlugin");
props.setProperty("token_type", "SUBJECT_TOKEN");
props.setProperty("token", token);

// Connect to Redshift
String url = "jdbc:redshift://your-cluster.region.redshift.amazonaws.com:5439/your_database";
try (Connection conn = DriverManager.getConnection(url, props)) {
    // Use connection
    System.out.println("Connected successfully!");
} catch (SQLException e) {
    e.printStackTrace();
}
            

Anforderungen an die IAM-Richtlinie

Um die Identity Center-Authentifizierung mit Amazon Redshift zu verwenden, sind spezifische IAM-Berechtigungen erforderlich, die über die Standardberechtigungen hinausgehen, die für die Verbindung mit Amazon Redshift Redshift-Clustern und Arbeitsgruppen erforderlich sind.

API-Berechtigungen

Für bereitgestellte Cluster muss Ihre erweiterte IAM-Rollensitzung über Folgendes verfügen:

Für serverlose Arbeitsgruppen muss Ihre erweiterte IAM-Rollensitzung über Folgendes verfügen:

IAM-Beispielrichtlinien

Beispielrichtlinie für bereitgestellte Cluster:

{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "redshift:GetIdentityCenterAuthToken"
            ],
            "Resource": [
                "arn:aws:redshift:us-east-1:123456789012:cluster:my-cluster"
            ]
        }
    ]
}

Beispielrichtlinie für serverlose Arbeitsgruppen:

{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "redshift-serverless:GetIdentityCenterAuthToken"
            ],
            "Resource": [
                "arn:aws:redshift-serverless:us-east-1:123456789012:workgroup/my-workgroup"
            ]
        }
    ]
}

Beispielrichtlinie für mehrere Ressourcen:

{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "redshift:GetIdentityCenterAuthToken"
            ],
            "Resource": [
                "arn:aws:redshift:*:123456789012:cluster/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "redshift-serverless:GetIdentityCenterAuthToken"
            ],
            "Resource": [
                "arn:aws:redshift-serverless:*:123456789012:workgroup/*"
            ]
        }
    ]
}

Regionale Verfügbarkeit

Die Identity Center-Authentifizierung ist in den folgenden AWS Regionen verfügbar: