SFTP

Mit dem SFTP-Connector können Sie eine Verbindung zu einem SFTP-Server herstellen und Dateiübertragungen ausführen.

Hinweise

Führen Sie in Ihrem Google Cloud-Projekt die folgenden Aufgaben aus:

• Prüfen Sie, ob eine Netzwerkverbindung eingerichtet ist. Weitere Informationen finden Sie unter Netzwerkverbindung.
• Weisen Sie dem Nutzer, der den Connector konfiguriert, die IAM-Rolle roles/connectors.admin zu.
• Weisen Sie dem Dienstkonto, das Sie für den Connector verwenden möchten, die IAM-Rollen roles/secretmanager.viewer und roles/secretmanager.secretAccessor zu.
• Aktivieren Sie secretmanager.googleapis.com (Secret Manager API) und connectors.googleapis.com (Connectors API). Weitere Informationen finden Sie unter Dienste aktivieren.

SFTP-Verbindung erstellen

Eine Verbindung ist für eine Datenquelle spezifisch. Wenn Sie also viele Datenquellen haben, müssen Sie für jede Datenquelle eine separate Verbindung erstellen. So erstellen Sie eine Verbindung:

1. Rufen Sie in der Cloud Console die Seite Integration Connectors > Verbindungen auf und wählen Sie ein Google Cloud-Projekt aus oder erstellen Sie eines.

   Zur Seite „Verbindungen“

2. Klicken Sie auf + NEU ERSTELLEN, um die Seite Verbindung erstellen zu öffnen.
3. Wählen Sie im Bereich Standort einen Standort aus der Liste Region aus und klicken Sie dann auf Weiter.

   Eine Liste aller unterstützten Regionen finden Sie unter Standorte.

4. Führen Sie im Abschnitt Verbindungsdetails folgende Schritte aus:
   1. Wählen Sie im Feld Connector die Option SFTP aus.
   2. Wählen Sie im Feld Connector-Version die gewünschte Version aus.
   3. Geben Sie im Feld Verbindungsname einen Namen für die Verbindungsinstanz ein. Der Verbindungsname darf Kleinbuchstaben, Zahlen oder Bindestriche enthalten. Der Name muss mit einem Buchstaben beginnen und mit einem Buchstaben oder einer Ziffer enden. Er darf nicht länger als 49 Zeichen sein.
   4. Geben Sie optional unter Beschreibung eine Beschreibung für die Verbindungsinstanz ein.
   5. Optional können Sie Cloud Logging aktivieren und dann eine Logebene auswählen. Die Logebene ist standardmäßig auf Error festgelegt.
   6. Wählen Sie im Feld Dienstkonto ein Konto mit den erforderlichen Rollen aus.
   7. Optional: Konfigurieren Sie die Verbindungsknoteneinstellungen.
   • Mindestanzahl von Knoten: Geben Sie die Mindestanzahl von Verbindungsknoten ein.
   • Maximale Anzahl von Knoten: Geben Sie die maximale Anzahl von Verbindungsknoten ein.

   Ein Knoten ist eine Einheit (oder ein Replikat) einer Verbindung, die Transaktionen verarbeitet. Zur Verarbeitung von mehr Transaktionen für eine Verbindung sind mehr Knoten erforderlich. Umgekehrt sind weniger Knoten erforderlich, um weniger Transaktionen zu verarbeiten. Informationen zu den Auswirkungen der Knoten auf Ihre Connector-Preise finden Sie unter Preise für Verbindungsknoten. Wenn Sie keine Werte eingeben, ist die Mindestanzahl von Knoten standardmäßig auf 2 (für eine bessere Verfügbarkeit) und die maximale Knotenzahl auf 50 gesetzt.

   8. Optional: Geben Sie im Feld Remote-Pfad den Ordnerpfad auf dem SFTP-Server ein, in dem die Entitätsvorgänge ausgeführt werden sollen, z. B. List, Create, Update oder Delete.

   Wenn Sie auf Elemente (Dateien oder Ordner) im Stammordner oder in den direkt untergeordneten Ordnern des Stammordners zugreifen, müssen Sie für dieses Feld keinen Wert festlegen. Wenn Sie jedoch auf verschachtelte Einheiten zugreifen möchten, die sich in einer Tiefe von mindestens zwei Ebenen vom Stammordner befinden, müssen Sie den Wert dieses Felds auf den Basispfad des Ordners festlegen, der die Einheiten enthält, auf die Sie zugreifen möchten. Wenn Sie beispielsweise auf die Datei /folder_A/folder_B/folder_C/test.png zugreifen möchten, müssen Sie den Remote-Pfad auf /folder_A/folder_B/folder_C festlegen.

   9. Klicken Sie optional auf + Label hinzufügen, um der Verbindung ein Label in Form eines Schlüssel/Wert-Paars hinzuzufügen.
   10. Klicken Sie auf Weiter.
