بث AE-CTR HMAC للبث AEAD
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يحدِّد هذا المستند رسميًا الدالة الحسابية التي تمثّلها مفاتيح البث باستخدام HMACHAES-CTR (المشفَّرة بتنسيق proto على النحو التالي:
type.googleapis.com/google.crypto.tink.AesCtrHmacStreamingKey
).
يستند هذا التشفير بشكل فضفاض إلى [HRRV15]1. لتحليل
الأمان، يُرجى الرجوع إلى [HS20]2. يُرجى العلم أيضًا أنّ اختبارات Tink المتعددة اللغات
تتضمّن اختبارًا هو
aes_ctr_hmac_streaming_key_test.py الذي
يحتوي على test_manually_created_test_vector
مع دليل إرشادي كامل حول كيفية
الحصول على نص مشفّر.
المفتاح والمَعلمات
يتم وصف المفاتيح من خلال الأجزاء التالية (جميع الأحجام في هذا المستند بالكلمات
الثنائية):
- \(\mathrm{InitialKeyMaterial}\)، سلسلة بايت: مادة المفتاح الأولية
- \(\mathrm{CiphertextSegmentSize} \in \{1, 2, \ldots, 2^{31}-1\}\).
- \(\mathrm{DerivedKeySize} \in \{16, 32\}\).
- \(\mathrm{HkdfHashType} \in \{\mathrm{SHA1}, \mathrm{SHA256},
\mathrm{SHA512}\}\).
- \(\mathrm{HmacHashType} \in \{\mathrm{SHA1}, \mathrm{SHA256},
\mathrm{SHA512}\}\).
- \(\mathrm{HmacTagSize} \in \mathbb{N}\).
تستوفي المفاتيح الصالحة أيضًا السمات التالية:
- \(\mathrm{len}(\mathrm{InitialKeyMaterial}) \geq \mathrm{DerivedKeySize}\).
- إذا \(\mathrm{HmacHashType} = \mathrm{SHA1}\) ثم \(\mathrm{HmacTagSize}
\in \{10, \ldots, 20\}\).
- إذا \(\mathrm{HmacHashType} = \mathrm{SHA256}\) ثم \(\mathrm{HmacTagSize}
\in \{10, \ldots, 32\}\).
- إذا \(\mathrm{HmacHashType} = \mathrm{SHA512}\) ثم \(\mathrm{HmacTagSize}
\in \{10, \ldots, 64\}\).
- \(\mathrm{CiphertextSegmentSize} > \mathrm{DerivedKeySize} +
\mathrm{HmacTagSize} + 8\) (هذا يساوي
\(\mathrm{len}(\mathrm{Header}) + \mathrm{HmacTagSize}\) كما هو موضّح لاحقًا).
ترفض Tink المفاتيح التي لا تستوفي أيًا من هذه السمات (إما عند تحليل المفتاح أو عند إنشاء العنصر الأساسي المقابل).
وظيفة التشفير
لتشفير رسالة \(\mathrm{Msg}\) مع بيانات مرتبطة
\(\mathrm{AssociatedData}\)، ننشئ عنوانًا،
ونقسّم الرسالة إلى أجزاء، ونشفّر كل جزء، ثم نجمعها
معًا. نوضّح هذه الخطوات في ما يلي.
لإنشاء العنوان، نختار أولاً سلسلة عشوائية موحّدة \(\mathrm{Salt}\)
بطول \(\mathrm{DerivedKeySize}\). نختار بعد ذلك سلسلة عشوائية موحّدة
\(\mathrm{NoncePrefix}\) بطول 7.
بعد ذلك، نضبط
\(\mathrm{Header} := \mathrm{len}(\mathrm{Header}) \| \mathrm{Salt} \|
\mathrm{NoncePrefix}\)،
حيث يتم ترميز طول العنوان كبايت واحد. نلاحظ أنّه
\(\mathrm{len}(\mathrm{Header}) \in \{24, 40\}\).
بعد ذلك، نستخدم دالة HKDF3 مع دالة التجزئة \(\mathrm{HkdfHashType}\)
لحساب مادة المفتاح التي يبلغ طولها
\(\mathrm{DerivedKeySize} + 32\) لهذه الرسالة:
\(k := \mathrm{HKDF}(\mathrm{InitialKeyMaterial}, \mathrm{Salt},
\mathrm{AssociatedData})\).
يتم استخدام المدخلات في المدخلات المقابلة لها في
\(\mathrm{HKDF}\): \(\mathrm{InitialKeyMaterial}\) هو \(\mathrm{ikm}\)،
\(\mathrm{Salt}\) هو الملح،
\(\mathrm{AssociatedData}\) يُستخدَم ك \(\mathrm{info}\).
بعد ذلك، يتم تقسيم السلسلة \(k\) إلى جزأين \(k_1 \| k_2 := k\)،
بحيث يكون\(\mathrm{len}(k_1) = \mathrm{DerivedKeySize}\) و \(\mathrm{len}(k_2) = 32\).
تقسيم الرسالة
بعد ذلك، يتم تقسيم الرسالة \(M\) إلى أجزاء: \(M = M_0 \| M_1 \| \cdots
\| M_{n-1}\).
يتم اختيار أطوالها بحيث تستوفي ما يلي:
- \(\mathrm{len}(M_0) \in \{0,\ldots, \mathrm{CiphertextSegmentSize} -
\mathrm{len}(\mathrm{Header}) - \mathrm{HmacTagSize}\}\).
- إذا \(n > 1\)، ثم \(\mathrm{len}(M_1), \ldots, \mathrm{len}(M_{n-1})
\in \{1,\ldots, \mathrm{CiphertextSegmentSize} - \mathrm{HmacTagSize}\}\).
- إذا كان \(n > 1\)، يجب أن يكون \(M_{0}, \ldots, M_{n-2}\) الحد الأقصى لطول
وفقًا للقيود المذكورة أعلاه.
في عملية التقسيم هذه، يمكن أن يكون \(n\) \(2^{32}\)كحد أقصى. بخلاف ذلك، لن يتم التشفير.
تشفير الكتل
لتشفير الجزء \(M_i\)، نحسب أولاً
\(\mathrm{IV}_i := \mathrm{NoncePrefix} \| \mathrm{i} \| b \| 0x00000000\)،
حيث نُشفِّر \(\mathrm{i}\) في 4
بايت باستخدام ترميز big-endian، ونضبط البايت $b$ على 0x00
إذا كان $i < n-1$
و0x01
في الحالات الأخرى.
بعد ذلك، نشفّر \(M_i\) باستخدام مفتاح AES CTR \(k_1\)ومتّجه الإعداد
\(\mathrm{IV}_i\). بعبارة أخرى، تكون مدخلات عمليات استدعاء AES هي
\(\mathrm{IV}_i, \mathrm{IV}_i + 1, \mathrm{IV}_i + 2, \ldots\)
حيث يتم تفسير \(\mathrm{IV}_i\) على أنّه عدد صحيح بترتيب ذي القيمة الأكبر أولاً.
ينتج عن ذلك \(C'_i\).
نحسب العلامة باستخدام HMAC مع دالة التجزئة التي تحدّدها \(\mathrm{HmacHashType}\) ومع المفتاح \(k_2\) على التسلسل\(\mathrm{IV}_i \| C'_i\).
بعد ذلك، نربط النص المشفَّر متبوعًا بالعلامة للحصول على \(C_i\).
تسلسل الشرائح
أخيرًا، يتم تسلسل جميع الأجزاء على النحو التالي:
\(\mathrm{Header} \| C_0 \| \cdots \| C_{n-1}\)، وهو النص المشفَّر النهائي.
دالة فك التشفير
إنّ عملية فك التشفير هي ببساطة عملية عكسية لعملية التشفير. نستخدم الرأس للحصول على المفتاح المؤقت،
وفك ترميز كل جزء من النص المشفَّر بشكلٍ فردي.
قد تسمح واجهات برمجة التطبيقات (وعادةً ما تسمح) بالوصول العشوائي أو الوصول إلى
بداية ملف بدون فحص نهايته. وهذا الإجراء
مقصود، لأنّه من الممكن فك تشفير \(M_i\) من \(C_i\)،
بدون فك تشفير جميع وحدات النص المشفَّر السابقة والباقيّة.
ومع ذلك، يجب أن تحرص واجهات برمجة التطبيقات على عدم السماح للمستخدمين بإدخال أخطاء في نهاية الملف و
أخطاء في فك التشفير: في كلتا الحالتَين، من المحتمل أن تعرض واجهة برمجة التطبيقات خطأ، وقد يؤدي تجاهل الفرق إلى تمكّن المهاجم من
اقتطاع الملفات بفعالية.
تسلسل المفاتيح وتحليلها
لتسلسل مفتاح بتنسيق "Tink Proto"، نربط أولاً المَعلمات
بالطريقة الواضحة في ملف proto الوارد في
aes_ctr_hmac_streaming.proto.
يجب ضبط الحقل version
على 0.
بعد ذلك، نُسلسل ذلك باستخدام تسلسل proto العادي، ونُدمج السلسلة الناتجة في قيمة حقل ملف proto لـ
KeyData. نضبط الحقل type_url
على type.googleapis.com/google.crypto.tink.AesCtrHmacStreamingKey
.
بعد ذلك، نضبط key_material_type
على SYMMETRIC
، ونضمّن ذلك في مجموعة مفاتيح. ننصح عادةً بضبط output_prefix_type
على RAW
. الاستثناء هو إذا تم تحليل المفتاح
بقيمة مختلفة تم ضبطها على output_prefix_type
،
قد يكتب Tink إما RAW
أو القيمة السابقة.
لتحليل مفتاح، نعكس العملية أعلاه (بالطريقة المعتادة عند تحليل
protos). يتم تجاهل الحقل key_material_type
. يمكن تجاهل قيمة
output_prefix_type
أو رفض المفاتيح التي
لها قيمة output_prefix_type
مختلفة عن RAW
.
يتم رفض المفاتيح التي تحتوي على version
مختلف عن 0.
المراجع
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis document defines the AES-CTR HMAC Streaming key and its mathematical function for encryption and decryption, loosely based on the HRRV15 and HS20 security analyses.\u003c/p\u003e\n"],["\u003cp\u003eThe encryption process involves creating a header, splitting the message into segments, encrypting each segment using AES CTR with a derived key, and concatenating the segments along with the header.\u003c/p\u003e\n"],["\u003cp\u003eKeys are described by parameters including InitialKeyMaterial, CiphertextSegmentSize, DerivedKeySize, HkdfHashType, HmacHashType, and HmacTagSize, with specific validity constraints.\u003c/p\u003e\n"],["\u003cp\u003eDecryption reverses the encryption process, allowing for potential random access to segments but requiring careful handling of end-of-file and decryption errors.\u003c/p\u003e\n"],["\u003cp\u003eSerialization and parsing of keys involve mapping parameters to a proto format, embedding them in a KeyData proto, and setting specific fields like type_url, key_material_type, and output_prefix_type.\u003c/p\u003e\n"]]],["AES-CTR HMAC Streaming keys define an encryption method involving key parameters like `InitialKeyMaterial`, `CiphertextSegmentSize`, `DerivedKeySize`, `HkdfHashType`, `HmacHashType`, and `HmacTagSize`. Encryption creates a header with a random salt and nonce prefix, derives key material using HKDF, and splits the message into segments. Each segment is encrypted using AES-CTR with a unique IV and HMAC tag, then concatenated to form the ciphertext. Decryption reverses this process. Keys are serialized into a specific proto format.\n"],null,["# AES-CTR HMAC Streaming AEAD\n\nThis document formally defines the mathematical function represented by\nAES-CTR HMAC Streaming keys (encoded in proto format as\n`type.googleapis.com/google.crypto.tink.AesCtrHmacStreamingKey`).\n\nThis encryption is loosely based on \\[HRRV15\\]^[1](#fn1)^. For an analysis of the\nsecurity we refer to \\[HS20\\]^[2](#fn2)^. Note also that the Tink cross language tests\nhave a test\n[aes_ctr_hmac_streaming_key_test.py](https://github.com/google/tink/blob/master/testing/cross_language/streaming_aead/aes_ctr_hmac_streaming_key_test.py) which\ncontains `test_manually_created_test_vector` with a complete walkthrough on how\nto get a ciphertext.\n\nKey and parameters\n------------------\n\nKeys are described by the following parts (all sizes in this document are in\nbytes):\n\n- \\\\(\\\\mathrm{InitialKeyMaterial}\\\\), a byte string: the initial key material.\n- \\\\(\\\\mathrm{CiphertextSegmentSize} \\\\in \\\\{1, 2, \\\\ldots, 2\\^{31}-1\\\\}\\\\).\n- \\\\(\\\\mathrm{DerivedKeySize} \\\\in \\\\{16, 32\\\\}\\\\).\n- \\\\(\\\\mathrm{HkdfHashType} \\\\in \\\\{\\\\mathrm{SHA1}, \\\\mathrm{SHA256}, \\\\mathrm{SHA512}\\\\}\\\\).\n- \\\\(\\\\mathrm{HmacHashType} \\\\in \\\\{\\\\mathrm{SHA1}, \\\\mathrm{SHA256}, \\\\mathrm{SHA512}\\\\}\\\\).\n- \\\\(\\\\mathrm{HmacTagSize} \\\\in \\\\mathbb{N}\\\\).\n\nValid keys additionally satisfy the following properties:\n\n- \\\\(\\\\mathrm{len}(\\\\mathrm{InitialKeyMaterial}) \\\\geq \\\\mathrm{DerivedKeySize}\\\\).\n- If \\\\(\\\\mathrm{HmacHashType} = \\\\mathrm{SHA1}\\\\) then \\\\(\\\\mathrm{HmacTagSize} \\\\in \\\\{10, \\\\ldots, 20\\\\}\\\\).\n- If \\\\(\\\\mathrm{HmacHashType} = \\\\mathrm{SHA256}\\\\) then \\\\(\\\\mathrm{HmacTagSize} \\\\in \\\\{10, \\\\ldots, 32\\\\}\\\\).\n- If \\\\(\\\\mathrm{HmacHashType} = \\\\mathrm{SHA512}\\\\) then \\\\(\\\\mathrm{HmacTagSize} \\\\in \\\\{10, \\\\ldots, 64\\\\}\\\\).\n- \\\\(\\\\mathrm{CiphertextSegmentSize} \\\u003e \\\\mathrm{DerivedKeySize} + \\\\mathrm{HmacTagSize} + 8\\\\) (This equals \\\\(\\\\mathrm{len}(\\\\mathrm{Header}) + \\\\mathrm{HmacTagSize}\\\\) as explained later).\n\nKeys which do not satisfy any of these properties are rejected by Tink (either\nwhen the key is parsed or when the corresponding primitive is created).\n\nEncryption function\n-------------------\n\nTo encrypt a message \\\\(\\\\mathrm{Msg}\\\\) with associated data\n\\\\(\\\\mathrm{AssociatedData}\\\\), we create a header,\nsplit the message into segments, encrypt each segment, and concatenate\nthe segments. We explain these steps in the following.\n\n### Creating the header\n\nTo create the header, we first pick a uniform random string \\\\(\\\\mathrm{Salt}\\\\)\nof length \\\\(\\\\mathrm{DerivedKeySize}\\\\). We next pick a uniform random string\n\\\\(\\\\mathrm{NoncePrefix}\\\\) of length 7.\n\nWe then set\n\\\\(\\\\mathrm{Header} := \\\\mathrm{len}(\\\\mathrm{Header}) \\\\\\| \\\\mathrm{Salt} \\\\\\|\n\\\\mathrm{NoncePrefix}\\\\),\nwhere the length of the header is encoded as a single byte. We note that\n\\\\(\\\\mathrm{len}(\\\\mathrm{Header}) \\\\in \\\\{24, 40\\\\}\\\\).\n\nNext, we use HKDF^[3](#fn3)^ with hash-function \\\\(\\\\mathrm{HkdfHashType}\\\\)\nto compute key material of length\n\\\\(\\\\mathrm{DerivedKeySize} + 32\\\\) for this message:\n\\\\(k := \\\\mathrm{HKDF}(\\\\mathrm{InitialKeyMaterial}, \\\\mathrm{Salt},\n\\\\mathrm{AssociatedData})\\\\).\nThe inputs are used in the corresponding respective inputs of\n\\\\(\\\\mathrm{HKDF}\\\\): \\\\(\\\\mathrm{InitialKeyMaterial}\\\\) is \\\\(\\\\mathrm{ikm}\\\\),\n\\\\(\\\\mathrm{Salt}\\\\) is the salt, and\n\\\\(\\\\mathrm{AssociatedData}\\\\) is used as \\\\(\\\\mathrm{info}\\\\).\n\nThe string \\\\(k\\\\) is then split into two parts \\\\(k_1 \\\\\\| k_2 := k\\\\),\nsuch that\n\\\\(\\\\mathrm{len}(k_1) = \\\\mathrm{DerivedKeySize}\\\\) and \\\\(\\\\mathrm{len}(k_2) = 32\\\\).\n\n### Splitting the message\n\nThe message \\\\(M\\\\) is next split into parts: \\\\(M = M_0 \\\\\\| M_1 \\\\\\| \\\\cdots\n\\\\\\| M_{n-1}\\\\).\n\nTheir lengths are chosen so that they satisfy:\n\n- \\\\(\\\\mathrm{len}(M_0) \\\\in \\\\{0,\\\\ldots, \\\\mathrm{CiphertextSegmentSize} - \\\\mathrm{len}(\\\\mathrm{Header}) - \\\\mathrm{HmacTagSize}\\\\}\\\\).\n- If \\\\(n \\\u003e 1\\\\), then \\\\(\\\\mathrm{len}(M_1), \\\\ldots, \\\\mathrm{len}(M_{n-1}) \\\\in \\\\{1,\\\\ldots, \\\\mathrm{CiphertextSegmentSize} - \\\\mathrm{HmacTagSize}\\\\}\\\\).\n- If \\\\(n \\\u003e 1\\\\), then \\\\(M_{0}, \\\\ldots, M_{n-2}\\\\) must have maximal length according to the above to constraints.\n\nIn this splitting, \\\\(n\\\\) may at most be \\\\(2\\^{32}\\\\). Otherwise, encryption fails.\n\n### Encrypting the blocks\n\nTo encrypt segment \\\\(M_i\\\\), we first compute\n\\\\(\\\\mathrm{IV}_i := \\\\mathrm{NoncePrefix} \\\\\\| \\\\mathrm{i} \\\\\\| b \\\\\\| 0x00000000\\\\),\nwhere we encode \\\\(\\\\mathrm{i}\\\\) in 4\nbytes using big-endian encoding, and set the byte $b$ to be `0x00` if $i \\\u003c n-1$\nand `0x01` otherwise.\n\nWe then encrypt \\\\(M_i\\\\) using AES CTR key \\\\(k_1\\\\), and initialization vector\n\\\\(\\\\mathrm{IV}_i\\\\). In other words, the inputs to the invocations of AES are\n\\\\(\\\\mathrm{IV}_i, \\\\mathrm{IV}_i + 1, \\\\mathrm{IV}_i + 2, \\\\ldots\\\\)\nwhere \\\\(\\\\mathrm{IV}_i\\\\) is interpreted as big-endian integer.\nThis yields \\\\(C'_i\\\\).\n\nWe compute the tag using HMAC with the hash function given\nby \\\\(\\\\mathrm{HmacHashType}\\\\) and with key \\\\(k_2\\\\) over the concatenation\n\\\\(\\\\mathrm{IV}_i \\\\\\| C'_i\\\\).\n\nWe then concatenate the ciphertext followed by the tag to get \\\\(C_i\\\\).\n\n### Concatenate the segments\n\nFinally, all segments are concatenated as\n\\\\(\\\\mathrm{Header} \\\\\\| C_0 \\\\\\| \\\\cdots \\\\\\| C_{n-1}\\\\), which is the final ciphertext.\n\nDecryption function\n-------------------\n\nDecryption simply inverts the encryption. We use the header to obtain the nonce,\nand decrypt each segment of ciphertext individually.\n\nAPIs may (and typically do) allow random access, or access to the\nbeginning of a file without inspecting the end of the file. This is\nintentional, since it is possible to decrypt \\\\(M_i\\\\) from \\\\(C_i\\\\),\nwithout decrypting all previous and remaining ciphertext blocks.\n\nHowever, APIs should be careful to not allow users to confuse end-of-file and\ndecryption errors: in both cases the API probably has to return an error, and\nignoring the difference can lead to an adversary being able to effectively\ntruncate files.\n\nSerialization and parsing of keys\n---------------------------------\n\nTo serialize a key in the \"Tink Proto\" format, we first map the parameters\nin the obvious way into the proto given at\n[aes_ctr_hmac_streaming.proto](https://github.com/tink-crypto/tink-java/blob/main/proto/aes_ctr_hmac_streaming.proto).\nThe field `version` needs to be set to 0.\nWe then serialize this using normal proto serialization, and embed the resulting\nstring in the value of field of a\n[KeyData](https://github.com/tink-crypto/tink-java/blob/main/proto/tink.proto) proto. We set the `type_url` field\nto `type.googleapis.com/google.crypto.tink.AesCtrHmacStreamingKey`.\nWe then set `key_material_type` to `SYMMETRIC`, and embed this into a keyset. We\nusually set the `output_prefix_type` to `RAW`. The exception is that if the key\nwas parsed with a different value set for `output_prefix_type`,\nTink may either write `RAW` or the previous value.\n\nTo parse a key, we reverse the above process (in the usual way when parsing\nprotos). The field `key_material_type` is ignored. The value of\n`output_prefix_type` can either be ignored, or keys which\nhave `output_prefix_type` different from `RAW` can be rejected.\nKeys which have a `version` different from 0 are be rejected.\n\nReferences\n----------\n\n*** ** * ** ***\n\n1. \\[HRRV15\\] Hoang, Reyhanitabar, Rogaway, Vizar. Online\n authenticated-encryption and its nonce-reuse misuse-resistance. CRYPTO 2015.\n \u003chttps://eprint.iacr.org/2015/189\u003e [↩](#fnref1)\n\n2. \\[HS20\\] Security of Streaming Encryption in Google's Tink Library.\n Hoang, Shen, 2020.\n \u003chttps://eprint.iacr.org/2020/1019\u003e [↩](#fnref2)\n\n3. \\[HKDF\\] HMAC-based Extract-and-Expand Key Derivation Function (HKDF),\n RFC 5869. \u003chttps://www.rfc-editor.org/rfc/rfc5869\u003e [↩](#fnref3)"]]