فئة ara::crypto::cryp::SignerPrivateCtx

[SWS_CRYPT_23500] Upstream: RS_CRYPTO_02204

class SignerPrivateCtx :             public CryptoContext {...};

Signature Private key Context interface.

Header-Datei	#include "ara/crypto/cryp/signer_private_ctx.h"
Forwarding-Header	#include "ara/crypto/crypto_fwd.h"
Scope	namespace ara::crypto::cryp
Basisklasse(n)	CryptoContext

دليل المستخدممولَّد بالذكاء الاصطناعي

يُستخدم لإنشاء التوقيع الرقمي باستخدام مفاتيح تشفيرية خاصة عبر إجراء الخطوة الواحدة أو إجراء البث.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: bdc0b85a137f المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يُستخدم لإنشاء التوقيع الرقمي باستخدام مفاتيح تشفيرية خاصة عبر إجراء الخطوة الواحدة أو إجراء البث.

تغلّف الواجهة ara::crypto::cryp::SignerPrivateCtx المفاتيح الخاصة لعمليات التوقيع الرقمي على Adaptive Platform [SWS_CRYPT_23501]. بعد تكوين المفتاح عبر SetKey()، يمكن توقيع الرسائل إما في خطوة واحدة عبر Sign() أو على مراحل متعددة عبر Start() وUpdate() وFinish() [SWS_CRYPT_23515] [SWS_CRYPT_23512] [SWS_CRYPT_50040]. جميع الاستدعاءات آمنة لخيوط التنفيذ (thread-safe) وتشير إلى أخطاء مثل السعات غير الكافية للمخزن المؤقت أو حالات السياق غير الصالحة عبر ara::core::Result [SWS_CRYPT_50040].

السياق

تمثل الواجهة ara::crypto::cryp::SignerPrivateCtx سياق التنفيذ التشفيري لعمليات التوقيع الرقمي باستخدام مفتاح خاص على AUTOSAR Adaptive Platform. ترث الفئة من CryptoContext وتغلّف خوارزميات التوقيع غير المتماثلة. لربط مادة المفتاح المطلوبة، يتفاعل السياق إما مباشرةً مع كائن مفتاح خاص عبر PrivateKey::Sptr [SWS_CRYPT_23515] أو مع فتحة مفتاح مُدارة عبر KeySlot::Sptr [SWS_CRYPT_50036]. يدير المتصلون عادةً مثيلات هذه الواجهة عبر الاسم المستعار المحدَّد لنوع المؤشر الذكي ara::crypto::cryp::SignerPrivateCtx::Sptr [SWS_CRYPT_23501].

دورة الحياة

تُشغَّل مثيلات SignerPrivateCtx ككائنات ذات حالة وتُدار عبر هياكل مؤشرات مشتركة (std::shared_ptr) [SWS_CRYPT_23501]. قبل إجراء الحسابات التشفيرية، يكون المثيل في حالة غير مهيأة ويتطلب تعيين مفتاح مناسب. عبر الطريقة SetKey()، يُعيَّن للسياق إما مفتاح خاص محدد [SWS_CRYPT_23515] أو يُودع KeySlot تُستخدم قيمة مفتاحه عند وقت بدء حساب التوقيع [SWS_CRYPT_50036]. بمجرد ربط المفتاح بنجاح، ينتقل السياق إلى الحالة الجاهزة للتشغيل. جميع طرق الواجهة محددة بأنها آمنة من الاستثناءات (exception safe) وآمنة لخيوط التنفيذ (thread-safe) [SWS_CRYPT_23512] [SWS_CRYPT_50037].

في إطار معالجة البيانات، تميز الواجهة بين التوقيع لمرة واحدة وإجراءات البث متعددة المراحل. تُبدأ عملية توقيع البث بواسطة Start() [SWS_CRYPT_50037] [SWS_CRYPT_50038]، وتُغذى تدريجياً بكتل البيانات عبر Update() [SWS_CRYPT_50039]، ويتم إنهاؤها بواسطة Finish() [SWS_CRYPT_50040]. كبديل، يمكن إلغاء البث الجاري في أي وقت عبر Cancel()، مما يعيد المثيل إلى الحالة الجاهزة للتشغيل [SWS_CRYPT_50041].

مخطط الحالة: انتقالات حالة سياق التوقيع من التكوين حتى اكتمال العملية. المصادر: [SWS_CRYPT_23515]، [SWS_CRYPT_50036]، [SWS_CRYPT_23512]، [SWS_CRYPT_50037]، [SWS_CRYPT_50039]، [SWS_CRYPT_50040]، [SWS_CRYPT_50041]

مسار الاستخدام

يمكن للتطبيقات إنشاء التواقيع إما في خطوة واحدة (Single-Call) أو كتدفق بيانات مستمر (Streaming). قبل التنفيذ، يحدد التطبيق عبر GetSignatureSize() الحجم المتوقع للمخزن المؤقت لتنسيق التوقيع المطلوب FormatId [SWS_CRYPT_29004] بالإضافة إلى الحد الأقصى المسموح به لحجم الكتلة لعمليات القراءة الفردية عبر GetMaximumChunkSize() [SWS_CRYPT_50042].

في مسار الخطوة الواحدة، تُوقَّع الرسالة الكاملة مباشرةً باستخدام Sign(). تستقبل الطريقة رسالة الإدخال، والمخزن المؤقت للهدف ReadWriteMemRegion، وتنسيق التوقيع، بالإضافة إلى قيمة سياق اختيارية خاصة بالخوارزمية، وتُرجع العدد الفعلي للبايتات المكتوبة [SWS_CRYPT_23512].

بالنسبة لكميات البيانات الأكبر أو الرسائل المجزأة، يتبع مسار البث نمطاً من ثلاث مراحل:

التهيئة: استدعاء Start() دون معلمات [SWS_CRYPT_50037] أو باستخدام مخزن مؤقت للسياق خاص بالتطبيق ReadOnlyMemRegion [SWS_CRYPT_50038].
المعالجة: التغذية المتكررة للرسائل الجزئية عبر Update()، مع ضرورة التزام كل كتلة بالحد الأقصى المحدد بواسطة GetMaximumChunkSize() [SWS_CRYPT_50039] [SWS_CRYPT_50042].
الاكتمال أو الإلغاء: إنهاء إنشاء التوقيع والكتابة في الذاكرة الهدف عبر Finish() [SWS_CRYPT_50040]، أو الإلغاء المبكر للعملية الجارية باستخدام Cancel() [SWS_CRYPT_50041].

