Đặt tên
- Client đặt theo quy ước
<app>-<ma-he-thong>, do đội vận hành xác nhận. - Biến thể theo nền tảng dùng hậu tố:
<app>-mobile-...,<app>-desktop-...,<app>-cli-...,<svc>-svc-.... - Mỗi loại app dùng một client riêng. Không dùng chung một client cho cả public (SPA, mobile, desktop) và confidential (backend).
Ai cấu hình client
- Đội vận hành DBIZ khai client trong cấu hình tự động của nền tảng. Mỗi lần triển khai, hệ thống đưa client về đúng cấu hình đã khai.
- Không tạo client tay trên trang quản trị. Client tạo tay không được quản lý: cấu hình dễ bị ghi đè hoặc mất khi dựng lại hệ thống.
- Thay đổi tay trên một client đã quản lý (thêm redirect URI, web origin…) sẽ bị xoá ở lần triển khai sau. Cần thêm gì thì gửi yêu cầu để được khai vào cấu hình.
- Client secret do hệ thống sinh, lưu trong kho secret và nạp vào app qua biến môi trường. Dev không cần giữ bản sao secret.
- Client web (public có PKCE, hoặc confidential) cấu hình được ngay. Client service account và device grant cần thêm một bước chuẩn bị, nên báo trước.
Host công khai mới
Nếu app cần một host công khai chưa có, báo đội vận hành cùng lúc với yêu cầu client. Đội vận hành kiểm host chưa bị dùng, tạo bản ghi DNS và đường vào cho host, rồi khai redirect URI, web origin và post-logout URI theo host mới. App mobile dùng universal link / App Link cũng cần một host công khai để phục vụ file/.well-known/apple-app-site-association và /.well-known/assetlinks.json.
Checklist gửi kèm yêu cầu
- Tên client đề xuất và loại app (SPA, web có backend, API, mobile, desktop, CLI, service-to-service)
- Redirect URIs, post-logout redirect URIs, web origins: đủ scheme và host; web origin không có
/cuối - Có cần
audriêng không (audience mapper trỏ tới API nào) - Có chặn theo organization không, cần thêm claim gì
- Host công khai mới (nếu có)
- Với client confidential: tên biến môi trường hoặc secret mà app sẽ đọc client secret
- Với service account: API đích và quyền tối thiểu cần có