Hướng dẫn thiết lập SFTP

MỤC LỤC

• Hướng dẫn thiết lập SFTP
  • Lưu trữ và xác thực
  • Cấu hình
  • Tần suất và lịch truyền tệp
  • Báo cáo và xử lý lỗi
    • Các câu hỏi thường gặp liên quan
  • Cách tạo khóa SSH công khai cho máy chủ SFTP
    • Định dạng
    • Mẫu
    • Tạo khóa SSH 
    • Ví dụ về khóa
  • Hướng dẫn cho từng loại bản ghi cụ thể

Lưu trữ và xác thực

Chúng tôi sẽ lưu trữ thư mục SFTP của quý khách trên một máy chủ SFTP riêng biệt (thông qua AWS). Mỗi khách hàng sẽ có một tài khoản người dùng riêng để truy cập trực tiếp vào thư mục SFTP của mình. Hệ thống hỗ trợ xác thực bằng khóa. Do đó, quý khách cần tạo một cặp khóa riêng tư - công khai và nhập khóa công khai vào mục Public Key khi thiết lập thư mục của mình. Khóa này cần được tạo theo định dạng openSSH RSA . Để biết cách tạo khóa, vui lòng xem mục Cách tạo khóa SSH công khai cho máy chủ SFTP bên dưới.

Cấu hình

1. Nhập khóa công khai đã tạo vào trường Public Key . Quý khách cũng có thể cập nhật trường Username . Giá trị trong trường Username phải bắt đầu bằng chữ cái, số hoặc dấu gạch dưới và có độ dài từ 3 đến 100 ký tự. Tên này có thể chứa chữ cái, số, dấu gạch dưới, ký tự @, dấu chấm (.) và dấu gạch ngang (-).

2. Sao chép các thông tin Username, URL miền Spotnanavà Số cổng (Port number) vào nơi lưu trữ an toàn để bộ phận kỹ thuật của quý công ty sử dụng khi cấu hình gửi tệp vào thư mục mới tạo. 
   Lưu ý: Sau khi hoàn tất thiết lập thư mục SFTP, quý khách vẫn có thể xem lại các thông tin này trong mục Quản lý.

3. Vui lòng nhập địa chỉ email mà quý khách muốn nhận báo cáo về việc tải tệp lên tại trường SFTP email notification . Để biết chi tiết, vui lòng xem mục Báo cáo và xử lý lỗi bên dưới.

4. Nhấn Kết nối.

Sau khi thêm khóa công khai, trạng thái ban đầu sẽ là Chưa xác thực. Trạng thái này sẽ hiển thị trên OBT cho đến khi hệ thống nhận được một tệp trong thư mục. Tệp gửi lên có thể là tệp kiểm thử hoặc tệp dữ liệu nhân sự, hoặc tệp trường tùy chỉnh (chỉ các tệp đúng định dạng mới được xử lý). Nếu sau này quý khách cập nhật lại khóa công khai, trạng thái sẽ được đặt lại thành Chưa xác thực cho đến khi có tệp mới được gửi lên.

Để xóa thư mục SFTP, hãy nhấn Ngắt kết nối. Hành động này sẽ xóa thư mục SFTP của quý khách. Nếu sau này cần thiết lập lại, quý khách sẽ phải nhập lại toàn bộ thông tin như đã hướng dẫn ở trên từ đầu.

Tần suất và lịch truyền tệp

Quý khách hoàn toàn chủ động quyết định tần suất và thời gian gửi tệp. Hệ thống sẽ tự động bắt đầu xử lý mỗi khi phát hiện có tệp mới được tải lên thư mục SFTP. Điều này có nghĩa là ngay khi quý khách tải tệp lên, ứng dụng sẽ tiến hành xử lý ngay lập tức. 

Để tham khảo khuyến nghị về tần suất và lịch truyền tệp cho từng loại bản ghi (ví dụ: người dùng, trường tùy chỉnh, pháp nhân), vui lòng xem mục Tần suất và lịch truyền tệp trong hướng dẫn SFTP cho từng loại bản ghi.