مخطط التسلسل: التدفق النموذجي لإنشاء توقيع عبر البث مع فحص المخزن المؤقت والإنهاء. المصادر: [SWS_CRYPT_23515]، [SWS_CRYPT_29004]، [SWS_CRYPT_50037]، [SWS_CRYPT_50039]، [SWS_CRYPT_50040]

سيناريوهات الأخطاء

تُرجع استدعاءات الطرق افتراضياً ara::core::Result وتستخدم في حالات الفشل رموز خطأ قياسية من ara::crypto::CryptoErrc مع دلالات التراجع (Rollback). تتضمن أسباب الأخطاء الشائعة ما يلي:

CryptoErrc::kUninitializedContext: استدعاء Sign() أو Start() قبل ربط مفتاح عبر SetKey() [SWS_CRYPT_23512] [SWS_CRYPT_50037] [SWS_CRYPT_50038].
CryptoErrc::kUsageViolation: لا يمتلك المفتاح المقدَّم إذن الاستخدام المطلوب kAllowSigGeneration [SWS_CRYPT_23515] [SWS_CRYPT_23512] [SWS_CRYPT_50037].
CryptoErrc::kIncompatibleObject: إن PrivateKey أو KeySlot الممرَّر غير متوافق مع خوارزمية السياق [SWS_CRYPT_23515] [SWS_CRYPT_50036].
CryptoErrc::kProcessingNotStarted: استدعاء Update() أو Finish() أو Cancel() دون استدعاء Start() بنجاح مسبقاً [SWS_CRYPT_50039] [SWS_CRYPT_50040] [SWS_CRYPT_50041].
CryptoErrc::kInsufficientCapacity: المخزن المؤقت للإخراج الممرَّر لـ Sign() أو Finish() أصغر من التوقيع المراد كتابته [SWS_CRYPT_23512] [SWS_CRYPT_50040].
CryptoErrc::kUnsupportedFormat: إن FormatId المطلوب غير مدعوم من السياق [SWS_CRYPT_29004] [SWS_CRYPT_23512] [SWS_CRYPT_50040].
CryptoErrc::kEmptyKeySlot: لا يحتوي KeySlot المكوَّن على أي مفتاح في وقت التنفيذ [SWS_CRYPT_23512] [SWS_CRYPT_50037].
CryptoErrc::kInvalidInputSize: أحجام غير صالحة للمخزن المؤقت عند استدعاءات Sign() أو Start() أو Update() [SWS_CRYPT_23512] [SWS_CRYPT_50038] [SWS_CRYPT_50039].

يعتمد هذا الدليل حصرياً على متطلبات مواصفة AUTOSAR Adaptive للوحدة crypto في الإصدار R25-11.

خريطة الأعضاء

الدوال الأعضاء

Cancel Finish GetMaximumChunkSize GetSignatureSize SetKey Sign Start Update

أسماء الأنواع البديلة

Sptr

مخطط الفئة

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

عرض التفاصيل

اختر عنصرًا من المخطط.

لا توجد بيانات عناصر لهذا الإصدار

الدوال الأعضاء

Cancel دالة

Cancel the ongoing streaming operation that has been initiated by Start() and has not yet been finished.

virtual ara::core::Result< void > Cancel () noexcept=0;

Finish دالة

Finish the signature generation and write the signature to the provided output buffer.

virtual ara::core::Result< size_t > Finish (ReadWriteMemRegion signature, FormatId signatureFormat) noexcept=0;

GetMaximumChunkSize دالة

Get the maximum input buffer size supported for processing in single calls to Update() or Sign() by this context.

virtual ara::core::Result< std::size_t > GetMaximumChunkSize () const noexcept=0;

GetSignatureSize دالة

Get size of the signature value produced by the current algorithm in the provided format.

virtual ara::core::Result< std::size_t > GetSignatureSize (FormatId signatureFormat) const noexcept=0;

SetKey دالة 2

Configure the context to use the provided key.

التحميلات الزائدة SetKey 2

virtual ara::core::Result< void > SetKey (PrivateKey::Sptr key) noexcept=0; SWS_CRYPT_23515

virtual ara::core::Result< void > SetKey (KeySlot::Sptr keySlot) noexcept=0; SWS_CRYPT_50036

Sign دالة

This function signs a message.

virtual ara::core::Result< std::size_t > Sign (ReadOnlyMemRegion message, ReadWriteMemRegion signature, FormatId signatureFormat, ara::core::Optional< ReadOnlyMemRegion > context) const noexcept=0;

Start دالة 2

Initialize the context for a new signature generation.

التحميلات الزائدة Start 2

virtual ara::core::Result< void > Start () noexcept=0; SWS_CRYPT_50037

virtual ara::core::Result< void > Start (ReadOnlyMemRegion context) noexcept=0; SWS_CRYPT_50038

Update دالة

Update the signature generation context by a new part of the message.

virtual ara::core::Result< void > Update (ReadOnlyMemRegion data) noexcept=0;

أسماء الأنواع البديلة

Sptr اسم نوع بديل

Smart pointer of the interface.

using Sptr = std::shared_ptr<SignerPrivateCtx>;

انقر على عنصر لعرض علاقاته.

