In diesem Dokument wird beschrieben, wie Sie mit Cloud FTP einen externen SFTP-Server erstellen. Auf einen externen SFTP-Server kann über das Internet zugegriffen werden. Partner außerhalb Ihres Netzwerks können den Server verwenden, um Dateien sicher nach und von Cloud Storage zu übertragen.
Sie können den Zugriff auf einen externen SFTP-Server anhand der IP-Adressen Ihrer Nutzer einschränken.
Eine Anleitung zum Erstellen eines internen Servers, auf den nur innerhalb Ihres VPC-Netzwerks (Virtual Private Cloud) zugegriffen werden kann, finden Sie unter Internen SFTP-Server erstellen. Sie können nicht mehr ändern, ob ein Server extern oder intern ist, nachdem der Server erstellt wurde.
Hinweis
Console
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Cloud FTP API, if it is not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.- Wenn Sie den Zugriff auf den Server anhand der IP-Adressen Ihrer Nutzer einschränken möchten, erstellen Sie eine Liste der CIDR-Blöcke, die auf den Server zugreifen dürfen.
gcloud
-
Installieren Sie die Google Cloud CLI.
-
Konfigurieren Sie die gcloud CLI für die Verwendung Ihrer föderierten Identität.
Weitere Informationen finden Sie unter Mit Ihrer föderierten Identität in der gcloud CLI anmelden.
-
Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren:
gcloud init -
Google Cloud -Projekt erstellen oder auswählen.
Erforderliche Rollen zum Auswählen oder Erstellen eines Projekts
- Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können jedes Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
-
Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Project Creator“ (
roles/resourcemanager.projectCreator), die die Berechtigungresourcemanager.projects.createenthält. Informationen zum Zuweisen von Rollen
-
Erstellen Sie ein Projekt in Google Cloud :
gcloud projects create PROJECT_ID
Ersetzen Sie
PROJECT_IDdurch einen Namen für das Google Cloud -Projekt, das Sie erstellen. -
Wählen Sie das von Ihnen erstellte Projekt Google Cloud aus:
gcloud config set project PROJECT_ID
Ersetzen Sie
PROJECT_IDdurch den Namen Ihres Projekts in Google Cloud .
-
Wenn Sie für diese Anleitung ein vorhandenes Projekt verwenden, prüfen Sie, ob Sie die erforderlichen Berechtigungen haben. Wenn Sie ein neues Projekt erstellt haben, haben Sie bereits die erforderlichen Berechtigungen.
-
Prüfen Sie, ob die Abrechnung für Ihr Google Cloud -Projekt aktiviert ist.
Aktivieren Sie die Cloud FTP API, falls sie noch nicht aktiviert ist:
Erforderliche Rollen zum Aktivieren von APIs
Zum Aktivieren von APIs benötigen Sie die Berechtigung
serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Inhaberrolle (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollengcloud services enable ftp.googleapis.com
- Wenn Sie den Zugriff auf den Server anhand der IP-Adressen Ihrer Nutzer einschränken möchten, erstellen Sie eine Liste der CIDR-Blöcke, die auf den Server zugreifen dürfen.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Cloud FTP Admin (roles/ftp.admin) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen eines SFTP-Servers benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erstellen eines SFTP-Servers erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind zum Erstellen eines SFTP-Servers erforderlich:
-
ftp.servers.create -
Wenn Sie die Google Cloud Console für diese Aufgabe verwenden:
-
ftp.servers.list -
ftp.locations.list
-
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Externen Server erstellen
Console
- Rufen Sie in der Google Cloud Console die Seite Cloud FTP auf.
Klicken Sie auf Server erstellen.
Geben Sie auf dem Tab Serverkonfiguration die grundlegenden Details für den Server ein:
Geben Sie im Feld Server-ID eine eindeutige ID für den Server ein.
Wählen Sie in der Liste Region den Google Cloud -Standort für den Server aus.
Erstellen Sie den Server am selben Standort wie den Cloud Storage-Bucket, in dem Ihre Daten gespeichert sind, um die schnellsten Datenübertragungsgeschwindigkeiten zu erzielen. Wenn der Standort des Buckets von Cloud FTP nicht unterstützt wird, wählen Sie den nächstgelegenen verfügbaren Standort aus.
Optional: Geben Sie einen Anzeigenamen für den Server ein.
Klicken Sie auf Weiter.
Konfigurieren Sie auf dem Tab Netzwerk und Sicherheit die Verbindung für den Server:
Wählen Sie Extern (öffentliche IP-Adresse) aus.
Geben Sie im Feld Zulässige IP-Bereiche einen CIDR-Block an, der auf den Server zugreifen darf, und drücken Sie dann die Eingabetaste. Beispiel:
192.0.2.0/24. Sie müssen mindestens einen Wert angeben und können maximal 500 CIDR-Blöcke angeben. Wenn Sie Verbindungen von allen IP-Adressen zulassen möchten, verwenden Sie0.0.0.0/0.
Klicken Sie auf Erstellen.
Es dauert etwa 10 Minuten, bis der Server erstellt ist.
gcloud
Führen Sie den Befehl gcloud alpha storage ftp servers create aus und geben Sie das Flag --access-type=EXTERNAL an, um einen externen Server zu erstellen.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
- SERVER_ID: eine eindeutige ID für den Server. Muss mit einem Kleinbuchstaben beginnen und mit einem Kleinbuchstaben oder einer Ziffer enden. Kann Kleinbuchstaben, Ziffern und Bindestriche enthalten.
Darf nicht mit dem Präfix
googbeginnen oder den Stringgoogleenthalten, einschließlich ähnlicher, falsch geschriebener Versionen wieg00gle. Die maximale Länge beträgt 30 Zeichen. -
LOCATION_ID: der Google Cloud -Standort des Servers, z. B.
us-west1.Erstellen Sie den Server am selben Standort wie den Cloud Storage-Bucket, in dem Ihre Daten gespeichert sind, um die schnellsten Datenübertragungsgeschwindigkeiten zu erzielen. Wenn der Standort des Buckets von Cloud FTP nicht unterstützt wird, wählen Sie den nächstgelegenen verfügbaren Standort aus.
- CIDR_BLOCK: Ein CIDR-Block, der auf den Server zugreifen darf. Beispiel:
192.0.2.0/24. Sie müssen mindestens einen Wert angeben und können maximal 500 CIDR-Blöcke in einer durch Kommas getrennten Liste angeben. Wenn Sie Verbindungen von allen IP-Adressen zulassen möchten, verwenden Sie0.0.0.0/0.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud alpha storage ftp servers create SERVER_ID --access-type=EXTERNAL \ --location=LOCATION_ID --allowed-cidr-blocks=CIDR_BLOCK
Windows (PowerShell)
gcloud alpha storage ftp servers create SERVER_ID --access-type=EXTERNAL ` --location=LOCATION_ID --allowed-cidr-blocks=CIDR_BLOCK
Windows (cmd.exe)
gcloud alpha storage ftp servers create SERVER_ID --access-type=EXTERNAL ^ --location=LOCATION_ID --allowed-cidr-blocks=CIDR_BLOCK
Es dauert etwa 10 Minuten, bis der Server erstellt ist.
REST
Verwenden Sie zum Erstellen eines externen Servers die Methode servers.create und geben Sie eine externalConfig-Zugriffskonfiguration an.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: die Google Cloud -Projekt-ID des Servers.
-
LOCATION_ID: der Google Cloud -Standort des Servers, z. B.
us-west1.Erstellen Sie den Server am selben Standort wie den Cloud Storage-Bucket, in dem Ihre Daten gespeichert sind, um die schnellsten Datenübertragungsgeschwindigkeiten zu erzielen. Wenn der Standort des Buckets von Cloud FTP nicht unterstützt wird, wählen Sie den nächstgelegenen verfügbaren Standort aus.
- SERVER_ID: eine eindeutige ID für den Server. Muss mit einem Kleinbuchstaben beginnen und mit einem Kleinbuchstaben oder einer Ziffer enden. Kann Kleinbuchstaben, Ziffern und Bindestriche enthalten.
Darf nicht mit dem Präfix
googbeginnen oder den Stringgoogleenthalten, einschließlich ähnlicher, falsch geschriebener Versionen wieg00gle. Die maximale Länge beträgt 30 Zeichen. - CIDR_BLOCK: Ein CIDR-Block, der auf den Server zugreifen darf. Beispiel:
192.0.2.0/24. Sie müssen mindestens einen Wert angeben und können maximal 500 CIDR-Blöcke angeben. Wenn Sie Verbindungen von allen IP-Adressen zulassen möchten, verwenden Sie0.0.0.0/0.
HTTP-Methode und URL:
POST https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers?serverId=SERVER_ID
JSON-Text anfordern:
{
"accessType": "EXTERNAL",
"externalConfig": {
"allowedCidrBlocks": [
"CIDR_BLOCK"
]
}
}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Die Antwort identifiziert einen Vorgang mit langer Ausführungszeit.Es dauert etwa 10 Minuten, bis der Server erstellt ist.
Clientbibliotheken
Wenn Sie einen externen Server erstellen möchten, legen Sie den Zugriffstyp auf „Extern“ fest und geben Sie eine Konfiguration für den externen Zugriff an.
C#
Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud FTP finden Sie unter Cloud FTP-Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Cloud FTP C#.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud FTP zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Go
Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud FTP finden Sie unter Cloud FTP-Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Cloud FTP Go.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud FTP zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud FTP finden Sie unter Cloud FTP-Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Cloud FTP Java.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud FTP zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud FTP finden Sie unter Cloud FTP-Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Cloud FTP Node.js.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud FTP zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
PHP
Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud FTP finden Sie unter Cloud FTP-Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Cloud FTP PHP.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud FTP zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud FTP finden Sie unter Cloud FTP-Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Cloud FTP Python.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud FTP zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Ruby
Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud FTP finden Sie unter Cloud FTP-Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Cloud FTP Ruby.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud FTP zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.