Khoá API là một chuỗi ký tự dài mà ứng dụng cấp cho bạn, ai cầm chuỗi đó là được ứng dụng coi như chính bạn trong phạm vi khoá cho phép. Nó không có mặt, không có vân tay, không hỏi mã xác nhận gửi về điện thoại. Vì vậy khoá API lọt ra ngoài thường nguy hiểm hơn lộ mật khẩu đăng nhập, nơi còn có lớp xác thực hai bước che chắn.
Người không lập trình gặp khoá API khi nối công cụ kéo thả với một ứng dụng chưa có sẵn kết nối, hoặc khi thêm bước gọi mô hình AI vào luồng. Bài này đi qua vòng đời của một chiếc khoá: tạo sao cho hẹp, cất ở đâu, đặt tên thế nào, khi nào thay, và quy trình xử lý trong giờ đầu tiên nếu nghi khoá bị lộ.
Khoá API khác mật khẩu và khác nút cho phép đăng nhập
Mật khẩu là thứ bạn gõ để vào giao diện, thường đi kèm mã xác nhận gửi qua điện thoại. Khoá API là thứ phần mềm đưa ra mỗi lần gọi, không có màn hình nào hiện lên hỏi thêm. Một khoá có thể dùng từ bất kỳ máy nào trên thế giới, trừ khi bên cung cấp cho phép giới hạn theo địa chỉ mạng.
Ngoài khoá API, bạn sẽ gặp kiểu kết nối bằng nút đăng nhập rồi bấm cho phép. Kiểu này, thường được gọi theo tên chuẩn OAuth, không đưa mật khẩu hay khoá cho công cụ kết nối, mà cấp cho nó một mã truy cập có hạn dùng và có danh sách quyền hiện rõ trên màn hình đồng ý. Khi có lựa chọn, kiểu bấm cho phép thường dễ quản hơn vì thu hồi được từ trang tài khoản của bạn. Phần cấp quyền kiểu này được bàn kỹ ở danh mục an toàn khi kết nối của trang; bài này tập trung vào khoá API dạng chuỗi.
Có ứng dụng cấp một cặp gồm mã công khai và mã bí mật. Mã công khai giống số tài khoản, lộ không sao lắm; mã bí mật mới là thứ phải giữ. Đọc kỹ tài liệu để biết chuỗi nào là chuỗi nào, đừng giữ kín cái công khai mà lại dán cái bí mật vào ghi chú.
Tạo khoá sao cho hẹp nhất có thể
Khoá càng ít quyền thì khi lộ càng ít thiệt hại. Trước khi bấm tạo, đi qua các bước sau.
- Viết ra một câu luồng này cần làm gì với ứng dụng đó, ví dụ chỉ đọc đơn hàng mới, không sửa, không xoá.
- Trong trang tạo khoá, nếu có tuỳ chọn phạm vi quyền, chỉ tích đúng phần cần. Bỏ hết các quyền ghi, quyền xoá, quyền quản trị nếu luồng chỉ đọc.
- Nếu ứng dụng cho tạo khoá gắn với một người dùng, tạo một tài khoản riêng cho tự động hoá với vai trò hạn chế, rồi tạo khoá từ tài khoản đó thay vì từ tài khoản chủ.
- Đặt tên khoá nói rõ mục đích và nơi dùng, ví dụ luồng đơn hàng sang bảng đóng gói, tạo tháng mười. Tên khoá vô nghĩa là lý do số một khiến không ai dám xoá khoá cũ.
- Nếu có tuỳ chọn hạn dùng hoặc giới hạn chi tiêu, như với khoá của các dịch vụ mô hình AI tính tiền theo lượng sử dụng, đặt hạn mức thấp vừa đủ cho một tháng chạy bình thường.
- Sao chép khoá một lần duy nhất vào chỗ cất an toàn. Nhiều ứng dụng chỉ hiện khoá đầy đủ đúng một lần, đóng cửa sổ là không xem lại được, đó là cố ý.
Một khoá cho một luồng là nguyên tắc nên giữ. Dùng chung một khoá cho năm luồng thì khi cần thu hồi vì một luồng có vấn đề, cả năm luồng cùng đứng.
Cất khoá ở đâu: chỗ nên và chỗ không nên
Nơi cất khoá quyết định bao nhiêu người vô tình nhìn thấy nó. Bảng dưới xếp theo mức an toàn.
| Nơi cất | Đánh giá | Ghi chú |
|---|---|---|
| Ô lưu thông tin kết nối hoặc kho khoá bí mật của công cụ tự động hoá | Nên dùng | Khoá được che khi hiển thị, luồng dùng lại được mà không phải dán vào từng bước |
| Trình quản lý mật khẩu dùng cho nhóm | Nên dùng để lưu bản gốc | Phân quyền được ai xem, có nhật ký ai đã mở |
| Dán thẳng vào ô tiêu đề của từng bước gọi API | Tạm chấp nhận khi công cụ không có chỗ khác | Ai được xem luồng là thấy khoá; nhớ hạn chế người được sửa luồng |
| Ghi chú điện thoại, bảng tính chung, tài liệu hướng dẫn nội bộ | Không nên | Hay bị chia sẻ nhầm, sao lưu lung tung, khó biết ai đã xem |
| Nhóm chat, email, ảnh chụp màn hình | Tuyệt đối không | Lưu vĩnh viễn trên nhiều thiết bị, không thu hồi được tin đã gửi |
Một lỗi rất hay gặp là chụp màn hình luồng để hỏi đồng nghiệp hoặc dán vào chatbot nhờ gỡ lỗi, trong khi ảnh có nguyên khoá. Trước khi chụp hay dán, che khoá bằng ký hiệu thay thế như KHOA_CUA_BAN. Chatbot cần biết cấu trúc, không cần khoá thật.
Khi nào nên thay khoá mới
Theo lịch cố định. Mỗi sáu hoặc mười hai tháng, tạo khoá mới, cập nhật vào luồng, xác nhận chạy đúng rồi xoá khoá cũ. Đặt lịch nhắc trên lịch chung để việc này không phụ thuộc trí nhớ một người.
Khi có người biết khoá nghỉ việc hoặc đổi vị trí. Kể cả người đó đáng tin. Mục đích là để danh sách người từng thấy khoá trở về đúng những người đang làm.
Khi đổi công cụ kết nối hoặc đổi nhà cung cấp dịch vụ. Khoá đã dán vào công cụ cũ có thể vẫn nằm trong bản lưu của họ. Tạo khoá mới cho công cụ mới và xoá khoá cũ ở phía ứng dụng nguồn.
Khi thấy hoạt động lạ. Lượt gọi tăng vọt vào giờ không ai làm, chi phí dịch vụ AI vượt mức thường lệ, dữ liệu bị sửa mà không ai nhận. Đừng chờ chắc chắn mới thay; thay khoá rẻ hơn nhiều so với điều tra sau.
Khi luồng ngừng dùng. Luồng tắt nhưng khoá còn sống là cửa sau bỏ ngỏ. Tắt luồng xong thì thu hồi khoá trong cùng buổi.
Giờ đầu tiên khi nghi khoá bị lộ
Có thể khoá lọt vào một ảnh chụp gửi nhầm nhóm, một tài liệu chia sẻ công khai, hay nhân viên báo đã dán vào một trang lạ. Làm theo thứ tự này, không cần chờ họp.
- Vào trang quản lý khoá của ứng dụng nguồn, thu hồi hoặc xoá ngay khoá bị lộ. Đây là bước quan trọng nhất, làm trước mọi thứ khác.
- Tạo khoá mới với phạm vi hẹp như cũ hoặc hẹp hơn, cập nhật vào luồng, chạy thử một lần bằng dữ liệu giả.
- Xem nhật ký hoạt động hoặc thống kê lượt gọi của ứng dụng trong khoảng thời gian từ lúc lộ tới lúc thu hồi, ghi lại những gì bất thường.
- Với khoá của dịch vụ tính tiền theo lượng dùng, kiểm hoá đơn và đặt lại hạn mức chi tiêu.
- Gỡ khoá khỏi nơi bị lộ: xoá tin nhắn, đổi quyền tài liệu, xin quản trị nhóm xoá ảnh. Việc này chỉ giảm thêm rủi ro, không thay được bước thu hồi.
- Ghi lại sự việc ngắn gọn: lộ ở đâu, lúc nào, đã làm gì. Nếu dữ liệu khách có thể đã bị truy cập, báo người phụ trách để xem xét nghĩa vụ thông báo theo quy định về bảo vệ dữ liệu cá nhân hiện hành.
Nhiều người ngại thu hồi khoá cũ khi luồng đang phục vụ khách, muốn tạo khoá mới trước cho liền mạch. Khi đã nghi lộ thì nên làm ngược lại: thu hồi trước, chấp nhận luồng đứng vài phút. Luồng đứng mười phút gần như luôn ít thiệt hại hơn một khoá bị lạm dụng thêm mười phút.
Lập sổ theo dõi khoá: mỗi khoá một dòng
Công ty nhỏ sau một năm tự động hoá thường có mười tới hai mươi khoá rải ở nhiều ứng dụng mà không ai nắm hết. Một bảng theo dõi đơn giản, chỉ lưu thông tin về khoá chứ không lưu bản thân khoá, giải quyết chuyện này. Mỗi dòng nên có các cột sau.
- Tên khoá đúng như đặt trong ứng dụng nguồn, để tra nhanh khi cần thu hồi.
- Ứng dụng cấp khoá và tài khoản đã tạo ra nó, tài khoản chung của công ty hay tài khoản riêng của ai.
- Phạm vi quyền viết bằng lời thường: chỉ đọc đơn hàng, đọc và ghi danh bạ khách, gọi mô hình AI với hạn mức tháng.
- Luồng nào đang dùng khoá, nằm trong công cụ kết nối nào.
- Người chịu trách nhiệm và người dự phòng, để khi một người nghỉ phép vẫn có người xử lý được.
- Ngày tạo, ngày thay mới gần nhất, ngày dự kiến thay tiếp theo.
- Cột ghi chú cho sự cố đã gặp, ví dụ từng bị lộ qua ảnh chụp và đã thay ngày nào.
Bảng này nên đặt ở nơi chỉ quản lý và người phụ trách tự động hoá xem được. Nó không chứa khoá, nhưng chứa bản đồ đường vào hệ thống của bạn, thứ mà người ngoài không nên có. Mỗi quý mở bảng ra một lần, đối chiếu với trang quản lý khoá của từng ứng dụng: khoá nào có trong ứng dụng mà không có trong bảng là khoá lạ, cần tìm hiểu ngay.
Khoá của dịch vụ AI cần cẩn thận thêm một bậc
Khi thêm bước gọi mô hình ngôn ngữ vào luồng, bạn thường phải tạo khoá API ở trang của nhà cung cấp mô hình. Loại khoá này gắn trực tiếp với tiền: ai cầm được là có thể dùng mô hình và để bạn trả hoá đơn. Đã có nhiều người kể chuyện khoá lọt lên mạng rồi bị dùng hết hạn mức trong một đêm. Vì vậy, với khoá AI, hạn mức chi tiêu tháng là bắt buộc chứ không phải tuỳ chọn.
Nếu công cụ kết nối có sẵn bước AI tích hợp, tính phí qua chính công cụ đó, bạn khỏi phải tự giữ khoá của nhà cung cấp mô hình. Đổi lại, bạn cần đọc điều khoản xem dữ liệu đi qua bước AI được lưu và dùng ra sao. Hai lựa chọn có đánh đổi khác nhau; với cửa hàng nhỏ, bước tích hợp sẵn thường đơn giản hơn để bắt đầu.
Dù chọn cách nào, đừng để luồng gửi cho AI những dữ liệu không cần. Một bước phân loại tin nhắn khách chỉ cần nội dung tin, không cần tên đầy đủ, số điện thoại hay lịch sử mua hàng. Khoá được giữ kín đến đâu thì dữ liệu đã gửi đi rồi cũng không lấy lại được.
Câu hỏi thường gặp
Khoá API có hết hạn không?
Tuỳ ứng dụng. Có khoá dùng mãi tới khi bạn xoá, có khoá tự hết hạn sau một thời gian bạn chọn. Khoá không hết hạn tiện nhưng rủi ro hơn, nên tự đặt lịch thay mới định kỳ.
Có nên đưa khoá API cho người làm dịch vụ tự động hoá thuê không?
Tốt hơn là tạo cho họ một tài khoản riêng trong công cụ kết nối với quyền hạn chế, hoặc tạo một khoá riêng chỉ dùng cho dự án đó, rồi thu hồi khi bàn giao xong. Không đưa khoá của tài khoản chủ.
Dán khoá API vào chatbot AI để nhờ kiểm lỗi có sao không?
Có rủi ro. Nội dung trò chuyện có thể được lưu và xem lại theo điều khoản của dịch vụ. Hãy thay khoá bằng ký hiệu giả trước khi dán, chatbot vẫn đủ thông tin để giúp bạn tìm lỗi cấu trúc.
Làm sao biết khoá nào còn đang được dùng?
Nhiều trang quản lý khoá hiện thời điểm dùng gần nhất. Khoá lâu không dùng là ứng viên xoá. Nếu không có thông tin đó, đối chiếu với danh sách luồng đang chạy, và đó là lý do nên đặt tên khoá rõ mục đích.
Một khoá dùng cho nhiều luồng được không?
Được về kỹ thuật nhưng không nên. Mỗi luồng một khoá giúp bạn thu hồi đúng chỗ có vấn đề mà không làm đứng các luồng khác, và giúp đọc nhật ký biết luồng nào đang gọi nhiều.
Khoá bị lộ nhưng chưa thấy gì bất thường thì có cần thay không?
Có. Không thấy gì bất thường không có nghĩa là chưa ai dùng; nhiều hành vi lạm dụng chỉ đọc dữ liệu mà không để lại dấu vết dễ thấy. Thu hồi và thay mới mất vài phút.