View a markdown version of this page

Buat konektor SFTP dengan keluar yang dikelola layanan - AWS Transfer Family

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Buat konektor SFTP dengan keluar yang dikelola layanan

Prosedur ini menjelaskan cara membuat konektor SFTP dengan menggunakan AWS Transfer Family konsol atau AWS CLI.

Console
Untuk membuat konektor SFTP
  1. Buka AWS Transfer Family konsol di https://console.aws.amazon.com/transfer/.

  2. Di panel navigasi kiri, pilih Konek tor SFTP, lalu pilih Buat konektor SFTP.

  3. Di bagian Konfigurasi konektor, untuk tipe Egress, pilih Layanan dikelola. Opsi ini menggunakan infrastruktur AWS Transfer Family keluar terkelola. Layanan Transfer Family menyediakan dan mengelola alamat IP statis untuk setiap konektor SFTP.

  4. Di bagian Konfigurasi konektor, berikan informasi berikut:

    Konsol konektor Transfer Family SFTP, menunjukkan pengaturan konfigurasi Konektor.
    • Untuk URL, masukkan URL untuk server SFTP jarak jauh. URL ini harus diformat sebagaisftp://partner-SFTP-server-url, misalnyasftp://AnyCompany.com.

      catatan

      Secara opsional, Anda dapat memberikan nomor port di URL Anda. Formatnya adalah sftp://partner-SFTP-server-url:port-number. Nomor port default (ketika tidak ada port yang ditentukan) adalah port 22.

    • Untuk peran Akses, pilih Nama Sumber Daya Amazon (ARN) dari peran AWS Identity and Access Management (IAM) yang akan digunakan.

      • Pastikan peran ini menyediakan akses baca dan tulis ke direktori induk dari lokasi file yang digunakan dalam StartFileTransfer permintaan.

      • Pastikan bahwa peran ini memberikan izin secretsmanager:GetSecretValue untuk mengakses rahasia.

        catatan

        Dalam kebijakan, Anda harus menentukan ARN untuk rahasia. ARN berisi nama rahasia, tetapi menambahkan nama dengan enam karakter alfanumerik acak. ARN untuk rahasia memiliki format berikut.

        arn:aws:secretsmanager:region:account-id:secret:aws/transfer/SecretName-6RandomCharacters
      • Pastikan peran ini berisi hubungan kepercayaan yang memungkinkan konektor mengakses sumber daya Anda saat melayani permintaan transfer pengguna. Untuk detail tentang membangun hubungan kepercayaan, lihatUntuk membangun hubungan kepercayaan.

      { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowListingOfUserFolder", "Action": [ "s3:ListBucket", "s3:GetBucketLocation" ], "Effect": "Allow", "Resource": [ "arn:aws:s3:::amzn-s3-demo-bucket" ] }, { "Sid": "HomeDirObjectAccess", "Effect": "Allow", "Action": [ "s3:PutObject", "s3:GetObject", "s3:DeleteObject", "s3:DeleteObjectVersion", "s3:GetObjectVersion", "s3:GetObjectACL", "s3:PutObjectACL" ], "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*" }, { "Sid": "GetConnectorSecretValue", "Effect": "Allow", "Action": [ "secretsmanager:GetSecretValue" ], "Resource": "arn:aws:secretsmanager:us-west-2:111122223333:secret:aws/transfer/SecretName-6RandomCharacters" } ] }
      catatan

      Untuk peran akses, contoh memberikan akses ke satu rahasia. Namun, Anda dapat menggunakan karakter wildcard, yang dapat menyimpan pekerjaan jika Anda ingin menggunakan kembali peran IAM yang sama untuk beberapa pengguna dan rahasia. Misalnya, pernyataan sumber daya berikut memberikan izin untuk semua rahasia yang memiliki nama dimulai denganaws/transfer.

      "Resource": "arn:aws:secretsmanager:region:account-id:secret:aws/transfer/*"

      Anda juga dapat menyimpan rahasia yang berisi kredenSIAL SFTP Anda di yang lain Akun AWS. Untuk detail tentang mengaktifkan akses rahasia lintas akun, lihat Izin ke AWS Secrets Manager rahasia untuk pengguna di akun lain.

  5. Lengkapi konfigurasi konektor:

    • (Opsional) Untuk peran Logging, pilih peran IAM untuk konektor yang akan digunakan untuk mendorong peristiwa ke CloudWatch log Anda. Kebijakan contoh berikut mencantumkan izin yang diperlukan untuk mencatat peristiwa untuk konektor SFTP.

      { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "logs:CreateLogStream", "logs:DescribeLogStreams", "logs:CreateLogGroup", "logs:PutLogEvents" ], "Resource": "arn:aws:logs:*:*:log-group:/aws/transfer/*" } ] }
  6. Di bagian Konfigur asi SFTP, berikan informasi berikut:

    Konsol konektor Transfer Family SFTP, menunjukkan pengaturan konfigurasi SFTP.
    • Untuk kreden SIAL Konektor, dari daftar dropdown, pilih nama rahasia AWS Secrets Manager yang berisi kunci pribadi atau kata sandi pengguna SFTP. Anda harus membuat rahasia dan menyimpannya dengan cara tertentu. Lihat perinciannya di Simpan kredentif otentikasi untuk konektor SFTP di Secrets Manager.

    • (Opsional) Anda memiliki opsi untuk membuat konektor sambil membiarkan TrustedHostKeys parameter kosong. Namun, konektor Anda tidak akan dapat mentransfer file dengan server jarak jauh sampai Anda memberikan parameter ini dalam konfigurasi konektor Anda. Anda dapat memasukkan kunci host tepercaya pada saat membuat konektor, atau memperbarui konektor nanti dengan menggunakan informasi kunci host yang dikembalikan oleh tindakan TestConnection konsol atau perintah API. Artinya, untuk kotak teks Kunci host tepercaya, Anda dapat melakukan salah satu dari hal berikut:

      • Berikan Kunci Host Tepercaya pada saat membuat konektor Anda. Tempel di bagian publik dari kunci host yang digunakan untuk mengidentifikasi server eksternal. Anda dapat menambahkan lebih dari satu kunci, dengan memilih Tambahkan kunci host tepercaya untuk menambahkan kunci tambahan. Anda dapat menggunakan ssh-keyscan perintah terhadap server SFTP untuk mengambil kunci yang diperlukan. Untuk detail tentang format dan jenis kunci host tepercaya yang didukung Transfer Family, lihat SFTPConnectorConfig.

      • Biarkan kotak teks Trusted Host Key kosong saat membuat konektor dan perbarui konektor Anda di lain waktu dengan informasi ini. Jika Anda tidak memiliki informasi kunci host pada saat membuat konektor Anda, Anda dapat membiarkan parameter ini kosong untuk saat ini dan melanjutkan dengan membuat konektor Anda. Setelah konektor dibuat, gunakan ID konektor baru untuk menjalankan TestConnection perintah, baik di AWS CLI atau dari halaman detail konektor. Jika berhasil, TestConnection akan mengembalikan informasi kunci host yang diperlukan. Anda kemudian dapat mengedit konektor menggunakan konsol (atau dengan menjalankan UpdateConnector AWS CLI perintah) dan menambahkan informasi kunci host yang dikembalikan saat Anda menjalankanTestConnection.

      penting

      Jika Anda mengambil kunci host server jarak jauh dengan menjalankanTestConnection, pastikan Anda melakukan validasi di luar band pada kunci yang dikembalikan.

      Anda harus menerima kunci baru sebagai tepercaya, atau memverifikasi sidik jari yang disajikan dengan sidik jari yang sebelumnya diketahui yang telah Anda terima dari pemilik server SFTP jarak jauh yang Anda sambungkan.

    • (Opsional) Untuk Koneksi bersamaan maksimum, dari daftar dropdown, pilih jumlah koneksi bersamaan yang dibuat konektor Anda ke server jarak jauh. Pilihan default pada konsol adalah 5.

      Pengaturan ini menentukan jumlah koneksi aktif yang dapat dibuat konektor Anda dengan server jarak jauh secara bersamaan. Membuat koneksi bersamaan dapat meningkatkan kinerja konektor dengan mengaktifkan operasi paralel.

    • (Opsional) Untuk ta hapan versi rahasia yang dipesan, masukkan daftar label tahap versi Manajer Rahasia yang diurutkan. Konektor mencoba otentikasi menggunakan setiap tahap secara berurutan selama transfer file. Jika Anda tidak menentukan tahapan versi, konektor hanya menggunakanAWSCURRENT. Misalnya, tentukanAWSCURRENT, AWSPREVIOUS untuk mengaktifkan fallback otomatis selama rotasi rahasia.

  7. Di bagian Opsi algoritma kriptografi, pilih kebijakan keamanan dari daftar dropdown di bidang Kebijakan Keamanan. Kebijakan keamanan memungkinkan Anda memilih algoritma kriptografi yang didukung konektor Anda. Untuk detail tentang kebijakan dan algoritma keamanan yang tersedia, lihatKebijakan keamanan untuk AWS Transfer Family Konektor SFTP.

  8. (Opsional) Di bagian Tag, untuk K unci dan Nilai, masukkan satu atau beberapa tag sebagai pasangan kunci-nilai.

  9. Setelah Anda mengonfirmasi semua pengaturan Anda, pilih Buat konektor SFTP untuk membuat konektor SFTP. Jika konektor berhasil dibuat, layar muncul dengan daftar alamat IP statis yang ditetapkan dan tombol U ji koneksi. Gunakan tombol untuk menguji konfigurasi untuk konektor baru Anda.

    Layar pembuatan konektor yang muncul ketika konektor SFTP telah berhasil dibuat. Ini berisi tombol untuk menguji koneksi dan daftar alamat IP statis yang dikelola layanan dari konektor ini.

