View a markdown version of this page

Penggunaan AWS Lambda untuk mengintegrasikan penyedia identitas Anda - AWS Transfer Family

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

Penggunaan AWS Lambda untuk mengintegrasikan penyedia identitas Anda

Topik ini menjelaskan cara membuat AWS Lambda fungsi yang terhubung ke penyedia identitas kustom Anda. Anda dapat menggunakan penyedia identitas kustom apa pun, seperti Okta, Manajer Rahasia OneLogin, atau penyimpanan data kustom yang menyertakan logika otorisasi dan otentikasi.

Untuk sebagian besar kasus penggunaan, cara yang disarankan untuk mengonfigurasi penyedia identitas kustom adalah dengan menggunakanSolusi penyedia identitas khusus.

catatan

Sebelum Anda membuat server Transfer Family yang menggunakan Lambda sebagai penyedia identitas, Anda harus membuat fungsi. Untuk contoh fungsi Lambda, lihatContoh fungsi Lambda. Atau, Anda dapat menerapkan tum CloudFormation pukan yang menggunakan salah satuTemplat fungsi lambda. Selain itu, pastikan fungsi Lambda Anda menggunakan kebijakan berbasis sumber daya yang mempercayai Transfer Family. Untuk contoh kebijakan, lihat Kebijakan berbasis sumber daya Lambda.

  1. Buka konsol AWS Transfer Family.

  2. Pilih Buat server untuk membuka halaman Buat server. Untuk Pilih penyedia identitas, pilih Penyedia Identi tas Kustom, seperti yang ditunjukkan pada tangkapan layar berikut.

    Bagian Pilih konsol penyedia identitas dengan penyedia identitas khusus dipilih. Juga memiliki nilai default yang dipilih, yaitu pengguna dapat mengotentikasi menggunakan kata sandi atau kunci mereka.
    catatan

    Pilihan metode otentikasi hanya tersedia jika Anda mengaktifkan SFTP sebagai salah satu protokol untuk server Transfer Family Anda.

  3. Pastikan nilai default, Gunakan AWS Lambda untuk menghubungkan penyedia identitas Anda, dipilih.

  4. Untuk AWS Lambda fungsi, pilih nama fungsi Lambda Anda.

  5. Isi kotak yang tersisa, lalu pilih Buat server. Untuk detail tentang langkah-langkah yang tersisa untuk membuat server, lihatMengkonfigurasi titik akhir server SFTP, FTPS, atau FTP.

Kebijakan berbasis sumber daya Lambda

Anda harus memiliki kebijakan yang mereferensikan server Transfer Family dan Lambda ARN. Misalnya, Anda dapat menggunakan kebijakan berikut dengan fungsi Lambda yang terhubung ke penyedia identitas Anda. Kebijakan ini lolos dari JSON sebagai string.

"Policy": "{\"Version\":\"2012-10-17\", \"Id\":\"default\", \"Statement\":[ {\"Sid\":\"AllowTransferInvocation\", \"Effect\":\"Allow\", \"Principal\":{\"Service\":\"transfer.amazonaws.com\"}, \"Action\":\"lambda:InvokeFunction\", \"Resource\":\"arn:aws:lambda:region:123456789012:function:my-lambda-auth-function\", \"Condition\":{\"ArnLike\":{\"AWS:SourceArn\":\"arn:aws:transfer:region:123456789012:server/server-id\"}}} ]}"
catatan

Dalam contoh kebijakan di atas, ganti masing-masing user input placeholder dengan informasi Anda sendiri.

Struktur pesan peristiwa

Struktur pesan peristiwa dari server SFTP dikirim ke fungsi Authorizer Lambda untuk IDP kustom adalah sebagai berikut.

{ "username": "value", "password": "value", "protocol": "SFTP", "serverId": "s-abcd123456", "sourceIp": "192.168.0.100" }

Di mana username dan password adalah nilai untuk kredenSIAL masuk yang dikirim ke server.

Misalnya, Anda memasukkan perintah berikut untuk menghubungkan:

sftp bobusa@server_hostname

Anda kemudian diminta untuk memasukkan kata sandi Anda:

Enter password: mysecretpassword

Anda dapat memeriksa ini dari fungsi Lambda Anda dengan mencetak peristiwa yang dilewati dari dalam fungsi Lambda. Seharusnya terlihat mirip dengan blok teks berikut.

{ "username": "bobusa", "password": "mysecretpassword", "protocol": "SFTP", "serverId": "s-abcd123456", "sourceIp": "192.168.0.100" }