الفئة الأساسيةالمشتقةيستخدممستخدم بواسطةالوراثةمحذوف اعتبارًا منيظهر فيلا توجد علاقات في هذه الفئةالدوالتعليق الذكاء الاصطناعيفتح صفحة الفئةتعذر تحميل صفحة الفئة.تغيير الترتيبتغيير العرضتغيير عرض المخططالأقساممدة القراءةمراجع SWSالمخططاتإعادة إلى الوسطغيّر الترتيب أو اسحب إلى شريط العنوانفك الإرساء – العرض في المحتوىنقل إلى العمود الأوسطإرساء كتبويب في شريط العنوانالعناصرنموذج الذكاء الاصطناعيفتح ملف التدقيقالملففتح النسخة المختصرةفتح النسخة المتوسطةفتح النسخة الكاملةاستعادة العرض الافتراضيتمت استعادة العرض الافتراضيتراجعإغلاق العرض التفصيليالتوقيعمعلومات عامةالقيمآخر تغيير حتى الإصدار المحددالتغيير التالي بعدهانقر: اختيار الإصدارلا يمكن الإفلات هنا: اسحب إلى شريط العنوان للتثبيت، أو إلى العمود الأوسط لإلغاء التثبيت.جديدمعدَّلدون تغييرمحذوفغير مُدرجالتغييراتلا تغيير في المحتوىلأول مرة فيحُذف فيلا تتوفر بيانات الإصدارات.جارٍ تحميل بيانات الإصدارات …النصالصياغة غير مسجلة في هذا الإصدارمرِّر فوق خلية أو انقرها: المقارنة مع الإصدار المحدد · انقر رأس إصدار: اختيار الإصداراختيار الإصدارالبياناتالإصدارالعنصرإصدار واحد فقط بصياغةموجود في PDF، لم يُستورد النص بعدالتُقط النص لأول مرةدون تغيير منذ {rel}ألوان الإصداراتأقدم إصدارأحدث إصدار

توثيق الدوال

دالة Cancel [SWS_CRYPT_50041] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< void > Cancel () noexcept=0;

Cancel the ongoing streaming operation that has been initiated by Start() and has not yet been finished.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: add6f8db34cb المصدر أسئلة مفتوحة (1)

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الطريقة Cancel() للإلغاء المتزامن لعملية تدفق قيد التشغيل ولم تكتمل بعد داخل الفئة ara::crypto::cryp::SignerPrivateCtx، والتي تم بدءها مسبقًا عن طريق استدعاء Start() [SWS_CRYPT_50041]. تم التصريح عن الواجهة الظاهرية البحتة virtual ara::core::Result<void> Cancel() noexcept = 0; في الترويسة ara/crypto/cryp/signer_private_ctx.h، ولا تقبل أي معاملات مُمررة وتشير إلى الإلغاء الناجح عبر ara::core::Result<void> فارغ [SWS_CRYPT_50041]. بالنسبة للمستدعي، تم تحديد الطريقة بأنها آمنة من الاستثناءات (exception safe) وآمنة للخيوط في الوصول المتزامن (thread-safe) [SWS_CRYPT_50041].

فيما يتعلق بترتيب الاستدعاء ومعالجة الأخطاء، يتطلب Cancel() بشكل إلزامي وجود معالجة نشطة: إذا لم يتم بدء معالجة البيانات مسبقًا عن طريق استدعاء الطريقة Start()، يفشل الإلغاء ويُعيد رمز الخطأ ara::crypto::CryptoErrc::kProcessingNotStarted مع دلالات تراجع محددة [SWS_CRYPT_50041]. تفسير: بعد استدعاء ناجح لـ Cancel()، من المرجح أن يعود السياق إلى حالة أساسية غير مبدوءة، بحيث يمكن بدء عملية توقيع أو تدفق جديدة. سؤال Q-348fb3ae43e424c9 (مفتوح)

يتبع التصميم مبدأ موحدًا لجميع عمليات التدفق في وحدة التشفير. توجد توقيعات ودلالات أخطاء متطابقة تمامًا للسياقات ذات الصلة مثل VerifierPublicCtx [SWS_CRYPT_50023]، MessageAuthnCodeCtx [SWS_CRYPT_50027]، SymmetricCipherCtx [SWS_CRYPT_50046]، HashFunctionCtx [SWS_CRYPT_50058]، DecryptorPrivateCtx [SWS_CRYPT_50069]، AuthCipherCtx [SWS_CRYPT_50077] بالإضافة إلى EncryptorPublicCtx [SWS_CRYPT_50089].

تم إنشاء ملاحظة الاستخدام هذه تلقائيًا بناءً على متطلبات مواصفات AUTOSAR Adaptive.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei	#include "ara/crypto/cryp/signer_private_ctx.h"
Scope	class ara::crypto::cryp::SignerPrivateCtx
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	an empty result if the ongoing streaming operation was cancelled successfully, or a result containing an error

Fehler

Fehlercode	Beschreibung
ara::crypto::CryptoErrc::kProcessingNotStarted	rollback_semantics if data processing was not started by a call of the Start() method

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_CRYPT_50041
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_50041@rel:R25-11#b88a1491
Content hash: b88a1491
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50041

Status: valid/unmigrated Version: rel:R25-11#5f721a2b Versionshistorie & Revisions (1 transition)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_CRYPT_50041@rel:R25-11#5f721a2b

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة Finish [SWS_CRYPT_50040] Upstream: RS_CRYPTO_02302, RS_CRYPTO_02203

virtual ara::core::Result< size_t > Finish (ReadWriteMemRegion signature, FormatId signatureFormat) noexcept=0;

Finish the signature generation and write the signature to the provided output buffer.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: c35d4c956908 المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تُنهي الطريقة ara::crypto::cryp::SignerPrivateCtx::Finish إنشاء التوقيع بشكل متزامن وتكتب التوقيع المحسوب مباشرةً في المخزن المؤقت للإخراج المقدم signature [SWS_CRYPT_50040]. وتتوقع الدالة كمعلمات تمرير نطاق الذاكرة القابل للكتابة signature (النوع ReadWriteMemRegion) والتنسيق المطلوب signatureFormat (النوع FormatId) [SWS_CRYPT_50040]. وكقيمة إرجاع، يقدم ara::core::Result<size_t> الحجم الفعلي بالبايت لبيانات التوقيع المكتوبة؛ ويجوز أن تكون كمية البيانات هذه أصغر من سعة المخزن المؤقت للوجهة [SWS_CRYPT_50040].

معالجة الأخطاء

تم تحديد دلالات التراجع لكافة حالات الخطأ التي قد تحدث [SWS_CRYPT_50040]. ويمكن إرجاع رموز الخطأ التالية عبر النتيجة:

