Bảng sau đây tóm tắt thông tin xác thực mà ứng dụng phải quản lý. Để biết thêm thông tin về các loại ứng dụng, hãy xem tài liệu về OAuth 2.0 của Google Identity.
| Quy trình xác thực | Thông tin xác thực | Loại thông tin xác thực | Mục đích |
|---|---|---|---|
|
Ứng dụng web JavaScript Ứng dụng Android |
Mã ứng dụng khách OAuth | Thông tin đăng nhập của ứng dụng | Xác định duy nhất ứng dụng trong quy trình OAuth. |
| Mã truy cập và mã làm mới | Thông tin xác thực người dùng | Đại diện cho sự uỷ quyền của người dùng để cho phép ứng dụng thay mặt họ truy cập vào tài khoản Google Ads của họ. | |
|
Ứng dụng web phía máy chủ Ứng dụng dành cho máy tính và iOS Ứng dụng TV và thiết bị |
Mã ứng dụng khách OAuth và khoá bí mật của ứng dụng khách | Thông tin đăng nhập của ứng dụng | Xác định duy nhất ứng dụng trong quy trình OAuth. |
| Mã truy cập và mã làm mới | Thông tin xác thực người dùng | Đại diện cho sự uỷ quyền của người dùng để cho phép ứng dụng thay mặt họ truy cập vào tài khoản Google Ads của họ. | |
| Tài khoản dịch vụ | Khoá tài khoản dịch vụ OAuth | Thông tin đăng nhập của ứng dụng | Dùng để ký yêu cầu OAuth. |
| Mã truy cập của tài khoản dịch vụ | Thông tin xác thực người dùng | Đại diện cho thông tin uỷ quyền của tài khoản dịch vụ khi người dùng chia sẻ tài khoản Google Ads của họ với tài khoản dịch vụ. |
Có một số điểm cần lưu ý khi quản lý thông tin xác thực cho một ứng dụng Google Ads API.
Xử lý thông tin đăng nhập của ứng dụng một cách an toàn
Thông tin xác thực ứng dụng là các chế độ cài đặt dành riêng cho ứng dụng của bạn và không thay đổi giữa người dùng này với người dùng khác. Hãy xử lý thông tin đăng nhập ứng dụng OAuth của bạn một cách cực kỳ cẩn thận, vì bất kỳ ai có thông tin đăng nhập này đều có thể sử dụng danh tính ứng dụng của bạn để truy cập vào thông tin người dùng. Lưu trữ thông tin xác thực ứng dụng OAuth của bạn ở một nơi an toàn và bảo vệ chúng, giống như cách bạn bảo vệ mật khẩu. Nếu có thể, hãy sử dụng trình quản lý thông tin bí mật, chẳng hạn như Google Cloud Secret Manager, để lưu trữ thông tin đăng nhập của ứng dụng. Bạn tuyệt đối không được đưa thông tin xác thực của ứng dụng vào các kho lưu trữ mã công khai. Bạn nên tránh đưa các khoá này vào bất kỳ kho lưu trữ mã nào.
Xử lý thông tin đăng nhập của người dùng một cách an toàn
Thông tin đăng nhập của người dùng là mã thông báo OAuth đại diện cho thông tin uỷ quyền của người dùng. Người dùng uỷ thác cho bạn bằng cách cấp cho bạn quyền hành động và truy cập vào dữ liệu thay mặt họ – trực tiếp bằng cách xác thực ứng dụng của bạn hoặc gián tiếp bằng cách chia sẻ tài khoản Google Ads của họ với tài khoản dịch vụ của bạn. Tuyệt đối không truyền mã thông báo ở dạng văn bản thuần tuý và luôn lưu trữ mã thông báo đã mã hoá ở trạng thái lưu trữ để cung cấp thêm một lớp bảo vệ trong trường hợp xảy ra sự cố rò rỉ dữ liệu. Thu hồi mã thông báo hoặc quyền của tài khoản dịch vụ khi bạn không cần truy cập vào tài khoản của người dùng nữa. Sau khi thu hồi mã thông báo, hãy xoá vĩnh viễn mã thông báo khỏi ứng dụng hoặc hệ thống của bạn.
Xử lý việc thu hồi và hết hạn mã làm mới
Nếu bạn sử dụng quy trình xác thực người dùng, hãy lưu ý rằng mã làm mới có thể bị vô hiệu hoá bất cứ lúc nào. Ví dụ: nếu bạn sử dụng quy trình xác thực nhiều người dùng, thì người dùng có thể chọn thu hồi quyền truy cập vào ứng dụng của bạn. Mặc dù ứng dụng sử dụng quy trình xác thực một người dùng ít có khả năng bị ảnh hưởng theo cách này, nhưng quy trình thủ công hoặc tự động được thiết kế để bảo vệ người dùng vẫn có thể xoá mã làm mới hoặc mã làm mới có thể hết hạn. Nếu ứng dụng của bạn yêu cầu thông báo thu hồi mã thông báo để mang lại trải nghiệm tốt cho người dùng, thì bạn phải tích hợp với dịch vụ Bảo vệ nhiều tài khoản.
Sử dụng lại thông tin đăng nhập của người dùng trong các yêu cầu API
Mã truy cập OAuth có thời gian tồn tại ngắn và sẽ hết hạn sau một giờ. Nếu bạn sử dụng thư viện ứng dụng Google Ads API, thì thư viện này sẽ xử lý việc hết hạn và làm mới mã truy cập theo cách an toàn cho luồng. Tạo một đối tượng ứng dụng Google Ads API bằng thông tin xác thực OAuth phù hợp và sử dụng lại đối tượng đó trong suốt thời gian hoạt động.
Nếu bạn xây dựng chiến lược quản lý và làm mới mã truy cập của riêng mình, hãy theo dõi thời hạn của mã truy cập và sử dụng lại mã khi mã vẫn còn hiệu lực. Khi bạn yêu cầu làm mới mã thông báo, máy chủ uỷ quyền sẽ trả về một mã truy cập mới cùng với thời gian còn lại tính bằng giây (expires_in). Bạn nên chủ động làm mới mã truy cập nếu còn chưa đến 5 phút trước khi hết hạn.