Struktur acara serupa untuk FTP dan FTPS: satu-satunya perbedaan adalah nilai-nilai tersebut digunakan untuk protocol parameter, bukan SFTP.

Fungsi lambda untuk otentikasi

Untuk menerapkan strategi otentikasi yang berbeda, edit fungsi Lambda. Untuk membantu Anda memenuhi kebutuhan aplikasi Anda, Anda dapat menerapkan CloudFormation tumpukan. Untuk informasi selengkapnya tentang Lambda, lihat Panduan Peng AWS Lambda embang atau Mem bangun fungsi Lambda dengan. Node.js

Nilai Lambda yang valid

Tabel berikut menjelaskan detail untuk nilai yang diterima Transfer Family untuk fungsi Lambda yang digunakan untuk penyedia identitas kustom.

Nilai Deskripsi Diperlukan

Role

Menentukan Nama Sumber Daya Amazon (ARN) dari peran IAM yang mengontrol akses pengguna ke bucket Amazon S3 atau sistem file Amazon EFS. Kebijakan yang dilampirkan pada peran ini menentukan tingkat akses yang ingin Anda berikan kepada pengguna saat mentransfer file masuk dan keluar dari sistem file Amazon S3 atau Amazon EFS Anda. IAM role juga harus berisi hubungan kepercayaan yang mengizinkan server untuk mengakses sumber daya Anda saat melayani permintaan transfer pengguna.

Untuk detail tentang membangun hubungan kepercayaan, lihatUntuk membangun hubungan kepercayaan.

Diperlukan

PosixProfile

Identitas POSIX lengkap, termasuk ID pengguna (Uid), ID grup (Gid), dan ID grup sekunder apa pun (SecondaryGids), yang mengontrol akses pengguna Anda ke sistem file Amazon EFS Anda. POSIX izin yang ditetapkan pada file dan direktori dalam sistem file Anda menentukan tingkat akses pengguna Anda mendapatkan ketika mentransfer file ke dalam dan keluar dari sistem file Amazon EFS Anda.

Diperlukan untuk penyimpanan dukungan Amazon EFS

PublicKeys

Daftar nilai kunci publik SSH yang valid untuk pengguna ini. Daftar kosong menyiratkan bahwa ini bukan login yang valid. Tidak boleh dikembalikan selama otentikasi kata sandi.

Opsional

Policy

Kebijakan sesi untuk pengguna Anda sehingga Anda dapat menggunakan peran IAM yang sama di beberapa pengguna. Kebijakan ini mencakup bawah akses pengguna ke bagian dari bucket Amazon S3 mereka. Untuk informasi selengkapnya tentang menggunakan kebijakan sesi dengan penyedia identitas khusus, lihat contoh kebijakan sesi dalam topik ini.

Opsional

HomeDirectoryType

Jenis direktori landing (folder) yang Anda inginkan sebagai direktori home pengguna Anda saat mereka masuk ke server.

  • Jika Anda mengaturnya kePATH, pengguna akan melihat bucket Amazon S3 absolut atau jalur Amazon EFS seperti pada klien protokol transfer file mereka.

  • Jika Anda menyetelnya keLOGICAL, Anda harus menyediakan pemetaan dalam HomeDirectoryDetails parameter untuk membuat jalur Amazon S3 atau Amazon EFS terlihat oleh pengguna Anda.

Opsional

HomeDirectoryDetails

Pemetaan direktori logis yang menentukan jalur dan kunci Amazon S3 atau Amazon EFS mana yang harus terlihat oleh pengguna Anda dan bagaimana Anda ingin membuatnya terlihat. Anda harus menentukan Entry dan Target pair, di mana Entry menunjukkan bagaimana jalur dibuat terlihat dan Target merupakan jalur Amazon S3 atau Amazon EFS yang sebenarnya.

Diperlukan jika HomeDirectoryType memiliki nilai LOGICAL

HomeDirectory

Direktori landing untuk pengguna saat mereka masuk ke server menggunakan klien. Format tergantung pada backend penyimpanan Anda:

  • Untuk Amazon S3: /bucket-name/user-home-directory

    Contoh: /amzn-s3-demo-bucket/users/john

  • Untuk Amazon EFS: /fs-12345/user-home-directory

    Contoh: /fs-faa1a123/users/john

penting

Nama bucket atau ID sistem file Amazon EFS harus disertakan dalam jalur. Menghilangkan informasi ini akan mengakibatkan kesalahan “File tidak ditemukan” selama transfer file.

Opsional

catatan

