Tài liệu · Tham chiếu
Tải về
Mỗi SDK là một file cài thẳng vào dự án, thư viện C và công cụ dòng lệnh có bản cho Windows và Linux, file nào cũng kèm SHA-256 để kiểm trước khi dùng
SDK
JavaScript · Node.js, Electron
Phiên bản 0.1.0Node.js 20 trở lên
clavisauh-sdk-js-0.1.0.tgz59 KBSHA-256 3ad4956aeda16eab27e338541ca925c003aed448a00eb7d8c1b3ee458b39bf05
Cài đặt
npm install ./clavisauh-sdk-js-0.1.0.tgzPython
Phiên bản 0.1.0Python 3.9 trở lên
clavisauh-0.1.0-py3-none-any.whl17 KBSHA-256 71956a9e347c9864bd433adf5d56345b54f7c066bf467e53417a79dad48cd568
Cài đặt
# in your virtual environment (python -m venv .venv)
pip install clavisauh-0.1.0-py3-none-any.whlC# · .NET
Phiên bản 0.1.0.NET 8 trở lên
ClavisAuh.0.1.0.nupkg37 KBSHA-256 7c05fcec2668643fc70e005d6e01eea0f0a7a079b6cb9fdc8e4830bd04dec579
Cài đặt
<!-- nuget.config, next to your .csproj; ClavisAuh.0.1.0.nupkg goes in its packages folder -->
<configuration>
<packageSources>
<add key="clavisauh" value="packages" />
<add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
</packageSources>
</configuration>dotnet add package ClavisAuh --version 0.1.0C++
Phiên bản 0.1.0C++17, CMake 3.21, libsodium, libcurl, nlohmann-json
clavisauh-cpp-0.1.0.zip21 KBSHA-256 099e52bb04d76b4981a843c9680ffd26b8e110ca46757cc66d87e65e684ea46b
Cài đặt
# unpack: unzip clavisauh-cpp-0.1.0.zip (Windows PowerShell: Expand-Archive clavisauh-cpp-0.1.0.zip .)
# CMakeLists.txt, with the zip unpacked beside it
add_subdirectory(clavisauh-cpp-0.1.0 clavisauh)
target_link_libraries(your_app PRIVATE clavisauh::clavisauh)Go
Phiên bản 1.0.0Go 1.23 trở lên, chỉ thư viện chuẩn
clavisauh-go-1.0.0.zip19 KBSHA-256 5e8e25fcb418a133507c17bd750f4ba1411721885dec739d6f5e0e28813de28b
Cài đặt
# unpack: unzip clavisauh-go-1.0.0.zip (Windows PowerShell: Expand-Archive clavisauh-go-1.0.0.zip .)
# in your module's folder (a new program: go mod init <name> first)
go mod edit -require=clavisauh@v0.0.0 -replace=clavisauh=./clavisauh-go-1.0.0Rust
Phiên bản 1.0.0Rust 1.80 trở lên
clavisauh-rust-1.0.0.zip29 KBSHA-256 d32ff847a507cf46db5bf8e9af7d9c47935eafae511a5b35acfb5e2d46aa4d83
Cài đặt
# unpack: unzip clavisauh-rust-1.0.0.zip (Windows PowerShell: Expand-Archive clavisauh-rust-1.0.0.zip .)
# in your crate's folder
cargo add --path clavisauh-rust-1.0.0Java · Kotlin
Phiên bản 1.0.0JDK 17 trở lên, không cần thư viện khác
clavisauh-1.0.0.jar59 KBSHA-256 ff91082b55306128b1c78b5ef1189dfdac12c0a0056f5775e48490f932fbdf1a
Cài đặt
# pick one of the three ways
# a source file, no build tool
java -cp clavisauh-1.0.0.jar K1Key.java
# Maven: install the jar once, then depend on clavisauh:clavisauh:1.0.0
mvn install:install-file -Dfile=clavisauh-1.0.0.jar -DgroupId=clavisauh -DartifactId=clavisauh -Dversion=1.0.0 -Dpackaging=jar
// Gradle (Kotlin DSL), with the jar in libs/
implementation(files("libs/clavisauh-1.0.0.jar"))Thư viện C và công cụ dòng lệnh
Thư viện C · Windows x64
Phiên bản 1.0.0Windows 10 trở lên, một file chỉ cần DLL có sẵn của Windows
clavis-c-1.0.0-windows-x64.zip758 KBSHA-256 2d7b345769c58a5afbdf8682e0db019fe3b10a1042da041862060ee0826976d4
Cài đặt
Expand-Archive clavis-c-1.0.0-windows-x64.zip .
# clavis-c-1.0.0-windows-x64\clavis.dll goes next to your programThư viện C · Linux x64
Phiên bản 1.0.0glibc 2.32 trở lên, cùng libsodium và libcurl của hệ thống (Debian, Ubuntu: apt install libsodium23 libcurl4)
clavis-c-1.0.0-linux-x64.tar.gz168 KBSHA-256 6e720f8db139cabcf7df88a3eac178a7cfc1f49d0aef36a0a51a0f5cf30ad161
Cài đặt
tar -xzf clavis-c-1.0.0-linux-x64.tar.gz
# clavis-c-1.0.0-linux-x64/libclavis.so: load it by path, or put the folder on LD_LIBRARY_PATHCông cụ dòng lệnh · Windows x64
Phiên bản 1.0.0Windows 10 trở lên, một file chỉ cần DLL có sẵn của Windows
clavis-cli-1.0.0-windows-x64.zip762 KBSHA-256 59cf6ad3e92c867f32008116ded25ebc1564fb70d1e88ab739e69927ee0091a1
Cài đặt
Expand-Archive clavis-cli-1.0.0-windows-x64.zip .
.\clavis-cli-1.0.0-windows-x64\clavis.exe versionCông cụ dòng lệnh · Linux x64
Phiên bản 1.0.0glibc 2.34 trở lên, cùng libsodium và libcurl của hệ thống (Debian, Ubuntu: apt install libsodium23 libcurl4)
clavis-cli-1.0.0-linux-x64.tar.gz166 KBSHA-256 30ba4e19ecbdf45c29ac24c320e0137cd0bdd5e62f3227b06cb1a3582a856f14
Cài đặt
tar -xzf clavis-cli-1.0.0-linux-x64.tar.gz
./clavis-cli-1.0.0-linux-x64/clavis versionKiểm tra tương thích
Bộ test vector CLV1.1
Phiên bản 1.1Cho client bạn tự viết: khoá, chuỗi ký, chữ ký, một token offline và một manifest, kèm kết quả mọi SDK chính thức đều ra đúng
clv1.1-test-vectors.json4 KBSHA-256 16ca22d4000fd5cfebcd79c7818687ebc7aa89919b59a2fc9e42ac7dd82d9ae3
Kiểm tra file tải về
So SHA-256 của file với mã ở trên, hoặc kiểm cùng lúc mọi file bằng SHA256SUMS
Windows (PowerShell)
(Get-FileHash <file vừa tải> -Algorithm SHA256).Hash.ToLower()Linux
sha256sum -c SHA256SUMS --ignore-missingmacOS
shasum -a 256 <file vừa tải>Một trang giả có thể ghi hash của riêng nó. SHA256SUMS được ký bằng khoá không bao giờ rời máy của chúng tôi, nên cách này vẫn đúng khi bạn lỡ vào link lạ. Lưu khoá dưới đây thành clavisauh-release.pub, khoá này không đổi, rồi chạy: SHA256SUMS.sig
-----BEGIN PUBLIC KEY-----
MCowBQYDK2VwAyEASwfDaETBKkFkf3Kg7ml3/aw+TsmxoBZQ+XNzHPpqUHQ=
-----END PUBLIC KEY-----openssl pkeyutl -verify -pubin -inkey clavisauh-release.pub -rawin -in SHA256SUMS -sigfile SHA256SUMS.sigChưa có
- npm, PyPI, NuGet, crates.io và Maven Central: khi gói được đăng, các bài hướng dẫn ghi cả hai cách
- Bản macOS và ARM của thư viện C và công cụ dòng lệnh
- Chữ ký số trên file Windows: SmartScreen có thể hỏi lại ở lần chạy đầu