Báo cáo và xử lý lỗi

Chúng tôi sẽ ghi nhận dữ liệu về các lần tải tệp của quý khách và tạo báo cáo nội bộ sau mỗi lần tải lên. Báo cáo này sẽ được gửi tới địa chỉ email mà quý khách đã cung cấp tại trường SFTP email notification khi thiết lập. Với mỗi tệp được tải lên, báo cáo sẽ bao gồm: 

• các lý do khiến tệp tải lên không thành công (sai định dạng, thiếu tên cột, v.v.).

• các lý do khiến một dòng dữ liệu trong tệp không được tải lên. Hệ thống không cập nhật từng phần mà sẽ loại bỏ cả dòng nếu có lỗi ở một cột bất kỳ hoặc thiếu trường bắt buộc. 

• trạng thái của lần tải lên (đang chờ, thành công, thất bại).

Quý khách có thể sử dụng nội dung báo cáo này để kiểm tra và xử lý lỗi. Nếu không tự khắc phục được, vui lòng liên hệ bộ phận hỗ trợ kỹ thuật. 

Các câu hỏi thường gặp liên quan

1. Chúng tôi có chấp nhận tệp bổ sung chỉ chứa các bản ghi cần cập nhật hoặc thêm mới không?

   • Có

2. Tệp mà quý khách tải lên (dù qua SFTP hay tải thủ công) có bắt buộc phải chứa các cột tùy chọn nếu không sử dụng đến không?

   • Không

Cách tạo khóa SSH công khai cho máy chủ SFTP

Vui lòng làm theo hướng dẫn dưới đây để tạo khóa SSH công khai và cung cấp cho chúng tôi.

Định dạng

• Loại: Chuỗi ký tự (String)

• Giới hạn độ dài: Tối đa 2048 ký tự.

Mẫu

 ^ssh-rsa\s+[A-Za-z0-9+/]+[=]{0,3}(\s+.+)?\s*$

Tạo khóa SSH 

Để tạo khóa SSH, hãy chạy lệnh sau trên Command Prompt (Windows) hoặc Terminal (macOS, Linux, UNIX):

ssh-keygen -t rsa -b 4096 -f key_name

Trong đó 

• -t là loại mã hóa

• -b là độ dài khóa (tính bằng bit)

• -f là tên khóa

Ví dụ về khóa

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDDJB9oBRPrBegMDPEQo+HmNDb/jKUJL6q2kQpNNMDjNps9mhhwJ1dP/lOavMitBPAndeXlwaNEm2XbGaSrZtD/tbQTX1HQjP6pacy+Alf8kYBm5QFfl/Z6lGC8qHys10fpRXgYE7UhdSv6VyRqt1gELGFQwVBZ2kJJuBGJF1IRywwvG/h68B8iWU1+6KEWYQoUcT45r3j3otnx4NhhzpTiNgDbMk0ix+kar4/IstobRLcb7rt7FoUerTLNrVDi69DqbsGY5LN+NM8jVx0sPQLRC/ruil8pTHP3k4rDCc7a80+sH4sUTW+mHc7MTqbi/CcyyFAD8h7p6WqxEydOaJjMnvqAbE17BOj0TSxv3HMohTf3skzE7PbzVcjIfHTpFPGxmJkghAYAMi5l9VvAs91IpVylxjqPss3xQQJIZEmQdG2k7zk/UpsUFlmaOj6lCHRicFKCixKekzzm3nFuJvDEklurtydOQjZ8WkPzTSJfZBdKMuMUi0SQ9m9ZAw99t0=

Hướng dẫn cho từng loại bản ghi cụ thể

Để biết hướng dẫn chi tiết về cách tải từng loại bản ghi qua SFTP, vui lòng tham khảo các chủ đề dưới đây:

• Luồng dữ liệu nhân sự (người dùng)
• Vai trò
• Trường tùy chỉnh
• Văn phòng
• Pháp nhân