HomeDirectoryDetailsadalah representasi string dari peta JSON. Ini berbeda denganPosixProfile, yang merupakan objek peta JSON yang sebenarnya, dan PublicKeys yang merupakan array string JSON. Lihat contoh kode untuk detail khusus bahasa.

HomeDirectory Persyaratan Format

Saat menggunakan HomeDirectory parameter, pastikan Anda menyertakan format jalur lengkap:

  • Untuk penyimpanan Amazon S3: Selalu sertakan nama bucket dalam format /bucket-name/path

  • Untuk penyimpanan Amazon EFS: Sel alu sertakan ID sistem file dalam format /fs-12345/path

Penyebab umum kesalahan “File tidak ditemukan” adalah menghilangkan nama bucket atau ID sistem file EFS dari HomeDirectory jalur. Pengaturan HomeDirectory ke hanya / tanpa pengenal penyimpanan akan menyebabkan otentikasi berhasil tetapi operasi file gagal.

Contoh fungsi Lambda

Bagian ini menyajikan beberapa contoh fungsi Lambda, baik di NodeJS dan Python.

catatan

Dalam contoh ini, pengguna, peran, profil POSIX, kata sandi, dan detail direktori home semuanya adalah contoh, dan harus diganti dengan nilai aktual Anda.

Logical home directory, NodeJS

Fungsi contoh NodeJS berikut menyediakan detail untuk pengguna yang memiliki direktori home logis.

// GetUserConfig Lambda exports.handler = (event, context, callback) => { console.log("Username:", event.username, "ServerId: ", event.serverId); var response; // Check if the username presented for authentication is correct. This doesn't check the value of the server ID, only that it is provided. if (event.serverId !== "" && event.username == 'example-user') { var homeDirectoryDetails = [ { Entry: "/", Target: "/fs-faa1a123" } ]; response = { Role: 'arn:aws:iam::123456789012:role/transfer-access-role', // The user is authenticated if and only if the Role field is not blank PosixProfile: {"Gid": 65534, "Uid": 65534}, // Required for EFS access, but not needed for S3 HomeDirectoryDetails: JSON.stringify(homeDirectoryDetails), HomeDirectoryType: "LOGICAL", }; // Check if password is provided if (!event.password) { // If no password provided, return the user's SSH public key response['PublicKeys'] = [ "ssh-rsa abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789" ]; // Check if password is correct } else if (event.password !== 'Password1234') { // Return HTTP status 200 but with no role in the response to indicate authentication failure response = {}; } } else { // Return HTTP status 200 but with no role in the response to indicate authentication failure response = {}; } callback(null, response); };
Path-based home directory, NodeJS

Fungsi contoh NodeJS berikut menyediakan detail untuk pengguna yang memiliki direktori home berbasis jalur.

// GetUserConfig Lambda exports.handler = (event, context, callback) => { console.log("Username:", event.username, "ServerId: ", event.serverId); var response; // Check if the username presented for authentication is correct. This doesn't check the value of the server ID, only that it is provided. // There is also event.protocol (one of "FTP", "FTPS", "SFTP") and event.sourceIp (e.g., "127.0.0.1") to further restrict logins. if (event.serverId !== "" && event.username == 'example-user') { response = { Role: 'arn:aws:iam::123456789012:role/transfer-access-role', // The user is authenticated if and only if the Role field is not blank Policy: '', // Optional, JSON stringified blob to further restrict this user's permissions // HomeDirectory format depends on your storage backend: // For S3: '/bucket-name/user-home-directory' (e.g., '/my-transfer-bucket/users/john') // For EFS: '/fs-12345/user-home-directory' (e.g., '/fs-faa1a123/users/john') HomeDirectory: '/my-transfer-bucket/users/example-user' // S3 example - replace with your bucket name // HomeDirectory: '/fs-faa1a123/users/example-user' // EFS example - uncomment for EFS }; // Check if password is provided if (!event.password) { // If no password provided, return the user's SSH public key response['PublicKeys'] = [ "ssh-rsa abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789" ]; // Check if password is correct } else if (event.password !== 'Password1234') { // Return HTTP status 200 but with no role in the response to indicate authentication failure response = {}; } } else { // Return HTTP status 200 but with no role in the response to indicate authentication failure response = {}; } callback(null, response); };
Logical home directory, Python

Fungsi contoh Python berikut menyediakan detail untuk pengguna yang memiliki direktori home logis.

