אחרי שמתקינים ומגדירים את 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 חיצוני, יצירת קבוצות מפתחות והחלפת מפתחות