Ta strona została przetłumaczona przez Cloud Translation API.

Konfigurowanie Tink Java

Po zainstalowaniu i skonfigurowaniu Tink przejdź do sekcji Dalsze kroki.

Tink Java

Podstawowa biblioteka Java to tink-java, a jej najnowsza wersja to 1.18.0. Biblioteka Tink Java obsługuje język Java w wersji 11 lub nowszej.

Maven

Możesz dołączyć Tink Java za pomocą Maven:

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

Bazel

Artefakt wersji Maven

Zalecany sposób dodawania Tink Java jako zależności przez użytkowników Bazela to zainstalowanie artefaktu wersji Maven za pomocą narzędzia rules_jvm_external w pliku WORKSPACE:

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",
    ],
)

Kompilowanie ze źródła

Jeśli chcesz skompilować tink-java ze źródeł, np. aby przypiąć konkretny commit, możesz uwzględnić go jako http_archive w pliku WORKSPACE:

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 na Androida

Podstawowa biblioteka Androida to tink-java, a jej najnowsza wersja to 1.18.0.

Biblioteka Tink Android jest w pełni obsługiwana od poziomu API 24. Większość komponentów Tink powinna działać od poziomu API 23. Elementy, w których Tink nie działa od razu na poziomie API 23, to:

Biblioteka JWT wymaga poziomu API 24, ponieważ używa klas takich jak java.util.Optional. Tego ograniczenia można uniknąć, stosując desugaring.
Niektóre interfejsy API w com.google.crypto.tink.streamingaead używają SeekableByteBufferChannel, który jest dostępny tylko od poziomu API 24.

Ze względów technicznych testujemy bibliotekę Tink na Androida tylko w infrastrukturze wewnętrznej Google. Nie spodziewamy się żadnych problemów, ale jeśli wystąpią, zgłoś je.

Tink Android nie wymaga konfiguracji ProGuard.

Gradle

Możesz użyć tink-android z Gradle:

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

Rozszerzenie AWS KMS

Rozszerzenie Tink Java AWS KMS to tink-java-awskms, a jego najnowsza wersja to 1.11.0.

Maven

Rozszerzenie Tink Java AWS KMS możesz dodać za pomocą Maven:

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

Bazel

Artefakt wersji Maven

com.google.crypto.tink:tink-awskms artefakt Mavena możesz zainstalować razem z com.google.crypto.tink:tink za pomocą narzędzia rules_jvm_external.

# ...

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",
    ],
)

Kompilowanie ze źródła

Jeśli chcesz skompilować tink-awskms ze źródeł, np. aby przypiąć konkretną zmianę, możesz uwzględnić ją jako http_archive w pliku WORKSPACE:

# ...

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",
    ],
)

Rozszerzenie Google Cloud KMS

Rozszerzenie Tink Java Google Cloud KMS to tink-java-gcpkms w najnowszej wersji 1.10.0.

Maven

Rozszerzenie Tink Java Google Cloud KMS możesz dodać za pomocą Maven:

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

Bazel

Artefakt wersji Maven

com.google.crypto.tink:tink-gcpkms artefakt Mavena możesz zainstalować razem z com.google.crypto.tink:tink za pomocą narzędzia rules_jvm_external.

# ...

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",
    ],
)

Kompilowanie ze źródła

Jeśli chcesz skompilować tink-gcpkms ze źródeł, np. aby przypiąć konkretną zmianę, możesz uwzględnić ją jako http_archive w pliku WORKSPACE:

# ...

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",
    ],
)

Aplikacje Tink Java

Biblioteka Tink Java Apps zawiera implementacje tokena metody płatności Google, weryfikacji po stronie serwera reklam z nagrodą Google AdMob i RFC 8291 – szyfrowanie wiadomości w przypadku powiadomień push w internecie. Najnowsza wersja to 1.12.2.

Maven

Bibliotekę Tink Java Apps możesz uwzględnić za pomocą Maven:

<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

Możesz zainstalować dowolny com.google.crypto.tink:apps-*artefakt Mavena za pomocą narzędzia rules_jvm_external.

# ...

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",
    ],
)

Dalsze kroki

Po skonfigurowaniu Tink postępuj zgodnie ze standardowymi instrukcjami korzystania z tej usługi:

Wybierz element podstawowy – zdecyduj, którego elementu podstawowego użyć w zależności od przypadku użycia.
Zarządzanie kluczami – chroń klucze za pomocą zewnętrznej usługi KMS, generuj zestawy kluczy i rotuj klucze.

Konfigurowanie Tink Java Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Tink Java

Maven

Bazel

Artefakt wersji Maven

Kompilowanie ze źródła

Tink na Androida

Gradle

Rozszerzenie AWS KMS

Maven

Bazel

Artefakt wersji Maven

Kompilowanie ze źródła

Rozszerzenie Google Cloud KMS

Maven

Bazel

Artefakt wersji Maven

Kompilowanie ze źródła

Aplikacje Tink Java

Maven

Bazel

Dalsze kroki

Konfigurowanie Tink Java