# GetUserConfig Python Lambda with LOGICAL HomeDirectoryDetails import json def lambda_handler(event, context): print("Username: {}, ServerId: {}".format(event['username'], event['serverId'])) response = {} # Check if the username presented for authentication is correct. This doesn't check the value of the server ID, only that it is provided. if event['serverId'] != '' and event['username'] == 'example-user': homeDirectoryDetails = [ { 'Entry': '/', 'Target': '/fs-faa1a123' } ] response = { 'Role': 'arn:aws:iam::123456789012:role/transfer-access-role', # The user will be authenticated if and only if the Role field is not blank 'PosixProfile': {"Gid": 65534, "Uid": 65534}, # Required for EFS access, but not needed for S3 'HomeDirectoryDetails': json.dumps(homeDirectoryDetails), 'HomeDirectoryType': "LOGICAL" } # Check if password is provided if event.get('password', '') == '': # If no password provided, return the user's SSH public key response['PublicKeys'] = [ "ssh-rsa abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789" ] # Check if password is correct elif event['password'] != 'Password1234': # Return HTTP status 200 but with no role in the response to indicate authentication failure response = {} else: # Return HTTP status 200 but with no role in the response to indicate authentication failure response = {} return response
Path-based home directory, Python

Fungsi contoh Python berikut menyediakan detail untuk pengguna yang memiliki direktori home berbasis jalur.

# GetUserConfig Python Lambda with PATH HomeDirectory def lambda_handler(event, context): print("Username: {}, ServerId: {}".format(event['username'], event['serverId'])) response = {} # Check if the username presented for authentication is correct. This doesn't check the value of the server ID, only that it is provided. # There is also event.protocol (one of "FTP", "FTPS", "SFTP") and event.sourceIp (e.g., "127.0.0.1") to further restrict logins. if event['serverId'] != '' and event['username'] == 'example-user': response = { 'Role': 'arn:aws:iam::123456789012:role/transfer-access-role', # The user will be authenticated if and only if the Role field is not blank 'Policy': '', # Optional, JSON stringified blob to further restrict this user's permissions # HomeDirectory format depends on your storage backend: # For S3: '/bucket-name/user-home-directory' (e.g., '/my-transfer-bucket/users/john') # For EFS: '/fs-12345/user-home-directory' (e.g., '/fs-faa1a123/users/john') 'HomeDirectory': '/my-transfer-bucket/users/example-user', # S3 example - replace with your bucket name # 'HomeDirectory': '/fs-faa1a123/users/example-user', # EFS example - uncomment for EFS 'HomeDirectoryType': "PATH" # Not strictly required, defaults to PATH } # Check if password is provided if event.get('password', '') == '': # If no password provided, return the user's SSH public key response['PublicKeys'] = [ "ssh-rsa abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789" ] # Check if password is correct elif event['password'] != 'Password1234': # Return HTTP status 200 but with no role in the response to indicate authentication failure response = {} else: # Return HTTP status 200 but with no role in the response to indicate authentication failure response = {} return response

Menguji konfigurasi Anda

Setelah membuat penyedia identitas kustom, Anda harus menguji konfigurasi Anda.

Console
Untuk menguji konfigurasi Anda dengan menggunakan AWS Transfer Family konsol
  1. Buka konsol AWS Transfer Family.

  2. Pada halaman Server, pilih server baru Anda, pilih Tind akan, lalu pilih U ji.

  3. Masukkan teks untuk Nama Pengguna dan Kata Sandi yang Anda tetapkan saat Anda menerapkan CloudFormation tumpukan. Jika Anda menyimpan opsi default, nama pengguna adalah myuser dan kata sandinya adalahMySuperSecretPassword.

  4. Pilih protokol Server dan masukkan alamat IP untuk IP Sumber, jika Anda mengaturnya saat Anda menerapkan tumpu CloudFormation kan.

CLI
Untuk menguji konfigurasi Anda dengan menggunakan AWS CLI
  1. Jalankan perintah test-identity-provider. Ganti masing-masing user input placeholder dengan informasi Anda sendiri, seperti yang dijelaskan dalam langkah-langkah selanjutnya.

    aws transfer test-identity-provider --server-id s-1234abcd5678efgh --user-name myuser --user-password MySuperSecretPassword --server-protocol FTP --source-ip 127.0.0.1
  2. Masukkan ID server.

  3. Masukkan nama pengguna dan kata sandi yang Anda tetapkan saat Anda menerapkan CloudFormation tumpukan. Jika Anda menyimpan opsi default, nama pengguna adalah myuser dan kata sandinya adalahMySuperSecretPassword.

  4. Masukkan protokol server dan alamat IP sumber, jika Anda mengaturnya saat Anda menerapkan tumpu CloudFormation kan.

