Nhảy tới nội dung

Kiến trúc tích hợp với hệ thống FPT AI eKYC qua SDK

1. Giới thiệu​

Tài liệu này mô tả kiến trúc hệ thống của hai phương án triển khai khi khách hàng tích hợp với hệ thống FPT AI eKYC sử dụng Web hoặc Mobile SDK, bao gồm sơ đồ kiến trúc, chi tiết luồng dữ liệu, ưu nhược điểm và các điểm cần lưu ý trong quá trình triển khai.

2. Các thành phần hệ thống liên quan​

  • FPT AI eKYC Backend: Hệ thống backend của FPT AI eKYC, đảm trách việc quản lý các phiên thực hiện eKYC và các luồng dữ liệu ra vào hệ thống.
  • FPT AI eKYC SDK: Bộ SDK được cung cấp bởi FPT AI eKYC bao gồm cho môi trường web và mobile, cho phép tích hợp với trang web hoặc ứng dụng của khách hàng.
  • Proxy Server: Máy chủ trung gian giữa hệ thống của khách hàng và hệ thống FPT AI eKYC, đặt tại hạ tầng của khách hàng, đảm trách việc truyền tải dữ liệu giữa hai bên.
  • Backend của khách hàng: Hệ thống backend của khách hàng, đảm trách việc nhận dữ liệu sinh ra trong quá trình thực hiện eKYC hoặc các logic khác liên quan đến luồng eKYC.

3. Các phương án tích hợp​

3.1. Tích hợp không sử dụng Proxy Server​

3.1.1. Mô tả​

Đây là phương án tích hợp đơn giản nhất, trong đó SDK của FPT AI eKYC sẽ gửi trực tiếp dữ liệu đến backend của FPT AI eKYC mà không cần thông qua Proxy Server. Để đảm bảo tính bảo mật và an toàn dữ liệu, kết quả xử lý sẽ được gửi về backend của khách hàng qua một callback URL đã được đăng ký trước đó.

Lưu đồ luồng dữ liệu giữa các thành phần trong phương án này như sau:

Ngoài việc lấy dữ liệu và kết quả xử lý phiên eKYC từ request callback, khách hàng có thể lấy các thông tin này từ SDK trả cho ứng dụng hoặc chủ động lấy theo client_uuid backend của FPT AI eKYC qua API GET /callback/get_result (chi tiết được mô tả ở tài liệu API_result).

3.1.2. Ưu điểm​

  • Đơn giản, dễ triển khai. Hệ thống FPT AI eKYC và hệ thống của khách hàng gần như tách biệt hoàn toàn.
  • Giảm được chi phí về thời gian và công sức của đội ngũ kỹ thuật phía khách hàng trong quá trình triển khai.
  • Không cần duy trì thêm một máy chủ trung gian. Từ đó:
    • Giảm thiểu độ trễ trong việc truyền tải dữ liệu giữa SDK và backend của FPT AI eKYC.
    • Dễ dàng hơn trong việc xử lý/phát hiện các lỗi phát sinh trong quá trình tích hợp cũng như sử dụng hệ thống eKYC

3.1.3. Nhược điểm​

  • Không thể kiểm soát được luồng dữ liệu giữa SDK và backend của FPT AI eKYC.
  • Không thể can thiệp được vào kết quả cuối cùng của phiên eKYC mà hoàn toàn phụ thuộc vào kết quả xử lý hệ thống FPT AI eKYC.
  • Việc lấy kết quả xử lý và dữ liệu eKYC phụ thuộc vào lưu trữ của hệ thống FPT AI eKYC nằm trên FPT Cloud.

3.2. Tích hợp sử dụng Proxy Server​

3.2.1. Mô tả​

Đây là phương án tích hợp phức tạp hơn, trong đó SDK của FPT AI eKYC sẽ gửi dữ liệu đến Proxy Server của khách hàng, sau đó Proxy Server sẽ gửi dữ liệu đến backend của FPT AI eKYC. Kết quả xử lý sẽ được gửi về Proxy Server và từ đó Proxy Server sẽ gửi kết quả về SDK và backend của khách hàng để phục vụ lưu trữ.

Lưu đồ luồng dữ liệu giữa các thành phần trong phương án này như sau:

Dữ liệu và kết quả của phiên eKYC có thể được xử lý lưu trữ từ Proxy Server (nằm trong hệ thống của khách hàng) mà không cần phải đợi callback từ eKYC Backend. Khách hàng vẫn có thể lấy kết quả callback nếu cần thiết. Ngoài ra, dữ liệu và kết quả eKYC cũng có thể lấy được từ SDK trả về cho ứng dụng.

3.2.2. Ưu điểm​

  • Có thể kiểm soát được luồng dữ liệu giữa SDK và backend của FPT AI eKYC.
  • Có thể can thiệp được vào kết quả cuối cùng của phiên eKYC mà không hoàn toàn phụ thuộc vào kết quả xử lý hệ thống FPT AI eKYC.
  • Dữ liệu và kết quả của phiên eKYC sẽ đi qua hệ thống của khách hàng trước nên có thể hoàn toàn chủ động việc lưu trữ mà không cần phụ thuộc việc lưu trữ trên cloud của hệ thống FPT AI eKYC.

3.2.3. Nhược điểm​

  • Phức tạp hơn trong việc triển khai. Hệ thống FPT AI eKYC và hệ thống của khách hàng không hoàn toàn tách biệt, tính ổn định của luồng eKYC sẽ phụ thuộc rất lớn vào kết nối tới Proxy Server.
  • Cần duy trì thêm một máy chủ trung gian. Từ đó:
    • Tăng độ trễ trong việc truyền tải dữ liệu giữa SDK và backend của FPT AI eKYC.
    • Khó khăn hơn trong việc xử lý/phát hiện các lỗi phát sinh trong quá trình tích hợp cũng như sử dụng hệ thống eKYC.
  • Cần có thêm một đội ngũ kỹ thuật để duy trì máy chủ trung gian này.