Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

SFTP サーバーにユーザーを追加する

このドキュメントでは、Cloud FTP サーバーにユーザーを追加する方法について説明します。外部パートナーや内部関係者などのユーザーは、このサーバーを使用して Cloud Storage との間でファイルを安全に転送できます。

SFTP サーバーにユーザーを追加する手順の概要は次のとおりです。

ユーザーの権限を構成します。
SFTP ユーザーを作成し、そのディレクトリを Cloud Storage バケットにマッピングします。

サーバーを作成する手順については、外部 SFTP サーバーを作成すると内部 SFTP サーバーを作成するをご覧ください。

考慮事項

ユーザーにアクセス権を付与できるバケットは最大 10 個です。
ユーザーは最大 10 個の公開鍵を持つことができます。

始める前に

バケットがまだ存在しない場合は、ユーザーが操作するデータを保存するための Cloud Storage バケットを 1 つ以上作成します。
サーバーへの接続に使用する各 SSH 認証鍵ペアからユーザーの公開鍵を取得します。

SSH 認証鍵ペアがない場合は、次の手順で生成します。
SSH 認証鍵ペアを生成する

必要な鍵の形式を選択してください。

必要な鍵の形式は、SFTP サーバーへの接続に使用するクライアントによって異なります。詳細については、サポートされている SFTP クライアントをご覧ください。
PEM 形式

OpenSSH 鍵ペア（PEM 形式）を作成するには、ssh-keygen ユーティリティを使用します。

SFTP サーバーに接続するクライアントマシンで、次のコマンドを実行します。

ssh-keygen -t rsa -b 4096 -f ~/.ssh/KEY_PAIR_NAME

KEY_PAIR_NAME は、sftp_user_key などの鍵ペアの名前に置き換えます。

公開鍵を抽出します。

cat ~/.ssh/KEY_PAIR_NAME.pub
PPK 形式

PuTTY 鍵ペア（PPK 形式）を作成するには、PuTTYgen ツールを使用します。

SFTP サーバーに接続するクライアントマシンで、次のコマンドを実行します。

puttygen -t rsa -b 4096 -o KEY_PAIR_NAME.ppk

KEY_PAIR_NAME は、sftp_user_key などの鍵ペアの名前に置き換えます。

公開鍵を抽出します。

puttygen -L KEY_PAIR_NAME.ppk

必要なロール

SFTP ユーザーを追加するために必要な権限を取得するには、プロジェクトに対する FTP 管理者（roles/ftp.admin）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

この事前定義ロールには、SFTP ユーザーを追加するために必要な ftp.users.create 権限が含まれています。

カスタムロールや他の事前定義ロールを使用して、この権限を取得することもできます。

ユーザーの権限を構成する

Google Cloud CLI をインストールします。インストール後、次のコマンドを実行して Google Cloud CLI を初期化します。
```
gcloud init
```
外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

注: Google Cloud CLI をインストールしなくても、 Google Cloud コンソールで gcloud CLI を実行できます。 Google Cloud コンソールで gcloud CLI を実行するには、Cloud Shell を使用します。
プロジェクトを設定します。
```
gcloud config set project PROJECT_ID
```
PROJECT_ID は、SFTP サーバーを含むプロジェクトの ID に置き換えます。
サービスアカウントがまだ存在しない場合は、ユーザーのサービスアカウントを作成します。サービスアカウントは、ユーザーに代わって Cloud Storage リソースにアクセスします。
```
gcloud iam service-accounts create USERNAME-sa \
    --description="USERNAME SFTP Service Account" \
    --display-name="USERNAME SFTP Service Account"
```
USERNAME は、SFTP ユーザーの一意のユーザー名に置き換えます。ユーザー名の先頭は英小文字にする必要があります。英小文字、数字、ハイフンを使用できます。最大長は 32 文字です。

成功すると、Created service account [example-userid-sa] のようなメッセージが表示されます。
SFTP ユーザーを作成する管理者に IAM ロールを付与します。
1. サービスアカウントユーザー（roles/iam.serviceAccountUser）ロールを自分に付与します。
```
gcloud iam service-accounts add-iam-policy-binding USERNAME-sa@PROJECT_ID.iam.gserviceaccount.com \
    --member="user:ADMINISTRATOR_EMAIL" \
    --role="roles/iam.serviceAccountUser"
```
  ADMINISTRATOR_EMAIL は、SFTP ユーザーを作成するプリンシパルのメールアドレスに置き換えます。ユーザー（アプリケーションではなく）を作成する場合は、この値は Google Cloudへのアクセスに使用するメールアドレスです。
  
  成功すると、次のようなメッセージが表示されます。
```
Updated IAM policy for serviceAccount [example-userid-sa@example-project.iam.gserviceaccount.com].
bindings:
- members:
- user:admin@example.com
role: roles/iam.serviceAccountUser
etag: BwZJk7OiSzw=
version: 1
```
2. バケットに対する Storage バケット閲覧者（roles/storage.bucketViewer）ロールを自分に付与します。
```
gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME \
    --member="user:ADMINISTRATOR_EMAIL" \
    --role="roles/storage.bucketViewer"
```
  BUCKET_NAME は、バケットの名前に置き換えます。
  
  ユーザーがアクセスする必要があるバケットごとに、この手順を繰り返します。
3. バケットに対する Storage オブジェクト閲覧者（roles/storage.objectViewer）ロールを自分に付与します。
```
gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME \
    --member="user:ADMINISTRATOR_EMAIL" \
    --role="roles/storage.objectViewer"
```
  ユーザーがアクセスする必要があるバケットごとに、この手順を繰り返します。
バケットへのアクセスに必要な IAM ロールをユーザーのサービスアカウントに付与します。
```
gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME \
    --member="serviceAccount:USERNAME-sa@PROJECT_ID.iam.gserviceaccount.com" \
    --role="ROLE"
```
ROLE は、次のいずれかの IAM ロールに置き換えます。
- 読み取り専用アクセス権の場合は、roles/storage.objectViewer ロールを使用します。
- 読み取り / 書き込みアクセス権の場合は、roles/storage.objectAdmin ロールを使用します。
ユーザーがアクセスする必要があるバケットごとに、この手順を繰り返します。
ユーザーのサービスアカウントのトークンを生成する権限を Cloud FTP サービスエージェントに付与します。
1. サーバーのサービスエージェントのメールアドレスを取得します。手順については、サーバーの詳細を取得するをご覧ください。
2. Cloud FTP サービスエージェントを承認します。
```
gcloud iam service-accounts add-iam-policy-binding USERNAME-sa@PROJECT_ID.iam.gserviceaccount.com \
    --member="serviceAccount:SERVICE_AGENT_EMAIL" \
    --role="roles/iam.serviceAccountTokenCreator"
```
  SERVICE_AGENT_EMAIL は、サービスエージェントのメールアドレスに置き換えます。

次に、ユーザーを作成します。

SFTP サーバーユーザーを作成する

ユーザーの権限を構成したら、ユーザーを作成し、そのディレクトリを 1 つ以上の Cloud Storage バケットにマッピングします。

gcloud

SFTP サーバーのユーザーを作成するには、gcloud alpha storage ftp users create コマンドを実行します。

後述のコマンドデータを使用する前に、次のように置き換えます。
- CREDENTIAL_NAME: ユーザー認証情報を識別する一意の名前。
- SSH_PUBLIC_KEY: ユーザーの SSH 公開鍵の本文（OpenSSH 形式）。例: ssh-rsa AAAAB3NzaC1ycRexample...
- USERNAME: SFTP ユーザーのユーザー名。
- SERVICE_ACCOUNT: ユーザーのサービスアカウント。例: username-sa@example-project.iam.gserviceaccount.com
- LOCATION_ID: サーバーのロケーション（us-west1 など）。
- SERVER_ID: サーバー ID。
- BUCKET_NAME: SFTP ユーザーにアクセス権が付与されているバケットの名前（example-bucket など）。gs:// は省略します。
- （省略可）BUCKET_PREFIX: このディレクトリマッピングのルートディレクトリとして設定するバケット内のフォルダのパス。bucket_prefix プロパティを省略すると、Cloud FTP はバケットのルートを使用します。
- DIRECTORY: SFTP ユーザーに表示される論理ランディングディレクトリのパス。例: /home/uploads。
  
  複数のバケットまたはフォルダをマッピングする場合は、マッピングごとに一意のディレクトリパスを指定します。
  
  ネストされた論理ディレクトリはサポートされていません。ディレクトリに複数のマッピングを指定する場合は、ネストされた構造ではなく、フラットな構造でディレクトリを指定します。たとえば、/dir1 と /dir1/dir2 ではなく /dir1 と /dir2 を使用します。
- SFTP_PERMISSION: ディレクトリのアクセスレベル。読み取り専用権限の場合は、この値を READ_ONLY に設定します。読み取り / 書き込みアクセス権の場合は、この値を READ_WRITE に設定します。
次の点にご注意ください。
- 複数のバケットへのアクセス権をユーザーに付与するには、バケットごとにディレクトリマッピングを指定して --storage-directory-mapping フラグを複数回指定します。
- ユーザーに複数の公開鍵を構成するには、credentials.json ファイルに複数の認証情報を指定します。
次の内容を credentials.json という名前のファイルに保存します。
```
[
  {
    "credentialName": "CREDENTIAL_NAME",
    "credentialType": "PUBLIC_KEY",
    "sshPublicKeyBody": "SSH_PUBLIC_KEY"
  }
]
```
次のコマンドを実行します。
Linux、macOS、Cloud Shell

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
```
gcloud alpha storage ftp users create USERNAME \
    --customer-service-account=SERVICE_ACCOUNT --location=LOCATION_ID \
    --server=SERVER_ID \
    --storage-directory-mapping=bucket=BUCKET_NAME,bucket_prefix=BUCKET_PREFIX,directory=DIRECTORY,permission=SFTP_PERMISSION \
    --user-credentials-from-file=credentials.json
```
Windows（PowerShell）

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
```
gcloud alpha storage ftp users create USERNAME `
    --customer-service-account=SERVICE_ACCOUNT --location=LOCATION_ID `
    --server=SERVER_ID `
    --storage-directory-mapping=bucket=BUCKET_NAME,bucket_prefix=BUCKET_PREFIX,directory=DIRECTORY,permission=SFTP_PERMISSION `
    --user-credentials-from-file=credentials.json
```
Windows（cmd.exe）

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。
```
gcloud alpha storage ftp users create USERNAME ^
    --customer-service-account=SERVICE_ACCOUNT --location=LOCATION_ID ^
    --server=SERVER_ID ^
    --storage-directory-mapping=bucket=BUCKET_NAME,bucket_prefix=BUCKET_PREFIX,directory=DIRECTORY,permission=SFTP_PERMISSION ^
    --user-credentials-from-file=credentials.json
```
ユーザーの作成には数秒かかります。
サーバーに接続するために必要な次の情報をユーザーに提供します。
- ユーザーの SFTP ユーザー名。
- サーバーのアクセス構成。サーバータイプによって異なります。
  - 外部サーバーの場合は、サーバーの IP アドレス。
  - 内部サーバーの場合、サーバーのサービスアタッチメントの URI。
  サーバーのアクセス構成を取得する手順については、サーバーの詳細を取得するをご覧ください。
- （省略可）サーバーの鍵のフィンガープリント。

REST

SFTP サーバーのユーザーを作成するには、servers.users.create メソッドを使用します。

リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: サーバーの Google Cloud プロジェクト ID。
- LOCATION_ID: サーバーのロケーション（us-west1 など）。
- SERVER_ID: サーバー ID。
- USERNAME: SFTP ユーザーのユーザー名。
- BUCKET_NAME: SFTP ユーザーにアクセス権が付与されているバケットの名前（example-bucket など）。gs:// は省略します。
- （省略可）BUCKET_PREFIX: このディレクトリマッピングのルートディレクトリとして設定するバケット内のフォルダのパス。この値を省略すると、Cloud FTP はバケットのルートを使用します。
- DIRECTORY: SFTP ユーザーに表示される論理ランディングディレクトリのパス。例: /home/uploads。この値を省略すると、Cloud FTP はランディングディレクトリを / に設定します。
  
  複数のバケットまたはフォルダをマッピングする場合は、マッピングごとに一意のディレクトリパスを指定します。
  
  ネストされた論理ディレクトリはサポートされていません。ディレクトリに複数のマッピングを指定する場合は、ネストされた構造ではなく、フラットな構造でディレクトリを指定します。たとえば、/dir1 と /dir1/dir2 ではなく /dir1 と /dir2 を使用します。
- SFTP_PERMISSION: ディレクトリのアクセスレベル。読み取り専用権限の場合は、この値を READ_ONLY に設定します。読み取り / 書き込みアクセス権の場合は、この値を READ_WRITE に設定します。
- SERVICE_ACCOUNT: ユーザーのサービスアカウント。例: username-sa@example-project.iam.gserviceaccount.com
- CREDENTIAL_NAME: ユーザー認証情報を識別する一意の名前。
- SSH_PUBLIC_KEY: ユーザーの SSH 公開鍵の本文（OpenSSH 形式）。例: ssh-rsa AAAAB3NzaC1ycRexample...
次の点にご注意ください。
- 複数のバケットへのアクセス権をユーザーに付与するには、storageDirectoryMappings リストに複数のバケットマッピングを指定します。
- ユーザーに複数の公開鍵を構成するには、userCredentials リストに複数の認証情報を指定します。
HTTP メソッドと URL:
```
POST https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID/users?userId=USERNAME
```
リクエストの本文（JSON）:
```
{
  "storageDirectoryMappings": [
    {
      "bucket": "BUCKET_NAME",
      "bucketPrefix": "BUCKET_PREFIX",
      "directory": "DIRECTORY",
      "permission": "SFTP_PERMISSION"
    }
  ],
  "customerServiceAccount": "SERVICE_ACCOUNT",
  "userCredentials": [
    {
      "credentialName": "CREDENTIAL_NAME",
      "credentialType": "PUBLIC_KEY",
      "sshPublicKeyBody": "SSH_PUBLIC_KEY"
    }
  ]
}
```
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。
```
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID/users?userId=USERNAME"
```
PowerShell（Windows）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザーアカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID/users?userId=USERNAME" | Select-Object -Expand Content
```
レスポンスで長時間実行オペレーションを識別できます。ユーザーの作成には数秒かかります。 <0
サーバーに接続するために必要な次の情報をユーザーに提供します。
- ユーザーの SFTP ユーザー名。
- サーバーのアクセス構成。サーバータイプによって異なります。
  - 外部サーバーの場合は、サーバーの IP アドレス。
  - 内部サーバーの場合、サーバーのサービスアタッチメントの URI。
  サーバーのアクセス構成を取得する手順については、サーバーの詳細を取得するをご覧ください。
- （省略可）サーバーの鍵のフィンガープリント。

次のステップ

外部 SFTP サーバーに接続します。
内部 SFTP サーバーに接続する。
SFTP コマンドを使用してデータを転送します。
Cloud Storage バケットのデータ保護、バックアップ、復元のオプションについて学習する。

SFTP サーバーにユーザーを追加する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

考慮事項

始める前に

SSH 認証鍵ペアを生成する

必要な鍵の形式を選択してください。

PEM 形式

PPK 形式

必要なロール

ユーザーの権限を構成する

SFTP サーバー ユーザーを作成する

gcloud

Linux、macOS、Cloud Shell

Windows（PowerShell）

Windows（cmd.exe）

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

次のステップ

SFTP サーバーにユーザーを追加する

SFTP サーバーユーザーを作成する