Skip to main content

Cài đặt access key

SDK cần được cấu hình với khóa truy cập của bạn (bao gồm id của khóa, và khóa truy cập), khóa này có sẵn ở trang quản lý Locker Secrets. Các khóa này phải không được tiết lộ. Nếu bạn để lộ khóa, bạn cần thu hồi chúng ngay lập tức. Biến môi trường là một giải pháp tốt và dễ sử dụng trong hầu hết các ngôn ngữ lập trình.

Thiết lập thông tin xác thực trên Linux/MacOS

Thiết lập thông tin xác thực trên Windows

PowerShell
Command Prompt
Bạn cũng cần đặt giá trị api_base (mặc định là https://api.locker.io/locker_secrets). Nếu bạn cần thiết lập header tùy chỉnh, bạn cũng cần đặt giá trị headers trong tham số option:
Bạn cũng có thể truyền vào tham số hoặc sử dụng tệp thông tin xác thực được chia sẻ ( ~/.locker/credentials ), nhưng chúng tôi không khuyến khích bạn thực hiện theo những cách này.

List secrets

Sử dụng phương thức .list() để lấy tất cả các secret trong dự án của bạn.

Get giá trị secrets

Lấy giá trị bằng tên khóa

Lấy giá trị bằng tên khóa và tên môi trường

Bạn có thể lấy giá trị bí mật bằng tên khóa và tên môi trường:

Tạo mới secrets

Dùng hàm .create() để tạo mới secret:
Tạo một secret mới với một môi trường cụ thể:

Cập nhật secrets


List environments

Dùng hàm .list() để lấy tất cả các môi trường trong dự án của bạn:

Retrieve an environment

Để lấy một môi trường theo tên, sử dụng .retrieve():

Tạo mới environment

Để tạo mới môi trường, sử dụng .create():

Cập nhật environment


Error Handling

SDK của Locker Secret cung cấp một số loại lỗi. Chúng có thể phản ánh các sự kiện bên ngoài, như thông tin đăng nhập không hợp lệ, gián đoạn kết nối mạng, hoặc các vấn đề về mã lỗi như các cuộc gọi API không hợp lệ. Nếu một vấn đề ngay lập tức ngăn chặn một hàm tiếp tục, SDK sẽ ném ra một ngoại lệ. Đây là một thực hành tốt để bắt và xử lý các ngoại lệ. Sử dụng cú pháp try/catch của Java và bắt LockerError hoặc các lớp con của nó để xử lý các ngoại lệ của Locker.
Trong SDK, các đối tượng lỗi thuộc về LockerError và các lớp con của nó. Sử dụng tài liệu cho mỗi lớp để biết cách phản ứng.

Logging

Thư viện có thể được cấu hình để phát ra thông tin logging giúp bạn hiểu rõ hơn về những gì đang diễn ra. Có một số cấp độ: debug, info, warning, error. Cấp độ info thường phù hợp nhất cho việc sử dụng trong môi trường production, nhưng debug cũng có sẵn để có thêm chi tiết.

Cách kích hoạt logging

1. Đặt biến môi trường LOCKER_LOG
2. Đặt log khi khởi tạo đối tượng LockerClient