ara::crypto::CryptoErrc::kProcessingNotStarted: لم يبدأ إنشاء التوقيع مسبقًا بنجاح [SWS_CRYPT_50040].
ara::crypto::CryptoErrc::kInsufficientCapacity: سعة المخزن المؤقت للإخراج الممرر signature صغيرة جدًا [SWS_CRYPT_50040].
ara::crypto::CryptoErrc::kUnsupportedFormat: قيمة signatureFormat غير معروفة أو غير مدعومة [SWS_CRYPT_50040].

التزامن والقيود

تم تحديد الطريقة على أنها thread-safe وexception safe ويجب ألا تُطلق أي استثناءات (noexcept) [SWS_CRYPT_50040]. ويتطلب الاستدعاء الصالح حتمًا أن تكون عملية الإنشاء في السياق قد بدأت مسبقًا بنجاح [SWS_CRYPT_50040].

تفاعل

تشكّل الطريقة ara::crypto::cryp::VerifierPublicCtx::Finish النظير الوظيفي المباشر للتحقق من التوقيع المُنشأ [SWS_CRYPT_50022]. وبالمقارنة مع سياقات حسابات التجزئة أو MAC، التي يقوم فيها Finish() فقط بإنهاء الحساب ويتم جلب النتيجة الوسيطة أو النهائية بشكل منفصل [SWS_CRYPT_21115] [SWS_CRYPT_21116]، يكتب SignerPrivateCtx::Finish التوقيع مباشرة في المخزن المؤقت [SWS_CRYPT_50040].

تم إنشاء ملاحظة الاستخدام هذه تلقائيًا استنادًا إلى مواصفات AUTOSAR R25-11.

Header-Datei	#include "ara/crypto/cryp/signer_private_ctx.h"
Scope	class ara::crypto::cryp::SignerPrivateCtx
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
signature	an output buffer that the signature will be written into
signatureFormat	the format in which the signature will be written

Rückgabewert

Typ	Beschreibung
ara::core::Result< size_t>	a result containing the size of the output data or an error. The output data may be smaller than the size of the output buffer signature.

Fehler

Fehlercode	Beschreibung
ara::crypto::CryptoErrc::kProcessingNotStarted	rollback_semantics if the signature generation has not been started successfully.
ara::crypto::CryptoErrc::kInsufficientCapacity	rollback_semantics if the output buffer is too small
ara::crypto::CryptoErrc::kUnsupportedFormat	rollback_semantics if the specified FormatId is unknown or not supported

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_CRYPT_50040
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_50040@rel:R25-11#e7c6a053
Content hash: e7c6a053
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50040

Status: valid/unmigrated Version: rel:R25-11#58202823 Versionshistorie & Revisions (1 transition)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_CRYPT_50040@rel:R25-11#58202823

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة GetMaximumChunkSize [SWS_CRYPT_50042] Upstream: RS_CRYPTO_02309

virtual ara::core::Result< std::size_t > GetMaximumChunkSize () const noexcept=0;

Get the maximum input buffer size supported for processing in single calls to Update() or Sign() by this context.

Header-Datei	#include "ara/crypto/cryp/signer_private_ctx.h"
Scope	class ara::crypto::cryp::SignerPrivateCtx
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Rückgabewert

Typ	Beschreibung
ara::core::Result<std::size_t >	the maximum buffer size in bytes

Fehler

Fehlercode	Beschreibung
This function does not specify any standardized errors.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_CRYPT_50042
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_50042@rel:R25-11#3c276c2b
Content hash: 3c276c2b
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50042

Status: valid/unmigrated Version: rel:R25-11#a4caf357 Versionshistorie & Revisions (1 transition)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_CRYPT_50042@rel:R25-11#a4caf357

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة GetSignatureSize [SWS_CRYPT_29004] Upstream: RS_CRYPTO_02309

virtual ara::core::Result< std::size_t > GetSignatureSize (FormatId signatureFormat) const noexcept=0;

Get size of the signature value produced by the current algorithm in the provided format.

Header-Datei	#include "ara/crypto/cryp/signer_private_ctx.h"
Scope	class ara::crypto::cryp::SignerPrivateCtx
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
signatureFormat	the format for which the size of the signature will be calculated

Rückgabewert

Typ	Beschreibung
ara::core::Result<std::size_t >	size of the signature value in bytes or an error

Fehler

Fehlercode	Beschreibung
ara::crypto::CryptoErrc::kUnsupportedFormat	rollback_semantics if the specified FormatId is unknown or not supported

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_CRYPT_29004
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_29004@rel:R25-11#30de5e64
Content hash: 30de5e64
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_29004

Status: valid/unmigrated Version: rel:R25-11#5dd47914 Versionshistorie & Revisions (1 transition, 7 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_CRYPT_29004@rel:R25-11#5dd47914

Recorded Revisions (7):

R25-11rel:R25-11#1da381032026-09-30
R20-11rel:R20-11#2a4501722026-10-14
R21-11rel:R21-11#d0e232c92026-10-14
R22-11rel:R22-11#68e2b9122026-10-14
R23-11rel:R23-11#260fdd9b2026-10-14
R24-11rel:R24-11#f3c2ba002026-10-14
R25-11rel:R25-11#5dd479142026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة SetKey [SWS_CRYPT_23515] Upstream: RS_CRYPTO_02001, RS_CRYPTO_02003

virtual ara::core::Result< void > SetKey (PrivateKey::Sptr key) noexcept=0;