Halaman Konektor muncul, dengan ID konektor SFTP baru Anda ditambahkan ke daftar. Untuk melihat detail konektor Anda, lihatLihat detail konektor SFTP.

CLI

Anda menggunakan create-connector perintah untuk membuat konektor. Untuk menggunakan perintah ini untuk membuat konektor SFTP, Anda harus memberikan informasi berikut.

  • URL untuk server SFTP jarak jauh. URL ini harus diformat sebagaisftp://partner-SFTP-server-url, misalnyasftp://AnyCompany.com.

  • Peran akses. Pilih Nama Sumber Daya Amazon (ARN) dari peran AWS Identity and Access Management (IAM) yang akan digunakan.

    • Pastikan peran ini menyediakan akses baca dan tulis ke direktori induk dari lokasi file yang digunakan dalam StartFileTransfer permintaan.

    • Pastikan bahwa peran ini memberikan izin secretsmanager:GetSecretValue untuk mengakses rahasia.

      catatan

      Dalam kebijakan, Anda harus menentukan ARN untuk rahasia. ARN berisi nama rahasia, tetapi menambahkan nama dengan enam karakter alfanumerik acak. ARN untuk rahasia memiliki format berikut.

      arn:aws:secretsmanager:region:account-id:secret:aws/transfer/SecretName-6RandomCharacters
    • Pastikan peran ini berisi hubungan kepercayaan yang memungkinkan konektor mengakses sumber daya Anda saat melayani permintaan transfer pengguna. Untuk detail tentang membangun hubungan kepercayaan, lihatUntuk membangun hubungan kepercayaan.

    { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowListingOfUserFolder", "Action": [ "s3:ListBucket", "s3:GetBucketLocation" ], "Effect": "Allow", "Resource": [ "arn:aws:s3:::amzn-s3-demo-bucket" ] }, { "Sid": "HomeDirObjectAccess", "Effect": "Allow", "Action": [ "s3:PutObject", "s3:GetObject", "s3:DeleteObject", "s3:DeleteObjectVersion", "s3:GetObjectVersion", "s3:GetObjectACL", "s3:PutObjectACL" ], "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*" }, { "Sid": "GetConnectorSecretValue", "Effect": "Allow", "Action": [ "secretsmanager:GetSecretValue" ], "Resource": "arn:aws:secretsmanager:us-west-2:111122223333:secret:aws/transfer/SecretName-6RandomCharacters" } ] }
    catatan

    Untuk peran akses, contoh memberikan akses ke satu rahasia. Namun, Anda dapat menggunakan karakter wildcard, yang dapat menyimpan pekerjaan jika Anda ingin menggunakan kembali peran IAM yang sama untuk beberapa pengguna dan rahasia. Misalnya, pernyataan sumber daya berikut memberikan izin untuk semua rahasia yang memiliki nama dimulai denganaws/transfer.

    "Resource": "arn:aws:secretsmanager:region:account-id:secret:aws/transfer/*"

    Anda juga dapat menyimpan rahasia yang berisi kredenSIAL SFTP Anda di yang lain Akun AWS. Untuk detail tentang mengaktifkan akses rahasia lintas akun, lihat Izin ke AWS Secrets Manager rahasia untuk pengguna di akun lain.

  • (Opsional) Pilih peran IAM untuk konektor yang akan digunakan untuk mendorong peristiwa ke CloudWatch log Anda. Kebijakan contoh berikut mencantumkan izin yang diperlukan untuk mencatat peristiwa untuk konektor SFTP.

    { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "logs:CreateLogStream", "logs:DescribeLogStreams", "logs:CreateLogGroup", "logs:PutLogEvents" ], "Resource": "arn:aws:logs:*:*:log-group:/aws/transfer/*" } ] }
  • Berikan informasi konfigurasi SFTP berikut.

    • ARN rahasia AWS Secrets Manager yang berisi kunci pribadi atau kata sandi pengguna SFTP.

    • Bagian publik dari kunci host yang digunakan untuk mengidentifikasi server eksternal. Anda dapat memberikan beberapa kunci host tepercaya jika Anda mau.

    Cara termudah untuk memberikan informasi SFTP adalah dengan menyimpannya ke file. Misalnya, salin teks contoh berikut ke file bernamatestSFTPConfig.json.

    // Listing for testSFTPConfig.json { "UserSecretId": "arn:aws::secretsmanager:us-east-2:123456789012:secret:aws/transfer/example-username-key", "TrustedHostKeys": [ "sftp.example.com ssh-rsa AAAAbbbb...EEEE=" ], "OrderedUserSecretVersionStages": ["AWSCURRENT", "AWSPREVIOUS"] }
    catatan

    Parameter OrderedUserSecretVersionStages bersifat opsional. Jika Anda menghilangkan parameter ini, konektor default ke. ["AWSCURRENT"]

  • Tentukan kebijakan keamanan untuk konektor Anda, masukkan nama kebijakan keamanan.