Jika otentikasi pengguna berhasil, pengujian mengembalikan respons StatusCode: 200 HTTP, string kosong Message: "" (yang akan berisi alasan kegagalan jika tidak), dan Response bidang.

catatan

Dalam contoh respons di bawah ini, Response bidang adalah objek JSON yang telah “disatukan” (diubah menjadi string JSON datar yang dapat digunakan di dalam program), dan berisi rincian peran dan izin pengguna.

{ "Response":"{\"Policy\":\"{\\\"Version\\\":\\\"2012-10-17\\\",\\\"Statement\\\":[{\\\"Sid\\\":\\\"ReadAndListAllBuckets\\\",\\\"Effect\\\":\\\"Allow\\\",\\\"Action\\\":[\\\"s3:ListAllMybuckets\\\",\\\"s3:GetBucketLocation\\\",\\\"s3:ListBucket\\\",\\\"s3:GetObjectVersion\\\",\\\"s3:GetObjectVersion\\\"],\\\"Resource\\\":\\\"*\\\"}]}\",\"Role\":\"arn:aws:iam::000000000000:role/MyUserS3AccessRole\",\"HomeDirectory\":\"/\"}", "StatusCode": 200, "Message": "" }

Templat fungsi lambda

Anda dapat menerapkan tumpukan CloudFormation yang menggunakan fungsi Lambda untuk otentikasi. Kami menyediakan beberapa templat yang mengotentikasi dan mengotorisasi pengguna Anda menggunakan kredenSIAL masuk. Anda dapat memodifikasi template atau AWS Lambda kode ini untuk lebih menyesuaikan akses pengguna.

catatan

Anda dapat membuat FIPS-enabled AWS Transfer Family server melalui CloudFormation dengan menentukan kebijakan FIPS-enabled keamanan di template Anda. Kebijakan keamanan yang tersedia dijelaskan di Kebijakan keamanan untuk AWS Transfer Family server

Untuk membuat CloudFormation tumpukan untuk digunakan untuk otentikasi
  1. Buka CloudFormation konsol di https://console.aws.amazon.com/cloudformation.

  2. Ikuti petunjuk untuk menerapkan tumpu CloudFormation kan dari template yang ada di Mem ilih template tumpukan di Panduan AWS CloudFormation Pengguna.

  3. Gunakan salah satu template berikut untuk membuat fungsi Lambda untuk digunakan untuk otentikasi di Transfer Family.

    • Templat tumpukan klasik (Amazon Cognito)

      Template dasar untuk membuat AWS Lambda untuk digunakan sebagai penyedia identitas khusus di AWS Transfer Family. Ini mengotentikasi terhadap Amazon Cognito untuk otentikasi berbasis kata sandi dan kunci publik dikembalikan dari bucket Amazon S3 jika otentikasi berbasis kunci publik digunakan. Setelah penerapan, Anda dapat memodifikasi kode fungsi Lambda untuk melakukan sesuatu yang berbeda.

    • AWS Secrets Manager templat tumpukan

      Template dasar yang digunakan AWS Lambda dengan AWS Transfer Family server untuk mengintegrasikan Secrets Manager sebagai penyedia identitas. Ini mengotentikasi terhadap entr AWS Secrets Manager i dalam formataws/transfer/server-id/username. Selain itu, rahasia harus menyimpan pasangan kunci-nilai untuk semua properti pengguna yang dikembalikan ke Transfer Family. Setelah penerapan, Anda dapat memodifikasi kode fungsi Lambda untuk melakukan sesuatu yang berbeda.

    • Template tumpukan Okta: Template dasar yang digunakan AWS Lambda dengan AWS Transfer Family server untuk mengintegrasikan Okta sebagai penyedia identitas khusus.

    • Okta-mfa template tumpukan: Template dasar yang digunakan AWS Lambda dengan AWS Transfer Family server untuk mengintegrasikan Okta, dengan Otentikasi Multi Faktor, sebagai penyedia identitas khusus.

    • Template Azure Active Directory: detail untuk tumpukan ini dijelaskan di posting blog Meng autentikasi AWS Transfer Family dengan Azure Active Directory dan AWS Lambda.

    Setelah tumpukan telah digunakan, Anda dapat melihat detail tentangnya di tab Out put di CloudFormation konsol.

    Menerapkan salah satu tumpukan ini adalah cara termudah untuk mengintegrasikan penyedia identitas kustom ke alur kerja Transfer Family.