Giao thức CLV1 đã công khaiĐọc đặc tả

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.0

Node.js 20 trở lên

clavisauh-sdk-js-0.1.0.tgz59 KB

SHA-256 3ad4956aeda16eab27e338541ca925c003aed448a00eb7d8c1b3ee458b39bf05

Cài đặt

npm install ./clavisauh-sdk-js-0.1.0.tgz

Python

Phiên bản 0.1.0

Python 3.9 trở lên

clavisauh-0.1.0-py3-none-any.whl17 KB

SHA-256 71956a9e347c9864bd433adf5d56345b54f7c066bf467e53417a79dad48cd568

Cài đặt

# in your virtual environment (python -m venv .venv)
pip install clavisauh-0.1.0-py3-none-any.whl

C# · .NET

Phiên bản 0.1.0

.NET 8 trở lên

ClavisAuh.0.1.0.nupkg37 KB

SHA-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.0

C++

Phiên bản 0.1.0

C++17, CMake 3.21, libsodium, libcurl, nlohmann-json

clavisauh-cpp-0.1.0.zip21 KB

SHA-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.0

Go 1.23 trở lên, chỉ thư viện chuẩn

clavisauh-go-1.0.0.zip19 KB

SHA-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.0

Rust

Phiên bản 1.0.0

Rust 1.80 trở lên

clavisauh-rust-1.0.0.zip29 KB

SHA-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.0

Java · Kotlin

Phiên bản 1.0.0

JDK 17 trở lên, không cần thư viện khác

clavisauh-1.0.0.jar59 KB

SHA-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.0

Windows 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 KB

SHA-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 program

Thư viện C · Linux x64

Phiên bản 1.0.0

glibc 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 KB

SHA-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_PATH

Công cụ dòng lệnh · Windows x64

Phiên bản 1.0.0

Windows 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 KB

SHA-256 59cf6ad3e92c867f32008116ded25ebc1564fb70d1e88ab739e69927ee0091a1

Cài đặt

Expand-Archive clavis-cli-1.0.0-windows-x64.zip .
.\clavis-cli-1.0.0-windows-x64\clavis.exe version

Công cụ dòng lệnh · Linux x64

Phiên bản 1.0.0

glibc 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 KB

SHA-256 30ba4e19ecbdf45c29ac24c320e0137cd0bdd5e62f3227b06cb1a3582a856f14

Cài đặt

tar -xzf clavis-cli-1.0.0-linux-x64.tar.gz
./clavis-cli-1.0.0-linux-x64/clavis version

Kiểm tra tương thích

Bộ test vector CLV1.1

Phiên bản 1.1

Cho 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 KB

SHA-256 16ca22d4000fd5cfebcd79c7818687ebc7aa89919b59a2fc9e42ac7dd82d9ae3

Cách dùng

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-missing

macOS

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.sig

Chư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

Bạn cần giúp gì?

Câu hỏi thường gặp

ClavisAUH là gì?

Dịch vụ bản quyền và xác thực cho phần mềm desktop: license key, khoá thiết bị, đăng nhập người dùng và phản hồi có chữ ký. Tất cả quản lý trên một dashboard

Vì sao kẻ crack không làm giả được server?

SDK chỉ tin câu trả lời ký bằng khoá bí mật của ứng dụng. Khoá đó không bao giờ rời server của chúng tôi, nên server giả không ký được và bị từ chối

Trong file chạy của tôi có gì?

Mã ứng dụng và khoá công khai. Không có bí mật nào, vì mỗi thiết bị tự tạo cặp khoá riêng ở lần chạy đầu

Có chạy được khi offline không?

Có. Mọi gói đều có token offline có chữ ký dùng được 7 ngày, ứng dụng tự kiểm tra tại máy. Premium cho bạn chọn bao lâu. License đã thu hồi vẫn có thể chạy offline trong khoảng đó, trừ khi Chế độ chỉ online đang bật

Hỗ trợ những ngôn ngữ nào?

Hiện có JavaScript và TypeScript. Tiếp theo là C++, C# và Python, cùng một giao thức công khai

Gói Basic có miễn phí thật không?

Có. Không giới hạn thời gian, không cần thẻ. Cần nhiều hơn thì lên Premium

Liên hệ