catatan

SecretIdBisa berupa seluruh ARN atau nama rahasia (example-username-keydalam daftar sebelumnya).

Kemudian jalankan perintah berikut untuk membuat konektor:

aws transfer create-connector --url "sftp://partner-SFTP-server-url" \ --access-role your-IAM-role-for-bucket-access \ --logging-role arn:aws:iam::your-account-id:role/service-role/AWSTransferLoggingAccess \ --sftp-config file:///path/to/testSFTPConfig.json \ --security-policy-name security-policy-name \ --maximum-concurrent-connections integer-from-1-to-5

Saat Anda menjelaskan konektor tipe keluar VPC, respons menyertakan bidang baru:

{ "Connector": { "AccessRole": "arn:aws:iam::123456789012:role/connector-role", "Arn": "arn:aws:transfer:us-east-1:123456789012:connector/c-1234567890abcdef0", "ConnectorId": "c-1234567890abcdef0", "Status": "ACTIVE", "EgressConfig": { "VpcLattice": { "ResourceConfigurationArn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-12345678", "PortNumber": 22 } }, "EgressType": "VPC", "ServiceManagedEgressIpAddresses": null, "SftpConfig": { "TrustedHostKeys": [ "ssh-rsa AAAAB3NzaC..." ], "UserSecretId": "aws/transfer/connector-secret" }, "Url": "sftp://my.sftp.server.com:22" } }

Perhatikan ServiceManagedEgressIpAddresses bahwa nol untuk konektor tipe keluar VPC karena rute lalu lintas melalui VPC Anda alih-alih infrastruktur terkel AWS ola.