5. Geben Sie im Bereich Ziele die Details zum Remote-Host (Backend-System) ein, zu dem Sie eine Verbindung herstellen möchten, und klicken Sie auf Weiter.

Wählen Sie im Feld Zieltyp den gewünschten Typ aus:

• Wenn Sie den Zielhostnamen oder die Ziel-IP-Adresse angeben möchten, wählen Sie Hostadresse aus und geben Sie die Adresse in das Feld Host 1 ein.
• Wenn Sie eine private Verbindung herstellen möchten, wählen Sie Endpunktanhang aus und wählen Sie den erforderlichen Anhang aus der Liste Endpunktanhang aus.

Wenn Sie eine öffentliche Verbindung zu Ihren Back-End-Systemen mit zusätzlicher Sicherheit herstellen möchten, können Sie statische ausgehende IP-Adressen für Ihre Verbindungen konfigurieren und dann Ihre Firewallregeln konfigurieren, um nur bestimmte statische IP-Adressen zuzulassen.

6. Wählen Sie im Bereich Authentifizierung einen Authentifizierungstyp aus, geben Sie die relevanten Details ein und klicken Sie auf Weiter.

   Die folgenden Authentifizierungstypen werden von der SFTP-Verbindung unterstützt:

   • Nutzername und Passwort
   • SSH_PUBLIC_KEY

   Informationen zum Konfigurieren dieser Authentifizierungstypen finden Sie unter Authentifizierung konfigurieren.

7. Prüfen Sie Ihre Verbindungs- und Authentifizierungsdetails und klicken Sie dann auf Erstellen.

Authentifizierung konfigurieren

Geben Sie die Details basierend auf der zu verwendenden Authentifizierung ein.

• Nutzername und Passwort
  • Nutzername: Der SFTP-Nutzername für die Verbindung.
  • Kennwort: Secret Manager-Secret mit dem Passwort, das dem SFTP-Nutzernamen zugeordnet ist.

• SSH_PUBLIC_KEY
  • Nutzername: Das SFTP-Nutzerkonto, das zur Authentifizierung verwendet wird.
  • Privater SSH-Schlüssel: Privater Schlüssel für die SSH-Authentifizierung.
  • Passwort für den privaten SSH-Schlüssel: Passphrase/Passwort, das den privaten Schlüssel schützt, falls vorhanden.
  • Typ des privaten SSH-Schlüssels: Format des privaten SSH-Schlüssels.

SFTP-Verbindung in einer Integration verwenden

Nachdem Sie die Verbindung erstellt haben, ist sie sowohl in Apigee Integration als auch in Application Integration verfügbar. Sie können die Verbindung in einer Integration über die Aufgabe „Connectors“ verwenden.

• Informationen zum Erstellen und Verwenden der Connectors-Aufgabe in Apigee Integration finden Sie unter Connectors-Aufgabe.
• Informationen zum Erstellen und Verwenden der Connectors-Aufgabe in Application Integration finden Sie unter Connectors-Aufgabe.

[{
"Success":"true"
}]

[{
"Success":"true"
}]

Systembeschränkungen

Der SFTP-Connector kann eine Transaktion pro Sekunde und Knoten verarbeiten und drosselt alle Transaktionen, die dieses Limit überschreiten. Standardmäßig werden für eine Verbindung zwei Knoten (für eine bessere Verfügbarkeit) zugewiesen.

Informationen zu den für Integration Connectors geltenden Limits finden Sie unter Limits.

Verbindungen mit Terraform erstellen

Sie können die Terraform-Ressource verwenden, um eine neue Verbindung zu erstellen.

Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.

Ein Beispiel für eine Terraform-Vorlage zum Erstellen einer Verbindung finden Sie hier.

Wenn Sie diese Verbindung mit Terraform erstellen, müssen Sie die folgenden Variablen in Ihrer Terraform-Konfigurationsdatei festlegen:

    {
      "type": "object",
      "properties": {
        "FilePath": {
          "type": "string",
          "readOnly": false
        },
        "Filename": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false,
          "description": "The name of the file or directory."
        },
        "FileSize": {
          "type": [
            "number",
            "null"
          ],
          "readOnly": false,
          "description": "The size of the file."
        },
        "LastModified": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false
        },
        "IsDirectory": {
          "type": [
            "boolean",
            "null"
          ],
          "readOnly": false
        },
        "Permissions": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false
        },
        "Owner": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false
        },
        "OwnerId": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false
        },
        "Group": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false
        },
        "GroupId": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false
        }
      }
    }
  

Hilfe von der Google Cloud-Community erhalten

Sie können Ihre Fragen und Anregungen zu diesem Connector in der Google Cloud-Community unter Cloud-Foren posten.

Nächste Schritte

• Verbindung anhalten und fortsetzen
• Informationen zum Überwachen der Connector-Nutzung
• Connector-Logs ansehen