Production checklist

Danh sách các bước được đề xuất cần hoàn thành trước khi tung sản phẩm cho người dùng

Các bước dưới đây là danh sách được Cas đề xuất cần thực hiện trước khi triển khai tích hợp Cas trên môi trường Production. Có thể một vài bước không quan trọng nhưng hoàn thành các bước sau sẽ giúp việc tích hợp Cas trên sản phẩm của bạn được đảm bảo hoạt động ổn định, an toàn và dễ bảo trì.

Thiết lập trên Production

Đã có tài khoản trên https://console.bankhub.dev

Đảm bảo bạn đang sử dụng thông tin secret của production, thông tin về secret key bạn có thể xem trên https://console.bankhub.dev

Cấu hình cho Cas Link và server code sử dụng thông tin của môi trường production, bằng cách thay đổi giá trị các API key khi gửi request đến Cas.

Thêm và cấp quyền truy cập cho thành viên, chi tiết Cas teams

Thiếp lập Cas Link

Chắc chắn phần tích hợp Oauth hoạt động

Để tránh tính phí không cần thiết hoặc gây nhầm lẫn cho người dùng, nên triển khai logic tránh duplicate Grant (phân quyền).

Đảm bảo tham số scopes lúc gọi POST /grant/token chỉ bao gồm những quyền bạn muốn sử dụng.

Cấu hình Webhook

Cas sử dụng webhook cho nhiều luồng thông thường. Để ứng dụng của bạn hoạt động mượt mà khi tích hợp Cas thì webhook cần được thiết lập.

Chắc chắn bạn đã nhận được các webhook từ Cas webhook IPs

Xem lại Cas webhook để đảm bảo logic xử lý webhook của bạn chính xác khi hệ thống không ổn định hoặc lượng truy cập tăng đột biến.

Xử lý lỗi

Thỉnh thoảng, gọi Cas API không thành công do hệ thống gián đoạn hoặc lỗi kết nối tới các tổ chức tài chính. Cần triển khai retry logic hoặc xử lý lỗi phù hợp.

Update mode

Update mode (chế độ cập nhật) được sử dụng để cập nhật các thay đổi của tài khoản đã được cấp quyền(ví dụ: người dùng thay đổi mật khẩu tài khoản).

Xử lý lỗi GRANT_LOGIN_REQUIRED của Grant bằng cách chạy Grant với Update mode để cho khách hàng của bạn có thể truy cập thông tin mà không bị gián đoạn. Chi tiết, Update mode

Quản lý Grant

Xoá Grant bằng cách sử dụng /grant/remove khi các phân quyền đó không còn được sử dụng. Ví dụ: bạn cho phép người dùng xoá liên kết tài khoản tài chính thông qua giao diện ứng dụng của bạn.

Xử lý trường hợp cần xác thực OTP cho xoá và tạm dừng phân quyền

Lưu trữ & logging

Lưu trữ log đúng cách để tăng cường xử lý sự cố và bảo mật khi liên hệ với đội ngũ hỗ trợ về một yêu cầu hoặc callback, cũng như tìm kiếm trong Logs.

Access Token và Grant ID là các định danh cốt lõi gắn trực tiếp với tài khoản tài chính của khách hàng. Lưu chúng ở nơi an toàn và liên kết tài khoản với người dùng trên ứng dụng của bạn. Đảm bảo không hiển thị thông tin này ở giao diện ứng dụng. Và một người dùng có thể tạo nhiều Grant (phân quyền) nếu người dùng có nhiều tài khoản tài chính.

Chắc chắn đã lưu trữ các định danh phía dưới ở nơi an toàn, vì chúng sẽ cần thiết khi liên hệ với bộ phận hỗ trợ về chi tiết một yêu cầu hoặc callback.

requestId: Được trả về trên tất cả các Response của Cas API

grantId: Được trả về trên tất cả các Response của Cas API thành công liên quan tới một Grant (phân quyền).

Xử lý chung

Đã xử lý USER_PERMISSION_REVOKED từ webhook của Grant khi một Grant (phân quyền) hoặc tài khoản tài chính bị xoá trên ứng dụng [Cas ID](https://cas.so/cas-id).

Đã xử lý webhook của Grant với mã DEFAULT_UPDATE, giá trị được gửi khi tài khoản tài chính gắn với Grant (phân quyền) đã kết nối lại.