رفتن به محتوا

فصل ۱۲. موتور تحلیل و ردگیری MATE

MATE:‏ موتور تحلیل و ردگیری متا (Meta Analysis and Tracing Engine)

MATE چیست؟ خب، اگر بخواهیم خیلی خلاصه بگوییم، با MATE می‌توانید افزونه(های) قابل‌پیکربندی توسط کاربر برای موتور فیلتر نمایش (display filter engine) بسازید.

هدف MATE این است که به کاربران امکان دهد فریم‌ها را بر اساس اطلاعات استخراج‌شده از فریم‌های مرتبط یا اطلاعاتی درباره چگونگی ارتباط فریم‌ها با یکدیگر فیلتر کنند. MATE برای کمک به عیب‌یابی دروازه‌ها (gateways) و سایر سیستم‌هایی نوشته شد که در آن‌ها یک «کاربرد» (use) شامل چندین پروتکل است. با این حال، می‌توان از MATE برای تحلیل مسائل دیگر مربوط به تعامل بین بسته‌ها نیز استفاده کرد؛ مانند زمان‌های پاسخ، ناقص بودن تراکنش‌ها، وجود یا عدم وجود برخی ویژگی‌ها در گروهی از واحدهای داده پروتکل (PDUs) و موارد بسیار دیگر.

MATE یک افزونه (plugin) در وایرشارک است که به کاربر اجازه می‌دهد نحوه ارتباط فریم‌های مختلف با یکدیگر را مشخص کند. برای این کار، MATE داده‌ها را از درخت فریم‌ها استخراج می‌کند و سپس با استفاده از آن اطلاعات، تلاش می‌کند فریم‌ها را بر اساس نحوه پیکربندی MATE گروه‌بندی نماید. پس از آنکه PDUها به هم مرتبط شدند، MATE یک درخت «پروتکل» دارای فیلدهایی ایجاد می‌کند که کاربر می‌تواند بر اساس آن‌ها فیلتر انجام دهد. این فیلدها برای تمام فریم‌های مرتبط تقریباً یکسان خواهند بود؛ بنابراین می‌توان یک نشست (session) کامل را که در چندین فریم حاوی پروتکل‌های متعدد گسترده شده است، بر اساس یک ویژگی (attribute) که در یکی از فریم‌های مرتبط ظاهر شده فیلتر کرد. علاوه بر این، MATE امکان فیلتر کردن فریم‌ها را بر اساس زمان‌های پاسخ، تعداد PDUها در یک گروه و موارد بسیار دیگر فراهم می‌سازد.

تاکنون از MATE برای موارد زیر استفاده شده است:

  • فیلتر کردن تمام بسته‌های یک تماس که از پروتکل‌های مختلف استفاده می‌کنند، تنها با دانستن شماره تماس‌گیرنده. (هدف اصلی و اولیه MATE)
  • فیلتر کردن تمام بسته‌های تمامی تماس‌هایی که از پروتکل‌های مختلف استفاده می‌کنند، بر اساس علت قطع تماس (release cause) در یکی از «بخش‌ها» (segments)ی آن.
  • استخراج تراکنش‌های کُند از فایل‌های کپچر بسیار «متراکم» (یافتن درخواست‌هایی که با انقضای زمان یا timeout مواجه می‌شوند).
  • یافتن تراکنش‌های ناقص (بدون پاسخ).
  • دنبال کردن درخواست‌ها در طول چندین دروازه/پروکسی (gateways/proxies).
  • و موارد دیگر…

مراحل آزمایش و استفاده از MATE به شرح زیر است:

  • وایرشارک را اجرا کنید و بررسی نمایید که آیا این افزونه نصب شده است یا خیر (MATE باید در مسیر Help→About Wireshark:Plugins ظاهر شود).
  • یک فایل پیکربندی مثلاً tcp.mate تهیه کنید (برای موارد بیشتر به Mate/Examples مراجعه کنید) و آن را در جایی روی دیسک سخت خود قرار دهید.
  • به مسیر Edit→Preferences…→Protocols→MATE بروید و گزینه Configuration Filename را روی فایلی که می‌خواهید استفاده کنید تنظیم کرده و وایرشارک را مجدداً راه‌اندازی (restart) نمایید.
  • یک فایل کپچر متناظر (مثلاً http.cap) را بارگذاری کنید و ببینید آیا MATE فیلدهای فیلتر نمایش جدیدی اضافه کرده است یا خیر، چیزی شبیه به: mate tcp_pdu:1→tcp_ses:1 یا در خط فرمان: path_to/wireshark -o "mate.config: tcp.mate" -r http.cap.

اگر همه‌چیز به‌درستی پیش رفته باشد، جزئیات بسته شما چیزی شبیه به تصویر زیر خواهد بود:

Figure 12.1. Packet Details - MATE TCP Session (tcp.mate)

شکل ۱۲.۱. جزئیات بسته - نشست TCP در MATE (tcp.mate)

MATE یک درخت قابل‌فیلتر بر اساس اطلاعات موجود در فریم‌هایی ایجاد می‌کند که با اطلاعات به‌دست‌آمده از فریم‌های دیگر رابطه مشخصی دارند. نحوه شکل‌گیری این روابط در یک فایل پیکربندی توصیف می‌شود. فایل پیکربندی به MATE می‌گوید چه چیزی یک PDU را می‌سازد و چگونه باید آن را به سایر PDUها مرتبط کند.

MATE هر فریم را تحلیل می‌کند تا اطلاعات مرتبط را از درخت «پروتکل» آن فریم استخراج نماید. اطلاعات استخراج‌شده در PDUهای MATE نگهداری می‌شوند؛ این PDUها حاوی فهرستی از ویژگی‌های (attributes) مرتبطی هستند که از درخت گرفته شده‌اند. از این پس، از اصطلاح «PDU» برای اشاره به اشیاء ایجادشده توسط MATE که حاوی اطلاعات مرتبط استخراج‌شده از فریم هستند استفاده خواهم کرد؛ و از واژه «فریم» (frame) برای اشاره به اطلاعات «خام» استخراج‌شده توسط کالبدشکاف‌های (dissectors) مختلفی که فریم را از پیش تحلیل کرده‌اند، استفاده می‌کنم.

برای هر PDU، موتور MATE بررسی می‌کند که آیا به یک «گروه از PDUها» (Group of PDUs یا GOP) موجود تعلق دارد یا خیر. اگر تعلق داشته باشد، آن PDU را به آن GOP اختصاص می‌دهد و هرگونه ویژگی مرتبط جدیدی را به فهرست ویژگی‌های آن GOP منتقل می‌کند. اینکه PDUها چگونه و چه زمانی به GOPها تعلق می‌گیرند نیز در فایل پیکربندی شرح داده می‌شود.

هر بار که یک PDU جدید به یک GOP اختصاص می‌یابد، MATE بررسی می‌کند که آیا شرایط لازم برای تعلق گرفتن به یک «گروه از گروه‌ها» (Group of Groups یا GOG) را دارد یا خیر. طبیعتاً شرایطی که باعث می‌شود یک GOP به یک GOG تعلق گیرد نیز از فایل پیکربندی گرفته می‌شود.

پس از آنکه MATE تحلیل فریم را به پایان رساند، قادر خواهد بود یک درخت «پروتکل» برای هر فریم بر اساس PDUها، GOPهایی که به آن‌ها تعلق دارند و طبیعتاً هر GOGای که GOPهای مذکور به آن تعلق دارند، ایجاد کند.

اینکه چگونه به MATE بگوییم چه چیزی را استخراج کند، چگونه آن را گروه‌بندی نماید و سپس چگونه آن گروه‌ها را به یکدیگر مرتبط سازد، با استفاده از AVPها و AVPLها انجام می‌شود.

اطلاعات در MATE در قالب «جفت‌های ویژگی-مقدار» (Attribute Value Pairs یا AVPs) نگهداری می‌شوند. AVPها از دو رشته ساخته شده‌اند: نام (name) و مقدار (value). AVPها در پیکربندی نیز به کار می‌روند و در آنجا دارای یک عملگر (operator) هم هستند. روش‌های گوناگونی وجود دارد که از طریق آن‌ها می‌توان AVPها را با استفاده از این عملگرها با یکدیگر تطبیق داد.

AVPها در «فهرست‌های AVP» (AVP Lists یا AVPLs) گروه‌بندی می‌شوند. هر یک از PDUها، GOPها و GOGها یک AVPL مخصوص به خود دارند. AVPLهای آن‌ها به روش‌های مختلف با سایر AVPLهایی که از فایل پیکربندی می‌آیند، تطبیق داده می‌شوند.

به MATE دستور داده می‌شود که چگونه AVPها را از فریم‌ها استخراج کند تا یک PDU دارای یک AVPL بسازد. همچنین به آن آموزش داده می‌شود که چگونه آن AVPL را با AVPLهای سایر PDUهای مشابه تطبیق دهد تا آن‌ها را به هم مرتبط سازد. در MATE، رابطه بین PDUها یک GOP است که آن هم دارای یک AVPL می‌باشد. MATE با AVPLهای دیگری پیکربندی می‌شود تا روی AVPLِ مربوط به GOP عمل کرده و GOPها را در قالب GOGها به یکدیگر مرتبط کند.

درک خوب از نحوه عملکرد AVPها و AVPLها برای فهمیدن چگونگی کارکرد MATE اساسی و ضروری است.

MATE در اصل توسط Luis Ontanon، یک عیب‌یاب سیستم‌های مخابراتی، به‌عنوان راهی برای صرفه‌جویی در زمان جهت فیلتر کردن بسته‌های یک تماس واحد از میان فایل‌های کپچر بسیار حجیم تنها با استفاده از شماره تماس‌گیرنده نوشته شد. او بعداً از زمانی که صرفه‌جویی کرده بود استفاده کرد تا این ابزار را به‌اندازه‌ای انعطاف‌پذیر سازد که با پروتکل‌هایی غیر از آن‌هایی که مستقیماً با آن‌ها سر و کار داشت نیز کار کند.

۱۲.۳.۲. جفت‌های ویژگی-مقدار (AVP)

Section titled “۱۲.۳.۲. جفت‌های ویژگی-مقدار (AVP)”

اطلاعاتی که MATE برای مرتبط ساختن فریم‌های مختلف استفاده می‌کند در قالب جفت‌های ویژگی-مقدار (AVPs) قرار دارند. AVPها از دو رشته تشکیل شده‌اند: نام و مقدار. هنگامی که AVPها در پیکربندی استفاده می‌شوند، یک عملگر نیز تعریف می‌گردد. روش‌های گوناگونی وجود دارد که می‌توان AVPها را با استفاده از آن عملگرها با یکدیگر تطبیق داد.

avp_name="avp's value"
another_name= "1234 is the value"

نام (name)، رشته‌ای است که برای اشاره به «نوع» یک AVP به کار می‌رود. دو AVP با یکدیگر مطابقت پیدا نمی‌کنند مگر اینکه نام‌هایشان کاملاً یکسان باشد.

نام باید با یک حرف کوچک انگلیسی (a-z) شروع شود و تنها می‌تواند شامل نویسه‌های الفبایی-عددی (a-zA-Z0-9) و نویسه‌های ویژه _، - و . باشد. نام با یک عملگر به پایان می‌رسد.

شما نباید از حروف بزرگ در نام‌ها، یا نام‌هایی که با . یا _ شروع می‌شوند استفاده کنید. نام‌هایی که با حرف بزرگ شروع می‌شوند برای پارامترهای پیکربندی رزرو شده‌اند (ما آن‌ها را کلمات کلیدی یا keywords می‌نامیم)؛ هیچ‌چیز شما را از به کار بردن رشته‌های دارای حروف بزرگ برای موارد دیگر منع نمی‌کند، اما این کار احتمالاً گیج‌کننده خواهد بود. من در این مستند، راهنمای مرجع، مثال‌ها و کتابخانه پایه، از به کار بردن کلمات با حروف بزرگ برای هر چیزی به جز کلمات کلیدی خودداری خواهم کرد. نام‌هایی که با . شروع می‌شوند نیز بسیار گیج‌کننده خواهند بود، زیرا در گرامر قدیمی، تبدیل‌های (transforms) مربوط به AVPL از نام‌هایی که با . آغاز می‌شوند برای نشان دادن تعلق آن‌ها به AVPL جایگزین استفاده می‌کردند.

مقدار (value)، رشته‌ای است که یا در پیکربندی (برای AVPهای پیکربندی) تنظیم می‌شود و یا توسط وایرشارک هنگام استخراج فیلدهای مورد نظر از درخت یک فریم مقداردهی می‌گردد. مقادیر استخراج‌شده از فیلدها از همان نمایشی استفاده می‌کنند که در رشته‌های فیلتر به کار می‌رود، با این تفاوت که از علامت نقل‌قول (quotes) استفاده نمی‌شود.

با مقدار همواره به‌عنوان یک رشته رفتار خواهد شد، حتی اگر یک عدد باشد. اگر در مقدار فاصله خالی (space) وجود داشته باشد، آن مقدار باید بین علامت‌های نقل‌قول "" قرار گیرد. مقادیری که خود کلمه کلیدی نیز محسوب می‌شوند، مانند True و False، نیز باید داخل علامت نقل‌قول قرار گیرند ("True"، "False").

ip_addr=10.10.10.11
tcp_port=1234
binary_data=01:23:45:67:89:ab:cd:ef
parameter12=0x23aa
parameter_with_spaces="this value has spaces"

شیوه‌ای که دو AVP هم‌نام ممکن است با یکدیگر مطابقت پیدا کنند توسط عملگر (operator) توصیف می‌شود. به خاطر داشته باشید که دو AVP با هم تطبیق نمی‌یابند مگر اینکه نام‌هایشان کاملاً یکسان باشد. در MATE، عملیات تطبیق همواره بین AVPهای استخراج‌شده از فریم‌ها (که AVPهای داده یا data AVPs نامیده می‌شوند) و AVPهای پیکربندی انجام می‌گیرد.

عملگرهای تطبیق AVP که در حال حاضر در MATE تعریف شده‌اند عبارتند از:

  • مساوی (= Equal): در صورتی مطابقت می‌یابد که رشته داده‌شده کاملاً با رشته مقدارِ AVP داده برابر باشد.
  • نامساوی (! Not Equal): تنها در صورتی مطابقت می‌یابد که رشته مقدار داده‌شده با رشته مقدارِ AVP داده برابر نباشد.
  • یکی از ({} One Of): در صورتی مطابقت می‌یابد که یکی از رشته‌های ممکن فهرست‌شده با رشته مقدارِ AVP داده برابر باشد.
  • شروع با (^ Starts With): در صورتی مطابقت می‌یابد که رشته داده‌شده با نویسه‌های ابتدایی رشته مقدارِ AVP داده مطابقت داشته باشد.
  • پایان با ($ Ends With): در صورتی مطابقت می‌یابد که رشته داده‌شده با نویسه‌های پایانی رشته مقدارِ AVP داده مطابقت داشته باشد.
  • شامل (~ Contains): در صورتی مطابقت می‌یابد که رشته داده‌شده با هر زیررشته‌ای از رشته مقدارِ AVP داده مطابقت داشته باشد.
  • کمتر از (< Lower Than): در صورتی مطابقت می‌یابد که رشته مقدارِ AVP داده از نظر معنایی (مرتبه الفبایی/مقداری) کوچک‌تر از رشته داده‌شده باشد.
  • بیشتر از (> Higher Than): در صورتی مطابقت می‌یابد که رشته مقدارِ AVP داده از نظر معنایی بزرگ‌تر از رشته داده‌شده باشد.
  • وجود دارد (? Exists - علامت ? را می‌توان حذف کرد): تا زمانی که یک AVP داده با نام مشخص‌شده وجود داشته باشد، مطابقت خواهد داشت.

۱۲.۳.۳. فهرست‌های AVP (AVPL)

Section titled “۱۲.۳.۳. فهرست‌های AVP (AVPL)”

یک AVPL مجموعه‌ای از AVPهای متنوع است که می‌توان آن را با سایر AVPLها تطبیق داد. هر PDU، GOP و GOG دارای یک AVPL است که اطلاعات مربوط به آن را در بر می‌گیرد. قوانینی که MATE برای گروه‌بندی PDUها و GOPها استفاده می‌کند، عملیات روی AVPL هستند.

هرگز دو AVP کاملاً یکسان در یک AVPL واحد وجود نخواهد داشت. با این حال، تا زمانی که مقادیر آن‌ها متفاوت باشد، می‌توانیم بیش از یک AVP با نام یکسان در یک AVPL داشته باشیم.

چند مثال از AVPL:

( addr=10.20.30.40, addr=192.168.0.1, tcp_port=21, tcp_port=32534, user_cmd=PORT,
data_port=12344, data_addr=192.168.0.1 )
( addr=10.20.30.40, addr=192.168.0.1, channel_id=22:23, message_type=Setup,
calling_number=1244556673 )
( addr=10.20.30.40, addr=192.168.0.1, ses_id=01:23:45:67:89:ab:cd:ef )
( user_id=pippo, calling_number=1244556673, assigned_ip=10.23.22.123 )

در MATE دو نوع AVPL وجود دارد:

  • AVPLهای داده (data AVPLs) که حاوی اطلاعات استخراج‌شده از فریم‌ها هستند.
  • AVPLهای پیکربندی (configuration AVPLs) که از پیکربندی می‌آیند و برای گفتن این موضوع به MATE استفاده می‌شوند که چگونه آیتم‌ها را بر اساس AVPLهای داده‌شان به یکدیگر مرتبط سازد.

AVPLهای داده را می‌توان به روش‌های گوناگون در برابر AVPLهای پیکربندی مورد عملیات قرار داد:

  • تطبیق آزاد (Loose Match): در صورتی مطابقت می‌یابد که حداقل یکی از AVPهای هر AVPL با هم مطابقت داشته باشند. در صورت تطبیق، یک AVPL حاوی تمام AVPهای موجود در AVPL داده که با AVPهای پیکربندی مطابقت داشته‌اند، برمی‌گرداند.
  • تطبیق «همه موارد موجود» (“Every” Match): در صورتی مطابقت می‌یابد که هیچ‌یک از AVPهای موجود در AVPL پیکربندی در تطبیق با یک AVP موجود در AVPL داده شکست نخورد، حتی اگر همه AVPهای پیکربندی دارای جفت منطبق نباشند. در صورت تطبیق، یک AVPL حاوی تمام AVPهای موجود در AVPL داده که با یک AVP در AVPL پیکربندی مطابقت داشته‌اند، برمی‌گرداند.
  • تطبیق دقیق (Strict Match): اگر و تنها اگر تک‌تک AVPهای پیکربندی حداقل یک مورد منطبق در AVPL داده داشته باشند، مطابقت می‌یابد. در صورت تطبیق، یک AVPL حاوی AVPهای موجود در AVPL داده که مطابقت داشته‌اند را برمی‌گرداند.
  • همچنین یک عملیات ادغام (Merge) نیز وجود دارد که بین AVPLها انجام می‌شود و در آن تمام AVPهایی که در AVPL داده وجود ندارند اما در پیکربندی موجودند، به AVPL داده اضافه خواهند شد.
  • علاوه بر این‌ها، تبدیل‌ها (Transforms) وجود دارند که ترکیبی از یک AVPL تطبیق و یک AVPL برای ادغام هستند.

تحلیل یک فریم توسط MATE در سه فاز انجام می‌شود:

  • در فاز اول، MATE تلاش می‌کند یک PDUِ مربوط به MATE را از درخت پروتکل فریم استخراج کند. اگر پیکربندی MATE دارای یک اعلان Pdu باشد که Proto (پروتکل) آن در فریم موجود است، MATE یک PDU ایجاد خواهد کرد.
  • در فاز دوم، اگر یک PDU از فریم استخراج شده باشد، MATE تلاش می‌کند با تطبیق معیار کلید (key criteria) داده‌شده توسط یک اعلان Gop، آن را با سایر PDUها در یک GOP (گروه PDUها) گروه‌بندی کند. اگر هنوز هیچ GOPای با معیار کلید مربوط به آن PDU وجود نداشته باشد، MATE تلاش می‌کند در صورت تطبیق با معیار Start داده‌شده در اعلان Gop، یک GOP جدید برای آن بسازد.
  • در فاز سوم، اگر یک GOP برای آن PDU وجود داشته باشد، MATE تلاش می‌کند با استفاده از معیارهای داده‌شده توسط بخش Member در یک اعلان Gog، این GOP را با سایر GOPها در یک GOG (گروه از گروه‌ها) گروه‌بندی نماید.
Figure 12.2. MATE Analysis (PDU→GOP→GOG) flowchart

شکل ۱۲.۲. فلوچارت تحلیل MATE (PDU→GOP→GOG)

منطق استخراج و تطبیق از پیکربندی MATE نشأت می‌گیرد؛ فایل پیکربندی MATE توسط گزینه ترجیحات mate.config مشخص می‌شود. به‌طور پیش‌فرض این مقدار یک رشته خالی است که یعنی: MATE را پیکربندی نکن.

فایل پیکربندی به MATE می‌گوید در فریم‌ها به دنبال چه چیزی بگردد؛ چگونه از آن PDU بسازد؛ PDUها چگونه با سایر PDUهای مشابه در قالب GOPها مرتبط شوند؛ و GOPها چگونه در قالب GOGها به هم ربط پیدا کنند.

فایل پیکربندی MATE فهرستی از اعلان‌ها (declarations) است. ۴ نوع اعلان وجود دارد: Transform، Pdu، Gop و Gog. یک بلوک Transform باید پیش از هر یک از بلوک‌های اعلان دیگری که ممکن است از آن استفاده کنند، قرار گیرد.

۱۲.۴.۱. ایجاد PDUها (فاز ۱)

Section titled “۱۲.۴.۱. ایجاد PDUها (فاز ۱)”

MATE درختِ هر فریم را بررسی می‌کند تا ببیند آیا داده مفیدی برای استخراج وجود دارد یا خیر، و اگر وجود داشته باشد، یک یا چند شیء PDU حاوی آن اطلاعات مفید ایجاد خواهد کرد.

بخش اول تحلیل MATE، «استخراج PDU» (PDU extraction) است.

۱۲.۴.۱.۱. استخراج داده PDU

Section titled “۱۲.۴.۱.۱. استخراج داده PDU”

MATE برای هر فیلد پروتکل متفاوت از نوع Proto که در فریم حضور داشته باشد، یک PDU می‌سازد. MATE از درختِ آن فیلد، فیلدهایی را واکشی می‌کند که در اعلانِ بخش ۱۲.۹.۱، «بلوک اعلان PDU» تعریف شده‌اند و آفست (offset) ابتدایی آن‌ها در فریم، در محدوده مرزهای Proto فعلی و مرزهای دستورات Transport و Payload مشخص‌شده قرار دارد.

Pdu dns_pdu Proto dns Transport ip {
Extract addr From ip.addr;
Extract dns_id From dns.id;
Extract dns_resp From dns.flags.response;
};
Figure 12.3. Wireshark window - fields for PDU extraction

شکل ۱۲.۳. پنجره وایرشارک - فیلدها برای استخراج PDU

پس از آنکه MATE یک فیلد Proto را پیدا کرد که باید برایش یک PDU از فریم بسازد، در فریم به سمت عقب حرکت می‌کند تا فیلدهای Transport مربوطه را بیابد. پس از آن، به ازای هر نمونه از فیلدهایی که به‌عنوان مقادیر اعلان شده‌اند، AVPهایی با نام‌های مشخص‌شده در بقیه AVPL ایجاد می‌کند.

Figure 12.4. Frame fields mapped to PDU attributes

شکل ۱۲.۴. فیلدهای فریم نگاشت‌شده به ویژگی‌های PDU

گاهی اوقات ما به اطلاعاتی از بیش از یک پروتکل Transport (انتقال) نیاز داریم. در آن حالت، MATE فریم را به سمت عقب بررسی می‌کند تا پروتکل‌های Transport مختلف را در پشته (stack) داده‌شده پیدا کند. MATE تنها نزدیک‌ترین مرز انتقال به ازای هر «پروتکل» در فریم را انتخاب خواهد کرد.

به این ترتیب، تمام PDUها برای هر Protoای که در یک فریم ظاهر می‌شود را به همراه پروتکل‌های انتقال متناظر و نسبی خودش خواهیم داشت.

Pdu isup_pdu Proto isup Transport mtp3/ip {
Extract addr From ip.addr;
Extract m3pc From mtp3.dpc;
Extract m3pc From mtp3.opc;
Extract cic From isup.cic;
Extract isup_msg From isup.message_type;
};
Figure 12.5. Frame containing multiple PDUs

شکل ۱۲.۵. فریمی حاوی چندین PDU

این قابلیت اجازه می‌دهد تا Transport درست به PDU اختصاص داده شود و از ورود پروتکل‌های انتقال تکراری (مثلاً در حالت تونل‌زنی IP روی IP) جلوگیری گردد.

Pdu ftp_pdu Proto ftp Transport tcp/ip {
Extract addr From ip.addr;
Extract port From tcp.port;
Extract ftp_cmd From ftp.command;
};
Figure 12.6. Frame with encapsulated (tunneled) fields

شکل ۱۲.۶. فریم دارای فیلدهای کپسوله‌شده (تونل‌شده)

علاوه بر دستور اجباری Transport، یک دستور اختیاری به نام Payload نیز وجود دارد که تقریباً مشابه Transport کار می‌کند، اما به عناصرِ پس از محدوده Proto اشاره دارد. این دستور در مواردی مفید است که پروتکل بار داده (payload) ممکن است در یک PDU ظاهر نشود، اما با این وجود آن PDU به همان دسته تعلق داشته باشد.

Pdu mmse_over_http_pdu Proto http Transport tcp/ip {
Payload mmse;
Extract addr From ip.addr;
Extract port From tcp.port;
Extract content From http.content_type;
Extract host From http.host;
Extract http_rq From http.request;
Extract method From http.request.method;
Extract resp From http.response.code;
Extract msg_type From mmse.message_type;
Extract notify_status From mmse.status;
Extract send_status From mmse.response_status;
Extract trx From mmse.transaction_id;
};
Figure 12.7. Extract from Payload fields

شکل ۱۲.۷. استخراج از فیلدهای Payload

۱۲.۴.۱.۲. شرایط ایجاد PDUها

Section titled “۱۲.۴.۱.۲. شرایط ایجاد PDUها”

ممکن است مواردی پیش بیاید که نخواهیم MATE یک PDU ایجاد کند، مگر اینکه برخی از ویژگی‌های استخراج‌شده آن با معیارهای خاصی مطابقت داشته باشند یا نداشته باشند. برای این کار، از دستورات Criteria در اعلان‌های Pdu استفاده می‌کنیم.

Pdu isup_pdu Proto isup Transport mtp3/ip {
...
// MATE will create isup_pdu PDUs only when there is not a point code '1234'
Criteria Reject Strict (m3pc=1234);
};
Pdu ftp_pdu Proto ftp Transport tcp/ip {
...
// MATE will create ftp_pdu PDUs only when they go to port 21 of our ftp_server
Criteria Accept Strict (addr=10.10.10.10, port=21);
};

به دستور Criteria یک عمل (Accept یا Reject)، یک نوع تطبیق (Strict، Loose یا Every) و یک AVPL داده می‌شود تا AVPL استخراج‌شده فعلی با آن تطبیق داده شود.

۱۲.۴.۱.۳. تبدیل ویژگی‌های یک PDU

Section titled “۱۲.۴.۱.۳. تبدیل ویژگی‌های یک PDU”

پس از آنکه فیلدها به درون AVPLِ مربوط به PDU استخراج شدند، MATE هرگونه Transform (تبدیل) اعلان‌شده را روی آن اعمال خواهد کرد. نحوه اعمال تبدیل‌ها و چگونگی کارکرد آن‌ها در ادامه توضیح داده شده است. با این حال، دانستن این نکته مفید است که پس از ایجاد AVPL برای PDU، ممکن است پیش از تحلیل شدن، دستخوش تبدیل قرار گیرد. به این ترتیب می‌توانیم داده‌ها را تغییر شکل دهیم تا فرآیند تحلیل ساده‌تر شود.

هر PDU که با موفقیت ایجاد شود، یک درخت MATE به کالبدشکافی فریم اضافه خواهد کرد. اگر آن PDU به هیچ GOPای مرتبط نباشد، درخت مربوط به PDU صرفاً حاوی اطلاعات همان PDU خواهد بود. اگر به یک GOP اختصاص یافته باشد، درخت شامل آیتم‌های GOP نیز خواهد بود و همین امر برای سطح GOG نیز صادق است.

mate dns_pdu:1
dns_pdu: 1
dns_pdu time: 3.750000
dns_pdu Attributes
dns_resp: False
dns_id: 0x8cac
addr: 10.194.4.11
addr: 10.194.24.35

درخت PDU حاوی چند فیلد قابل‌فیلتر است:

  • فیلد mate.dns_pdu حاوی شماره PDUِ مربوط به «dns_pdu» خواهد بود.
  • فیلد mate.dns_pdu.RelativeTime حاوی زمان سپری‌شده از ابتدای کپچر بر حسب ثانیه خواهد بود.
  • این درخت همچنین حاوی ویژگی‌های مختلف PDU خواهد بود؛ تمامی این‌ها به صورت رشته هستند (که در فیلترها باید به صورت "10.0.0.1" استفاده شوند، نه به شکل 10.0.0.1):
    • mate.dns_pdu.dns_resp
    • mate.dns_pdu.dns_id
    • mate.dns_pdu.addr

۱۲.۴.۲. گروه‌بندی PDUها با یکدیگر (GOP) (فاز ۲)

Section titled “۱۲.۴.۲. گروه‌بندی PDUها با یکدیگر (GOP) (فاز ۲)”

پس از آنکه MATE واحدهای PDU را ایجاد کرد، وارد فاز تحلیل PDU می‌شود. در طول فاز تحلیل PDU، موتور MATE تلاش می‌کند PDUهای هم‌نوع را در «گروه‌هایی از PDUها» (موسوم به GOPها) گروه‌بندی کند و برخی از AVPها را از AVPLِ مربوط به PDU به AVPLِ مربوط به GOP کپی نماید.

Figure 12.8. Grouping PDUs (GOP) flowchart

شکل ۱۲.۸. فلوچارت گروه‌بندی PDUها (GOP)

۱۲.۴.۲.۱. چه چیزهایی می‌توانند به یک GOP تعلق بگیرند

Section titled “۱۲.۴.۲.۱. چه چیزهایی می‌توانند به یک GOP تعلق بگیرند”

با داشتن یک PDU، اولین کاری که MATE انجام می‌دهد این است که بررسی کند آیا هیچ اعلان GOPای در پیکربندی برای نوعِ PDU داده‌شده وجود دارد یا خیر. در صورت وجود، از AVPLِ بخش Match آن برای تطبیق دادن با AVPLِ مربوط به PDU استفاده می‌کند؛ اگر با هم مطابقت نداشته باشند، فاز تحلیل به پایان می‌رسد. اگر تطبیق صورت گیرد، آن AVPL کلید کاندید (candidate key) برای GOP خواهد بود که جهت جستجو در نمایه (index) مربوط به GOPها به کار می‌رود تا مشخص شود PDU فعلی باید به کدام GOP اختصاص یابد. اگر چنین GOPای وجود نداشته باشد و این PDU با معیار Start در اعلان Gop برای آن نوع PDU مطابقت نداشته باشد، آن PDU بدون تخصیص باقی می‌ماند و تنها فاز تحلیل به پایان می‌رسد.

Gop ftp_ses On ftp_pdu Match (addr, addr, port, port) {...};
Gop dns_req On dns_pdu Match (addr, addr, dns_id) {...};
Gop isup_leg On isup_pdu Match (m3pc, m3pc, cic) {...};

اگر تطبیقی وجود داشته باشد، از کلید کاندید برای جستجو در نمایه GOPها استفاده می‌شود تا مشخص گردد آیا از قبل GOPای که به همان شکل با کلید GOP مطابقت داشته باشد وجود دارد یا خیر. اگر چنین مورد منطبقی در مجموعه GOPها وجود داشته باشد و PDU با AVPLِ مربوط به Start برای نوع خودش مطابقت نداشته باشد، آن PDU به GOP منطبق اختصاص داده می‌شود. اگر یک تطبیق از نوع Start باشد، MATE بررسی می‌کند که آیا آن GOP قبلاً متوقف (stopped) شده است یا خیر. اگر GOP متوقف شده باشد، یک GOP جدید ایجاد خواهد شد و در نمایه GOPها جایگزینِ GOP قدیمی می‌شود.

Gop ftp_ses On ftp_pdu Match (addr, addr, port, port) {
Start (ftp_cmd=USER);
};
Gop dns_req On dns_pdu Match (addr, addr, dns_id) {
Start (dns_resp="True");
};
Gop isup_leg On isup_pdu Match (m3pc, m3pc, cic) {
Start (isup_msg=1);
};

اگر هیچ دستور Startای برای یک GOP مشخص نشده باشد، هر PDUای که AVPL آن با کلید یک GOP منطبق شود، به‌عنوان شروع یک GOP عمل خواهد کرد.

۱۲.۴.۲.۳. چه چیزهایی وارد AVPLِ یک GOP می‌شوند

Section titled “۱۲.۴.۲.۳. چه چیزهایی وارد AVPLِ یک GOP می‌شوند”

پس از آنکه دانستیم یک GOP وجود دارد و PDU به آن اختصاص یافته است، MATE تمام ویژگی‌های منطبق با کلید، به علاوه هر AVP موجود در AVPLِ آن PDU که با AVPLِ بخش Extra مطابقت داشته باشد را در AVPLِ مربوط به GOP کپی می‌کند.

Gop ftp_ses On ftp_pdu Match (addr, addr, port, port) {
Start (ftp_cmd=USER);
Extra (pasv_prt, pasv_addr);
};
Gop isup_leg On isup_pdu Match (m3pc, m3pc, cic) {
Start (isup_msg=1);
Extra (calling, called);
};

پس از آنکه PDU به GOP اختصاص داده شد، MATE بررسی می‌کند که آیا آن PDU با معیار Stop مطابقت دارد یا خیر؛ در صورت تطبیق، MATE آن GOP را به‌عنوان متوقف‌شده (stopped) علامت‌گذاری می‌کند. حتی پس از متوقف شدن نیز، یک GOP ممکن است PDUهای جدیدی که با کلید آن مطابقت دارند را دریافت کند، مگر اینکه آن PDU با معیار Start مطابقت داشته باشد. اگر چنین باشد، MATE در عوض یک GOP جدید ایجاد می‌کند که با آن PDU آغاز می‌شود.

Gop ftp_ses On ftp_pdu Match (addr, addr, port, port) {
Start (ftp_cmd=USER);
Stop (ftp_cmd=QUIT); // The response to the QUIT command will be assigned to the same GOP
Extra (pasv_prt, pasv_addr);
};
Gop dns_req On dns_pdu Match (addr, addr, dns_id) {
Start (dns_resp="False");
Stop (dns_resp="True");
};
Gop isup_leg On isup_pdu Match (m3pc, m3pc, cic) {
Start (isup_msg=1); // IAM
Stop (isup_msg=16); // RLC
Extra (calling, called);
};

اگر هیچ معیار Stopای برای یک GOP مشخص نشده باشد، آن GOP به محض ایجاد شدن، متوقف خواهد شد. با این حال، درست مانند هر GOP دیگری، PDUهایی که با کلید آن GOP مطابقت دارند همچنان به همان GOP اختصاص خواهند یافت، مگر اینکه با شرط Start مطابقت پیدا کنند که در این صورت یک GOP جدید با استفاده از همان کلید ایجاد خواهد شد. برای گروه‌بندی چندین PDU که همگی با معیار Start مطابقت دارند، یک دستور Stop ساختگی (bogus) مانند زیر اضافه کنید:

Gop frame_ses On frame_pdu Match (frame_time) {
Start (frame_time);
Stop (frame_time="FOO");
};

برای هر فریمی که حاوی یک PDU متعلق به یک GOP باشد، MATE یک درخت برای آن GOP ایجاد خواهد کرد.

مثال زیر درخت ایجادشده توسط مثال‌های dns_pdu و dns_req را نشان می‌دهد.

...
MATE dns_pdu:6->dns_req:1
dns_pdu: 6
dns_pdu time: 2.103063
dns_pdu time since beginning of Gop: 2.103063
dns_pdu Attributes
dns_resp: True
dns_id: 0x8cac
addr: 10.194.4.11
addr: 10.194.24.35
dns_req: 1
GOP Key: addr=10.194.4.11; addr=10.194.24.35; dns_id=0x8cac;
dns_req Attributes
dns_id: 0x8cac
addr: 10.194.4.11
addr: 10.194.24.35
dns_req Times
dns_req start time: 0.000000
dns_req hold time: 2.103063
dns_req duration: 2.103063
dns_req number of PDUs: 2
Start PDU: in frame 1
Stop PDU: in frame 6 (2.103063 : 2.103063)

علاوه بر درخت PDU، این درخت حاوی اطلاعاتی درباره رابطه بین PDUهایی است که به آن GOP تعلق دارند. به این ترتیب موارد زیر را داریم:

  • فیلد mate.dns_req که حاوی شناسه (id) این GOP از نوع dns_req است. این فیلد در فریم‌هایی که به GOPهای dns_req تعلق دارند حضور خواهد داشت.
  • فیلدهای mate.dns_req.dns_id و mate.dns_req.addr که مقادیر ویژگی‌های کپی‌شده به درون GOP را نشان می‌دهند.
  • زمان‌سنج‌های (timers) مربوط به GOP:
    • فیلد mate.dns_req.StartTime: زمان سپری‌شده (بر حسب ثانیه) از ابتدای کپچر تا شروع GOP.
    • فیلد mate.dns_req.Time: زمان سپری‌شده بین PDU شروع (start PDU) و PDU توقف (stop PDU) اختصاص‌یافته به این GOP (تنها در صورتی ایجاد می‌شود که یک معیار Stop برای GOP اعلان شده باشد و یک PDU منطبق از راه رسیده باشد).
    • فیلد mate.dns_req.Duration: زمان سپری‌شده بین PDU شروع و آخرین PDU اختصاص‌یافته به این GOP.
  • فیلد mate.dns_req.NumOfPdus: تعداد PDUهایی که به این GOP تعلق دارند.
    • فیلد mate.dns_req.Pdu: فهرستی قابل‌فیلتر از شماره‌های فریم مربوط به PDUهای این GOP.

۱۲.۴.۲.۶. زمان‌سنج‌های GOP

Section titled “۱۲.۴.۲.۶. زمان‌سنج‌های GOP”

توجه داشته باشید که دو «زمان‌سنج» (timers) برای یک GOP وجود دارد:

  • زمان‌سنج Time، که تنها برای GOPهایی که متوقف (Stopped) شده‌اند تعریف می‌شود و زمان سپری‌شده بین PDUهای Start و Stop را نشان می‌دهد.
  • زمان‌سنج Duration، که برای هر GOP صرف‌نظر از وضعیت آن تعریف می‌شود و زمان سپری‌شده بین PDUِ مربوط به Start و آخرین PDUای که به آن GOP اختصاص یافته است را نشان می‌دهد.

بنابراین:

  • می‌توانیم PDUهایی را که به GOPهای متوقف‌شده تعلق دارند با mate.xxx.Time فیلتر کنیم.
  • می‌توانیم PDUهایی را که به GOPهای متوقف‌نشده تعلق دارند با mate.xxx && !mate.xxx.Time فیلتر کنیم.
  • می‌توانیم PDUهایی را که به GOPهای متوقف‌شده تعلق دارند با استفاده از mate.xxx.Duration نیز فیلتر کنیم.
  • می‌توانیم PDUهایی را که به GOPهایی تعلق دارند که تکمیل شدن آن‌ها بیش از (یا کمتر از) ۰.۵ ثانیه زمان برده است با mate.xxx.Time > 0.5 فیلتر کنیم (می‌توانید این موارد را به‌عنوان فیلترهای رنگ‌آمیزی نیز امتحان کنید تا متوجه شوید چه زمانی زمان‌های پاسخ شروع به افزایش می‌کنند).

۱۲.۴.۳. گروه‌بندی GOPها با یکدیگر (GOG) (فاز ۳)

Section titled “۱۲.۴.۳. گروه‌بندی GOPها با یکدیگر (GOG) (فاز ۳)”

هنگامی که GOPها ایجاد می‌شوند، یا هر زمان که AVPL آن‌ها تغییر می‌کند، GOPها (مجدداً) تحلیل می‌شوند تا بررسی گردد آیا با یک گروه از گروه‌ها (GOG) که از قبل موجود است مطابقت دارند یا می‌توانند یک GOG جدید ایجاد کنند. تحلیل GOP به دو فاز تقسیم می‌شود. در فاز اول، GOPای که هنوز تخصیص نیافته است بررسی می‌شود تا مشخص گردد آیا به یک GOG موجود تعلق دارد یا ممکن است یک GOG جدید بسازد. فاز دوم در نهایت GOG را بررسی کرده و کلیدهای آن را در نمایه (index) مربوط به GOGها ثبت می‌کند.

Figure 12.9. Grouping GOPs (GOG) flowchart

شکل ۱۲.۹. فلوچارت گروه‌بندی GOPها (GOG)

دلایل متعددی وجود دارد که نویسنده معتقد است این ویژگی نیاز به پیاده‌سازی مجدد دارد؛ بنابراین احتمالاً در آینده نزدیک تغییرات عمیقی در نحوه انجام این کار صورت خواهد گرفت. این بخش از مستندات، نسخه MATE را تا وایرشارک 0.10.9 منعکس می‌کند؛ در نسخه‌های آینده این بخش تغییر خواهد کرد.

۱۲.۴.۳.۱. اعلان یک گروه از گروه‌ها (GOG)

Section titled “۱۲.۴.۳.۱. اعلان یک گروه از گروه‌ها (GOG)”

اولین کاری که هنگام پیکربندی یک GOG باید انجام دهیم این است که به MATE بگوییم چنین GOGای وجود دارد.

Gog http_use {
...
};

۱۲.۴.۳.۲. گفتن به MATE که چه چیزی می‌تواند عضو یک GOG باشد

Section titled “۱۲.۴.۳.۲. گفتن به MATE که چه چیزی می‌تواند عضو یک GOG باشد”

سپس باید به MATE بگوییم که برای یافتن مطابقت در GOPهای کاندید، به دنبال چه چیزی بگردد.

Gog http_use {
Member http_ses (host);
Member dns_req (host);
};

۱۲.۴.۳.۳. وارد کردن داده‌های جالب و مورد نظر به درون GOG

Section titled “۱۲.۴.۳.۳. وارد کردن داده‌های جالب و مورد نظر به درون GOG”

در اغلب اوقات، ویژگی‌های دیگری غیر از آن‌هایی که برای تطبیق استفاده شده‌اند نیز جالب توجه و مفید خواهند بود. به منظور کپی کردن سایر ویژگی‌های مورد نظر از GOP به GOG، می‌توانیم مانند کاری که برای GOPها انجام می‌دهیم، از دستور Extra استفاده کنیم.

Gog http_use {
...
Extra (cookie);
};
mate http_pdu:4->http_req:2->http_use:1
http_pdu: 4
http_pdu time: 1.309847
http_pdu time since beginning of Gop: 0.218930
http_req: 2
... (the gop's tree for http_req: 2) ..
http_use: 1
http_use Attributes
host: www.example.com
http_use Times
http_use start time: 0.000000
http_use duration: 1.309847
number of GOPs: 3
dns_req: 1
... (the gop's tree for dns_req: 1) ..
http_req: 1
... (the gop's tree for http_req: 1) ..
http_req of current frame: 2

می‌توانیم بر اساس موارد زیر فیلتر انجام دهیم:

  • زمان‌سنج‌های (timers) مربوط به GOG:
    • mate.http_use.StartTime:‏ زمان سپری‌شده (بر حسب ثانیه) از ابتدای کپچر تا شروع GOG.
    • mate.http_use.Duration:‏ زمان سپری‌شده بین اولین فریم یک GOG و آخرین فریم اختصاص‌یافته به آن.
  • ویژگی‌های منتقل‌شده به GOG:
    • mate.http_use.host
  • mate.http_use.NumOfGops:‏ تعداد GOPهایی که به این GOG تعلق دارند.
  • mate.http_use.GopStart:‏ فریم شروع یک GOP.
  • mate.http_use.GopStop:‏ فریم توقف یک GOP.

۱۲.۴.۴. تنظیم داده‌ها (تبدیل‌های AVPL)

Section titled “۱۲.۴.۴. تنظیم داده‌ها (تبدیل‌های AVPL)”

یک Transform (تبدیل)، دنباله‌ای از قوانین Match (تطبیق) است که به صورت اختیاری با تغییر دادن نتیجه تطبیق توسط یک AVPL اضافی تکمیل می‌شود. چنین تغییری می‌تواند یک Insert (درج/ادغام) یا یک Replace (جایگزینی) باشد. از تبدیل‌ها می‌توان به‌عنوان ابزارهای کمکی برای دستکاری AVPLِ یک آیتم پیش از پردازش‌های بعدی استفاده کرد. آن‌ها در موارد متعددی بسیار کارآمد ظاهر می‌شوند.

تبدیل‌های AVPL به شکل زیر اعلان می‌شوند:

Transform name {
Match [Strict|Every|Loose] match_avpl [Insert|Replace] modify_avpl;
...
};

بخش name، دستگیره (handle) یا نامِ تبدیل AVPL است. از آن برای اشاره به این تبدیل در زمان فراخوانی آن در مراحل بعدی استفاده می‌شود.

اعلان‌های Match به MATE دستور می‌دهند که چه چیزی را و چگونه با AVPL داده تطبیق دهد و در صورت موفقیت‌آمیز بودن تطبیق، چگونه AVPL داده را تغییر دهد. هر زمان که این تبدیل‌ها فراخوانی شوند، به همان ترتیبی که در فایل پیکربندی ظاهر شده‌اند اجرا خواهند شد.

مشخص‌کننده اختیاری نوع تطبیق (Strict، Every یا Loose) برای انتخاب نوع Match به کار می‌رود؛ مقدار پیش‌فرض Strict است که می‌توان آن را حذف کرد (ننوشت).

مشخص‌کننده اختیاری حالت تغییر (modification mode) به MATE دستور می‌دهد که چگونه باید از AVPL تغییر (modify_avpl) استفاده شود:

  • مقدار پیش‌فرض Insert (که می‌توان آن را حذف کرد) باعث می‌شود modify_avpl با AVPL داده موجود ادغام (merged) گردد،
  • مقدار Replace باعث می‌شود تمام AVPهای منطبق از AVPL داده با modify_avpl جایگزین (replaced) شوند.

بخش modify_avpl ممکن است خالی باشد؛ این ویژگی در برخی موارد برای هر دو حالت تغییر Insert و Replace مفید واقع می‌شود.

Transform rm_client_from_http_resp1 {
Match (http_rq); //first match wins so the request won't get the not_rq attribute inserted
Match Every (addr) Insert (not_rq); //this line won't be evaluated if the first one matched so not_rq won't be inserted to requests
};
Transform rm_client_from_http_resp2 {
Match (not_rq, client) Replace (); //replace "client and not_rq" with nothing
};

مثال‌ها:

Transform insert_name_and {
Match Strict (host=10.10.10.10, port=2345) Insert (name=JohnDoe);
};

در صورتی که AVPL داده حاوی host=10.10.10.10 و (and) port=2345 باشد، عبارت name=JohnDoe را به آن اضافه می‌کند.

Transform insert_name_or {
Match Loose (host=10.10.10.10, port=2345) Insert (name=JohnDoe);
};

در صورتی که AVPL داده حاوی host=10.10.10.10 یا (or) port=2345 باشد، عبارت name=JohnDoe را به آن اضافه می‌کند.

Transform replace_ip_address {
Match (host=10.10.10.10) Replace (host=192.168.10.10);
};

مقدار اصلی host=10.10.10.10 را با host=192.168.10.10 جایگزین می‌کند.

Transform add_ip_address {
Match (host=10.10.10.10) (host=192.168.10.10);
};

عبارت host=192.168.10.10 را به AVPL اضافه (درج) می‌کند و در عین حال مقدار اصلی host=10.10.10.10 را نیز در آن نگه می‌دارد.

Transform replace_may_be_surprising {
Match Loose (a=aaaa, b=bbbb) Replace (c=cccc, d=dddd);
};

نتایج زیر را به دست می‌دهد:

  • عبارت (a=aaaa, b=eeee) به (b=eeee, c=cccc, d=dddd) تبدیل می‌شود، زیرا a=aaaa مطابقت داشت و بنابراین جایگزین شد، در حالی که b=eeee مطابقت نداشت و در نتیجه دست‌نخورده باقی ماند،
  • عبارت (a=aaaa, b=bbbb) به (c=cccc, d=dddd) تبدیل می‌شود، زیرا هر دو مورد a=aaaa و b=bbbb مطابقت داشتند.

پس از اعلان شدن، تبدیل‌ها (Transforms) را می‌توان به اعلان‌های مربوط به PDUها، GOPها یا GOGها اضافه کرد. این کار با افزودن دستور Transform name_list به اعلان انجام می‌شود:

Pdu my_proto_pdu Proto my_proto Transport ip {
Extract addr From ip.addr;
...
Transform my_pdu_transform[, other_pdu_transform[, yet_another_pdu_transform]];
};
  • در مورد PDU، فهرست تبدیل‌ها پس از ایجاد شدن PDU روی AVPL آن اعمال می‌شود.
  • در مورد GOP و GOG، فهرست تبدیل‌ها در زمان ایجاد شدن آن‌ها و همچنین هر بار که تغییر می‌کنند، روی AVPLهای مربوطه‌شان اعمال می‌گردد.
Figure 12.10. Applying Transform flowchart

شکل ۱۲.۱۰. فلوچارت اعمال Transform

  • فهرستی از تبدیل‌های از پیش اعلان‌شده را می‌توان با استفاده از دستور Transform به هر آیتم (Pdu، Gop یا Gog) اختصاص داد.
  • هر بار که AVPLِ یک آیتم تغییر می‌کند، در برابر تمامی تبدیل‌های موجود در فهرستِ داده‌شده به آن آیتم مورد عملیات قرار می‌گیرد. تبدیل‌های موجود در فهرست از چپ به راست اعمال می‌شوند.
  • در درون هر یک از تبدیل‌ها، AVPLِ آیتم در برابر عبارت‌های Match مربوط به آن Transform، با شروع از بالاترین مورد، عملیات می‌شود تا زمانی که همه موارد امتحان شوند یا یکی از آن‌ها با موفقیت مطابقت یابد.

از تبدیل‌های MATE می‌توان برای کارهای بسیار متنوعی استفاده کرد، از جمله:

۱۲.۴.۴.۴. شروط چندگانه Start/Stop برای یک GOP

Section titled “۱۲.۴.۴.۴. شروط چندگانه Start/Stop برای یک GOP”

با استفاده از Transforms می‌توانیم بیش از یک شرط شروع (start) یا توقف (stop) به یک GOP اضافه کنیم.

Transform start_cond {
Match (attr1=aaa,attr2=bbb) (msg_type=start);
Match (attr3=www,attr2=bbb) (msg_type=start);
Match (attr5^a) (msg_type=stop);
Match (attr6$z) (msg_type=stop);
};
Pdu pdu ... {
...
Transform start_cond;
}
Gop gop ... {
Start (msg_type=start);
Stop (msg_type=stop);
...
}

۱۲.۴.۴.۵. علامت‌گذاری GOPها و GOGها برای فیلتر کردن آسان آن‌ها

Section titled “۱۲.۴.۴.۵. علامت‌گذاری GOPها و GOGها برای فیلتر کردن آسان آن‌ها”
Transform marks {
Match (addr=10.10.10.10, user=john) (john_at_host);
Match (addr=10.10.10.10, user=tom) (tom_at_host);
}
...
Gop my_gop ... {
...
Transform marks;
}

پس از آن می‌توانیم از فیلتر نمایش mate.my_gop.john_at_host یا mate.my_gop.tom_at_host استفاده کنیم.

۱۲.۴.۴.۶. افزودن (Insert) آگاهی از جهت (direction) به MATE

Section titled “۱۲.۴.۴.۶. افزودن (Insert) آگاهی از جهت (direction) به MATE”
Transform direction_as_text {
Match (src=192.168.0.2, dst=192.168.0.3) Insert (direction=from_2_to_3);
Match (src=192.168.0.3, dst=192.168.0.2) Insert (direction=from_3_to_2);
};
Pdu my_pdu Proto my_proto Transport tcp/ip {
Extract src From ip.src;
Extract dst From ip.dst;
Extract addr From ip.addr;
Extract port From tcp.port;
Extract start From tcp.flags.syn;
Extract stop From tcp.flags.fin;
Extract stop From tcp.flags.rst;
Transform direction_as_text;
}
Gop my_gop On my_pdu Match (addr,addr,port,port) {
...
Extra (direction);
}

مثال اصلی (در زیر) ابتدا src و dst را حذف کرده و سپس direction را اضافه می‌کرد.

Transform direction_as_text {
Match (src=192.168.0.2, dst=192.168.0.3) Replace (direction=from_2_to_3);
Match (src=192.168.0.3, dst=192.168.0.2) Replace (direction=from_3_to_2);
};

۱۲.۴.۴.۷. برگردان نشانی شبکه (NAT)

Section titled “۱۲.۴.۴.۷. برگردان نشانی شبکه (NAT)”

NAT می‌تواند هنگام ردگیری مشکلاتی ایجاد کند، اما می‌توانیم به‌راحتی با تبدیل کردن (Transforming) نشانی IPِ تغییریافته با NAT و نشانی اترنتِ روتر به نشانیِ بدون NAT، این مشکل را دور بزنیم:

Transform denat {
Match (addr=192.168.0.5, ether=01:02:03:04:05:06) Replace (addr=123.45.67.89);
Match (addr=192.168.0.6, ether=01:02:03:04:05:06) Replace (addr=123.45.67.90);
Match (addr=192.168.0.7, ether=01:02:03:04:05:06) Replace (addr=123.45.67.91);
}
Pdu my_pdu Proto my_proto transport tcp/ip/eth {
Extract ether From eth.addr;
Extract addr From ip.addr;
Extract port From tcp.port;
Transform denat;
}

در این بخش یک پیکربندی MATE را نمایش می‌دهیم که ابتدا برای هر درخواست DNS و HTTP یک GOP ایجاد می‌کند، سپس آن GOPها را بر اساس نام میزبان (host) در یک GOG به هم پیوند می‌زند. در نهایت، درخواست‌هایی را که از سمت کاربران مختلف می‌آیند در GOGهای متفاوت تفکیک خواهیم کرد.

با بارگذاری این پیکربندی MATE می‌توانیم:

  • از mate.http_use.Duration > 5.5 برای فیلتر کردن فریم‌ها بر اساس زمانی که بارگذاری کامل یک صفحه (از درخواست DNS برای ترجمه نام آن تا بارگذاری شدن آخرین تصویر) طول می‌کشد، استفاده کنیم.
  • از mate.http_use.client == “10.10.10.20” && mate.http_use.host == “www.example.com” برای جداسازی بسته‌های DNS و HTTP مرتبط با بازدید یک کاربر مشخص استفاده کنیم.
  • از mate.http_req.Duration > 1.5 برای فیلتر کردن تمام بسته‌های درخواست‌های HTTPای که تکمیل آن‌ها بیش از ۱.۵ ثانیه زمان می‌برد، استفاده کنیم.

فایل پیکربندی کامل در ویکی وایرشارک در دسترس است: https://wiki.wireshark.org/Mate/Tutorial

توجه: این مثال از فیلد dns.qry.name استفاده می‌کند که از نسخه 0.10.9 وایرشارک تعریف شده است. با فرض اینکه از قبل افزونه MATE را نصب کرده‌اید، می‌توانید آن را با نسخه فعلی وایرشارک آزمایش کنید.

۱۲.۵.۱. یک GOP برای درخواست‌های DNS

Section titled “۱۲.۵.۱. یک GOP برای درخواست‌های DNS”

ابتدا به MATE می‌گوییم که چگونه برای هر درخواست/پاسخ DNS یک GOP بسازد.

MATE باید بداند چه چیزی یک PDU از نوع DNS را می‌سازد. ما آن را با استفاده از یک اعلان Pdu توصیف می‌کنیم:

Pdu dns_pdu Proto dns Transport ip {
Extract addr From ip.addr;
Extract dns_id From dns.id;
Extract dns_resp From dns.flags.response;
};

با استفاده از Proto dns به MATE می‌گوییم هر بار که پروتکل dns را پیدا کرد، PDU ایجاد نماید. با استفاده از Transport ip به MATE اطلاع می‌دهیم که برخی از فیلدهای مورد علاقه ما در بخش ip فریم قرار دارند. در نهایت، به MATE می‌گوییم که ip.addr را با نام addr، فیلد dns.id را با نام dns_id و فیلد dns.flags.response را با نام dns_resp وارد (استخراج) کند.

پس از آنکه به MATE گفتیم چگونه dns_pduها را استخراج کند، به او می‌گوییم که چگونه درخواست‌ها و پاسخ‌ها را با هم تطبیق دهد و آن‌ها را در یک GOP گروه‌بندی نماید. برای این کار از یک اعلان Gop جهت تعریف GOP، و سپس از دستورات Start و Stop برای مشخص کردن زمان شروع و پایان GOP استفاده خواهیم کرد.

Gop dns_req On dns_pdu Match (addr,addr,dns_id) {
Start (dns_resp="False");
Stop (dns_resp="True");
};

با استفاده از اعلان Gop به MATE می‌گوییم که نام (Name) این GOP برابر با dns_req است، و اینکه واحدهای dns_pdu می‌توانند عضو این GOP شوند، و همچنین کلیدی که برای تطبیق دادن PDUها با GOP استفاده می‌شود چیست.

کلید این GOP عبارت “addr, addr, dns_id” است. این یعنی برای آنکه واحدهای dns_pdu به یک GOP واحد تعلق بگیرند، باید هر دو نشانی و همچنین شناسه درخواست (request id) در آن‌ها کاملاً یکسان باشد. سپس به MATE دستور می‌دهیم که یک dns_req هر زمان که یک dns_pdu با عبارت "dns_resp="False"" مطابقت یافت شروع می‌شود و زمانی که یک dns_pdu دیگر با عبارت "dns_resp="True"" مطابقت پیدا کرد، متوقف می‌شود.

در این مرحله، اگر یک فایل کپچر را با استفاده از این پیکربندی باز کنیم، قادریم از فیلتر نمایش mate.dns_req.Time > 1 استفاده کنیم تا فقط بسته‌های مربوط به درخواست‌های DNSای را ببینیم که تکمیل شدن آن‌ها بیش از یک ثانیه طول کشیده است.

می‌توانیم از فیلتر نمایش mate.dns_req && ! mate.dns_req.Time برای یافتن درخواست‌هایی که هیچ پاسخی به آن‌ها داده نشده است استفاده کنیم. فیلد mate.xxx.Time تنها برای GOPهایی که متوقف (stopped) شده‌اند مقداردهی می‌شود.

۱۲.۵.۲. یک GOP برای درخواست‌های HTTP

Section titled “۱۲.۵.۲. یک GOP برای درخواست‌های HTTP”

این مثال دیگر، برای هر درخواست HTTP یک GOP ایجاد می‌کند.

Pdu http_pdu Proto http Transport tcp/ip {
Extract addr From ip.addr;
Extract port From tcp.port;
Extract http_rq From http.request.method;
Extract http_rs From http.response;
DiscardPduData true;
};
Gop http_req On http_pdu Match (addr, addr, port, port) {
Start (http_rq);
Stop (http_rs);
};

بنابراین، اگر یک فایل کپچر را با استفاده از این پیکربندی باز کنیم:

  • فیلتر کردن با mate.http_req.Time > 1 تمام درخواست‌هایی را نشان می‌دهد که در آن‌ها رسیدن سرآیند (header) پاسخ بیش از یک ثانیه طول کشیده است.
  • فیلتر کردن با mate.http_req.Duration > 1.5 آن دسته از درخواست‌هایی را نشان می‌دهد که تکمیل شدن کامل آن‌ها بیش از ۱.۵ ثانیه زمان برده است.

باید بدانید که mate.xxx.Time زمان بر حسب ثانیه بین PDU منطبق با عبارت Start در GOP و PDU منطبق با عبارت Stop در GOP را به دست می‌دهد (بله، می‌توانید با استفاده از این قابلیت زمان‌سنج بسازید!). از سوی دیگر، mate.xxx.Duration زمان سپری‌شده بین Start در GOP و آخرین PDU اختصاص‌یافته به آن GOP را به شما می‌دهد، صرف‌نظر از اینکه آن PDU یک Stop باشد یا خیر. پس از Stop شدنِ GOP، واحدهای PDU که با کلید آن GOP مطابقت دارند همچنان به همان GOP اختصاص خواهند یافت، تا زمانی که با شرط Start آن GOP مطابقت پیدا نکنند؛ که در آن صورت یک GOP جدید با همان کلید ایجاد خواهد شد.

۱۲.۵.۳. گرد هم آوردن DNS و HTTP در یک GOG

Section titled “۱۲.۵.۳. گرد هم آوردن DNS و HTTP در یک GOG”

ما با استفاده از تعاریف Pdu و Gop در مثال‌های قبلی، تمام بسته‌های HTTP متعلق به درخواست‌ها و پاسخ‌های ارسال‌شده به یک میزبان (host) مشخص و همچنین درخواست و پاسخ DNS استفاده‌شده برای ترجمه نام دامنه آن را در یک GOG واحد به هم پیوند خواهیم زد.

برای اینکه بتوانیم درخواست‌های DNS و HTTP را با هم گروه‌بندی کنیم، باید بخشی از اطلاعات را که هر دوی این پروتکل‌ها به اشتراک می‌گذارند، وارد PDUها و GOPها نماییم. پس از آنکه PDUها و GOPها تعریف شدند، می‌توانیم از دستورات Extract (برای PDUها) و Extra (برای GOPها) استفاده کنیم تا به MATE بگوییم چه فیلدهای پروتکل دیگری باید به AVPLهای مربوط به PDU و GOP اضافه شوند. دستورات زیر را به اعلان‌های مربوطه اضافه می‌کنیم:

Extract host From http.host; // to Pdu http_pdu as the last Extract in the list
Extra (host); // to Gop http_req after the Stop
Extract host From dns.qry.name; // to Pdu dns_pdu as the last Extract in the list
Extra (host); // to Gop dns_req after the Stop

در اینجا به MATE گفته‌ایم که http.host را در http_pdu و فیلد dns.qry.name را در dns_pdu با نام host وارد کند. همچنین باید به MATE بگوییم که ویژگی host را از PDUها به GOPها کپی نماید؛ این کار را با استفاده از دستور Extra انجام می‌دهیم.

پس از آنکه تمام داده‌های مورد نیاز خود را در PDUها و GOPها در اختیار داشتیم، به MATE می‌گوییم چه چیزی باعث می‌شود GOPهای مختلف به یک GOG مشخص تعلق بگیرند.

Gog http_use {
Member http_req (host);
Member dns_req (host);
Expiration 0.75;
};

با استفاده از اعلان Gog، به MATE می‌گوییم یک نوع GOG به نام http_use تعریف کند که زمان انقضای (expiration) آن ۰.۷۵ ثانیه پس از متوقف شدن تمام GOPهای متعلق به آن است. پس از گذشت آن زمان، یک GOP جدید احتمالی که دارای همان کلید منطبق باشد، به جای اضافه شدن به GOG قبلی، یک GOG جدید ایجاد خواهد کرد.

با استفاده از دستورات Member، به MATE می‌گوییم که واحدهای http_req دارای host یکسان به یک GOG واحد تعلق دارند، و همین موضوع برای واحدهای dns_req نیز صادق است.

تا اینجا به MATE دستور داده‌ایم که تمام بسته‌های مرتبط با نشست‌های ارسال‌شده به سمت یک میزبان مشخص را گروه‌بندی کند. در این مرحله اگر یک فایل کپچر را باز کنیم:

  • فیلتر نمایش mate.http_use.Duration > 5 تنها آن دسته از درخواست‌هایی را نشان می‌دهد که تکمیل آن‌ها از زمان شروع درخواست DNS تا آخرین بسته از پاسخ‌های HTTP، بیش از ۵ ثانیه طول کشیده است.
  • فیلتر نمایش mate.http_use.host == “www.w3c.org” تمام بسته‌های (هم DNS و هم HTTP) مرتبط با درخواست‌های هدایت‌شده به سمت www.w3c.org را نمایش خواهد داد.

۱۲.۵.۴. جداسازی درخواست‌های کاربران متعدد

Section titled “۱۲.۵.۴. جداسازی درخواست‌های کاربران متعدد”

«هیوستون: ما اینجا به یک مشکل برخورده‌ایم.»

این پیکربندی اگر برای فایل‌های کپچر گرفته‌شده در سمت کلاینت استفاده شود به‌خوبی کار می‌کند، اما در لایه‌های عمیق‌تر شبکه با یک آشفتگی واقعی روبه‌رو خواهیم شد. درخواست‌های کاربران مختلف در داخل http_useها با هم مخلوط می‌شوند. GOGها تقریباً به صورت تصادفی ایجاد و متوقف می‌شوند (بسته به زمان‌بندی شروع و توقف GOPها). چگونه می‌توانیم درخواست‌های کاربران مجزا را از یکدیگر تفکیک کنیم؟

MATE ابزاری دارد که می‌توان از آن برای حل این قبیل مسائل گروه‌بندی استفاده کرد. این ابزار همان Transforms (تبدیل‌ها) هستند. پس از تعریف شدن، می‌توان آن‌ها را روی PDUها، GOPها و GOGها اعمال کرد و آن‌ها می‌توانند بر اساس آنچه موجود است، ویژگی‌های بیشتری را جایگزین یا درج نمایند. ما از آن‌ها برای ایجاد یک ویژگی به نام client استفاده خواهیم کرد که به کمک آن، درخواست‌های مختلف را از هم جدا می‌کنیم.

برای DNS، نیاز داریم که ip.src مربوط به درخواست، تنها از طرفِ درخواستِ DNS به درون GOP منتقل شود.

بنابراین ابتدا به MATE می‌گوییم که ip.src را با نام client وارد کند:

Extract client From ip.src;

سپس، به MATE می‌گوییم که در PDU، ترکیب ( dns_resp=“True”, client ) را تنها با dns_resp=“True” جایگزین کند. به این ترتیب، ویژگی client را فقط در PDUهای درخواست DNS (یعنی بسته‌هایی که از سمت کلاینت می‌آیند) نگه می‌داریم. برای انجام این کار، باید یک اعلان Transform (در این مورد، فقط با یک عبارت) پیش از اعلان Pduای که از آن استفاده می‌کند، اضافه کنیم:

Transform rm_client_from_dns_resp {
Match (dns_resp="True", client) Replace (dns_resp="True");
};

در گام بعد، با افزودن خط زیر پس از فهرست Extract در PDUِ مربوط به dns_pdu، این تبدیل را فراخوانی می‌کنیم:

Transform rm_client_from_dns_resp;

پروتکل HTTP کمی پیچیده‌تر است. ما باید ویژگی حاملِ ip.src را هم از پاسخ و هم از «ادامه‌ها» (continuations)ی پاسخ حذف کنیم، اما از آنجا که هیچ چیزی برای فیلتر کردن روی بسته‌های ادامه وجود ندارد، ابتدا باید یک ویژگی ساختگی (fake attribute) اضافه کنیم. و سپس باید هر زمان که آن ویژگی ساختگی ظاهر شد، client را حذف نماییم. این کار به لطف این واقعیت امکان‌پذیر است که عبارت‌های Match در داخل یک Transform یکی‌یکی اجرا می‌شوند تا زمانی که یکی از آن‌ها با موفقیت مطابقت یابد. ابتدا، دو Transform دیگر اعلان می‌کنیم:

Transform rm_client_from_http_resp1 {
Match (http_rq); //first match wins so the request won't get the not_rq attribute inserted
Match Every (addr) Insert (not_rq); //this line won't be evaluated if the first one matched so not_rq won't be inserted to requests
};
Transform rm_client_from_http_resp2 {
Match (not_rq, client) Replace (); //replace "client and not_rq" with nothing (will happen only in the response and eventual parts of it)
};

سپس، یک دستور Extract دیگر به اعلان http_pdu اضافه می‌کنیم و هر دو Transform اعلان‌شده در بالا را به ترتیب درست اعمال می‌نماییم:

Extract client From ip.src;
Transform rm_client_from_http_resp1, rm_client_from_http_resp2;

در MATE، تمامی Transformهای فهرست‌شده برای یک آیتم ارزیابی خواهند شد، در حالی که در درون یک Transform واحد، ارزیابی در اولین عبارت Match موفقیت‌آمیز متوقف می‌شود. به همین دلیل است که ما ابتدا فقط http_rq را تطبیق می‌دهیم تا پیش از اضافه شدن ویژگی not_rq، از دنباله اول خارج شویم. سپس Transform دوم را اعمال می‌کنیم که در صورت حضور هم‌زمان not_rq و client، هر دوی آن‌ها را حذف می‌کند. بله، Transformها کمی پرزحمت و دست‌وپاگیر هستند، اما بسیار کارآمدند.

پس از آنکه تمام آنچه در PDUها نیاز داشتیم را به دست آوردیم، باید به MATE بگوییم که ویژگی client را از PDUها به GOPهای مربوطه کپی کند؛ این کار را با افزودن client به فهرست‌های Extra در هر دو اعلان Gop انجام می‌دهیم:

Extra (host, client);

علاوه بر این، باید اعلان‌های قدیمی کلید GOP را به اعلان‌های جدیدی تغییر دهیم که هم شامل client و هم شامل host باشند. بنابراین اعلان‌های Member در Gog را به شکل زیر تغییر می‌دهیم:

Member http_req (host, client);
Member dns_req (host, client);

حالا به هدفمان رسیدیم؛ هر «استفاده» (usage) GOG مخصوص به خود را دریافت می‌کند.

۱۲.۶. مثال‌های پیکربندی MATE

Section titled “۱۲.۶. مثال‌های پیکربندی MATE”

در ادامه مجموعه‌ای از مثال‌های مختلف پیکربندی برای MATE آورده شده است. بسیاری از آن‌ها در عمل چندان ضروری نیستند زیرا قابلیت «مکالمات» (conversations) در وایرشارک این کار را بهتر انجام می‌دهد. با این حال، هدف از ارائه آن‌ها کمک به کاربران برای درک نحوه پیکربندی MATE است.

مثال زیر از هر نشست TCP یک GOP می‌سازد.

Transform add_tcp_stop {
Match (tcp_flags_reset="True") Insert (tcp_stop="True");
Match (tcp_flags_fin="True") Insert (tcp_stop="True");
};
Pdu tcp_pdu Proto tcp Transport ip {
Extract addr From ip.addr;
Extract port From tcp.port;
Extract tcp_start From tcp.flags.syn;
Extract tcp_flags_reset From tcp.flags.reset;
Extract tcp_flags_fin From tcp.flags.fin;
Transform add_tcp_stop;
};
Gop tcp_ses On tcp_pdu Match (addr, addr, port, port) {
Start (tcp_start="True");
Stop (tcp_stop="True");
};
Done;

این پیکربندی احتمالاً در ۹۹.۹٪ موارد به‌خوبی کار خواهد کرد، اما دو جریان 10.0.0.1:20→10.0.0.2:22 و 10.0.0.1:22→10.0.0.2:20 اگر از نظر زمانی با یکدیگر هم‌پوشانی داشته باشند، هر دو در یک GOP واحد قرار خواهند گرفت.

  • فیلتر کردن با mate.tcp_ses.Time > 1 تمام نشست‌هایی را نشان می‌دهد که بیش از یک ثانیه به طول می‌انجامند.
  • فیلتر کردن با mate.tcp_ses.NumOfPdus < 5 تمام نشست‌های TCP را که کمتر از ۵ بسته دارند نمایش خواهد داد.
  • فیلتر کردن با mate.tcp_ses.Id == 3 تمام بسته‌های مربوط به سومین نشست TCPای را که MATE پیدا کرده است نشان خواهد داد.

۱۲.۶.۲. یک GOG برای یک نشست کامل FTP

Section titled “۱۲.۶.۲. یک GOG برای یک نشست کامل FTP”

این پیکربندی اجازه می‌دهد تا یک نشست کامل FTP غیرفعال (passive FTP) (به همراه انتقال داده آن) در یک GOG واحد به هم پیوند داده شود.

Pdu ftp_pdu Proto ftp Transport tcp/ip {
Extract ftp_addr From ip.addr;
Extract ftp_port From tcp.port;
Extract ftp_resp From ftp.response.code;
Extract ftp_req From ftp.request.command;
Extract server_addr From ftp.passive.ip;
Extract server_port From ftp.passive.port;
LastPdu true;
};
Pdu ftp_data_pdu Proto ftp-data Transport tcp/ip{
Extract server_addr From ip.src;
Extract server_port From tcp.srcport;
};
Gop ftp_data On ftp_data_pdu Match (server_addr, server_port) {
Start (server_addr);
};
Gop ftp_ctl On ftp_pdu Match (ftp_addr, ftp_addr, ftp_port, ftp_port) {
Start (ftp_resp=220);
Stop (ftp_resp=221);
Extra (server_addr, server_port);
};
Gog ftp_ses {
Member ftp_ctl (ftp_addr, ftp_addr, ftp_port, ftp_port);
Member ftp_data (server_addr, server_port);
};
Done;

توجه: نداشتن هیچ مشخصه‌ای برای تمایز قائل شدن بین بسته‌های ftp-data باعث می‌شود این پیکربندی به جای هر انتقال فایل، برای هر بسته ftp-data یک GOP بسازد. استفاده از GOPهای از پیش شروع‌شده (Pre-started GOPs) از این موضوع جلوگیری می‌کرد.

۱۲.۶.۳. استفاده از RADIUS برای فیلتر کردن ترافیک SMTP یک کاربر مشخص

Section titled “۱۲.۶.۳. استفاده از RADIUS برای فیلتر کردن ترافیک SMTP یک کاربر مشخص”

جاسوسی از افراد، علاوه بر اینکه کاری غیراخلاقی است، در بسیاری از کشورها غیرقانونی نیز می‌باشد. این مثال صرفاً برای توضیح نحوه انجام فنی این کار آورده شده است، نه دعوتی به انجام آن. انجام این قبیل کارها زمانی که دلیل موجهی وجود داشته باشد، بر عهده پلیس و مراجع قانونی است.

Pdu radius_pdu On radius Transport udp/ip {
Extract addr From ip.addr;
Extract port From udp.port;
Extract radius_id From radius.id;
Extract radius_code From radius.code;
Extract user_ip From radius.framed_addr;
Extract username From radius.username;
}
Gop radius_req On radius_pdu (radius_id, addr, addr, port, port) {
Start (radius_code {1|4|7} );
Stop (radius_code {2|3|5|8|9} );
Extra (user_ip, username);
}
// we define the smtp traffic we want to filter
Pdu user_smtp Proto smtp Transport tcp/ip {
Extract user_ip From ip.addr;
Extract smtp_port From tcp.port;
Extract tcp_start From tcp.flags.syn;
Extract tcp_stop From tcp.flags.reset;
}
Gop user_smtp_ses On user_smtp (user_ip, user_ip, smtp_port!25) {
Start (tcp_start=1);
Stop (tcp_stop=1);
}
// with the following group of groups we'll group together the radius and the smtp
// we set a long expiration to avoid the session expire on long pauses.
Gog user_mail {
Expiration 1800;
Member radius_req (user_ip);
Member user_smtp_ses (user_ip);
Extra (username);
}
Done;

فیلتر کردن فایل کپچر با عبارت mate.user_mail.username == “theuser” بسته‌های RADIUS و ترافیک SMTP مربوط به کاربر “theuser” را فیلتر خواهد کرد.

این پیکربندی از هر تماس، یک GOG ایجاد خواهد کرد.

Pdu q931 Proto q931 Transport ip {
Extract addr From ip.addr;
Extract call_ref From q931.call_ref;
Extract q931_msg From q931.message_type;
Extract calling From q931.calling_party_number.digits;
Extract called From q931.called_party_number.digits;
Extract guid From h225.guid;
Extract q931_cause From q931.cause_value;
};
Gop q931_leg On q931 Match (addr, addr, call_ref) {
Start (q931_msg=5);
Stop (q931_msg=90);
Extra (calling, called, guid, q931_cause);
};
Pdu ras Proto h225.RasMessage Transport ip {
Extract addr From ip.addr;
Extract ras_sn From h225.requestSeqNum;
Extract ras_msg From h225.RasMessage;
Extract guid From h225.guid;
};
Gop ras_req On ras Match (addr, addr, ras_sn) {
Start (ras_msg {0|3|6|9|12|15|18|21|26|30} );
Stop (ras_msg {1|2|4|5|7|8|10|11|13|14|16|17|19|20|22|24|27|28|29|31});
Extra (guid);
};
Gog call {
Member ras_req (guid);
Member q931_leg (guid);
Extra (called,calling,q931_cause);
};
Done;

با این پیکربندی می‌توانیم:

  • تمام سیگنالینگ مربوط به یک تماس‌گیرنده خاص را فیلتر کنیم: mate.call.caller == “123456789”
  • تمام سیگنالینگ مربوط به تماس‌های دارای یک علت قطع (release cause) خاص را فیلتر کنیم: mate.call.q931_cause == 31
  • تمام سیگنالینگ مربوط به تماس‌های بسیار کوتاه را فیلتر کنیم: mate.q931_leg.Time < 5

۱۲.۶.۵. پیام‌های چندرسانه‌ای (MMS)

Section titled “۱۲.۶.۵. پیام‌های چندرسانه‌ای (MMS)”

با این مثال، تمام اجزای ارسال یا دریافت یک پیام MMS در یک GOG واحد به هم پیوند داده می‌شوند. توجه داشته باشید که این مثال از عبارت Payload استفاده می‌کند، زیرا تحویل MMS از پروتکل MMSE بر بستر HTTP یا WSP بهره می‌برد. از آنجا که مرتبط ساختن درخواست بازیابی (retrieve request) به یک پاسخ صرفاً به وسیله MMSE امکان‌پذیر نیست (درخواست صرفاً یک HTTP GET بدون هیچ‌گونه بخش MMSE است)، یک GOP از واحدهای PDUِ مربوط به HTTP ساخته می‌شود، اما داده‌های MMSE باید از بدنه (bodies) استخراج گردند.

## WARNING: this example has been blindly translated from the "old" MATE syntax
## and it has been verified that Wireshark accepts it. However, it has not been
## tested against any capture file due to lack of the latter.
Transform rm_client_from_http_resp1 {
Match (http_rq);
Match Every (addr) Insert (not_rq);
};
Transform rm_client_from_http_resp2 {
Match (not_rq,ue) Replace ();
};
Pdu mmse_over_http_pdu Proto http Transport tcp/ip {
Payload mmse;
Extract addr From ip.addr;
Extract port From tcp.port;
Extract http_rq From http.request;
Extract content From http.content_type;
Extract resp From http.response.code;
Extract method From http.request.method;
Extract host From http.host;
Extract content From http.content_type;
Extract trx From mmse.transaction_id;
Extract msg_type From mmse.message_type;
Extract notify_status From mmse.status;
Extract send_status From mmse.response_status;
Transform rm_client_from_http_resp1, rm_client_from_http_resp2;
};
Gop mmse_over_http On mmse_over_http_pdu Match (addr, addr, port, port) {
Start (http_rq);
Stop (http_rs);
Extra (host, ue, resp, notify_status, send_status, trx);
};
Transform mms_start {
Match Loose() Insert (mms_start);
};
Pdu mmse_over_wsp_pdu Proto wsp Transport ip {
Payload mmse;
Extract trx From mmse.transaction_id;
Extract msg_type From mmse.message_type;
Extract notify_status From mmse.status;
Extract send_status From mmse.response_status;
Transform mms_start;
};
Gop mmse_over_wsp On mmse_over_wsp_pdu Match (trx) {
Start (mms_start);
Stop (never);
Extra (ue, notify_status, send_status);
};
Gog mms {
Member mmse_over_http (trx);
Member mmse_over_wsp (trx);
Extra (ue, notify_status, send_status, resp, host, trx);
Expiration 60.0;
};

۱۲.۷. کتابخانه پیکربندی MATE

Section titled “۱۲.۷. کتابخانه پیکربندی MATE”

کتابخانه MATE حاوی تعاریف GOP برای چندین پروتکل است (یا خواهد بود). پروتکل‌های کتابخانه با استفاده از دستور زیر در پیکربندی MATE شما گنجانده می‌شوند: Action=Include; Lib=proto_name;.

برای هر پروتکلی که یک ورودی در کتابخانه دارد، تعریفِ آنچه از PDU برای ایجاد یک GOP برای آن پروتکل نیاز است، به همراه هرگونه معیار احتمالی و تعریف کاملاً ضروری GOP (یعنی Gop، Start و Stop) را خواهیم یافت.

[Note]
توجه

به نظر می‌رسد این کد به نحو (syntax) قدیمی MATE نوشته شده است. تاکنون به قالب جدید بازنویسی نشده است. با این حال، همچنان می‌تواند پایه‌ای برای بازسازی این موارد در قالب جدید باشد.

۱۲.۷.۱. پروتکل‌های با کاربرد عمومی

Section titled “۱۲.۷.۱. پروتکل‌های با کاربرد عمومی”

این بخش برای هر نشست TCP یک GOP ایجاد خواهد کرد. در صورت استفاده، باید آخرین مورد در فهرست باشد. و هر پروتکل دیگری که بر بستر TCP قرار می‌گیرد باید با دستور LastPdu=TRUE; اعلان شود تا در جایی که نوع دیگری از PDU وجود دارد، یک PDU از نوع TCP ایجاد نشود.

Transform add_tcp_stop {
Match (tcp_flags_reset="True") Insert (tcp_stop="True");
Match (tcp_flags_fin="True") Insert (tcp_stop="True");
};
Pdu tcp_pdu Proto tcp Transport ip {
Extract addr From ip.addr;
Extract port From tcp.port;
Extract tcp_start From tcp.flags.syn;
Extract tcp_flags_reset From tcp.flags.reset;
Extract tcp_flags_fin From tcp.flags.fin;
Transform add_tcp_stop;
};
Gop tcp_ses On tcp_pdu Match (addr, addr, port, port) {
Start (tcp_start="True");
Stop (tcp_stop="True");
};
Done;

یک GOP ایجاد می‌کند که حاوی هر درخواست و پاسخ آن (و در نهایت باز전송‌ها یا retransmissions نیز) خواهد بود.

Action=PduDef; Name=dns_pdu; Proto=dns; Transport=udp/ip; addr=ip.addr; port=udp.port; dns_id=dns.id; dns_rsp=dns.flags.response;
Action=GopDef; Name=dns_req; On=dns_pdu; addr; addr; port!53; dns_id;
Action=GopStart; For=dns_req; dns_rsp=0;
Action=GopStop; For=dns_req; dns_rsp=1;

یک GOP برای هر تراکنش.

Action=PduDef; Name=radius_pdu; Proto=radius; Transport=udp/ip; addr=ip.addr; port=udp.port; radius_id=radius.id; radius_code=radius.code;
Action=GopDef; Name=radius_req; On=radius_pdu; radius_id; addr; addr; port; port;
Action=GopStart; For=radius_req; radius_code|1|4|7;
Action=GopStop; For=radius_req; radius_code|2|3|5|8|9;
Action=PduDef; Name=rtsp_pdu; Proto=rtsp; Transport=tcp/ip; addr=ip.addr; port=tcp.port; rtsp_method=rtsp.method;
Action=PduExtra; For=rtsp_pdu; rtsp_ses=rtsp.session; rtsp_url=rtsp.url;
Action=GopDef; Name=rtsp_ses; On=rtsp_pdu; addr; addr; port; port;
Action=GopStart; For=rtsp_ses; rtsp_method=DESCRIBE;
Action=GopStop; For=rtsp_ses; rtsp_method=TEARDOWN;
Action=GopExtra; For=rtsp_ses; rtsp_ses; rtsp_url;

۱۲.۷.۲. پروتکل‌های VoIP/تلفنی

Section titled “۱۲.۷.۲. پروتکل‌های VoIP/تلفنی”

اکثر تعاریف پروتکل‌ها در این بخش، مگر اینکه خلاف آن ذکر شده باشد، برای هر بخش از تماس (Call Leg) یک GOP ایجاد خواهند کرد.

Action=PduDef; Name=isup_pdu; Proto=isup; Transport=mtp3; mtp3pc=mtp3.dpc; mtp3pc=mtp3.opc; cic=isup.cic; isup_msg=isup.message_type;
Action=GopDef; Name=isup_leg; On=isup_pdu; ShowPduTree=TRUE; mtp3pc; mtp3pc; cic;
Action=GopStart; For=isup_leg; isup_msg=1;
Action=GopStop; For=isup_leg; isup_msg=16;
Action=PduDef; Name=q931_pdu; Proto=q931; Stop=TRUE; Transport=tcp/ip; addr=ip.addr; call_ref=q931.call_ref; q931_msg=q931.message_type;
Action=GopDef; Name=q931_leg; On=q931_pdu; addr; addr; call_ref;
Action=GopStart; For=q931_leg; q931_msg=5;
Action=GopStop; For=q931_leg; q931_msg=90;
Action=PduDef; Name=ras_pdu; Proto=h225.RasMessage; Transport=udp/ip; addr=ip.addr; ras_sn=h225.RequestSeqNum; ras_msg=h225.RasMessage;
Action=PduExtra; For=ras_pdu; guid=h225.guid;
Action=GopDef; Name=ras_leg; On=ras_pdu; addr; addr; ras_sn;
Action=GopStart; For=ras_leg; ras_msg|0|3|6|9|12|15|18|21|26|30;
Action=GopStop; For=ras_leg; ras_msg|1|2|4|5|7|8|10|11|13|14|16|17|19|20|22|24|27|28|29|31;
Action=GopExtra; For=ras_leg; guid;
Action=PduDef; Proto=sip_pdu; Transport=tcp/ip; addr=ip.addr; port=tcp.port; sip_method=sip.Method; sip_callid=sip.Call-ID; calling=sdp.owner.username;
Action=GopDef; Name=sip_leg; On=sip_pdu; addr; addr; port; port;
Action=GopStart; For=sip; sip_method=INVITE;
Action=GopStop; For=sip; sip_method=BYE;

از هر تراکنش یک GOP ایجاد خواهد کرد.

برای «پیوند زدن» آن‌ها به GoGِ مربوط به تماس خود، از دستور زیر استفاده کنید: Action=GogKey; Name=your_call; On=mgc_tr; addr!mgc_addr; megaco_ctx;

Action=PduDef; Name=mgc_pdu; Proto=megaco; Transport=ip; addr=ip.addr; megaco_ctx=megaco.context; megaco_trx=megaco.transid; megaco_msg=megaco.transaction; term=megaco.termid;
Action=GopDef; Name=mgc_tr; On=mgc_pdu; addr; addr; megaco_trx;
Action=GopStart; For=mgc_tr; megaco_msg|Request|Notify;
Action=GopStop; For=mgc_tr; megaco_msg=Reply;
Action=GopExtra; For=mgc_tr; term^DS1; megaco_ctx!Choose one;

۱۲.۸.۱. جفت‌های ویژگی-مقدار (AVP)

Section titled “۱۲.۸.۱. جفت‌های ویژگی-مقدار (AVP)”

MATE تقریباً برای همه‌چیز از AVPها استفاده می‌کند: هم برای نگهداری داده‌هایی که از درخت فریم‌ها استخراج کرده است و هم برای نگهداری عناصر مربوط به پیکربندی.

این «جفت‌ها» (در واقع چندتایی‌ها یا tuples) از یک نام (name)، یک مقدار (value) و در مورد AVPهای پیکربندی، یک عملگر (operator) ساخته می‌شوند. نام‌ها و مقادیر از نوع رشته هستند. AVPهای دارای عملگرهایی غیر از = تنها در پیکربندی به کار می‌روند و در فاز تحلیل برای تطبیق دادن AVPهای مربوط به PDUها، GOPها و GOGها استفاده می‌شوند.

نام، رشته‌ای است که برای اشاره به یک نوع از AVP به کار می‌رود. دو ویژگی با یکدیگر مطابقت پیدا نمی‌کنند مگر اینکه نام‌هایشان کاملاً یکسان باشد. نام‌هایی که با حرف بزرگ شروع می‌شوند برای کلمات کلیدی رزرو شده‌اند (اگر بخواهید می‌توانید از آن‌ها برای عناصر خودتان نیز استفاده کنید، اما فکر نمی‌کنم کار درستی باشد). از نام ویژگی‌های MATE می‌توان در فیلترهای نمایش وایرشارک به همان شکلی استفاده کرد که از نام فیلدهای پروتکل ارائه‌شده توسط کالبدشکاف‌ها استفاده می‌شود، اما آن‌ها صرفاً ارجاعاتی به (یا نام‌های مستعار برای) فیلدهای پروتکل نیستند.

مقدار، یک رشته است. این مقدار یا در پیکربندی (برای AVPهای پیکربندی) تنظیم می‌شود و یا توسط MATE هنگام استخراج فیلدهای مورد نظر از یک درخت کالبدشکافی و/یا دستکاری آن‌ها در مراحل بعدی مقداردهی می‌گردد. مقادیر استخراج‌شده از فیلدها از همان نمایشی استفاده می‌کنند که در رشته‌های فیلتر به کار می‌رود.

۱۲.۸.۲. عملگرهای AVP (=, !, {}, ^, $, ~, <, >, ?)

Section titled “۱۲.۸.۲. عملگرهای AVP (=, !, {}, ^, $, ~, <, >, ?)”

در حال حاضر تنها عملگرهای تطبیق تعریف شده‌اند (برنامه‌هایی برای افزودن (مجدد) ویژگی‌های تبدیل وجود دارد، اما پیش از آن باید برخی مسائل داخلی حل شوند). عملیات تطبیق همواره بین دو عملوند انجام می‌شود: مقدارِ یک AVP تصریح‌شده در پیکربندی و مقدارِ یک AVP (یا چندین AVP با نام یکسان) استخراج‌شده از داده‌های بسته (که «AVPهای داده» یا data AVPs نامیده می‌شوند). تطبیق دادن AVPهای داده با یکدیگر امکان‌پذیر نیست.

عملگرهای تطبیق تعریف‌شده عبارتند از:

  • مساوی (= Equal): تساوی را می‌آزماید، بدین معنا که یا رشته‌های مقدار کاملاً یکسان هستند و یا تطبیق با شکست مواجه خواهد شد.
  • نامساوی (! Not Equal): تنها در صورتی مطابقت می‌یابد که رشته‌های مقدار با هم برابر نباشند.
  • یکی از ({} One Of): در صورتی مطابقت می‌یابد که یکی از رشته‌های مقدار فهرست‌شده با رشته AVP داده برابر باشد. آیتم‌های داخل آکولادهای فهرست با نویسه | از هم جدا می‌شوند.
  • شروع با (^ Starts With): در صورتی مطابقت می‌یابد که رشته مقدارِ پیکربندی با نویسه‌های ابتدایی رشته مقدارِ AVP داده مطابقت داشته باشد.
  • پایان با ($ Ends With): در صورتی مطابقت می‌یابد که رشته مقدارِ پیکربندی با نویسه‌های پایانی رشته مقدارِ AVP داده مطابقت داشته باشد.
  • شامل (~ Contains): در صورتی مطابقت می‌یابد که رشته مقدارِ پیکربندی با زیررشته‌ای از نویسه‌های رشته مقدارِ AVP داده مطابقت داشته باشد.
  • کمتر از (< Lower Than): در صورتی مطابقت می‌یابد که رشته مقدارِ AVP داده از نظر معنایی کوچک‌تر از رشته مقدارِ پیکربندی باشد.
  • بیشتر از (> Higher Than): در صورتی مطابقت می‌یابد که رشته مقدارِ AVP داده از نظر معنایی بزرگ‌تر از رشته مقدارِ پیکربندی باشد.
  • وجود دارد (? Exists - قابل حذف): در صورتی که نام AVP مطابقت داشته باشد، صرف‌نظر از اینکه رشته مقدار چیست، مطابقت خواهد داشت.

۱۲.۸.۲.۱. عملگر AVP مساوی (=)

Section titled “۱۲.۸.۲.۱. عملگر AVP مساوی (=)”

این عملگر بررسی می‌کند که آیا مقادیر عملگر (پیکربندی) و AVP عملوند با هم برابر هستند یا خیر.

  • مثال — عبارت attrib=aaa با attrib=aaa مطابقت دارد؛ عبارت attrib=aaa با attrib=bbb مطابقت ندارد.

۱۲.۸.۲.۲. عملگر AVP نامساوی (!)

Section titled “۱۲.۸.۲.۲. عملگر AVP نامساوی (!)”

این عملگر در صورتی مطابقت می‌یابد که رشته‌های مقدارِ دو AVP با هم برابر نباشند.

  • مثال — عبارت attrib=aaa با attrib!bbb مطابقت دارد؛ عبارت attrib=aaa با attrib!aaa مطابقت ندارد.

۱۲.۸.۲.۳. عملگر AVP «یکی از» ({})

Section titled “۱۲.۸.۲.۳. عملگر AVP «یکی از» ({})”

عملگر «یکی از» در صورتی مطابقت می‌یابد که مقدارِ AVP داده برابر با یکی از مقادیر فهرست‌شده در AVP «یکی از» باشد.

  • مثال — عبارت attrib=1 با attrib{1|2|3} مطابقت دارد؛ عبارت attrib=2 با attrib{1|2|3} مطابقت دارد؛ عبارت attrib=4 با attrib{1|2|3} مطابقت ندارد.

۱۲.۸.۲.۴. عملگر AVP «شروع با» (^)

Section titled “۱۲.۸.۲.۴. عملگر AVP «شروع با» (^)”

عملگر «شروع با» در صورتی مطابقت می‌یابد که نویسه‌های ابتدایی مقدارِ AVP داده کاملاً با مقدارِ AVP پیکربندی یکسان باشند.

  • مثال — عبارت attrib=abcd با attrib^abc مطابقت دارد؛ عبارت attrib=abc با attrib^abc مطابقت دارد؛ عبارت attrib=ab با attrib^abc مطابقت ندارد؛ عبارت attrib=abcd با attrib^bcd مطابقت ندارد؛ عبارت attrib=abc با attrib^abcd مطابقت ندارد.

۱۲.۸.۲.۵. عملگر «پایان با» ($)

Section titled “۱۲.۸.۲.۵. عملگر «پایان با» ($)”

عملگر «پایان با» در صورتی مطابقت می‌یابد که آخرین بایت‌های مقدارِ AVP داده برابر با مقدارِ AVP پیکربندی باشند.

  • مثال — عبارت attrib=wxyz با attrib$xyz مطابقت دارد؛ عبارت attrib=yz با attrib$xyz مطابقت ندارد؛ عبارت attrib=abc…wxyz با attrib$abc مطابقت ندارد.

عملگر «شامل» در صورتی مطابقت می‌یابد که مقدارِ AVP داده حاوی رشته‌ای کاملاً یکسان با مقدارِ AVP پیکربندی باشد.

  • مثال — عبارت attrib=abcde با attrib~bcd مطابقت دارد؛ عبارت attrib=abcde با attrib~abc مطابقت دارد؛ عبارت attrib=abcde با attrib~cde مطابقت دارد؛ عبارت attrib=abcde با attrib~xyz مطابقت ندارد.

۱۲.۸.۲.۷. عملگر «کمتر از» (<)

Section titled “۱۲.۸.۲.۷. عملگر «کمتر از» (<)”

عملگر «کمتر از» در صورتی مطابقت می‌یابد که مقدارِ AVP داده از نظر معنایی (الفبایی/واژگانی) کوچک‌تر از مقدارِ AVP پیکربندی باشد.

  • مثال — عبارت attrib=abc با attrib<bcd مطابقت دارد؛ عبارت attrib=1 با attrib<2 مطابقت دارد، اما مراقب باشید: عبارت attrib=10 با attrib<9 مطابقت ندارد؛ عبارت attrib=bcd با attrib<abc مطابقت ندارد؛ عبارت attrib=bcd با attrib<bcd مطابقت ندارد.

اشکالات (BUGS)

این عملگر باید بررسی کند که آیا مقادیر عدد هستند یا خیر و در صورت عددی بودن، آن‌ها را به صورت عددی مقایسه نماید.

۱۲.۸.۲.۸. عملگر «بیشتر از» (>)

Section titled “۱۲.۸.۲.۸. عملگر «بیشتر از» (>)”

عملگر «بیشتر از» در صورتی مطابقت می‌یابد که مقدارِ AVP داده از نظر معنایی بزرگ‌تر از مقدارِ AVP پیکربندی باشد.

مثال‌ها

عبارت attrib=bcd با attrib>abc مطابقت دارد؛ عبارت attrib=3 با attrib>2 مطابقت دارد، اما مراقب باشید: عبارت attrib=9 با attrib>10 مطابقت ندارد؛ عبارت attrib=abc با attrib>bcd مطابقت ندارد؛ عبارت attrib=abc با attrib>abc مطابقت ندارد.

اشکالات (BUGS)

این عملگر باید بررسی کند که آیا مقادیر عدد هستند یا خیر و در صورت عددی بودن، آن‌ها را به صورت عددی مقایسه نماید.

۱۲.۸.۲.۹. عملگر وجود دارد (?)

Section titled “۱۲.۸.۲.۹. عملگر وجود دارد (?)”

عملگر «وجود دارد» تا زمانی که دو عملوند دارای نام یکسانی باشند، همواره مطابقت خواهد یافت.

مثال‌ها

عبارت attrib=abc با attrib? مطابقت دارد؛ عبارت attrib=abc با attrib مطابقت دارد (این صرفاً یک نمادگذاری جایگزین برای مثال قبلی است)؛ بدیهی است که attrib=abc با other_attrib? مطابقت ندارد.

۱۲.۸.۳. فهرست جفت‌های ویژگی-مقدار (AVPL)

Section titled “۱۲.۸.۳. فهرست جفت‌های ویژگی-مقدار (AVPL)”

واحدهای PDU، GOP و GOG از یک AVPL برای نگهداری اطلاعات ردگیری استفاده می‌کنند. یک AVPL مجموعه‌ای نامرتب از AVPها است که می‌توان آن را با سایر AVPLها تطبیق داد.

۱۲.۸.۴. عملیات بین AVPLها (Match)

Section titled “۱۲.۸.۴. عملیات بین AVPLها (Match)”

سه نوع عملیات تطبیق وجود دارد که می‌توان بین AVPLها انجام داد. AVPLِ مربوط به PDU/GOP/GOG همواره یکی از عملوندها خواهد بود؛ عملگر AVPL (نوع تطبیق) و عملوند دوم AVPL همواره از پیکربندی خواهند آمد. توجه داشته باشید که می‌توان برای هر AVP در AVPL پیکربندی، یک عملگر تطبیق AVP متفاوت مشخص کرد.

یک عملیات تطبیق AVPL، یک AVPL نتیجه (result AVPL) برمی‌گرداند. در تبدیل‌ها (Transforms)، ممکن است AVPL نتیجه با یک AVPL دیگر جایگزین شود. جایگزینی بدین معناست که AVPهای داده موجود دور ریخته می‌شوند و AVPL جایگزین از پیکربندی با AVPL داده مربوط به PDU/GOP/GOG ادغام (Merged) می‌گردد.

  • تطبیق آزاد (Loose Match): در صورتی مطابقت می‌یابد که حداقل یکی از AVPهای دو AVPL عملوند با هم مطابقت داشته باشند. در صورت تطبیق، یک AVPL نتیجه حاوی تمام AVPهای موجود در AVPL داده که با AVPهای پیکربندی مطابقت داشته‌اند، برمی‌گرداند.
  • تطبیق «همه موارد موجود» (“Every” Match): در صورتی مطابقت می‌یابد که هیچ‌یک از AVPهای موجود در AVPL پیکربندی در تطبیق با یک AVP در AVPL داده شکست نخورد، حتی اگر همه AVPهای پیکربندی دارای جفت منطبق نباشند. در صورت تطبیق، یک AVPL نتیجه حاوی تمام AVPهای موجود در AVPL داده که با یک AVP در AVPL پیکربندی مطابقت داشته‌اند، برمی‌گرداند.
  • تطبیق دقیق (Strict Match): اگر و تنها اگر تک‌تک AVPهای موجود در AVPL پیکربندی حداقل یک مورد منطبق در AVPL داده داشته باشند، مطابقت می‌یابد. در صورت تطبیق، یک AVPL نتیجه حاوی آن دسته از AVPهای موجود در AVPL داده که مطابقت داشته‌اند را برمی‌گرداند.

۱۲.۸.۴.۱. تطبیق آزاد (Loose Match)

Section titled “۱۲.۸.۴.۱. تطبیق آزاد (Loose Match)”

تطبیق آزاد بین AVPLها در صورتی با موفقیت انجام می‌شود که حداقل یکی از AVPهای داده با حداقل یکی از AVPهای پیکربندی مطابقت داشته باشد. AVPL نتیجه آن حاوی تمام AVPهای داده‌ای است که مطابقت داشته‌اند.

تطبیق‌های آزاد در عملیات Extra روی AVPLِ مربوط به PDU جهت ادغام نتیجه در AVPLِ مربوط به GOP، و روی AVPLِ مربوط به GOP جهت ادغام نتیجه در AVPLِ مربوط به GOG استفاده می‌شوند. همچنین ممکن است در دستورات Criteria و Transforms نیز به کار روند.

مثال‌های تطبیق آزاد (Loose Match)

عبارت (attr_a=aaa, attr_b=bbb, attr_c=xxx) Match Loose (attr_a?, attr_c?) =⇒ نتیجه: (attr_a=aaa, attr_c=xxx)

عبارت (attr_a=aaa, attr_b=bbb, attr_c=xxx) Match Loose (attr_a?, attr_c=ccc) =⇒ نتیجه: (attr_a=aaa)

عبارت (attr_a=aaa, attr_b=bbb, attr_c=xxx) Match Loose (attr_a=xxx; attr_c=ccc) =⇒ نتیجه: عدم تطبیق (No Match!)

۱۲.۸.۴.۲. تطبیق همه موارد موجود (Every Match)

Section titled “۱۲.۸.۴.۲. تطبیق همه موارد موجود (Every Match)”

یک تطبیق «همه موارد موجود» (every) بین AVPLها در صورتی با موفقیت انجام می‌شود که هیچ‌یک از AVPهای پیکربندی که دارای جفت متناظر در AVPL داده هستند، در تطبیق شکست نخورند. AVPL نتیجه آن حاوی تمام AVPهای داده‌ای است که مطابقت داشته‌اند.

این نوع تطبیق تنها می‌تواند در دستورات Criteria و Transforms مورد استفاده قرار گیرد.

[Note]
توجه

در نسخه فعلی (2.0.1)، تطبیق آزاد (Loose Match) آن‌طور که در اینجا توصیف شده است کار نمی‌کند؛ به گزارش مشکل ۱۲۱۸۴ مراجعه کنید.

مثال‌های تطبیق «همه موارد موجود» (“Every” Match)

عبارت (attr_a=aaa, attr_b=bbb, attr_c=xxx) Match Every (attr_a?, attr_c?) =⇒ نتیجه: (attr_a=aaa, attr_c=xxx)

عبارت (attr_a=aaa, attr_b=bbb, attr_c=xxx) Match Every (attr_a?, attr_c?, attr_d=ddd) =⇒ نتیجه: (attr_a=aaa, attr_c=xxx)

عبارت (attr_a=aaa, attr_b=bbb, attr_c=xxx) Match Every (attr_a?, attr_c=ccc) =⇒ نتیجه: عدم تطبیق (No Match!)

عبارت (attr_a=aaa; attr_b=bbb; attr_c=xxx) Match Every (attr_a=xxx, attr_c=ccc) =⇒ نتیجه: عدم تطبیق (No Match!)

۱۲.۸.۴.۳. تطبیق دقیق (Strict Match)

Section titled “۱۲.۸.۴.۳. تطبیق دقیق (Strict Match)”

یک تطبیق دقیق (Strict match) بین AVPLها اگر و تنها اگر تک‌تک AVPهای موجود در AVPL پیکربندی حداقل یک جفت متناظر در AVPL داده داشته باشند و هیچ‌یک از تطبیق‌های AVP شکست نخورد، با موفقیت انجام می‌شود. AVPL نتیجه حاوی تمام AVPهای داده‌ای است که مطابقت داشته‌اند.

این نوع تطبیق بین کلیدهای GOP (یعنی key AVPLها) و AVPLهای مربوط به PDU به کار می‌رود. همچنین ممکن است در دستورات Criteria و Transforms نیز استفاده شود.

مثال‌ها

عبارت (attr_a=aaa, attr_b=bbb, attr_c=xxx) Match Strict (attr_a?, attr_c=xxx) =⇒ نتیجه: (attr_a=aaa, attr_c=xxx)

عبارت (attr_a=aaa, attr_b=bbb, attr_c=xxx, attr_c=yyy) Match Strict (attr_a?, attr_c?) =⇒ نتیجه: (attr_a=aaa, attr_c=xxx, attr_c=yyy)

عبارت (attr_a=aaa, attr_b=bbb, attr_c=xxx) Match Strict (attr_a?, attr_c=ccc) =⇒ نتیجه: عدم تطبیق (No Match!)

عبارت (attr_a=aaa, attr_b=bbb, attr_c=xxx) Match Strict (attr_a?, attr_c?, attr_d?) =⇒ نتیجه: عدم تطبیق (No Match!)

یک AVPL را می‌توان در یک AVPL دیگر ادغام (merged) کرد. این کار باعث می‌شود تمام AVPهای موجود در اولی که از قبل در دومی وجود ندارند، به دومی اضافه شوند.

این عملیات در موارد زیر انجام می‌گیرد:

  • بین نتیجه یک تطبیق کلید (key match) و AVPLِ مربوط به GOP یا GOG،
  • بین نتیجه یک تطبیق Extra و AVPLِ مربوط به GOP یا GOG،
  • بین نتیجه یک تطبیق Transform و AVPLِ مربوط به PDU/GOP. اگر عملیات مشخص‌شده توسط عبارت Match از نوع Replace باشد، پیش از آنکه modify_avpl در آن ادغام شود، AVPL نتیجه تطبیق از AVPLِ آیتم حذف می‌گردد.

مثال‌ها

عبارت (attr_a=aaa, attr_b=bbb) "merge" (attr_a=aaa, attr_c=xxx): مورد اول تبدیل می‌شود به (attr_a=aaa, attr_b=bbb, attr_c=xxx)

نمی‌توان چندین attr_a با مقدار یکسان "aaa" داشت.

عبارت (attr_a=aaa, attr_b=bbb) "merge" (attr_a=aaa, attr_a=xxx): مورد اول تبدیل می‌شود به (attr_a=aaa, attr_a=xxx, attr_b=bbb)

چندین attr_a با مقادیر متفاوت "aaa" و "xxx".

عبارت (attr_a=aaa, attr_b=bbb) "merge" (attr_c=xxx, attr_d=ddd): مورد اول تبدیل می‌شود به (attr_a=aaa, attr_b=bbb, attr_c=xxx, attr_d=ddd)

تمامی نام‌های AVP یکتا هستند، بنابراین AVPL حاصل شامل تمام AVPها از هر دو AVPL است.

۱۲.۹. مرجع پیکربندی (mate.config)

Section titled “۱۲.۹. مرجع پیکربندی (mate.config)”

AVPLهای پیکربندی زیر با ایجاد PDU و استخراج داده سر و کار دارند.

۱۲.۹.۱.۱. سرآیند بلوک اعلان Pdu

Section titled “۱۲.۹.۱.۱. سرآیند بلوک اعلان Pdu”

در هر فریم از کپچر، MATE به ترتیب ظهور اعلان‌ها در پیکربندی خود به دنبال PDUهای مربوط به proto_name مبدأ می‌گردد و از آن فریم، PDUهایی از هر نوعی که بتواند ایجاد خواهد کرد، مگر آنکه به طور مشخص به آن دستور داده شده باشد که نوع خاصی از PDU آخرین موردی است که باید در فریم جستجو شود. اگر چنین دستوری برای یک نوع مشخص داده شود، MATE تمام PDUهای آن نوع و انواع اعلان‌شده قبلی را که در فریم بیابد استخراج خواهد کرد، اما انواع اعلان‌شده پس از آن را نادیده می‌گیرد.

اعلان کامل یک Pdu به شکل زیر است؛ رعایت ترتیب اجباری عبارت‌های گوناگون به شکلی که نمایش داده شده، الزامی است.

Pdu name Proto proto_name Transport {proto1[/proto2/proto3[/...]|mate}; {
Payload proto; //optional, no default value
Extract attribute From proto.field ; //may occur multiple times, at least once
Transform transform1[, transform2[, ...]]; //optional
Criteria {Accept|Reject} {Strict|Every|Loose} match_avpl; //optional
DropUnassigned {TRUE|FALSE}; //optional, default=FALSE
DiscardPduData {TRUE|FALSE}; //optional, default=FALSE
LastPdu {TRUE|FALSE}; //optional, default=FALSE
};

ویژگی name یک ویژگی اجباری در اعلان Pdu است. این نام به صورت دلخواه انتخاب می‌شود، با این استثنا که هر name را تنها یک بار می‌توان در پیکربندی MATE به کار برد، صرف‌نظر از اینکه برای چه دسته‌ای از آیتم‌ها استفاده می‌شود. از name برای تمایز قائل شدن بین انواع مختلف PDUها، GOPها و GOGها استفاده می‌شود. همچنین از name به‌عنوان بخشی از نام فیلدهای قابل‌فیلتر مرتبط با این نوع PDU که MATE ایجاد می‌کند، استفاده می‌گردد.

با این حال، چندین اعلان Pdu می‌توانند یک name مشترک داشته باشند. در چنین حالتی، تمامی آن‌ها از هر PDU مبدأ که با عبارت‌های Proto، Transport و Payload آن‌ها مطابقت داشته باشد ایجاد می‌شوند، در حالی که بدنه اعلان‌های آن‌ها ممکن است کاملاً با یکدیگر متفاوت باشد. این ویژگی در کنار عبارت‌های Accept (یا Reject) زمانی مفید است که لازم باشد AVPLِ مربوط به PDU، بسته به محتوای (یا صرفِ حضور) سایر فیلدهای مبدأ، از مجموعه‌های متفاوتی از فیلدهای مبدأ ساخته شود.

۱۲.۹.۱.۱.۲. عبارت‌های Proto و Transport
Section titled “۱۲.۹.۱.۱.۲. عبارت‌های Proto و Transport”

هر نمونه از PDU پروتکلِ proto_name در یک فریم، یک PDU به همراه AVPهای استخراج‌شده از فیلدهایی که در محدوده proto_name و/یا محدوده‌های پروتکل‌های زیرین مشخص‌شده توسط فهرست Transport قرار دارند، تولید خواهد کرد. این یک ویژگی اجباری برای اعلان Pdu است. مقدار proto_name همان نام پروتکل است که در فیلتر نمایش وایرشارک به کار می‌رود.

بخش Proto در PDU، و فهرست پروتکل‌های Transport آن که با / از هم جدا شده‌اند، به MATE می‌گویند که کدام فیلدهای یک فریم می‌توانند وارد AVPLِ آن PDU شوند. برای اینکه MATE یک ویژگی را از درخت پروتکل فریم استخراج کند، ناحیه‌ای که آن فیلد را در نمایش هگزادسیمال (hex display) فریم نمایندگی می‌کند باید در داخل ناحیه Proto یا پروتکل‌های Transport نسبی آن قرار داشته باشد. پروتکل‌های Transport با حرکت به سمت عقب از ناحیه پروتکل اصلی، و به ترتیبی که داده شده‌اند انتخاب می‌شوند.

عبارت Proto http Transport tcp/ip دقیقاً همان کاری را انجام می‌دهد که از آن انتظار دارید: نزدیک‌ترین محدوده tcp که پیش از محدوده فعلی http قرار دارد، و نزدیک‌ترین محدوده ip که پیش از آن محدوده tcp قرار دارد را انتخاب می‌کند. اگر یک محدوده ip دیگر پیش از نزدیک‌ترین مورد وجود داشته باشد (مثلاً در حالت تونل‌زنی IP)، آن مورد انتخاب نخواهد شد. عبارت Transport به صورت tcp/ip/ip که «از نظر منطقی» باید سرآیند IP کپسوله‌کننده را نیز انتخاب کند، تاکنون کار نمی‌کند.

پس از آنکه محدوده‌های Proto و Transport را انتخاب کردیم، MATE آن دسته از فیلدهای پروتکل متعلق به آن‌ها را که استخراجشان با استفاده از عبارت‌های Extract برای آن نوع PDU اعلان شده است، واکشی خواهد کرد. فهرست Transport نیز اجباری است؛ اگر واقعاً نمی‌خواهید از هیچ پروتکل انتقالی استفاده کنید، عبارت Transport mate را به کار ببرید (این قابلیت تا نسخه 0.10.9 کار نمی‌کرد).

علاوه بر Proto و پروتکل‌های Transport مربوط به PDU، یک ویژگی Payload نیز وجود دارد تا به MATE بگوید از کدام محدوده‌های بار داده (payload) مربوط به Proto باید فیلدهای فریم را به درون PDU استخراج کند. برای استخراج یک ویژگی از درخت فریم، ناحیه برجسته‌شده (highlighted) آن فیلد در نمایش هگزادسیمال باید در داخل ناحیه بار(های) داده نسبیِ Proto قرار داشته باشد. مقادیر Payload با حرکت به سمت جلو از ناحیه پروتکل اصلی، به ترتیبی که داده شده‌اند انتخاب می‌شوند. عبارت Proto http Transport tcp/ip Payload mmse اولین محدوده mmse پس از محدوده فعلی http را انتخاب خواهد کرد. پس از آنکه محدوده‌های Payload را انتخاب کردیم، MATE آن دسته از فیلدهای پروتکل متعلق به آن‌ها را که استخراجشان با استفاده از عبارت‌های Extract برای آن نوع PDU اعلان شده است، واکشی خواهد کرد.

هر عبارت Extract به MATE می‌گوید که مقدارِ کدام فیلد پروتکل را به‌عنوان یک مقدار AVP استخراج کند و چه رشته‌ای را به‌عنوان نام AVP به کار ببرد. به فیلدهای پروتکل با استفاده از همان نام‌هایی اشاره می‌شود که در فیلترهای نمایش وایرشارک کاربرد دارند. اگر بیش از یکی از چنین فیلدهای پروتکلی در فریم وجود داشته باشد، هر نمونه‌ای که معیارهای بیان‌شده در بالا را برآورده سازد، در AVP مخصوص به خود استخراج می‌شود. نام‌های AVP را می‌توان به دلخواه انتخاب کرد، اما برای اینکه بتوان مقادیری را که در اصل از PDUهای متفاوت می‌آیند (مثلاً نام میزبان از پرس‌وجوی DNS و نام میزبان از درخواست HTTP GET) در مراحل بعدی تحلیل با یکدیگر تطبیق داد، باید نام‌های AVP کاملاً یکسانی به آن‌ها اختصاص داده شود و کالبدشکاف‌ها نیز باید مقادیر فیلدها را با قالب کاملاً یکسانی ارائه دهند (که همیشه این‌طور نیست).

عبارت Transform فهرستی از تبدیل‌های (Transforms) از پیش اعلان‌شده را مشخص می‌کند که باید پس از استخراج شدن تمامی فیلدهای پروتکل به درون AVPLِ مربوط به PDU، روی آن انجام شوند. این فهرست همواره به طور کامل، از چپ به راست اجرا می‌شود. در مقابل، فهرست عبارت‌های Match در داخل هر Transform مجزا، تنها تا زمانی اجرا می‌شود که اولین تطبیق با موفقیت انجام گیرد.

این عبارت به MATE می‌گوید که آیا از PDU برای تحلیل استفاده کند یا خیر. این دستور یک AVPL تطبیق، یک نوع تطبیق AVPL (Strict، Every یا Loose) و عملی را که باید در صورت موفقیت‌آمیز بودن تطبیق انجام شود (Accept یا Reject) مشخص می‌سازد. پس از آنکه تمامی ویژگی‌ها استخراج شدند و فهرست تبدیل‌های احتمالی اجرا گردید، در صورت حضور عبارت Criteria، ساختار AVPLِ مربوط به PDU با AVPL تطبیق مقایسه می‌شود؛ اگر تطبیق با موفقیت صورت گیرد، عمل مشخص‌شده اجرا می‌شود، یعنی PDU پذیرفته (accepted) یا رد (rejected) می‌شود. رفتارهای پیش‌فرضی که در صورت حذف شدن کلمات کلیدی مربوطه استفاده می‌شوند، Strict و Accept هستند. بر همین اساس، اگر کل این عبارت حذف شود، تمامی PDUها پذیرفته می‌شوند.

اگر روی TRUE تنظیم شود، در صورتی که MATE نتواند PDU را به یک GOP اختصاص دهد، آن PDU را از بین خواهد برد. اگر روی FALSE تنظیم شود (مقدار پیش‌فرض در صورت عدم ذکر)، MATE آن‌ها را نگه خواهد داشت.

اگر روی TRUE تنظیم شود، MATE پس از تحلیل کردن PDU و استخراج احتمالی برخی AVPها از آن به درون AVPLِ مربوط به GOP، ساختار AVPLِ آن PDU را حذف خواهد کرد. این ویژگی برای صرفه‌جویی در مصرف حافظه (که MATE مقدار زیادی از آن را مصرف می‌کند) مفید است. اگر روی FALSE تنظیم شود (مقدار پیش‌فرض در صورت عدم ذکر)، MATE ویژگی‌های PDU را نگه خواهد داشت.

اگر روی FALSE تنظیم شود (مقدار پیش‌فرض در صورت عدم ذکر)، MATE به جستجو برای یافتن PDUهایی از انواع دیگر در فریم ادامه خواهد داد. اگر روی TRUE تنظیم شود، دیگر تلاش نخواهد کرد PDUهایی از انواع دیگر از فریم فعلی بسازد، با این حال همچنان تلاش برای یافتن موارد بیشتر از نوعِ فعلی را ادامه خواهد داد.

۱۲.۹.۲.۱. سرآیند بلوک اعلان Gop

Section titled “۱۲.۹.۲.۱. سرآیند بلوک اعلان Gop”

یک نوع Gop و کلید کاندید (candidate key) آن را اعلان می‌کند.

Gop name On pduname Match key {
Start match_avpl; // optional
Stop match_avpl; // optional
Extra match_avpl; // optional
Transform transform_list; // optional
Expiration time; // optional
IdleTimeout time; // optional
Lifetime time; // optional
DropUnassigned [TRUE|FALSE]; //optional
ShowTree [NoTree|PduTree|FrameTree|BasicTree]; //optional
ShowTimes [TRUE|FALSE]; //optional, default TRUE
};

ویژگی name یک ویژگی اجباری در اعلان Gop است. این نام به صورت دلخواه انتخاب می‌شود، با این استثنا که هر name را تنها یک بار می‌توان در پیکربندی MATE به کار برد، صرف‌نظر از اینکه برای چه دسته‌ای از آیتم‌ها استفاده می‌شود. از name برای تمایز قائل شدن بین انواع مختلف PDUها، GOPها و GOGها استفاده می‌شود. همچنین از name به‌عنوان بخشی از نام فیلدهای قابل‌فیلتر مرتبط با این نوع GOP که MATE ایجاد می‌کند، استفاده می‌گردد.

نام (name) مربوط به PDUهایی است که قرار است این نوع از GOP آن‌ها را گروه‌بندی کند. این عبارت اجباری است.

تعریف می‌کند که کدام AVPها بخش کلید (key) از AVPLِ مربوط به GOP را تشکیل می‌دهند (AVPLِ کلید در GOP یا به اختصار کلید GOP). تمامی PDUهایی که با AVPLِ کلید یک GOP فعال مطابقت داشته باشند به آن GOP اختصاص داده می‌شوند؛ یک PDU که حاوی AVPهایی باشد که نام ویژگی‌هایشان در AVPLِ کلید مربوط به GOP فهرست شده است، اما به طور دقیق (strictly) با هیچ‌یک از AVPLهای کلید در GOPهای فعال مطابقت نداشته باشد، یک GOP جدید ایجاد خواهد کرد (مگر آنکه یک عبارت Start داده شده باشد). هنگامی که یک GOP ایجاد می‌شود، عناصرِ AVPL کلید آن از PDU ایجادکننده کپی می‌شوند.

در صورت ذکر شدن، به MATE می‌گوید که AVPLِ یک PDU علاوه بر تطبیق با کلید GOP، باید با چه match_avplای مطابقت داشته باشد تا یک GOP را آغاز کند. در صورت عدم ذکر، هر PDUای که AVPL آن با AVPLِ کلید در GOP مطابقت داشته باشد، به‌عنوان شروع‌کننده یک GOP عمل خواهد کرد. AVPهای مربوط به PDU که با match_avpl مطابقت دارند، به طور خودکار در AVPLِ مربوط به GOP کپی نمی‌شوند.

در صورت ذکر شدن، به MATE می‌گوید که AVPLِ یک PDU علاوه بر تطبیق با کلید GOP، باید با چه match_avplای مطابقت داشته باشد تا یک GOP را متوقف کند. در صورت حذف شدن، GOP به صورت «خودکار متوقف» (auto-stopped) می‌شود؛ یعنی به محض ایجاد شدن، به‌عنوان متوقف‌شده علامت‌گذاری می‌گردد. AVPهای مربوط به PDU که با match_avpl مطابقت دارند، به طور خودکار در AVPLِ مربوط به GOP کپی نمی‌شوند.

در صورت ذکر شدن، به MATE می‌گوید که علاوه بر کلید GOP، کدام AVPها از AVPLِ مربوط به PDU باید به درون AVPLِ مربوط به GOP کپی شوند.

عبارت Transform فهرستی از تبدیل‌های (Transforms) از پیش اعلان‌شده را مشخص می‌کند که باید پس از ادغام شدن AVPهای هر PDU جدید (مشخص‌شده توسط AVPLِ کلید و match_avpl در عبارت Extra)، روی AVPLِ مربوط به GOP اجرا شوند. این فهرست همواره به طور کامل، از چپ به راست اجرا می‌شود. در مقابل، فهرست عبارت‌های Match در داخل هر Transform مجزا، تنها تا زمانی اجرا می‌شود که اولین تطبیق با موفقیت انجام گیرد.

یک عدد (اعشاری/شناور) بر حسب ثانیه پس از متوقف شدن (Stop) یک GOP است که در طول آن مدت، PDUهای بعدی که با کلیدِ GOP متوقف‌شده مطابقت دارند اما با شرط Start منطبق نیستند، همچنان به همان GOP اختصاص خواهند یافت. مقدار پیش‌فرضِ صفر در واقع به معنای بی‌نهایت است، زیرا این زمان‌سنج را غیرفعال می‌کند؛ بنابراین تمام PDUهای منطبق با کلیدِ GOP متوقف‌شده، به همان GOP اختصاص خواهند یافت مگر آنکه با شرط Start مطابقت داشته باشند.

یک عدد (اعشاری/شناور) بر حسب ثانیه سپری‌شده از آخرین PDU اختصاص‌یافته به GOP است که پس از گذشت آن، GOP آزادشده (released) تلقی خواهد شد. مقدار پیش‌فرضِ صفر در واقع به معنای بی‌نهایت است، زیرا این زمان‌سنج را غیرفعال می‌کند؛ بنابراین حتی اگر هیچ PDU جدیدی نرسد نیز GOP آزاد نخواهد شد، مگر آنکه زمان‌سنج Lifetime منقضی شود.

یک عدد (اعشاری/شناور) بر حسب ثانیه پس از شروع (Start) یک GOP است که پس از گذشت آن، GOP صرف‌نظر از هر چیز دیگری، آزادشده تلقی خواهد شد. مقدار پیش‌فرضِ صفر در واقع به معنای بی‌نهایت است.

مشخص می‌کند که آیا یک GOP که به هیچ GOGای اختصاص نیافته است باید دور ریخته شود یا خیر. اگر TRUE باشد، GOP بلافاصله پس از ایجاد شدن دور ریخته می‌شود. اگر FALSE باشد (مقدار پیش‌فرض)، GOPِ تخصیص‌نیافته نگه داشته می‌شود. تنظیم کردن آن روی TRUE به صرفه‌جویی در حافظه و افزایش سرعت فیلتر کردن کمک می‌کند.

نمایش زیردرختِ مربوط به PDUهای یک GOP را کنترل می‌کند:

  • مقدار NoTree: نمایش درخت را به طور کامل متوقف و مخفی می‌کند.
  • مقدار PduTree: درخت نمایش داده می‌شود و PDUها را بر اساس شناسه PDU (PDU Id) نشان می‌دهد.
  • مقدار FrameTree: درخت نمایش داده می‌شود و PDUها را بر اساس شماره فریمی که در آن قرار دارند نشان می‌دهد.
  • مقدار BasicTree: نیاز به بررسی بیشتر دارد.

مشخص می‌کند که آیا زیردرختِ زمان‌ها (times subtree) مربوط به GOP نمایش داده شود یا خیر. اگر TRUE باشد (مقدار پیش‌فرض)، زیردرخت حاوی زمان‌سنج‌ها به درخت GOP اضافه می‌شود. اگر FALSE باشد، نمایش این زیردرخت متوقف و مخفی می‌گردد.

۱۲.۹.۳.۱. سرآیند بلوک اعلان Gog

Section titled “۱۲.۹.۳.۱. سرآیند بلوک اعلان Gog”

یک نوع Gog و کلید کاندید (candidate key) آن را اعلان می‌کند.

Gog name {
Member gopname (key); // mandatory, at least one
Extra match_avpl; // optional
Transform transform_list; // optional
Expiration time; // optional, default 2.0
GopTree [NoTree|PduTree|FrameTree|BasicTree]; // optional
ShowTimes [TRUE|FALSE]; // optional, default TRUE
};

ویژگی name یک ویژگی اجباری در اعلان Gog است. این نام به صورت دلخواه انتخاب می‌شود، با این استثنا که هر name را تنها یک بار می‌توان در پیکربندی MATE به کار برد، صرف‌نظر از اینکه برای چه دسته‌ای از آیتم‌ها استفاده می‌شود. از name برای تمایز قائل شدن بین انواع مختلف PDUها، GOPها و GOGها استفاده می‌شود. همچنین از name به‌عنوان بخشی از نام فیلدهای قابل‌فیلتر مرتبط با این نوع GOG که MATE ایجاد می‌کند، استفاده می‌گردد.

ساختار AVPLِ کلید (key) برای GOG را به طور مجزا برای هر نوع GOP با نام gopname تعریف می‌کند. تمامی GOPهای از نوع gopname که AVPLِ کلید آن‌ها با AVPLِ کلید متناظر در یک GOG فعال مطابقت داشته باشد، به آن GOG اختصاص داده می‌شوند؛ یک GOP که حاوی AVPهایی باشد که نام ویژگی‌هایشان در AVPLِ کلید متناظر در GOG فهرست شده است، اما به طور دقیق (strictly) با هیچ‌یک از AVPLهای کلید در GOGهای فعال مطابقت نداشته باشد، یک GOG جدید ایجاد خواهد کرد. هنگامی که یک GOG ایجاد می‌شود، عناصرِ AVPLِ کلید آن از GOP ایجادکننده کپی می‌شوند.

اگرچه AVPLهای کلید به صورت جداگانه برای هر یک از gopnameهای بخش Member مشخص می‌شوند، اما در اکثر موارد کاملاً با هم یکسان هستند، چرا که هدف اصلی یک GOG، گروه‌بندی کردن GOPهایی است که از PDUهایی با انواع مختلف ساخته شده‌اند.

در صورت ذکر شدن، به MATE می‌گوید که علاوه بر کلید GOG، کدام AVPها از هر یک از AVPLهای مربوط به GOP باید به درون AVPLِ مربوط به GOG کپی شوند.

یک عدد (اعشاری/شناور) بر حسب ثانیه پس از آزاد شدن (released) تمامی GOPهای اختصاص‌یافته به یک GOG است که در طول آن مدت، GOPهای جدیدی که با هر یک از کلیدهای نشست مطابقت داشته باشند، به جای ایجاد یک GOG جدید، همچنان باید به همان GOG موجود اختصاص یابند. مقدار آن می‌تواند در بازه ۰.۰ تا بی‌نهایت باشد. مقدار پیش‌فرض ۲.۰ ثانیه است.

عبارت Transform فهرستی از تبدیل‌های (Transforms) از پیش اعلان‌شده را مشخص می‌کند که باید پس از ادغام شدن AVPهای هر GOP جدید (مشخص‌شده توسط AVPLِ کلید و match_avpl در عبارت Extra)، روی AVPLِ مربوط به GOG اجرا شوند. این فهرست همواره به طور کامل، از چپ به راست اجرا می‌شود. در مقابل، فهرست عبارت‌های Match در داخل هر Transform مجزا، تنها تا زمانی اجرا می‌شود که اولین تطبیق با موفقیت انجام گیرد.

نمایش زیردرختِ مربوط به GOPهای یک GOG را کنترل می‌کند:

  • مقدار NoTree: نمایش درخت را به طور کامل متوقف و مخفی می‌کند.
  • مقدار BasicTree: نیاز به بررسی بیشتر دارد.
  • مقدار FullTree: نیاز به بررسی بیشتر دارد.

مشخص می‌کند که آیا زیردرختِ زمان‌ها (times subtree) مربوط به GOG نمایش داده شود یا خیر. اگر TRUE باشد (مقدار پیش‌فرض)، زیردرخت حاوی زمان‌سنج‌ها به درخت GOG اضافه می‌شود. اگر FALSE باشد، نمایش این زیردرخت متوقف و مخفی می‌گردد.

یک Transform (تبدیل)، دنباله‌ای از قوانین Match (تطبیق) است که به صورت اختیاری با دستورالعملی درباره نحوه تغییر دادن نتیجه تطبیق با استفاده از یک AVPL اضافی دنبال می‌شود. چنین تغییری می‌تواند یک Insert (درج/ادغام) یا یک Replace (جایگزینی) باشد. نحو (syntax) آن به شرح زیر است:

Transform name {
Match [Strict|Every|Loose] match_avpl [[Insert|Replace] modify_avpl] ; // may occur multiple times, at least once
};

برای مشاهده مثال‌هایی از Transforms، صفحه راهنما (Manual) را بررسی کنید.

TODO:‏ آیا مثال‌ها به اینجا منتقل شوند؟

فهرست قوانین Match در داخل یک Transform از بالا به پایین پردازش می‌شود؛ این پردازش به محض آنکه یکی از قوانین Match با موفقیت انجام گیرد یا تمامی موارد بدون نتیجه امتحان شوند، به پایان می‌رسد.

از تبدیل‌ها می‌توان به‌عنوان ابزارهای کمکی برای دستکاری AVPLِ یک آیتم پیش از پردازش‌های بعدی روی آن آیتم استفاده کرد. اعلان یک آیتم ممکن است حاوی یک عبارت Transform باشد که فهرستی از تبدیل‌های از پیش اعلان‌شده را نشان می‌دهد. صرف‌نظر از اینکه تبدیل‌های تک‌تکِ موارد با موفقیت همراه باشند یا شکست بخورند، این فهرست همواره به طور کامل و به ترتیب داده‌شده، یعنی از چپ به راست، اجرا می‌شود.

در فایل پیکربندی MATE، یک Transform باید پیش از اعلانِ هر آیتمی که از آن استفاده می‌کند، اعلان شده باشد.

۱۲.۹.۵. ساختار AVPL پیکربندی Settings

Section titled “۱۲.۹.۵. ساختار AVPL پیکربندی Settings”
[Note]
توجه

پارامترهای Settings به سایر پارامترهای پیکربندی منتقل شده‌اند یا منسوخ گردیده‌اند. فعلاً تا زمانی که بقیه مستندات برای نحو (syntax) فعلی به‌روزرسانی شوند، به همین شکل باقی می‌مانند.

عنصر پیکربندی Settings برای ارسال پارامترهای عملیاتی گوناگون به MATE به کار می‌رود. پارامترهای ممکن عبارتند از:

۱۲.۹.۵.۱. پارامتر GogExpiration

Section titled “۱۲.۹.۵.۱. پارامتر GogExpiration”

مشخص می‌کند چه مدت بر حسب ثانیه پس از آزاد شدن تمامی GOPهای اختصاص‌یافته به یک GOG، GOPهای جدیدی که با هر یک از کلیدهای نشست مطابقت دارند باید به جای اختصاص یافتن به GOG قبلی، یک GOG جدید ایجاد کنند. مقدار آن می‌تواند از ۰.۰ تا بی‌نهایت باشد. مقدار پیش‌فرض ۲.۰ ثانیه است.

۱۲.۹.۵.۲. پارامتر DiscardPduData

Section titled “۱۲.۹.۵.۲. پارامتر DiscardPduData”

مشخص می‌کند که آیا AVPLِ هر PDU باید پس از پردازش شدن حذف شود یا خیر (باعث صرفه‌جویی در حافظه می‌شود). مقدار آن می‌تواند TRUE یا FALSE باشد. مقدار پیش‌فرض TRUE است. تنظیم کردن آن روی FALSE در مواقعی که پیکربندی شما کار نمی‌کند، می‌تواند شما را از سردرگمی و دردسر نجات دهد.

۱۲.۹.۵.۳. پارامتر DiscardUnassignedPdu

Section titled “۱۲.۹.۵.۳. پارامتر DiscardUnassignedPdu”

مشخص می‌کند که آیا PDUها در صورتی که به هیچ GOPای اختصاص نیابند باید حذف شوند یا خیر. مقدار آن می‌تواند TRUE یا FALSE باشد. مقدار پیش‌فرض FALSE است. اگر PDUهای تخصیص‌نیافته بی‌استفاده هستند، برای صرفه‌جویی در حافظه آن را روی TRUE تنظیم کنید.

۱۲.۹.۵.۴. پارامتر DiscardUnassignedGop

Section titled “۱۲.۹.۵.۴. پارامتر DiscardUnassignedGop”

مشخص می‌کند که آیا GOPها در صورتی که به هیچ نشستی (GOG) اختصاص نیابند باید حذف شوند یا خیر. مقدار آن می‌تواند TRUE یا FALSE باشد. مقدار پیش‌فرض FALSE است. تنظیم کردن آن روی TRUE باعث صرفه‌جویی در مصرف حافظه می‌شود.

۱۲.۹.۵.۶. پارامتر ShowGopTimes

Section titled “۱۲.۹.۵.۶. پارامتر ShowGopTimes”

۱۲.۹.۶. موارد اشکال‌زدایی (Debugging Stuff)

Section titled “۱۲.۹.۶. موارد اشکال‌زدایی (Debugging Stuff)”

تنظیمات زیر برای اشکال‌زدایی (debug) موتور MATE و پیکربندی آن به کار می‌روند. تمامی سطوح، اعداد صحیحی در بازه ۰ (فقط چاپ خطاها) تا ۹ (بمباران اطلاعاتی با جزئیات کامل) هستند و مقدار پیش‌فرض آن‌ها ۰ است.

۱۲.۹.۶.۱. سرآیند بلوک اعلان Debug

Section titled “۱۲.۹.۶.۱. سرآیند بلوک اعلان Debug”
Debug {
Filename "path/name"; //optional, no default value
Level [0-9]; //optional, generic debug level
Pdu Level [0-9]; //optional, specific debug level for Pdu handling
Gop Level [0-9]; //optional, specific debug level for Gop handling
Gog Level [0-9]; //optional, specific debug level for Gog handling
};

عبارت {{{path/name}}} مسیر کامل فایلی است که خروجی اشکال‌زدایی باید در آن نوشته شود. اگر فایل وجود نداشته باشد ایجاد خواهد شد، و اگر از قبل موجود باشد با هر بار باز کردن یک فایل کپچر، بازنویسی (overwrite) می‌شود. در صورت عدم وجود این دستور، پیام‌های اشکال‌زدایی در کنسول نوشته می‌شوند؛ که بدین معناست که در سیستم‌عامل ویندوز نامرئی و غیرقابل‌مشاهده خواهند بود.

سطح اشکال‌زدایی را برای پیام‌های اشکال‌زدایی عمومی تنظیم می‌کند. این مقدار یک عدد صحیح در بازه ۰ (فقط چاپ خطاها) تا ۹ (چاپ حداکثر جزئیات) است.

سطح اشکال‌زدایی را برای پیام‌های مربوط به ایجاد PDU تنظیم می‌کند. این مقدار یک عدد صحیح در بازه ۰ (فقط چاپ خطاها) تا ۹ (چاپ حداکثر جزئیات) است.

سطح اشکال‌زدایی را برای پیام‌های مربوط به تحلیل PDU (یعنی اینکه چگونه در GOPها جای می‌گیرند) تنظیم می‌کند. این مقدار یک عدد صحیح در بازه ۰ (فقط چاپ خطاها) تا ۹ (چاپ حداکثر جزئیات) است.

سطح اشکال‌زدایی را برای پیام‌های مربوط به تحلیل GOP (یعنی اینکه چگونه در GOGها جای می‌گیرند) تنظیم می‌کند. این مقدار یک عدد صحیح در بازه ۰ (فقط چاپ خطاها) تا ۹ (چاپ حداکثر جزئیات) است.

Action=Settings; SessionExpiration=3.5; DiscardPduData=FALSE;

یک فایل را در پیکربندی فعلی وارد (include) می‌کند.

Action=Include; {Filename=filename;|Lib=libname;}

نام فایلی که باید وارد شود. اگر با / شروع نشود، به دنبال آن فایل در مسیر فعلی خواهد گشت.

نام پیکربندی کتابخانه‌ای که باید وارد شود. به دنبال فایل libname.mate در مسیر wiresharks_dir/matelib خواهد گشت.

Action=Include; Filename=rtsp.mate;

این دستور فایلِ موسوم به "rtsp.mate" را در پیکربندی فعلی وارد خواهد کرد.

ترجمه فارسی Wireshark User's Guide — بر اساس نسخه 5.1.0تحت مجوز GNU GPL v2نسخه رسمی انگلیسی:wireshark.org