Thiết lập Tink Java

Sau khi cài đặt và thiết lập Tink, hãy tiếp tục với Các bước tiếp theo.

Tink Java

Thư viện Java cốt lõi là tink-java với bản phát hành mới nhất là 1.24.0. Tink Java hỗ trợ Java 11 trở lên.

Maven

Bạn có thể thêm Tink Java bằng Maven:

<dependency>
  <groupId>com.google.crypto.tink</groupId>
  <artifactId>tink</artifactId>
  <version>1.24.0</version>
</dependency>

Bazel

Người dùng Bazel có thể thêm Tink Java làm phần phụ thuộc bằng cách thêm đoạn mã sau vào tệp MODULE.bazel:

  bazel_dep(name = "tink_java", version = "1.24.0")

  git_override(
      module_name = "tink_java",
      remote = "https://github.com/tink-crypto/tink-java",
      tag = "v1.24.0",
  )

Tink Android

Thư viện Android cốt lõi là tink-java với bản phát hành mới nhất là 1.24.0.

Tink Android được hỗ trợ đầy đủ kể từ cấp độ API 24. Hầu hết các phần của Tink dự kiến sẽ hoạt động từ cấp độ API 23. Các phần mà Tink không chạy ngay được với cấp độ API 23 là:

  • Thư viện JWT yêu cầu cấp độ API 24 vì thư viện này sử dụng các lớp như java.util.Optional. Bạn có thể tránh giới hạn này bằng cách đơn giản hoá cú pháp.

  • Một số API trong com.google.crypto.tink.streamingaead sử dụng SeekableByteBufferChannel chỉ có từ cấp độ API 24.

Vì lý do kỹ thuật, chúng tôi chỉ thử nghiệm Tink trên Android trên cơ sở hạ tầng nội bộ của Google. Chúng tôi không cho rằng việc này sẽ gây ra vấn đề, nhưng nếu bạn gặp phải vấn đề, vui lòng báo cáo vấn đề.

Tink Android không yêu cầu cấu hình proguard.

Gradle

Bạn có thể sử dụng tink-android từ Gradle:

dependencies {
  implementation 'com.google.crypto.tink:tink-android:1.24.0'
}

Tiện ích AWS KMS

Tiện ích AWS KMS của Tink Java là tink-java-awskms, trong đó 2.2.0 là bản phát hành mới nhất.

Maven

Bạn có thể thêm tiện ích Tink Java AWS KMS bằng cách sử dụng Maven:

<dependencies>
  <dependency>
    <groupId>com.google.crypto.tink</groupId>
    <artifactId>tink-awskms</artifactId>
    <version>2.2.0</version>
  </dependency>
</dependencies>

Bazel

Cấu phần phần mềm của bản phát hành Maven

Bạn có thể cài đặt cấu phần phần mềm Maven com.google.crypto.tink:tink-awskms cùng với com.google.crypto.tink:tink bằng công cụ rules_jvm_external.

# ...

maven_install(
    artifacts = [
        "com.google.crypto.tink:tink:1.24.0",
        "com.google.crypto.tink:tink-awskms:2.2.0",
        # ... other dependencies ...
    ],
    repositories = [
        "https://maven.google.com",
        "https://repo1.maven.org/maven2",
    ],
)

Tiện ích Google Cloud KMS

Tiện ích Google Cloud KMS của Tink Java là tink-java-gcpkms, trong đó 1.12.0 là bản phát hành mới nhất.

Maven

Bạn có thể thêm tiện ích Tink Java Google Cloud KMS bằng Maven:

<dependencies>
  <dependency>
    <groupId>com.google.crypto.tink</groupId>
    <artifactId>tink-gcpkms</artifactId>
    <version>1.12.0/version>
  </dependency>
</dependencies>

Bazel

Cấu phần phần mềm của bản phát hành Maven

Bạn có thể cài đặt cấu phần phần mềm Maven com.google.crypto.tink:tink-gcpkms cùng với com.google.crypto.tink:tink bằng công cụ rules_jvm_external.

# ...

maven_install(
    artifacts = [
        "com.google.crypto.tink:tink:1.24.0",
        "com.google.crypto.tink:tink-gcpkms:1.12.0",
        # ... other dependencies ...
    ],
    repositories = [
        "https://maven.google.com",
        "https://repo1.maven.org/maven2",
    ],
)

Tạo từ nguồn

Thêm đoạn mã sau vào tệp MODULE.bazel.

bazel_dep(name = "tink_java_gcpkms")

git_override(
    module_name = "tink_java_gcpkms",
    remote = "https://github.com/tink-crypto/tink-java-gcpkms",
    tag = "v1.12.0",
)

Ứng dụng Java của Tink

Thư viện Tink Java Apps cung cấp các phương thức triển khai cho Mã thông báo phương thức thanh toán của Google, Xác minh phía máy chủ cho quảng cáo có tặng thưởng của Google AdMob và RFC 8291 – Mã hoá thông báo cho thông báo đẩy trên web với bản phát hành mới nhất là 1.15.0.

Maven

Bạn có thể thêm thư viện Ứng dụng Java của Tink bằng cách sử dụng Maven:

<dependency>
  <groupId>com.google.crypto.tink</groupId>
  <artifactId>apps-webpush</artifactId>
  <version>1.15.0</version>
</dependency>

<dependency>
  <groupId>com.google.crypto.tink</groupId>
  <artifactId>apps-paymentmethodtoken</artifactId>
  <version>1.15.0</version>
</dependency>

<dependency>
  <groupId>com.google.crypto.tink</groupId>
  <artifactId>apps-rewardedads</artifactId>
  <version>1.15.0</version>
</dependency>

Bazel

Bạn có thể cài đặt bất kỳ cấu phần phần mềm Maven com.google.crypto.tink:apps-* nào bằng công cụ rules_jvm_external.

# ...

maven_install(
    artifacts = [
        "com.google.crypto.tink:apps-webpush:1.15.0",
        "com.google.crypto.tink:apps-paymentmethodtoken:1.15.0",
        "com.google.crypto.tink:apps-rewardedads:1.15.0",
        # ... other dependencies ...
    ],
    repositories = [
        "https://maven.google.com",
        "https://repo1.maven.org/maven2",
    ],
)

Các bước tiếp theo

Sau khi thiết lập xong Tink, hãy tiếp tục với các bước sử dụng Tink tiêu chuẩn:

  • Chọn một dữ liệu gốc – Quyết định dữ liệu gốc nào sẽ được sử dụng dựa trên trường hợp sử dụng của bạn
  • Quản lý khoá – Bảo vệ khoá bằng KMS bên ngoài, tạo tập hợp khoá và xoay vòng khoá