با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
در بسیاری از کتابخانه های رمزنگاری، کلیدها اغلب تنها با چند توالی بایت شناسایی می شوند. به عنوان مثال توابع OpenSSL مانند EVP_EncryptInit_ex را در نظر بگیرید که به غیر از بایت های کلیدی، به IV نیز برای محاسبه نیاز دارند. یا روش javax.crypto Cipher.init که هم یک دنباله کلید و هم یک AlgorithmParameterSpec را می گیرد. استفاده صحیح از چنین توابعی اغلب دشوار است و عبور از پارامترهای اشتباه می تواند عواقب جدی داشته باشد.
هدف Tink متفاوت بودن است و انتظار دارد که یک کلید همیشه از مواد کلیدی و فراداده (پارامترها) تشکیل شود.
برای مثال یک کلید کامل AEAD با جزئیات دقیق نحوه عملکرد رمزگذاری و رمزگشایی را مشخص می کند - این دو عملکرد را مشخص می کند. \(\mathrm{Enc}\) و\(\mathrm{Dec}\)و نحوه کدگذاری متن رمز شده (مثلاً بردار مقداردهی اولیه، به دنبال رمزگذاری و به دنبال آن برچسب).
یک کلید AES در Tink نه تنها یک توالی بایت به طول 128، 192 یا 256 بیت است، بلکه مشخصات الگوریتم مربوطه مورد نیاز برای محاسبه کلید را نیز در قالب یک شی پارامتر ذخیره می کند. از این رو، یک کلید کامل AES-EAX و یک کلید کامل AES-GCM اشیاء مختلف در Tink هستند.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eIn Tink, a Key is a cryptographic object encompassing both key material and metadata, ensuring clear and complete functionality specification.\u003c/p\u003e\n"],["\u003cp\u003eUnlike traditional libraries, Tink Keys include necessary parameters like IV and algorithm specifications, simplifying usage and mitigating potential errors.\u003c/p\u003e\n"],["\u003cp\u003eTink Keys fully define cryptographic operations, including encryption, decryption, and ciphertext encoding, as exemplified by AEAD keys.\u003c/p\u003e\n"],["\u003cp\u003eDifferent key types with distinct algorithm specifications, like AES-EAX and AES-GCM, are treated as separate objects within Tink.\u003c/p\u003e\n"],["\u003cp\u003eTink incorporates Keys into Keysets, enabling key rotation and enhanced security practices.\u003c/p\u003e\n"]]],["Tink's **Key** includes both key material and metadata, defining its functionality. Unlike other libraries that only use byte sequences, Tink requires complete parameter specifications. A full AEAD key defines encryption and decryption processes, along with ciphertext encoding. AES keys in Tink include algorithm specifications, making different AES types distinct objects. Keys in Tink exist as parts of a set of keys called a Keyset, allowing key rotation.\n"],null,["# Keys\n\n| In Tink, a **Key** describes a complete cryptographic object, and consists of the key material plus all necessary metadata which describes its functionality.\n\nIn many cryptographic libraries, keys are often identified by only some byte\nsequences. Consider for example OpenSSL functions such as `EVP_EncryptInit_ex`,\nwhich apart from the key bytes, also needs the IV for computation; or the\njavax.crypto method `Cipher.init`, which takes both a key sequence and an\n`AlgorithmParameterSpec`. Such functions are often difficult to use correctly\nand passing the wrong parameters can have serious consequences.\n\nTink aims to be different, and expects a key to always consist of both the key\nmaterial and the metadata (the parameters).\n\nA full AEAD key for example specifies in exact detail how encryption and\ndecryption works - it specifies the two functions \\\\(\\\\mathrm{Enc}\\\\) and\n\\\\(\\\\mathrm{Dec}\\\\), and how the ciphertext is encoded (e.g. initialization vector,\nfollowed by the encryption, followed by the tag).\n\nAn AES key in Tink is not only a byte sequence of length 128, 192 or 256 bits,\nbut it also stores the corresponding algorithm specifications needed to compute\nthe key, in the form of a [parameters](/tink/design/parameters) object. Hence, a\nfull AES-EAX key and a full AES-GCM key are different objects in Tink.\n| **Note:** In Tink, keys are part of a [keyset](/tink/design/keysets) - a set of keys which implement the same primitive, which facilitates key rotation."]]
