הגדרת Tink Java

אחרי שמתקינים ומגדירים את Tink, ממשיכים לשלבים הבאים.

Tink Java

ספריית הליבה של Java היא tink-java, והגרסה האחרונה היא 1.24.0. ‫Tink Java תומך ב-Java 11 ואילך.

Maven

אפשר לכלול את Tink Java באמצעות Maven:

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

Bazel

משתמשי Bazel יכולים להוסיף את Tink Java כתלות על ידי הוספת הקוד הבא לקובץ 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

ספריית הליבה של Android היא tink-java, והגרסה האחרונה היא 1.24.0.

‫Tink Android נתמך באופן מלא החל מרמת API‏ 24. רוב החלקים של Tink אמורים לפעול החל מרמת API‏ 23. החלקים שבהם Tink לא פועל באופן מיידי עם רמת API‏ 23 הם:

  • ספריית ה-JWT דורשת רמת API‏ 24 כי היא משתמשת במחלקות כמו java.util.Optional. אפשר להימנע מהמגבלה הזו באמצעות הסרה של סוכר תחבירי.

  • חלק מממשקי ה-API ב-com.google.crypto.tink.streamingaead משתמשים ב-SeekableByteBufferChannel, שזמין רק מרמת API‏ 24.

מסיבות טכניות, אנחנו בודקים את Tink ב-Android רק בתשתית הפנימית של Google. אנחנו לא צופים בעיות בגלל זה, אבל אם נתקלתם בבעיות, אתם יכולים לדווח עליהן.

ב-Tink Android אין צורך בהגדרת ProGuard.

Gradle

אפשר להשתמש ב-tink-android מ-Gradle:

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

תוסף AWS KMS

תוסף Tink Java AWS KMS הוא tink-java-awskms, והגרסה האחרונה היא 2.2.0.

Maven

אפשר לכלול את התוסף Tink Java AWS KMS באמצעות Maven:

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

Bazel

ארטיפקט של גרסת Maven

אתם יכולים להתקין את פריט המידע שנוצר ב-Maven,‏ com.google.crypto.tink:tink-awskms, לצד com.google.crypto.tink:tink באמצעות הכלי 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",
    ],
)

התוסף Google Cloud KMS

התוסף של Tink Java ל-Google Cloud KMS הוא tink-java-gcpkms, והגרסה האחרונה היא 1.12.0.

Maven

אפשר לכלול את התוסף Tink Java Google Cloud KMS באמצעות Maven:

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

Bazel

ארטיפקט של גרסת Maven

אתם יכולים להתקין את פריט המידע שנוצר ב-Maven,‏ com.google.crypto.tink:tink-gcpkms, לצד com.google.crypto.tink:tink באמצעות הכלי 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",
    ],
)

בנייה מהמקור

מוסיפים לקובץ 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",
)

אפליקציות Tink Java

הספרייה Tink Java Apps מספקת הטמעות ל-Google Payment Method Token, ל-אימות בצד השרת של מודעות מתגמלות ב-Google AdMob ול-RFC 8291 - Message Encryption for Web Push, כשהגרסה האחרונה היא 1.15.0.

Maven

אפשר לכלול את ספריית Tink Java Apps באמצעות 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

אפשר להתקין כל אחד מהרכיבים של com.google.crypto.tink:apps-* Maven באמצעות הכלי 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",
    ],
)

השלבים הבאים

אחרי שמסיימים להגדיר את Tink, ממשיכים לשלבים הרגילים של השימוש ב-Tink:

  • בחירת פרימיטיב – בוחרים את הפרימיטיב שמתאים לתרחיש לדוגמה.
  • ניהול מפתחות – הגנה על המפתחות באמצעות KMS חיצוני, יצירת קבוצות מפתחות והחלפת מפתחות