Configure the context to use the provided key.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 0a351f8997c6 المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تقوم الطريقة الافتراضية SetKey للفئة ara::crypto::cryp::SignerPrivateCtx (include "ara/crypto/cryp/signer_private_ctx.h"#) بتهيئة سياق التوقيع لاستخدام مفتاح خاص مقدم [SWS_CRYPT_23515]. يتم تمرير key من النوع PrivateKey::Sptr كمعامل لكائن المفتاح المصدر [SWS_CRYPT_23515]. يتم تنفيذ الطريقة بشكل متزامن وتُرجع ara::core::Result<void>، والذي يكون فارغًا في حالة النجاح أو ينقل رمز الخطأ الذي حدث في حالة الفشل [SWS_CRYPT_23515].

معالجة الأخطاء

في حالة حدوث خطأ أثناء التهيئة، تسري دلالات التراجع (Rollback) [SWS_CRYPT_23515]. تم تحديد رموز الخطأ التالية:

ara::crypto::CryptoErrc::kIncompatibleObject: كائن المفتاح الممرر غير متوافق مع السياق الحالي [SWS_CRYPT_23515].
ara::crypto::CryptoErrc::kUsageViolation: الاستخدام المسموح به للمفتاح لا يتضمن إنشاء التوقيع (kAllowSig Generation) [SWS_CRYPT_23515].
ara::crypto::CryptoErrc::kUnsupported: السياق المحدد يدعم فقط التعيين عبر KeySlot [SWS_CRYPT_23515].

التزامن والقيود

تم الإعلان عن الواجهة كـ noexcept وصُنفت وفقًا للمواصفة على أنها آمنة من حيث الاستثناءات ("exception safe") وكذلك آمنة من حيث خيوط التنفيذ ("thread-safe") [SWS_CRYPT_23515].

تفاعل

في SignerPrivateCtx، يتوفر بدلاً من ذلك التحميل الزائد SetKey(KeySlot::Sptr)، والذي يقوم بتهيئة السياق بحيث لا يتم استخدام المفتاح المخزن في KeySlot إلا عند وقت بدء حساب التوقيع [SWS_CRYPT_50036]. وللتحقق من التوقيعات، يُستخدم النظير الوظيفي SetKey مع PublicKey::Sptr داخل ara::crypto::cryp::VerifierPublicCtx [SWS_CRYPT_24115] في جانب التحقق.

تم توليد إشعار الاستخدام هذا آليًا استنادًا إلى مواصفة AUTOSAR Adaptive R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

Header-Datei	#include "ara/crypto/cryp/signer_private_ctx.h"
Scope	class ara::crypto::cryp::SignerPrivateCtx
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
key	the source key object

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	An empty result or an error

Fehler

Fehlercode	Beschreibung
ara::crypto::CryptoErrc::kIncompatibleObject	rollback_semantics if the provided key object is incompatible with this context
ara::crypto::CryptoErrc::kUsageViolation	rollback_semantics if the allowed usage of the key does not include kAllowSig Generation
ara::crypto::CryptoErrc::kUnsupported	rollback_semantics if the context only supports setting a KeySlot

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_CRYPT_23515
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_23515@rel:R25-11#34725773
Content hash: 34725773
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_23515

Status: valid/unmigrated Version: rel:R25-11#71952992 Versionshistorie & Revisions (1 transition, 7 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_CRYPT_23515@rel:R25-11#71952992

Recorded Revisions (7):

R25-11rel:R25-11#95d92ab72026-09-30
R20-11rel:R20-11#e3c992392026-10-14
R21-11rel:R21-11#601e899c2026-10-14
R22-11rel:R22-11#a52d4de52026-10-14
R23-11rel:R23-11#4a68f6e92026-10-14
R24-11rel:R24-11#2c23797e2026-10-14
R25-11rel:R25-11#719529922026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة SetKey [SWS_CRYPT_50036] Upstream: RS_CRYPTO_02001, RS_CRYPTO_02003

virtual ara::core::Result< void > SetKey (KeySlot::Sptr keySlot) noexcept=0;

Configure the context to use the key stored in the provided KeySlot at the time the signature calculation is started.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 4ac747154425 المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تُهيئ الدالة SetKey سياق التوقيع [SWS_CRYPT_50036] لاستخدام مفتاح موجود في KeySlot::Sptr المُمرَّر. ولا يُستعان بالمفتاح إلا في اللحظة التي يبدأ فيها حساب التوقيع الفعلي [SWS_CRYPT_50036]. يتم الاستدعاء تزامنيًا، وهو مُعلن كـ noexcept ويُرجع ara::core::Result<void> [SWS_CRYPT_50036].

معالجة الأخطاء

إذا فشل التكوين، يُرسَل خطأ في كائن الإرجاع، مع سريان دلالات التراجع [SWS_CRYPT_50036]:

ara::crypto::CryptoErrc::kIncompatibleObject: يحدث عندما يكون keySlot المُقدَّم غير متوافق مع سياق التوقيع هذا [SWS_CRYPT_50036].
ara::crypto::CryptoErrc::kUnsupported: يُبلَّغ عنه إذا كان السياق يدعم حصريًا التعيين المباشر لـ PrivateKey [SWS_CRYPT_50036].

التزامن والتفاعل

تنتمي الواجهة إلى الفئة ara::crypto::cryp::SignerPrivateCtx وحُددت على أنها thread-safe وكذلك exception-safe [SWS_CRYPT_50036]. وإلى جانب هذا البديل المعتمد على الفتحات، يوفر SignerPrivateCtx أيضًا تحميلاً زائدًا يقبل كائن PrivateKey::Sptr مباشرة [SWS_CRYPT_23515]. وتوجد روابط فتحات مماثلة لسياقات تشفير أخرى، مثل التحقق من التوقيع باستخدام KeySlot في VerifierPublicCtx [SWS_CRYPT_50018] أو اشتقاق المفاتيح في KeyDerivationFunctionCtx [SWS_CRYPT_50010].

تم إنشاء هذا النص بواسطة ذكاء اصطناعي وهو مخصص كدليل توجيهي. والمواصفة الملزمة هي مواصفة AUTOSAR.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

Header-Datei	#include "ara/crypto/cryp/signer_private_ctx.h"
Scope	class ara::crypto::cryp::SignerPrivateCtx
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
keySlot	a keyslot containing a private key

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	An empty result or an error

Fehler

Fehlercode	Beschreibung
ara::crypto::CryptoErrc::kIncompatibleObject	rollback_semantics if the provided keySlot is incompatible with this context
ara::crypto::CryptoErrc::kUnsupported	rollback_semantics if the context only supports setting a PrivateKey

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_CRYPT_50036
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_50036@rel:R25-11#76880c2d
Content hash: 76880c2d
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50036

Status: valid/unmigrated Version: rel:R25-11#26b40256 Versionshistorie & Revisions (1 transition)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_CRYPT_50036@rel:R25-11#26b40256

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة Sign [SWS_CRYPT_23512] Upstream: RS_CRYPTO_02204

virtual ara::core::Result< std::size_t > Sign (ReadOnlyMemRegion message, ReadWriteMemRegion signature, FormatId signatureFormat, ara::core::Optional< ReadOnlyMemRegion > context) const noexcept=0;

This function signs a message.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 8e0e8733da4c المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

توقع الطريقة Sign رسالة بشكل متزامن في خطوة واحدة وفقًا لـ [SWS_CRYPT_23512]. وتستقبل رسالة الإدخال المراد توقيعها (message)، والمخزن المؤقت للوجهة (signature)، وتنسيق التوقيع المطلوب (signatureFormat)، بالإضافة اختياريًا إلى قيمة سياق (context). وفي حالة النجاح، تُرجع الدالة عبر ara::core::Result<std::size_t> الحجم الفعلي بالبايت للتوقيع المُنشأ، والذي قد يكون أصغر من سعة المخزن المؤقت للوجهة [SWS_CRYPT_23512].

فيما يتعلق بالتزامن والأمان من الاستثناءات، تم التصريح عن الطريقة كـ noexcept، وتُعتبر exception safe، ومحددة صراحة بأنها thread-safe [SWS_CRYPT_23512].

قبل الاستدعاء، يجب تهيئة السياق بشكل صحيح بقيمة مفتاح؛ وإلا فسيتم الإبلاغ عن UninitializedContext [SWS_CRYPT_23512]. وفيما يتعلق بطول الإدخال، يتفاعل Sign مع [SWS_CRYPT_50042]: عبر GetMaximumChunkSize يمكن تحديد الحد الأقصى لحجم المخزن المؤقت المدعوم لمعالجة الخطوة الواحدة، للوقاية من أخطاء مثل ara::crypto::CryptoErrc::kInvalidInputSize [SWS_CRYPT_23512] [SWS_CRYPT_50042].

تنص معالجة الأخطاء على أساليب دلالية للتراجع لرموز أخطاء محددة [SWS_CRYPT_23512]:

ara::crypto::CryptoErrc::kInsufficientCapacity: المخزن المؤقت للإخراج signature صغير جدًا.
ara::crypto::CryptoErrc::kUnsupported: معالجة الخطوة الواحدة غير مدعومة، أو أن تحديد السياق context لا يطابق المتطلبات.
ara::crypto::CryptoErrc::kUnsupportedFormat: الـ FormatId المحدد غير معروف أو غير مدعوم.
ara::crypto::CryptoErrc::kUsageViolation: الاستخدام المسموح به للمفتاح لا يتضمن kAllowSig Generation.
ara::crypto::CryptoErrc::kEmptyKeySlot أو ara::crypto::CryptoErrc::kBusyResource: الـ KeySlot الذي تم تكوينه فارغ، أو أن موردًا مطلوبًا قيد الاستخدام.

تم إنشاء ملاحظة الاستخدام هذه آليًا وتستند إلى محددات مواصفة AUTOSAR.

Header-Datei	#include "ara/crypto/cryp/signer_private_ctx.h"
Scope	class ara::crypto::cryp::SignerPrivateCtx
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe ara::crypto::CryptoErrc::k rollback_semantics

Parameter (in)

Parameter	Beschreibung
message	an input buffer containing the message to be signed
signatureFormat	the format in which the signature will be written
context	an optional "context" value

Parameter (out)

Parameter	Beschreibung
signature	an output buffer that the signature will be written into

Rückgabewert

Typ	Beschreibung
ara::core::Result<std::size_t >	a result containing the size of the output data or an error. The output data may be smaller than the size of the output buffer signature.

Fehler

Fehlercode	Beschreibung
UninitializedContext	if the context was not initialized by a key value
ara::crypto::CryptoErrc::kUnsupported	rollback_semantics if single-call processing is not supported, or if the context requires setting a context but no context is provided, or if the context does not support setting a context but a context is provided
ara::crypto::CryptoErrc::kInsufficientCapacity	rollback_semantics if the output buffer is too small
ara::crypto::CryptoErrc::kInvalidInputSize	rollback_semantics if the size of the input buffer is invalid
ara::crypto::CryptoErrc::kBusyResource	rollback_semantics a required resource is busy
ara::crypto::CryptoErrc::kEmptyKeySlot	rollback_semantics if a KeySlot was configured that is currently is empty
ara::crypto::CryptoErrc::kUsageViolation	rollback_semantics if the allowed usage of the key does not include kAllowSig Generation
ara::crypto::CryptoErrc::kUnsupportedFormat	rollback_semantics if the specified FormatId is unknown or not supported

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_CRYPT_23512
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_23512@rel:R25-11#d9cf00ed
Content hash: d9cf00ed
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_23512

Status: valid/unmigrated Version: rel:R25-11#bc8b5705 Versionshistorie & Revisions (1 transition, 8 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_CRYPT_23512@rel:R25-11#bc8b5705

Recorded Revisions (8):

R25-11rel:R25-11#a06a44132026-09-30
R19-11rel:R19-11#78781cac2026-10-14
R20-11rel:R20-11#1b96176f2026-10-14
R21-11rel:R21-11#f8f46bec2026-10-14
R22-11rel:R22-11#8b3d99122026-10-14
R23-11rel:R23-11#e3aedff12026-10-14
R24-11rel:R24-11#2e8d11c12026-10-14
R25-11rel:R25-11#bc8b57052026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة Start [SWS_CRYPT_50037] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< void > Start () noexcept=0;

Initialize the context for a new signature generation.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: f5a51cd4061a المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تهيئ الطريقة Start الخالية من المعلمات سياقًا من الفئة ara::crypto::cryp::SignerPrivateCtx لإنشاء توقيع جديد [SWS_CRYPT_50037]. يتم الاستدعاء بشكل متزامن، وهو مصرح به كـ noexcept، ويعيد ara::core::Result<void> فارغًا عند نجاح التهيئة أو رمز خطأ في حالة حدوث خطأ [SWS_CRYPT_50037].

في حالة حدوث خطأ، تدعم العملية دلالات التراجع (Rollback-Semantik) [SWS_CRYPT_50037]. وتتضمن أسباب الأخطاء المحددة من ara::crypto::CryptoErrc ما يلي:

kUninitializedContext: لم تتم تهيئة السياق مسبقًا من خلال توفير مفتاح [SWS_CRYPT_50037].
kEmptyKeySlot: فتحة مفتاح (Key-Slot) مهيأة فارغة حاليًا [SWS_CRYPT_50037].
kUsageViolation: أذونات المفتاح المخصص لا تشمل kAllowSigGeneration [SWS_CRYPT_50037].
kBusyResource: مورد مطلوب للعملية مشغول [SWS_CRYPT_50037].
kUnsupported: لا يدعم السياق البث التدفقي (Streaming)، أو تتطلب خوارزمية التوقيع إلزاميًا تحديد قيمة سياق [SWS_CRYPT_50037].

وفقًا للمواصفة، فإن الدالة آمنة خيطيًا (thread-safe) بالإضافة إلى كونها آمنة من الاستثناءات (exception safe) [SWS_CRYPT_50037]. وإذا تطلبت الخوارزمية قيمة سياق محددة، فيجب بدلاً من ذلك استخدام المتغير المحمل بشكل زائد Start(ReadOnlyMemRegion context) [SWS_CRYPT_50038]. بعد الاستدعاء الناجح لـ Start، يمكن معالجة أجزاء الرسالة المراد توقيعها بصورة متتابعة عبر Update [SWS_CRYPT_50039].

تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR Adaptive R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei	#include "ara/crypto/cryp/signer_private_ctx.h"
Scope	class ara::crypto::cryp::SignerPrivateCtx
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe ara::crypto::CryptoErrc::k rollback_semantics

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	An empty result or an error

Fehler

Fehlercode	Beschreibung
UninitializedContext	if the context was not initialized by deploying a key
ara::crypto::CryptoErrc::kUnsupported	rollback_semantics if the context does not support streaming or the algorithm requires setting a context value
ara::crypto::CryptoErrc::kBusyResource	rollback_semantics a required resource is busy
ara::crypto::CryptoErrc::kEmptyKeySlot	rollback_semantics if a KeySlot was configured that is currently is empty
ara::crypto::CryptoErrc::kUsageViolation	rollback_semantics if the allowed usage of the key does not include kAllowSig Generation

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_CRYPT_50037
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_50037@rel:R25-11#1f283b3b
Content hash: 1f283b3b
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50037

Status: valid/unmigrated Version: rel:R25-11#2ee5d052 Versionshistorie & Revisions (1 transition)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_CRYPT_50037@rel:R25-11#2ee5d052

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة Start [SWS_CRYPT_50038] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< void > Start (ReadOnlyMemRegion context) noexcept=0;

Initialize the context for a new signature generation.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 71c4a255a10b المصدر أسئلة مفتوحة (1)

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدَم الطريقة Start للتهيئة المتزامنة للسياق ara::crypto::cryp::SignerPrivateCtx لإنشاء توقيع جديد مع تقديم قيمة سياق ([SWS_CRYPT_50038]). وهي تستقبل المعلمة context من النوع ReadOnlyMemRegion وتُرجع ara::core::Result<void>. والدالة محددة على أنها noexcept=0، وآمنة من الاستثناءات، ومُعلنة على أنها آمنة تفرعيًا ([SWS_CRYPT_50038]).

في حالة الخطأ، تُترك حالة السياق دون تغيير عبر دلالات التراجع ([SWS_CRYPT_50038]). وأسباب الخطأ المحددة هي:

UninitializedContext: إذا لم تتم تهيئة السياق مسبقًا من خلال توفير مفتاح.
ara::crypto::CryptoErrc::kUnsupported: إذا كان السياق لا يدعم التدفق أو كانت الخوارزمية لا تسمح بقيمة سياق.
ara::crypto::CryptoErrc::kInvalidInputSize: إذا كان حجم المخزن المؤقت لقيمة السياق الممررة غير صالح.
ara::crypto::CryptoErrc::kEmptyKeySlot: إذا كان منفذ المفتاح المكوّن فارغًا حاليًا.
ara::crypto::CryptoErrc::kUsageViolation: إذا كان الاستخدام المسموح به للمفتاح لا يتضمن إنشاء التوقيع (kAllowSig Generation).
ara::crypto::CryptoErrc::kBusyResource: إذا كان أحد الموارد المطلوبة مشغولًا.

في تسلسل المعالجة النموذجي، يُرجَّح أن يتم تمرير البيانات المراد توقيعها تباعًا عبر Update ([SWS_CRYPT_50039]) بعد البدء الناجح. سؤال Q-7b821391730c9d38 (مفتوح) وإذا كانت العملية التشفيرية لا تتطلب قيمة سياق، يتوفر كبديل التحميل الزائد عديم المعلمات Start() ([SWS_CRYPT_50037]).

تم إنشاء ملاحظة الاستخدام هذه تلقائياً بناءً على مواصفة AUTOSAR.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei	#include "ara/crypto/cryp/signer_private_ctx.h"
Scope	class ara::crypto::cryp::SignerPrivateCtx
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe ara::crypto::CryptoErrc::k rollback_semantics

Parameter (in)

Parameter	Beschreibung
context	a context value

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	An empty result or an error

Fehler

Fehlercode	Beschreibung
UninitializedContext	if the context was not initialized by deploying a key
ara::crypto::CryptoErrc::kUnsupported	rollback_semantics if the context does not support streaming or the algorithm does not support setting a context value
ara::crypto::CryptoErrc::kBusyResource	rollback_semantics a required resource is busy
ara::crypto::CryptoErrc::kEmptyKeySlot	rollback_semantics if a KeySlot was configured that is currently is empty
ara::crypto::CryptoErrc::kUsageViolation	rollback_semantics if the allowed usage of the key does not include kAllowSig Generation
ara::crypto::CryptoErrc::kInvalidInputSize	rollback_semantics if the size of the context is invalid

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_CRYPT_50038
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_50038@rel:R25-11#50492aa5
Content hash: 50492aa5
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50038

Status: valid/unmigrated Version: rel:R25-11#0f9c636d Versionshistorie & Revisions (1 transition)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_CRYPT_50038@rel:R25-11#0f9c636d

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة Update [SWS_CRYPT_50039] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< void > Update (ReadOnlyMemRegion data) noexcept=0;

Update the signature generation context by a new part of the message.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 21170590fbb3 المصدر أسئلة مفتوحة (1)

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الطريقة Update في [SWS_CRYPT_50039] لتوسيع الحالة الداخلية لحساب التوقيع باستمرار بجزء إضافي من الرسالة. يتم الاستدعاء بشكل متزامن ويعالج نطاق الذاكرة الممرر data من النوع ReadOnlyMemRegion. وكنتيجة، تُرجع الدالة ara::core::Result<void> لا يحتوي على أي قيمة عند المعالجة الناجحة أو يغلّف رمز خطأ في خلاف ذلك [SWS_CRYPT_50039].

في حالة حدوث خطأ، تمتلك قيم الإرجاع دلالات تراجع (Rollback-Semantik) [SWS_CRYPT_50039]:

ara::crypto::CryptoErrc::kProcessingNotStarted: يحدث إذا لم يُبدأ حساب التوقيع مسبقًا باستدعاء الطريقة Start() [SWS_CRYPT_50039].
ara::crypto::CryptoErrc::kInvalidInputSize: يتم الإبلاغ عنه إذا كان حجم بيانات الإدخال المقدمة غير مدعوم من قِبل السياق [SWS_CRYPT_50039].

فيما يتعلق بالتزامن والأمان، تم التصريح بالطريقة على أنها thread-safe وكذلك exception safe [SWS_CRYPT_50039]. وفي إطار التفاعل مع سياق التوقيع، يفترض الحساب إلزاميًا أن يكون المسار قد بدأ بـ Start(). يمكن الاستعلام عن الحد الأقصى المسموح به لحجم المخزن المؤقت للاستدعاءات الفردية عبر GetMaximumChunkSize() [SWS_CRYPT_50042]؛ ومن المرجح أن يمثل هذا الحد القيمة القصوى التي يؤدي تجاوزها إلى kInvalidInputSize. سؤال Q-cf204a853a730365 (مفتوح)

ملاحظة: تم إنشاء ملاحظة الاستخدام هذه آليًا بناءً على معيار AUTOSAR ذي الإصدار R25-11.

Header-Datei	#include "ara/crypto/cryp/signer_private_ctx.h"
Scope	class ara::crypto::cryp::SignerPrivateCtx
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
data	a part of the input message that should be processed

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	An empty result or an error

Fehler

Fehlercode	Beschreibung
ara::crypto::CryptoErrc::kProcessingNotStarted	rollback_semantics if the signature calculation was not initiated by a call of the Start() method
ara::crypto::CryptoErrc::kInvalidInputSize	rollback_semantics if the size of provided data is not supported

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_CRYPT_50039
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_50039@rel:R25-11#9c033396
Content hash: 9c033396
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50039

Status: valid/unmigrated Version: rel:R25-11#5d5cf894 Versionshistorie & Revisions (1 transition)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_CRYPT_50039@rel:R25-11#5d5cf894

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

توثيق أسماء الأنواع البديلة

اسم نوع بديل Sptr [SWS_CRYPT_23501] Upstream: RS_CRYPTO_02204

using Sptr = std::shared_ptr<SignerPrivateCtx>;

Smart pointer of the interface.

Header-Datei	#include "ara/crypto/cryp/signer_private_ctx.h"
Scope	class ara::crypto::cryp::SignerPrivateCtx
Symbol	Sptr

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_CRYPT_23501
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_23501@rel:R25-11#c25588bc
Content hash: c25588bc
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_23501

Status: valid/unmigrated Version: rel:R25-11#61a401aa Versionshistorie & Revisions (1 transition, 8 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_CRYPT_23501@rel:R25-11#61a401aa

Recorded Revisions (8):

R25-11rel:R25-11#f562001b2026-09-30
R19-11rel:R19-11#acb907532026-10-14
R20-11rel:R20-11#046264ae2026-10-14
R21-11rel:R21-11#046264ae2026-10-14
R22-11rel:R22-11#6b63922b2026-10-14
R23-11rel:R23-11#0b7610c02026-10-14
R24-11rel:R24-11#0b7610c02026-10-14
R25-11rel:R25-11#61a401aa2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

فئة ara::crypto::cryp::SignerPrivateCtx

دليل المستخدممولَّد بالذكاء الاصطناعي

السياق

دورة الحياة

مسار الاستخدام

سيناريوهات الأخطاء

خريطة الأعضاء

الدوال الأعضاء

أسماء الأنواع البديلة

مخطط الفئة

عرض التفاصيل

الدوال الأعضاء

أسماء الأنواع البديلة

توثيق الدوال

دالة Cancel [SWS_CRYPT_50041] Upstream: RS_CRYPTO_02302

Rückgabewert

Fehler

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة Finish [SWS_CRYPT_50040] Upstream: RS_CRYPTO_02302, RS_CRYPTO_02203

الاستخدام

معالجة الأخطاء

التزامن والقيود

تفاعل

Parameter (in)

Rückgabewert

Fehler

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة GetMaximumChunkSize [SWS_CRYPT_50042] Upstream: RS_CRYPTO_02309

Rückgabewert

Fehler

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة GetSignatureSize [SWS_CRYPT_29004] Upstream: RS_CRYPTO_02309

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (7):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة SetKey [SWS_CRYPT_23515] Upstream: RS_CRYPTO_02001, RS_CRYPTO_02003

الاستخدام

معالجة الأخطاء

التزامن والقيود

تفاعل

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (7):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة SetKey [SWS_CRYPT_50036] Upstream: RS_CRYPTO_02001, RS_CRYPTO_02003

الاستخدام

معالجة الأخطاء

التزامن والتفاعل

Parameter (in)

Rückgabewert

Fehler

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة Sign [SWS_CRYPT_23512] Upstream: RS_CRYPTO_02204

Parameter (in)

Parameter (out)

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة Start [SWS_CRYPT_50037] Upstream: RS_CRYPTO_02302

Rückgabewert

Fehler

Requirement Text as-of this release: