此页面由 Cloud Translation API 翻译。

设置 Tink Java

安装并设置 Tink 后，请继续执行后续步骤。

Tink Java

核心 Java 库为 tink-java，最新版本为 1.18.0。Tink Java 支持 Java 11 或更高版本。

Maven

您可以使用 Maven 包含 Tink Java：

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

Bazel

Maven 发布版制品

建议 Bazel 用户使用 WORKSPACE 文件中的 rules_jvm_external 工具安装 Maven 发布制品，从而将 Tink Java 添加为依赖项：

load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")

RULES_JVM_EXTERNAL_TAG = "6.1"
RULES_JVM_EXTERNAL_SHA ="d31e369b854322ca5098ea12c69d7175ded971435e55c18dd9dd5f29cc5249ac"

http_archive(
    name = "rules_jvm_external",
    strip_prefix = "rules_jvm_external-%s" % RULES_JVM_EXTERNAL_TAG,
    sha256 = RULES_JVM_EXTERNAL_SHA,
    url = "https://github.com/bazelbuild/rules_jvm_external/releases/download/%s/rules_jvm_external-%s.tar.gz" % (RULES_JVM_EXTERNAL_TAG, RULES_JVM_EXTERNAL_TAG)
)

load("@rules_jvm_external//:repositories.bzl", "rules_jvm_external_deps")

rules_jvm_external_deps()

load("@rules_jvm_external//:setup.bzl", "rules_jvm_external_setup")

rules_jvm_external_setup()

load("@rules_jvm_external//:defs.bzl", "maven_install")

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

从源代码构建

如果您想从源代码构建 tink-java（例如，为了固定特定提交），可以将其作为 WORKSPACE 文件中的 http_archive 包含在内：

load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")

TINK_COMMIT="f4127f6b6ab9c367d41ade1f50db6f0ef9909044"
TINK_SHA256="e246f848f7749e37f558955ecb50345b04d79ddb9d8d1e8ae19f61e8de530582"

http_archive(
    name = "tink_java",
    urls = ["https://github.com/tink-crypto/tink-java/archive/%s.zip" % TINK_COMMIT],
    strip_prefix = "tink-%s" % TINK_COMMIT,
    sha256 = TINK_SHA256
)

load("@tink_java//:tink_java_deps.bzl", "TINK_MAVEN_ARTIFACTS", "tink_java_deps")

tink_java_deps()

load("@tink_java//:tink_java_deps_init.bzl", "tink_java_deps_init")

tink_java_deps_init()

# rules_jvm_external is imported and initialized by tink_java_deps and
# tink_java_deps_init.
load("@rules_jvm_external//:defs.bzl", "maven_install")

maven_install(
  artifacts = TINK_MAVEN_ARTIFACTS + # ... other dependencies ...
  repositories = [
      "https://maven.google.com",
      "https://repo1.maven.org/maven2",
  ],
)

Tink Android

核心 Android 库是 tink-java，最新版本为 1.18.0。

从 API 级别 24 开始，Tink Android 得到完全支持。预计 Tink 的大部分功能从 API 级别 23 开始即可正常运行。Tink 无法在 API 级别 23 中开箱即用的部分包括：

JWT 库需要 API 级别 24，因为它使用 java.util.Optional 等类。通过脱糖可以避免此限制。
com.google.crypto.tink.streamingaead 中的某些 API 使用 SeekableByteBufferChannel，而 SeekableByteBufferChannel 仅从 API 级别 24 开始提供。

由于技术原因，我们仅在 Google 内部基础架构上测试 Android 版 Tink。我们预计不会因此出现任何问题，但如果您遇到任何问题，请提交问题报告。

Tink Android 不需要任何 ProGuard 配置。

Gradle

您可以通过 Gradle 使用 tink-android：

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

AWS KMS 扩展程序

Tink Java AWS KMS 扩展程序为 tink-java-awskms，最新版本为 1.11.0。

Maven

您可以使用 Maven 包含 Tink Java AWS KMS 扩展程序：

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

Bazel

Maven 发布版制品

您可以使用 rules_jvm_external 工具安装 com.google.crypto.tink:tink-awskms Maven 制品以及 com.google.crypto.tink:tink。

# ...

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

从源代码构建

如果您想从源代码构建 tink-awskms，例如固定到特定提交，您可以将其作为 WORKSPACE 文件中的 http_archive 包含在内：

# ...

http_archive(
    name = "tink_java",
    urls = ["https://github.com/tink-crypto/tink-java/releases/download/v1.18.0/tink-java-1.18.0.zip"],
    strip_prefix = "tink-java-1.18.0",
    sha256 = "f74f0b8fa8a6edc129ce6b369764e176d7047d87d8f77cec06a8880f00498571",
)

load("@tink_java//:tink_java_deps.bzl", "TINK_MAVEN_ARTIFACTS", "tink_java_deps")

tink_java_deps()

load("@tink_java//:tink_java_deps_init.bzl", "tink_java_deps_init")

tink_java_deps_init()

http_archive(
    name = "tink_java_awskms",
    urls = ["https://github.com/tink-crypto/tink-java-awskms/releases/download/v1.11.0/tink-java-awskms-1.11.0.zip"],
    strip_prefix = "tink-java-awskms-1.11.0",
    sha256 = "18f8faa7ba0019fc584f9e03f94221ebbcc83f059568d2277a4866003153e151",
)

load("@tink_java_awskms//:tink_java_awskms_deps.bzl", "TINK_JAVA_AWSKMS_MAVEN_ARTIFACTS")

maven_install(
    artifacts = TINK_MAVEN_ARTIFACTS + TINK_JAVA_AWSKMS_MAVEN_ARTIFACTS + [
        # ... other dependencies ...
    ],
    repositories = [
        "https://maven.google.com",
        "https://repo1.maven.org/maven2",
    ],
)

Google Cloud KMS 扩展服务

Tink Java Google Cloud KMS 扩展程序为 tink-java-gcpkms，最新版本为 1.10.0。

Maven

您可以使用 Maven 包含 Tink Java Google Cloud KMS 扩展程序：

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

Bazel

Maven 发布版制品

您可以使用 rules_jvm_external 工具安装 com.google.crypto.tink:tink-gcpkms Maven 制品以及 com.google.crypto.tink:tink。

# ...

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

从源代码构建

如果您想从源代码构建 tink-gcpkms，例如固定到特定提交，您可以将其作为 WORKSPACE 文件中的 http_archive 包含在内：

# ...

http_archive(
    name = "tink_java",
    urls = ["https://github.com/tink-crypto/tink-java/releases/download/v1.18.0/tink-java-1.18.0.zip"],
    strip_prefix = "tink-java-1.18.0",
    sha256 = "f74f0b8fa8a6edc129ce6b369764e176d7047d87d8f77cec06a8880f00498571",
)

load("@tink_java//:tink_java_deps.bzl", "TINK_MAVEN_ARTIFACTS", "tink_java_deps")

tink_java_deps()

load("@tink_java//:tink_java_deps_init.bzl", "tink_java_deps_init")

tink_java_deps_init()

http_archive(
    name = "tink_java_gcpkms",
    urls = ["https://github.com/tink-crypto/tink-java-gcpkms/releases/download/v1.10.0/tink-java-gcpkms-1.10.0.zip"],
    strip_prefix = "tink-java-gcpkms-1.10.0",
    sha256 = "ad85625cc4409f2f6ab13a8eef39c965501585e9323d59652cce322b3d2c09a2",
)

load("@tink_java_gcpkms//:tink_java_gcpkms_deps.bzl", "TINK_JAVA_GCPKMS_MAVEN_ARTIFACTS")

maven_install(
    artifacts =  TINK_MAVEN_ARTIFACTS + TINK_JAVA_GCPKMS_MAVEN_ARTIFACTS + [
        # ... other dependencies ...
    ],
    repositories = [
        "https://maven.google.com",
        "https://repo1.maven.org/maven2",
    ],
)

Tink Java Apps

Tink Java 应用库提供了 Google 付款方式令牌、Google AdMob 激励广告的服务器端验证和 RFC 8291 - Web 推送的消息加密的实现，最新版本为 1.12.2。

Maven

您可以使用 Maven 包含 Tink Java Apps 库：

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

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

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

Bazel

您可以使用 rules_jvm_external 工具安装任何 com.google.crypto.tink:apps-* Maven 制品。

# ...

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

后续步骤

完成 Tink 设置后，请继续执行标准 Tink 使用步骤：

选择一个基元 - 根据您的使用情形决定使用哪个基元
管理密钥 - 使用外部 KMS 保护密钥、生成密钥集和轮替密钥

设置 Tink Java 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

Tink Java

Maven

Bazel

Maven 发布版制品

从源代码构建

Tink Android

Gradle

AWS KMS 扩展程序

Maven

Bazel

Maven 发布版制品

从源代码构建

Google Cloud KMS 扩展服务

Maven

Bazel

Maven 发布版制品

从源代码构建

Tink Java Apps

Maven

Bazel

后续步骤

设置 Tink Java