AUTOSAR Classic Security & Intrusion Detection
Das Security-Cluster schützt vernetzte Fahrzeugfunktionen gegen Cyber-Bedrohungen durch Intrusion Detection (IdsM), kryptographische PDU-Authentifizierung und Freshness-Protection (SecOC) sowie Key- und Zertifikatsmanagement (KeyM).
क्लस्टर गाइडएआई जनित
क्रिप्टो सेवाओं, PDU प्रमाणीकरण, कुंजी प्रबंधन और घटना पहचान के माध्यम से ऑन-बोर्ड सुरक्षा सुनिश्चित करता है।
क्रिप्टो सेवाओं, PDU प्रमाणीकरण, कुंजी प्रबंधन और घटना पहचान के माध्यम से ऑन-बोर्ड सुरक्षा सुनिश्चित करता है।
Security & Intrusion Detection क्लस्टर CSM, CryIf और Crypto Driver के माध्यम से क्रिप्टोग्राफ़िक प्रिमिटिव उपलब्ध कराता है, SecOC के जरिए प्रमाणीकरण डेटा के साथ I-PDUs की सुरक्षा करता है तथा KeyM AUTOSAR_CP_SWS_CryptoServiceManager पृ. 21 के साथ कुंजियों और प्रमाणपत्रों का प्रबंधन करता है। सुरक्षा घटनाओं को Events के रूप में IdsM को रिपोर्ट किया जाता है, जहाँ उन्हें बफ़र किया जाता है और एसिंक्रोनस रूप से फ़िल्टर किया जाता है [SWS_IdsM_00702]। शटडाउन के समय, RAM कुंजी डेटा को सक्रिय रूप से हटाना अनधिकृत समझौते (कॉम्प्रोमाइज़) से सुरक्षा प्रदान करता है।
मॉड्यूल क्लस्टर Security & Intrusion Detection वाहन संचार को सुरक्षित करने और AUTOSAR Classic Platform AUTOSAR_CP_SWS_IntrusionDetectionSystemManager पृ. 21 में सुरक्षा घटनाओं की पहचान करने के लिए मॉड्यूल secoc, idsm, keym, csm, cryif और crypto को संयोजित करता है। मूलभूत क्रिप्टोग्राफ़िक सेवाएँ पदानुक्रमिक रूप से Crypto Service Manager (CSM) के माध्यम से प्रदान की जाती हैं, जो जॉब्स को Crypto_JobType संरचनाओं में एनकैप्सुलेट करता है [SWS_Csm_01013] और Crypto Interface (CryIf_ProcessJob [SWS_CryIf_91003]) के माध्यम से Crypto Driver के विशिष्ट हार्डवेयर या सॉफ्टवेयर ड्राइवर ऑब्जेक्ट्स को अग्रेषित करता है।
PDU संचार को SecOC द्वारा संदेश प्रमाणीकरण कोड (MAC) और फ्रेशनेस मानों के माध्यम से सुरक्षित किया जाता है ([SWS_SecOC_91006], [SWS_SecOC_00012]), जबकि Key Manager (KeyM) CSM के लिए प्रमाणपत्रों और कुंजियों को तैयार, अद्यतित और मान्य करता है ([SWS_KeyM_00052], [SWS_KeyM_00059])। सुरक्षा-प्रासंगिक घटनाएँ — जैसे कि विफल PDU जाँचें — Security Events (SEv) के रूप में IdsM को रिपोर्ट की जाती हैं [SWS_IdsM_91002], जो उन्हें सिंक्रोनस रूप से बफ़र करता है [SWS_IdsM_00701] और कॉन्फ़िगर करने योग्य फ़िल्टर शृंखलाओं के माध्यम से एसिंक्रोनस रूप से योग्य बनाता है [SWS_IdsM_01020]।
आर्किटेक्चर आरेख: Security और Intrusion Detection क्लस्टर की स्तरित संरचना और इंटरफ़ेस संबंध। स्रोत: AUTOSAR_CP_SWS_IntrusionDetectionSystemManager पृ. 21, AUTOSAR_CP_SWS_CryptoServiceManager पृ. 21।
निष्पादन IdsM_MainFunction, SecOC_MainFunctionTx [SWS_SecOC_00176] और KeyM_MainBackgroundFunction [SWS_KeyM_00075] में सिंक्रोनस API प्रवेश बिंदुओं को गणना-गहन पृष्ठभूमि कार्यों से अलग करता है। त्रुटि की स्थिति में या सिस्टम अधिभार (CRYPTO_E_BUSY) के दौरान, SecOC [SWS_SecOC_91013] में मानक प्रमाणीकरण पैटर्न और IdsM [SWS_IdsM_01702] में NvM रोलबैक जैसे फ़ॉलबैक तंत्र संपूर्ण सिस्टम की स्थिरता सुनिश्चित करते हैं; शटडाउन के समय KeyM सक्रिय RAM कुंजी सामग्री को पूरी तरह से हटा देता है [SWS_KeyM_00047]।
सिस्टम आर्किटेक्चर & मॉड्यूल क्लस्टर की भूमिका
AUTOSAR Classic Platform (रिलीज़ R20-11) का Security & Intrusion Detection मॉड्यूल क्लस्टर क्रिप्टोग्राफ़ी, सुरक्षित ऑन-बोर्ड संचार, कुंजी और प्रमाणपत्र प्रबंधन तथा आक्रमण पहचान के लिए मानकीकृत सेवाएँ प्रदान करता है। कार्यात्मक रूप से, यह क्लस्टर AUTOSAR Basic Software (BSW) के कई स्तरों में विभाजित है: सेवा स्तर पर, Crypto Service Manager (CSM) हार्डवेयर-स्वतंत्र क्रिप्टोग्राफ़िक सेवाओं को एनकैप्सुलेट करता है AUTOSAR_CP_SWS_CryptoServiceManager पृ. 21। I-PDUs का सुरक्षित संचार संचार स्तर में Secure Onboard Communication (SecOC) मॉड्यूल द्वारा नियंत्रित किया जाता है [SWS_SecOC_00162], जबकि एक सुरक्षा सेवा के रूप में Key Manager (KeyM) क्रिप्टोग्राफ़िक कुंजियों और प्रमाणपत्रों के जीवनचक्र का संचालन करता है SWS_KeyManager पृ. 31। इसके अतिरिक्त, Intrusion Detection System Manager (IdsM) पूरे सिस्टम में सुरक्षा-प्रासंगिक घटनाओं के लिए एक केंद्रीय एग्रीगेटर और फ़िल्टर के रूप में कार्य करता है AUTOSAR_CP_SWS_IntrusionDetectionSystemManager पृ. 21।
CSM के नीचे, Crypto Interface (CryIf) परत CryIf के रूप में कई क्रिप्टोग्राफ़िक ड्राइवर ऑब्जेक्ट्स तक हार्डवेयर- या सॉफ्टवेयर-विशिष्ट एक्सेस को एब्सट्रैक्ट करता है और जॉब तथा कुंजी डिस्पैचिंग तंत्र को मानकीकृत करता है SWS_CryptoInterface पृ. 1। MCAL और ड्राइवर स्तर पर, Crypto Driver (Crypto) सॉफ्टवेयर में या हार्डवेयर सुरक्षा मॉड्यूल (HSM) पर वास्तविक गणनाएँ निष्पादित करता है [SWS_Crypto_91016]। इन परतों का अंतःक्रिया अनुप्रयोग सॉफ़्टवेयर (SW-C) और संचार मॉड्यूल का हार्डवेयर-विशिष्ट क्रिप्टो एक्सेलरेटरों से पूर्ण डीकपलिंग सुनिश्चित करता है।
आर्किटेक्चर आरेख: Security और Intrusion Detection क्लस्टर की स्तरित संरचना और इंटरफ़ेस संबंध। स्रोत: AUTOSAR_CP_SWS_IntrusionDetectionSystemManager पृ. 21, AUTOSAR_CP_SWS_CryptoServiceManager पृ. 21।
मॉड्यूल के बीच परस्पर क्रिया और इंटरैक्शन पथ
क्लस्टर के मॉड्यूल स्पष्ट रूप से परिभाषित नियंत्रण और डेटा प्रवाह पथों के माध्यम से एक दूसरे से जुड़े हुए हैं। क्रिप्टोग्राफ़िक जॉब्स का प्रसंस्करण मुख्य रूप से CSM के माध्यम से होता है। अनुप्रयोग मॉड्यूल या BSW मॉड्यूल जैसे कि SecOC और KeyM, CSM सेवाओं जैसे Csm_MacGenerate [SWS_Csm_00982], Csm_Encrypt [SWS_Csm_00984], Csm_AEADEncrypt [SWS_Csm_01023], Csm_SignatureGenerate [SWS_Csm_00992], Csm_Hash [SWS_Csm_00980] या Csm_RandomGenerate [SWS_Csm_01543] के माध्यम से जॉब्स प्रारंभ करते हैं। जॉब्स को मानकीकृत रनटाइम संरचना Crypto_JobType में एनकैप्सुलेट किया जाता है [SWS_Csm_01013], जो ऑपरेटिंग मोड (Crypto_OperationModeType जैसे कि CRYPTO_OPERATIONMODE_START, UPDATE, FINISH या SINGLECALL) द्वारा नियंत्रित होती है [SWS_Csm_00802]। CSM जॉब को CryIf_ProcessJob [SWS_CryIf_91003] को सौंपता है, जो कॉल को संबंधित Crypto ड्राइवर ऑब्जेक्ट को अग्रेषित करता है।
SecOC मॉड्यूल PduR और संचार बस के बीच PDU स्थानांतरण को सुरक्षित करता है। SecOC_TpRxIndication [SWS_SecOC_00125] के माध्यम से एक सुरक्षित PDU प्राप्त होने पर, SecOC सबसे पहले SecOC_GetRxFreshnessAuthData [SWS_SecOC_91006] के माध्यम से फ्रेशनेस मान प्राप्त करता है और विनिर्देश SecOcProtocol पृ. 19 के अनुसार प्रमाणीकृत किए जाने वाले डेटा का निर्माण करता है। MAC सत्यापन के लिए SecOC CSM [SWS_SecOC_00012] का उपयोग करता है। सफल सत्यापन के बाद, प्रामाणिक PDU को ऊपरी परतों को सौंप दिया जाता है। यदि सत्यापन विफल हो जाता है, तो परिणाम स्थिति SecOC_VerificationStatusType में दर्ज किया जाता है [SWS_SecOC_00160], [SWS_SecOC_91014]; व्याख्या: यह विफलता IdsM को Security Event के रूप में रिपोर्ट की जाती है AUTOSAR_CP_SWS_IntrusionDetectionSystemManager पृ. 21। प्रश्न Q-8cfd1660757f3f1f (खुला)
Key Manager (KeyM) में कुंजियों और प्रमाणपत्रों के अपडेट तैयार किए जाते हैं और निष्पादित किए जाते हैं। प्रमाणपत्र सत्यापन (उदा. KeyM_VerifyCertificates [SWS_KeyM_00059] या KeyM_VerifyCertificateChain [SWS_KeyM_00061] के माध्यम से) के दौरान, KeyM हस्ताक्षर सत्यापन के लिए CSM के क्रिप्टोग्राफ़िक प्रिमिटिव का तथा वैधता जाँच के लिए StbM के बाहरी समय आधारों का उपयोग करता है SWS_KeyManager पृ. 119। कुंजी अपडेट (KeyM_Update [SWS_KeyM_00052]) उपयोगकर्ता-विशिष्ट हैंडलर्स (KeyM_KH_Update [SWS_KeyM_00069], [SWS_KeyM_00055]) को एकीकृत करते हैं, जिसके तहत परिणामी कुंजी बाइट्स Crypto ड्राइवर में Csm_KeyElementSet [SWS_Csm_00957] और Csm_JobKeySetValid [SWS_Csm_91027] के माध्यम से सक्रिय किए जाते हैं। CryIf कुंजी व्युत्पत्ति (डेरिवेशन) और कॉपी प्रक्रियाओं को CryIf_KeyDerive [SWS_CryIf_91009] या CryIf_KeyElementCopy [SWS_CryIf_91015] के माध्यम से ड्राइवर फ़ंक्शनों जैसे कि Crypto_KeyElementCopyPartial [SWS_Crypto_91015] को अग्रेषित करता है।
IdsM BSW सेंसरों (SecOC सहित) और एप्लिकेशन SW-Cs से IdsM_SetSecurityEvent [SWS_IdsM_91002] या IdsM_SetSecurityEventWithCount [SWS_IdsM_91018] जैसे इंटरफ़ेस के माध्यम से सुरक्षा घटनाओं (Security Events, SEv) को एकत्र करता है। घटनाओं को बफ़र किया जाता है, फ़िल्टर शृंखलाओं (उदा. Block State Filter [SWS_IdsM_01020] या एग्रीगेशन फ़िल्टर AUTOSAR_CP_SWS_IntrusionDetectionSystemManager पृ. 40) के माध्यम से योग्य बनाया जाता है और अंततः PduR के माध्यम से अग्रेषित किया जाता है [SWS_IdsM_91009], [SWS_IdsM_91010]।
अनुक्रम आरेख: क्रिप्टो स्टैक का उपयोग करते हुए SecOC में एक सुरक्षित PDU का सत्यापन और IdsM को सुरक्षा घटनाओं की रिपोर्टिंग। स्रोत: [SWS_SecOC_00125], [SWS_SecOC_00012], [SWS_CryIf_91003], [SWS_CryIf_91013], [SWS_IdsM_91002]।
सिंक्रोनाइज़ेशन, री-एंट्रेंसी और टास्क संदर्भ
क्रिप्टोग्राफ़िक गणनाओं और सुरक्षा ऑपरेशनों के निष्पादन के लिए सिंक्रोनस कॉल पथों और एसिंक्रोनस टास्क संदर्भों के सख्त पृथक्करण की आवश्यकता होती है। CSM और CryIf में निष्पादन व्यवहार क्रिप्टो प्रिमिटिव के कॉन्फ़िगरेशन पर निर्भर करता है: ऑपरेशन सिंक्रोनस रूप से ब्लॉकिंग या एसिंक्रोनस रूप से चल सकते हैं [SWS_Csm_00982], [SWS_CryIf_91003]। एसिंक्रोनस जॉब्स के मामले में, Crypto ड्राइवर CryIf_CallbackNotification [SWS_CryIf_91013] के माध्यम से पूर्णता की रिपोर्ट करता है, जिसके बाद CSM कॉलर के पंजीकृत कॉलबैक फ़ंक्शन को निष्पादित करता है [SWS_SecOC_00012]। बाधित होने योग्य या लंबी अवधि तक चलने वाली गणनाओं के लिए, CSM निरस्तीकरण फ़ंक्शन Csm_CancelJob प्रदान करता है [SWS_Csm_00968], जिसे CryIf_CancelJob [SWS_CryIf_91014] के माध्यम से ड्राइवर को सौंप दिया जाता है।
SecOC मॉड्यूल में ट्रांसमिशन समय-नियंत्रित रूप से डीकपल होता है: आवधिक चक्रों में, SecOC_MainFunctionTx जाँचता है कि क्या नई प्रामाणिक PDUs हस्ताक्षर के लिए लंबित हैं, प्रमाणीकरणकर्ताओं की गणना करता है और PduR प्रेषण आरंभ करता है [SWS_SecOC_00176]। IdsM में, रिपोर्ट की गई घटनाओं का अधिग्रहण सेंसर संदर्भ (टास्क या ISR) में IdsM_SetSecurityEvent [SWS_IdsM_91002] के माध्यम से अत्यधिक उच्च प्रदर्शन के साथ होता है, जहाँ घटनाओं को शुरुआत में सिंक्रोनस रूप से कॉन्फ़िगर करने योग्य इवेंट बफ़र्स में संग्रहीत किया जाता है [SWS_IdsM_00701], [SWS_IdsM_00702]। समय-गहन फ़िल्टरिंग, संदर्भ डेटा प्रोसेसिंग और StbM या RTE के माध्यम से टाइमस्टैम्प संवर्धन पूरी तरह से एसिंक्रोनस रूप से आवधिक IdsM_MainFunction के संदर्भ में संसाधित किए जाते हैं SWS_IntrusionDetectionSystemManager पृ. 87, AUTOSAR_CP_SWS_IntrusionDetectionSystemManager पृ. 86।
Key Manager समय-महत्वपूर्ण और गणना-गहन कार्यों के बीच अंतर करता है: जबकि मानक स्थिति क्वेरी और कॉलबैक ऑर्केस्ट्रेशन KeyM_MainFunction में चलते हैं [SWS_KeyM_00074], गणना-गहन सिंक्रोनस हैंडलर प्रक्रियाओं (जैसे KeyM_KH_Update) के लिए निष्पादन एक प्रीएम्प्टिव पृष्ठभूमि फ़ंक्शन KeyM_MainBackgroundFunction में प्रदान किया जाता है [SWS_KeyM_00075]। मल्टीकोर आर्किटेक्चर में, CSM पार्टीशन-विशिष्ट मुख्य फ़ंक्शनों और इनिशियलाइज़ेशन का भी समर्थन करता है [SWS_Csm_00646], SWS_CryptoInterface पृ. 1; व्याख्या: यह विभाजन प्रति प्रोसेसर कोर समर्पित हार्डवेयर ड्राइवर ऑब्जेक्ट्स के आवंटन से मेल खाता है। प्रश्न (खुला)
विशिष्ट जीवन चक्र और परिचालन मोड
क्लस्टर का इनिशियलाइज़ेशन नीचे से ऊपर की ओर एक सख्त निर्भरता पदानुक्रम का पालन करता है। सबसे पहले, हार्डवेयर-निकट ड्राइवरों को Crypto_Init के माध्यम से कॉन्फ़िगर किया जाता है [SWS_Crypto_91016], जिसके बाद CryIf इंटरफ़ेस [SWS_CryIf_91118] और CSM को Csm_Init [SWS_Csm_00646] के माध्यम से कॉन्फ़िगर किया जाता है। केवल इसके बाद ही निर्भर मॉड्यूल SecOC, KeyM और IdsM को इनिशियलाइज़ किया जा सकता है। SecOC इनिशियलाइज़ेशन के माध्यम से स्थिति SECOC_UNINIT से SECOC_INIT में परिवर्तित होता है [SWS_SecOC_00162]। KeyM में, सभी कॉन्फ़िगर किए गए प्रमाणपत्रों को प्रारंभ में स्थिति KEYM_CERTIFICATE_NOT_AVAILABLE [SWS_KeyM_00021], [SWS_KeyM_91003] प्राप्त होती है, इससे पहले कि उन्हें NvM से पढ़ा जाए या KeyM_SetCertificate अथवा डायग्नोस्टिक्स के माध्यम से लोड और सत्यापित किया जाए SWS_KeyManager पृ. 119।
रनटाइम पर, वाहन की स्थिति में परिवर्तन IdsM के ऑपरेटिंग मोड को प्रभावित करते हैं: Basic Software Manager (BswM) IdsM को IdsM_BswM_StateChanged के माध्यम से स्थिति परिवर्तनों की सूचना देता है [SWS_IdsM_91005]। ये स्थितियाँ Block State Filter [SWS_IdsM_01020], [SWS_IdsM_91017] को नियंत्रित करती हैं, जिसके द्वारा कुछ परिचालन चरणों (उदा. प्रोग्रामिंग मोड या स्लीप चरण) में सुरक्षा घटनाओं के अग्रेषण को दबा दिया जाता है। इसके अलावा, घटनाओं के रिपोर्टिंग मोड को DCM के माध्यम से डायग्नोस्टिक रूप से संशोधित किया जा सकता है (IdsM_Dcm_SetReportingMode_Start [SWS_IdsM_91008], [SWS_IdsM_91013]) और NvM में स्थायी रूप से संग्रहीत किया जा सकता है [SWS_IdsM_01700], [SWS_IdsM_01701]।
इलेक्ट्रॉनिक नियंत्रण इकाई (ECU) के शटडाउन के समय, मॉड्यूल व्यवस्थित रूप से डी-इनिशियलाइज़ किए जाते हैं। SecOC_DeInit सुरक्षित संचार को रोकता है, सभी आंतरिक बफ़र्स और चरों को साफ़ करता है और SecOC को वापस स्थिति SECOC_UNINIT [SWS_SecOC_00161] में स्थानांतरित करता है। KeyM_Deinit [SWS_KeyM_00047] को कॉल करने पर, सुरक्षा कारणों से RAM में मौजूद सभी क्रिप्टोग्राफ़िक कुंजी सामग्री को सक्रिय रूप से नष्ट कर दिया जाता है और प्रारंभिक मानों से अधिलेखित कर दिया जाता है, ताकि निष्क्रिय अवस्था में अनधिकृत पढ़ने से रोका जा सके।
त्रुटि प्रबंधन, DET-ट्रेसिंग और डिग्रेडेशन
मॉड्यूल क्लस्टर विकास त्रुटियों (Development Error Tracer, DET) और रनटाइम समस्याओं का पता लगाने के लिए संपूर्ण तंत्र लागू करता है। सभी मॉड्यूल अपने इनिशियलाइज़ेशन की पुष्टि करते हैं और अन-इनिशियलाइज़्ड कॉल की स्थिति में DET त्रुटियों की रिपोर्ट करते हैं, उदाहरण के लिए CryIf इंटरफ़ेस जैसे CryIf_RandomSeed [SWS_CryIf_91007], CryIf_CancelJob [SWS_CryIf_91014], CryIf_KeyDerive [SWS_CryIf_91009] या CryIf_CallbackNotification [SWS_CryIf_91013] में CRYIF_E_UNINIT। इसी तरह, त्रुटिपूर्ण पॉइंटर पैरामीटर DET संदेशों की ओर ले जाते हैं, जैसे कि Crypto_GetVersionInfo [SWS_Crypto_91001] में CRYPTO_E_PARAM_POINTER, जबकि CSM में इनिशियलाइज़ेशन त्रुटियों की रिपोर्ट CSM_E_INIT_FAILED के साथ की जाती है [SWS_Csm_00646]।
क्रिप्टो हार्डवेयर ऑब्जेक्ट्स के ओवरलोड या विफलता की स्थिति में, ड्राइवर स्थिति CRYPTO_E_BUSY [SWS_CryIf_91003], [SWS_Csm_00957] का संकेत देता है। ऐसे डिग्रेडेशन परिदृश्यों में, SecOC वाहन की उपलब्धता बनाए रखने के लिए SecOC_SendDefaultAuthenticationInformation के माध्यम से निचली परतों को अप्रमाणित प्रतिस्थापन PDUs के कॉन्फ़िगर करने योग्य प्रेषण की अनुमति देता है [SWS_SecOC_91013]। IdsM में, कॉन्फ़िगर किए गए इवेंट बफ़र्स के समाप्त होने से आंतरिक सुरक्षा घटना SEV_IDSM_NO_EVENT_BUFFER_AVAILABLE ट्रिगर होती है [SWS_IdsM_00703]। यदि संशोधित IdsM मापदंडों का NvM पर्सिस्टेंस विफल हो जाता है, तो IdsM स्वचालित रूप से पिछली स्थिति में रोलबैक करता है [SWS_IdsM_01702]। यदि Csm_KeyElementSet में कुंजियाँ सेट करते समय कोई त्रुटि होती है, तो कुंजी तत्व की स्थिति को अपरिभाषित माना जाता है और इसे Csm_KeyGetStatus [SWS_Csm_91047] और CryIf_KeyGetStatus [SWS_CryIf_91012] के माध्यम से मान्य किया जाना चाहिए।
यह गाइड रिलीज़ R20-11 के लिए AUTOSAR Classic Platform विनिर्देशों पर आधारित है और Security & Intrusion Detection क्लस्टर के आर्किटेक्चर का सारांश प्रस्तुत करता है।
विषय मानचित्र
IdsM
21KeyM
42SecOC
33इस रिलीज़ के लिए कोई तत्व डेटा उपलब्ध नहीं
IdsM
This callback function is invoked by the BswM to indicate ECU state changes.
void IdsM_BswM_StateChanged (IdsM_Filters_BlockStateType state);This function is called to acquire the transmit data of an I-PDU segment (N-PDU). Each call to this function provides the next part of the I-PDU data unless retry->TpDataState is TP_ DATARETRY. In this case the function restarts to copy the data beginning at the offset from the current position indicated by retry->TxTpDataCnt. The size of the remaining data is written to the position indicated by availableDataPtr.
BufReq_ReturnType IdsM_CopyTxData (PduIdType id, const PduInfoType* info, const RetryInfoType* retry, PduLengthType* availableDataPtr);This function is a request from DCM to the IdsM to read the routine results triggered by function IdsM_Dcm_GetReportingMode_Start().
Std_ReturnType IdsM_Dcm_GetReportingMode_RequestResults (Dcm_OpStatusType OpStatus, uint8* Out_ReportingMode, Dcm_NegativeResponseCodeType* ErrorCode);This function is a request from DCM to the IdsM to start the routine execution to request the current reporting mode of a specific Security Event ID.
Std_ReturnType IdsM_Dcm_GetReportingMode_Start (uint16 In_SecurityEventId, uint8 In_SensorInstanceId, Dcm_OpStatusType OpStatus, Dcm_NegativeResponseCodeType* ErrorCode);This function is a request from DCM to the IdsM to start the routine execution to set the reporting mode of a specific Security Event ID.
Std_ReturnType IdsM_Dcm_SetReportingMode_Start (uint16 In_SecurityEventId, uint8 In_SensorInstanceId, uint8 In_ReportingMode, Dcm_OpStatusType OpStatus, Dcm_NegativeResponseCodeType* ErrorCode);Returns version information, vendor ID and AUTOSAR module ID of the component.
void IdsM_GetVersionInfo (const Std_VersionInfoType* versionInfo);Service to initialize the module IdsM. It initializes all variables and sets the module state to initialized.
void IdsM_Init (const IdsM_ConfigType* configPtr);This function is called periodically. It processes security events asynchronously which are queued during API function calls.
void IdsM_MainFunction (void);This API is the application interface to report security events to the IdsM.
void IdsM_SetSecurityEvent (IdsM_SecurityEventIdType securityEventId);This API is the application interface to report security events with context data to the IdsM.
void IdsM_SetSecurityEventWithContextData (IdsM_SecurityEventIdType securityEventId, const uint8* contextData, uint16 contextDataSize);This API is the application interface for Smart Sensors to report security events with a count value to the IdsM.
void IdsM_SetSecurityEventWithCount (IdsM_SecurityEventIdType securityEventId, uint16 count);This API is the application interface for Smart Sensors to report security events with a count value and context data to the IdsM.
void IdsM_SetSecurityEventWithCountContextData (IdsM_SecurityEventIdType securityEventId, uint16 count, const uint8* contextData, uint16 contextDataSize);This API is the application interface for Smart Sensors to report security events with a timestamp and a count value to the IdsM.
void IdsM_SetSecurityEventWithTimestampCount (IdsM_SecurityEventIdType securityEventId, IdsM_TimestampType timestamp, uint16 count);This API is the application interface for Smart Sensors to report security events with a timestamp, a count value and context data to the IdsM.
void IdsM_SetSecurityEventWithTimestampCountContextData (IdsM_SecurityEventIdType securityEventId, IdsM_TimestampType timestamp, uint16 count, const uint8* contextData, uint16 contextDataSize);This function is called after the I-PDU has been transmitted on its network, the result indicates whether the transmission was successful or not.
void IdsM_TpTxConfirmation (PduIdType id, Std_ReturnType result);The lower layer communication interface module confirms the transmission of a PDU, or the failure to transmit a PDU.
void IdsM_TxConfirmation (PduIdType TxPduId, Std_ReturnType result);Configuration data structure of IdsM module.
Data type used for "Block State" filter values (bit masks)
Reporting modes used by the reporting mode filter
Data type used for local IdsM Security Event IDs
Data type for IdsM timestamps
KeyM
Service KeyM_CertElementGet.
Std_ReturnType KeyM_CertElementGet (KeyM_CertificateIdType CertId, KeyM_CertElementIdType CertElementId, uint8* CertElementData, uint32* CertElementDataLength);Service KeyM_CertElementGetFirst.
Std_ReturnType KeyM_CertElementGetFirst (KeyM_CertificateIdType CertId, KeyM_CertElementIdType CertElementId, KeyM_CertElementIteratorType* CertElementIterator, uint8* CertElementData, uint32* CertElementDataLength);Service KeyM_CertElementGetNext.
Std_ReturnType KeyM_CertElementGetNext (KeyM_CertElementIteratorType* CertElementIterator, uint8* CertElementData, uint32* CertElementDataLength);This function provides the sta tus of a certificate.
Std_ReturnType KeyM_CertGetStatus (KeyM_CertificateIdType CertId, KeyM_CertificateStatusType* Status);Service KeyM_CertificateElementGetByIndex.
Std_ReturnType KeyM_CertificateElementGetByIndex (KeyM_CertificateIdType CertId, KeyM_CertElementIdType CertElementId, uint32 Index, uint8* CertElementDataPtr, uint32* CertElementDataLengthPtr);This function provides the total number of data elements that a re available for the specified certificate element. Typically, only one data element is available. But in some cases, several data elements can be assigned to one certificate element in a row. This function retrieves the total number of elements. The indiv idual data elements can then accessed with Key M_ Certificate Element Get By Index(). It is similar to the functions Key M_ Cert Element Get First/ Key M_ Cert Element Get Next to retrieve a group of data elements of one certificate element. AUTOSAR CP R20 - of
Std_ReturnType KeyM_CertificateElementGetCount (KeyM_CertificateIdType CertId, KeyM_CertElementIdType CertElementId, uint16* CountPtr);Notifies the application that a certificate verification has been finished. The function name is configurable by Key MCertificate Verify Callback Notification Func. Availabl e via Key M_ Externals.h
Std_ReturnType KeyM_CertificateVerifyCallbackNotification (KeyM_CertificateIdType CertId, KeyM_CertificateStatusType Result);This function resets the key management module to the uninitialized state.
void KeyM_Deinit (void);The function is used to finalize key update operations. It is typi cally used in conjunction with the Key M_
Std_ReturnType KeyM_Finalize (const uint8* RequestDataPtr, uint16 RequestDataLength, uint8* ResponseDataPtr, uint16 ResponseMaxDataLength);This function provides the certificate data
Std_ReturnType KeyM_GetCertificate (KeyM_CertificateIdType CertId, KeyM_CertDataType* CertificateDataPtr);Provides the version information of this module.
void KeyM_GetVersionInfo (Std_VersionInfoType* VersionInfo);This function initializes the key management module.
void KeyM_Init (const KeyM_ConfigType* ConfigPtr);If Key MCrypto Key Start Finalize Function Enabled and Key MCrypto Key Handler Start Finalize Enabled is set to TRUE, this function will be called immediately when Key M_
Std_ReturnType KeyM_KH_Finalize (const uint8* RequestData, uint16 RequestDataLength, uint8* ResponseData, uint16* ResponseDataLength);If the configuration parameters Key MCrypto Key Prepare Function Enabled and Key MCrypto Key Handler Prepare Enabled are both set to TRUE, then this function w ill be called immediately when Key M_ Prepare gets called. The function takes over the task to prepare a key management operation. The response data will be passed on as is to the caller of Key_ Prepare.
Std_ReturnType KeyM_KH_Prepare (const uint8* RequestData, uint16 RequestDataLength, uint8* ResponseDataPtr, uint16* ResponseDataLength);If Key MCrypto Key Start Finalize Function Enabled and Key MCrypto Key
Std_ReturnType KeyM_KH_Start (KeyM_StartType StartType, const uint8* RequestData, uint16 RequestDataLength, uint8* ResponseData, uint16* ResponseDataLength);Function is called from a pre - emptive operating system when no other task operation is needed. Can be used for calling time consuming synchronous functions such as Key M_ KH_ Update().
void KeyM_MainBackgroundFunction (void);Function is called periodically according the specified time interval.
void KeyM_MainFunction (void);This function is used to prepare a key update operation. The main intent is to provide information for the key operation to the key server. Other operations may start the negotiation for a common secret that is used further to derive key material. This function is only av ailable if Key MCrypto Key Prepare Function Enabled is set to TRUE.
Std_ReturnType KeyM_Prepare (const uint8* RequestData, uint16 RequestDataLength, uint8* ResponseData, uint16* ResponseDataLength);Notifies the application that the certificate service operation has been finished. This function is used by the certificate submodule. Thi s callback is only provided if Key MService Certificate Function Enabled is set to TRUE. The function name is configurable by Key MService Certificate Callback Notification Func.
This function provides the certificate data to the key managem ent module to temporarily store the certificate.
Std_ReturnType KeyM_SetCertificate (KeyM_CertificateIdType CertId, const KeyM_CertDataType* CertificateDataPtr);This function is optional and only used if the configuration item Key MCrypto Key Start Finalize Function Enabled is set to true. It intents to allow key update operation.
Std_ReturnType KeyM_Start (KeyM_StartType StartType, const uint8* RequestData, uint16 RequestDataLength, uint8* ResponseData, uint16* ResponseDataLength);Service KeyM_VerifyCertificate.
Std_ReturnType KeyM_VerifyCertificate (KeyM_CertificateIdType CertId);Service KeyM_VerifyCertificateChain.
Std_ReturnType KeyM_VerifyCertificateChain (KeyM_CertificateIdType CertId, const KeyM_CertDataType[] certChainData, uint8 NumberOfCertificates);This function verifies two certificates that are stored and parsed internally against each other. The certificat e referenced with Cert Id was signed by the certificate referenced with cert Upper Id. Only these two certificates are validated against each other.
Std_ReturnType KeyM_VerifyCertificates (KeyM_CertificateIdType CertId, KeyM_CertificateIdType CertUpperId);Byte - pointer to the data of the certificate
This structure is used to exchange certificate data through interface functions.
Certificate Element handle.
This structure is used to iterate through a number of elements of a certificate.
Array long enough to store data
Certificate handle.
Type KeyM_CertificateStatusType.
This structure is the base type to initialize the Key Manager module. A pointer to an instance of this structure will be used in the initialization of the Key Manager module.
Byte - pointer to the input or output data
Crypto key handle.
Specifies the type of key handler update operation that was performed in the callback.
Specifies the result type of an asynchronous key management fu nction.
This type specifies the requested service operation and what information is provided with this function.
This type specifies in which mode the key operation will start. The OEM production mode provides higher privileges compared to workshop mode.
Array long enough to store the key or certificate name. base Type Encoding = UTF -
SecOC
This function is called to provide the received data of an I - PDU segment (N - PDU) to the upper layer. Each call to this function provides the next part of the I - PDU data. The si ze of the remaining buffer is written to the position indicated by buffer Size Ptr.
BufReq_ReturnType SecOC_CopyRxData (PduIdType id, const PduInfoType* info, PduLengthType* bufferSizePtr);Service SecOC_CopyTxData.
BufReq_ReturnType SecOC_CopyTxData (PduIdType id, const PduInfoType* info, const RetryInfoType* retry, PduLengthType* availableDataPtr);This service stops the secure onboard communication. All buffered I - PDU are removed and have to be obtained again, if needed, after Sec OC_ Init has been called. By a call to Sec OC_ De Init the AUTOSAR Sec OC module is put into a not in itialized state (Sec OC_ UNINIT).
void SecOC_DeInit (void);Service SecOC_GetRxFreshnessAuthData.
Std_ReturnType SecOC_GetRxFreshnessAuthData (uint16 SecOCFreshnessValueID, const uint8* SecOCTruncatedFreshnessValue, uint32 SecOCTruncatedFreshnessValueLength, const uint8* SecOCAuthDataFreshnessValue, uint16 SecOCAuthDataFreshnessValueLength, uint16 SecOCAuthVerifyAttempts, uint8* SecOCFreshnessValue, uint32* SecOCFreshnessValueLength);This API returns th e freshness value from the Most Significant Bits in the first byte in the array (Sec OCFreshness Value), in big endian format.
Std_ReturnType SecOC_GetTxFreshness (uint16 SecOCFreshnessValueID, uint8* SecOCFreshnessValue, uint32* SecOCFreshnessValueLength);Returns the version information of this module.
void SecOC_GetVersionInfo (Std_VersionInfoType* versioninfo);Requests cancellation of an ongoing transmission of a PDU in a lower layer communication module.
Std_ReturnType SecOC_IfCancelTransmit (PduIdType TxPduId);Requests transmission of a PDU.
Std_ReturnType SecOC_IfTransmit (PduIdType TxPduId, const PduInfoType* PduInfoPtr);Initializes the the Sec OC module. Successful initialization leads to state Sec OC_ INIT. In configurations, in which Sec OC is assigned to more than one partition (i.e. Sec OC_ Main Functions are mapped to partition s), Sec OC may provide one init AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_SecureOnboardCommunication function per partition. The decision on whether a single Sec OC_ Init() function or one per partition is provided is implementation - specific. In case a given implementation provides one Sec OC_ Init() function per partition, it is up to the implementation to devise a naming pattern that prevents name clashes among the different Sec OC_ Init() functions (e.g., by adding a suffix containing short name the Ecuc Partition.
void SecOC_Init (const SecOC_ConfigType* config);This function performs the processing of the Sec OC module's authentication and verification processing for the Rx path. Per configured Sec OCMain Function Rx instance one Sec OC_ Main Function Rx_ shall be implemented. Hereby is the short name of the Sec OCMain Function Rx configuration container in the ECU configuration.
void SecOC_MainFunctionRx (void);This function performs the processing of the Sec OC module's authentication and verification processing for the Tx path. Per configured Sec OCMain Function Tx instance one Sec OC_ Main Function Tx_ shall be implemented. Hereby is t he short name of the Sec OCMain Function Tx configuration container in the ECU configuration.
void SecOC_MainFunctionTx (void);Indication of a received PDU from a lower layer communication interface module.
void SecOC_RxIndication (PduIdType RxPduId, const PduInfoType* PduInfoPtr);The service provides the ability to enable the sending of un - authenticated PDU to lower layer. (example: in case authentication build counter has reached the configuration value Sec OCAuthentication Build Attempts or the query of the freshness function returns E_ NOT_ OK or the calculation of the authenticator has returned a non - recoverable error such as returning E_ NOT_ OK or KEY_ FAILURE). T his service is optional (the service is available only if Sec OCDefault Authentication Information Pattern is configured). If the service is not available or the service is available but the service was called with send Default
Std_ReturnType SecOC_SendDefaultAuthenticationInformation (uint16 FreshnessValueID, boolean sendDefaultAuthenticationInformation);This interface is used by the Sec OC to indicate that the Secured I - PDU has been initiated for transmission.
void SecOC_SPduTxConfirmation (uint16 SecOCFreshnessValueID);Service SecOC_StartReception.
BufReq_ReturnType SecOC_StartOfReception (PduIdType id, const PduInfoType* info, PduLengthType TpSduLength, PduLengthType* bufferSizePtr);Requests cancellation of an ongoing reception of a PDU in a lower layer transport protocol module.
Std_ReturnType SecOC_TpCancelReceive (PduIdType RxPduId);Requests cancellation of an ongoing transmission of a PDU in a lower layer communication module.
Std_ReturnType SecOC_TpCancelTransmit (PduIdType TxPduId);Called after an I - PDU has been received via the TP API, the result indicates whether the transmission was successful or not.
void SecOC_TpRxIndication (PduIdType id, Std_ReturnType result);Requests transmission of a PDU.
Std_ReturnType SecOC_TpTransmit (PduIdType TxPduId, const PduInfoType* PduInfoPtr);This function is called after the I - PDU has been transmitted on its network, the result indicates whether the transmission was successful or not.
void SecOC_TpTxConfirmation (PduIdType id, Std_ReturnType result);Within this API , the upper layer module (called module) shall check whether the available data fits into the buffer size reported by Pdu Info Ptr - >Sdu Length. If it fits, it shall copy its data into the buffer provided by Pdu Info Ptr - >Sdu Data Ptr and update the length of the actual copied data in Pdu Info Ptr - >Sdu Length. If not, it returns E_ NOT_ OK without changing Pdu Info Ptr.
Std_ReturnType SecOC_TriggerTransmit (PduIdType TxPduId, PduInfoType* PduInfoPtr);The lower layer communication interface module confirms the transmission of a PDU, or the failure to transmit a PDU.
void SecOC_TxConfirmation (PduIdType TxPduId, Std_ReturnType result);Service is used to propagate the status of each verification attempt from the Sec OC module to other modules. This service can be configured such that: Only: "False" Verifica tion Status is propagated to modules Both: "True" and "False" Verification Status are propagated to modules None: No Verification Status is propagated
void SecOC_VerificationStatusCallout (SecOC_VerificationStatusType verificationStatus);This s ervice provides the ability to inform the application about the result of the verification attempt of a received PDU by the Sec OC module.
void SecOC_VerifyStatus (SecOC_VerificationStatusType verificationStatus);Service SecOC_VerifyStatusOverride.
Std_ReturnType SecOC_VerifyStatusOverride (uint16 ValueID, SecOC_OverrideStatusType overrideStatus, uint8 numberOfMessagesToOverride);Configuration data structure of Sec OC module
-
Type SecOC_OverrideStatusType.
States of the Sec OC module
Enumeration to indicate veri fication results.
Data structure to bundle the status of a verification attempt for a specific Freshness Value and Data ID
Module im Cluster
Firewall (Fw)
AUTOSAR Classic Communication Services-Modul Firewall (Fw, Spezifikation: AUTOSAR_CP_SWS_Firewall.pdf).
Intrusion Detection System Manager (IdsM)
Collects and reports onboard security events to detect threats.
Key Manager (KeyM)
Manages lifecycle, storage, and distribution of cryptographic keys and certificates.
MACsec Key Agreement (Mka)
AUTOSAR Classic Communication Services-Modul MACsec Key Agreement (Mka, Spezifikation: AUTOSAR_CP_SWS_MACsecKeyAgreement.pdf, AUTOSAR_SWS_MACsecKeyAgreement.pdf).
Secure Onboard Communication (SecOC)
Provides cryptographic authentication and freshness protection for critical communication PDUs.
gemini-3.8-flash-low· 2026-10-13 · जर्मन मूल