Menggunakan direktori logis untuk menyederhanakan struktur direktori Transfer Family

Untuk menyederhanakan struktur direktori AWS Transfer Family server Anda, Anda dapat menggunakan direktori logis. Dengan direktori logis, Anda dapat membuat struktur direktori virtual yang menggunakan nama yang mudah digunakan yang dinavigasi pengguna saat mereka terhubung ke bucket Amazon S3 atau sistem file Amazon Anda. EFS Saat menggunakan direktori logis, Anda dapat menghindari pengungkapan jalur direktori absolut, nama bucket Amazon S3, EFS dan nama sistem file kepada pengguna akhir.

Anda dapat menggunakan direktori logis untuk mengatur direktori root pengguna ke lokasi yang diinginkan dalam hierarki penyimpanan Anda, dengan melakukan apa yang dikenal sebagai chroot operasi. Dalam mode ini, pengguna tidak dapat menavigasi ke direktori di luar direktori home atau root yang telah Anda konfigurasi untuk mereka.

Misalnya, meskipun pengguna Amazon S3 telah dicakup untuk mengakses saja/mybucket/home/${transfer:UserName}, beberapa klien mengizinkan pengguna untuk melintasi folder. /mybucket/home Dalam situasi ini, pengguna kembali ke direktori home yang dimaksudkan hanya setelah keluar dari dan kembali ke server Transfer Family lagi. Melakukan chroot operasi dapat mencegah situasi ini terjadi.

Anda dapat membuat struktur direktori Anda sendiri di seluruh bucket dan awalan. Fitur ini berguna jika Anda memiliki alur kerja yang mengharapkan struktur direktori tertentu yang tidak dapat Anda tiru melalui awalan bucket. Anda juga dapat menautkan ke beberapa lokasi yang tidak berdekatan dalam Amazon S3, mirip dengan membuat tautan simbolis dalam sistem file Linux di mana jalur direktori Anda mereferensikan lokasi yang berbeda dalam sistem file.

Aturan untuk menggunakan direktori logis

Sebelum Anda membangun pemetaan direktori logis Anda, Anda harus memahami aturan berikut:

Menerapkan direktori logis dan chroot

Untuk menggunakan direktori dan chroot fitur logis, Anda harus melakukan hal berikut:

Aktifkan direktori logis untuk setiap pengguna. Lakukan ini dengan menyetel HomeDirectoryType parameter LOGICAL saat Anda membuat atau memperbarui pengguna Anda.

"HomeDirectoryType": "LOGICAL"

chroot

Untukchroot, buat struktur direktori yang terdiri dari satu Entry dan Target pasangan untuk setiap pengguna. Folder root adalah Entry intinya, dan lokasi di bucket atau sistem file Anda untuk dipetakan. Target

Anda dapat menggunakan jalur absolut seperti pada contoh sebelumnya, atau Anda dapat menggunakan substitusi dinamis untuk nama pengguna dengan${transfer:UserName}, seperti pada contoh berikut.

[{"Entry": "/", "Target":
"/mybucket/${transfer:UserName}"}]

Dalam contoh sebelumnya, pengguna dikunci ke direktori root mereka dan tidak dapat melintasi lebih tinggi dalam hierarki.

Struktur direktori virtual

Untuk struktur direktori virtual, Anda dapat membuat beberapa Entry Target pasangan, dengan target di mana saja di bucket atau sistem EFS file S3 Anda, termasuk di beberapa bucket atau sistem file, selama pemetaan IAM peran pengguna memiliki izin untuk mengaksesnya.

Dalam contoh struktur virtual berikut, ketika pengguna login ke AWS SFTP, mereka berada di direktori root dengan sub-direktori/pics,, /doc/reporting, dan. /anotherpath/subpath/financials

[
{"Entry": "/pics", "Target": "/bucket1/pics"}, 
{"Entry": "/doc", "Target": "/bucket1/anotherpath/docs"},
{"Entry": "/reporting", "Target": "/reportingbucket/Q1"},
{"Entry": "/anotherpath/subpath/financials", "Target": "/reportingbucket/financials"}]

{
   "Entry": "/pics", 
   "Target": "/mybucket/pics"
}, 
{
   "Entry": "/doc", 
   "Target": "/mybucket/mydocs"
}, 
{
   "Entry": "/temp", 
   "Target": "/mybucket"
}

sftp> pwd
Remote working directory: /
sftp> put file
Uploading file to /file
remote open("/file"): No such file or directory

Untuk informasi selengkapnya tentang mengonfigurasi direktori logis dan chroot untuk pengguna Anda, termasuk AWS CloudFormation templat yang dapat Anda unduh dan gunakan, lihat Menyederhanakan AWS SFTP Struktur Anda dengan direktori chroot dan logis di Blog Penyimpanan. AWS

Konfigurasikan contoh direktori logis

Dalam contoh ini, kami membuat pengguna dan menetapkan dua direktori logis. Perintah berikut membuat pengguna baru (untuk server Transfer Family yang ada) dengan direktori logis pics dandoc.

aws transfer create-user --user-name marymajor-logical --server-id s-11112222333344445 --role arn:aws:iam::1234abcd5678:role/marymajor-role --home-directory-type LOGICAL \
 --home-directory-mappings "[{\"Entry\":\"/pics\", \"Target\":\"/DOC-EXAMPLE-BUCKET1/pics\"}, {\"Entry\":\"/doc\", \"Target\":\"/DOC-EXAMPLE-BUCKET2/test/mydocs\"}]" \
 --ssh-public-key-body file://~/.ssh/id_rsa.pub

Jika marymajor adalah pengguna yang sudah ada dan jenis direktori home nyaPATH, Anda dapat mengubahnya LOGICAL dengan perintah yang sama seperti yang sebelumnya.

aws transfer update-user --user-name marymajor-logical \
 --server-id s-11112222333344445 --role arn:aws:iam::1234abcd5678:role/marymajor-role \
 --home-directory-type LOGICAL --home-directory-mappings "[{\"Entry\":\"/pics\", \"Target\":\"/DOC-EXAMPLE-BUCKET1/pics\"}, \
 {\"Entry\":\"/doc\", \"Target\":\"/DOC-EXAMPLE-BUCKET2/test/mydocs\"}]"

Perhatikan hal berikut:

Konfigurasikan direktori logis untuk Amazon EFS

Jika server Transfer Family Anda menggunakan AmazonEFS, direktori home untuk pengguna harus dibuat dengan akses baca dan tulis sebelum pengguna dapat bekerja di direktori home logisnya. Pengguna tidak dapat membuat direktori ini sendiri, karena mereka akan kekurangan izin untuk mkdir direktori home logis mereka.

Jika direktori home pengguna tidak ada, dan mereka menjalankan ls perintah, sistem merespons sebagai berikut:

sftp> ls
remote readdir ("/"): No such file or directory

Seorang pengguna dengan akses administratif ke direktori induk perlu membuat direktori home logis pengguna.

AWS Lambda Tanggapan khusus

Anda dapat menggunakan direktori logis dengan fungsi Lambda yang terhubung ke penyedia identitas kustom Anda. Untuk melakukannya, dalam fungsi Lambda Anda, Anda menentukan HomeDirectoryType sebagaiLOGICAL, dan menambahkan Entry dan Target nilai untuk parameter. HomeDirectoryDetails Sebagai contoh:

HomeDirectoryType: "LOGICAL"
HomeDirectoryDetails: "[{\"Entry\": \"/\", \"Target\": \"/DOC-EXAMPLE-BUCKET/theRealFolder"}]"

Kode berikut adalah contoh respons yang berhasil dari panggilan otentikasi Lambda kustom.

aws transfer test-identity-provider --server-id s-1234567890abcdef0 --user-name myuser
{
    "Url": "https://a1b2c3d4e5.execute-api.us-east-2.amazonaws.com/prod/servers/s-1234567890abcdef0/users/myuser/config", 
    "Message": "", 
    "Response": "{\"Role\": \"arn:aws:iam::123456789012:role/bob-usa-role\",\"HomeDirectoryType\": \"LOGICAL\",\"HomeDirectoryDetails\": \"[{\\\"Entry\\\":\\\"/myhome\\\",\\\"Target\\\":\\\"/DOC-EXAMPLE-BUCKET/theRealFolder\\\"}]\",\"PublicKeys\": \"[ssh-rsa myrsapubkey]\"}", 
    "StatusCode": 200
}