Konfigurowanie Tink Java

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

Tink Java

Główna biblioteka Java to tink-java, a jej najnowsza wersja to 1.22.0. Tink Java obsługuje Javę 11 lub nowszą.

Maven

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

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

Bazel

Użytkownicy Bazel mogą dodać Tink Java jako zależność, dodając w pliku MODULE.bazel ten kod:

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

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

Tink Android

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

Biblioteka Tink Android jest w pełni obsługiwana od poziomu API 24. Większość komponentów biblioteki Tink powinna działać od poziomu API 23. Elementy, które nie działają od razu w Tink w przypadku interfejsu API na poziomie 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.22.0'
}

Rozszerzenie AWS KMS

Rozszerzenie Tink Java AWS KMS to tink-java-awskms w najnowszej wersji 2.0.0.

Maven

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

<dependencies>
  <dependency>
    <groupId>com.google.crypto.tink</groupId>
    <artifactId>tink-awskms</artifactId>
    <version>2.0.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.22.0",
        "com.google.crypto.tink:tink-awskms:2.0.0",
        # ... 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.11.0.

Maven

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

<dependencies>
  <dependency>
    <groupId>com.google.crypto.tink</groupId>
    <artifactId>tink-gcpkms</artifactId>
    <version>1.11.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.22.0",
        "com.google.crypto.tink:tink-gcpkms:1.11.0",
        # ... other dependencies ...
    ],
    repositories = [
        "https://maven.google.com",
        "https://repo1.maven.org/maven2",
    ],
)

Utwórz na podstawie ź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/archive/refs/tags/v1.22.0.zip],
    urls = ["https://github.com/tink-crypto/tink-java/releases/download/v1.22.0/tink-java-1.22.0.zip"],
    strip_prefix = "tink-java-1.22.0",
    sha256 = "94d73be03a03a8c59914f643eb29b1df52bef5e45e67a4e46800b84e24240ffb",
)

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/archive/refs/tags/v1.11.0.zip"],
    strip_prefix = "tink-java-gcpkms-1.11.0",
    sha256 = "dc64ce1aa013f2c21fdb877a47356564ebbd99201afdb1a1c88fe5252f54a3e9",
)

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 formy płatności Google, weryfikacji po stronie serwera reklam z nagrodą Google AdMob i RFC 8291 – Message Encryption for Web Push w najnowszej wersji 1.14.0.

Maven

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

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

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

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

Bazel

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

# ...

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

Dalsze kroki

Po skonfigurowaniu usługi Tink wykonaj standardowe czynności związane z jej używaniem:

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