إنشاء تذاكر للتحقق من الوضعية الفاشلة

المتطلبات السابقة

• مستخدم يحمل صلاحيات تصفح الأماكن و إنشاء عناصر العمل

الخطوة 1: إعداد التكوينات المطلوبة في Jira

لتكوين الإعدادات في Jira:

1. في حسابك في Atlassian، انقر فوق ملفك الشخصي في الزاوية العليا اليمنى واضغط على إعدادات الحساب.

2. على علامة التبويب الأمان، في قسم رموز API، اضغط على إنشاء وإدارة رموز API.

3. يمكنك إنشاء رمز API إما بمحيط أو بدون محيط:

   1. لإنشاء رمز API بمحيط:

      1. انقر على إنشاء رمز API بمحيط.

      2. أضف اسمًا وتاريخ انتهاء الصلاحية.
         ملاحظة: نوصي بتحديد تاريخ انتهاء الصلاحية الأقصى لـ 365 يومًا.

      3. انقر التالي واختر تطبيق Jira

      4. انقر التالي واختر نطاق write:jira-work

      5. انقر على إنشاء.

   2. لإنشاء رمز API بدون نطاقات:

      1. انقر على إنشاء رمز API.

      2. أضف اسمًا وتاريخ انتهاء الصلاحية.
         ملاحظة: نوصي باختيار الحد الأقصى لتاريخ انتهاء الصلاحية وهو 365 يومًا.

      3. انقر على إنشاء.

4. انسخ واحفظ الرمز ليمكن إدخاله في CMA.

5. في حساب Atlassian الخاص بك، على الشريط الجانبي، انقر على الثلاث نقاط بجانب المساحات.

6. انقر إدارة المساحات.

7. انسخ واحفظ المفتاح للفضاء حيث ترغب في إنشاء التذاكر ليتم إدخالها في CMA.

8. إذا قمت بإنشاء رمز مع نطاقات، في متصفح الويب، أدخل https://<your-site>.atlassian.net/_edge/tenant_info و انسخ قيمة cloudId ليتم إدخالها في CMA.
   إذا لم تنشئ رمزًا بنطاق، فإن هذه الخطوة غير ضرورية.

الخطوة 2: تكوين Webhook في CMA

لتكوين Webhook في CMA:

1. في CMA، انتقل إلى حساب > الاشتراكات.

2. في علامة التبويب Webhooks، انقر جديد.

3. أضف اسمًا.

4. من قائمة البدء من النموذج المنسدلة، اختر Jira إنشاء تذكرة فحص الوضع.

5. في حقل URL:

   1. لرمز API مع نطاقات: https://api.atlassian.com/ex/jira/<cloudId>/rest/api/2/issue، حيث <cloudId> هو الcloudId الذي نسخته في الخطوة 1.

   2. لرمز API بدون نطاقات: https://<your-site>.atlassian.net/rest/api/2/issue، حيث <your-site> هو اسم موقع Jira الخاص بك.

6. أضف اسم المستخدم للمستخدم الذي أنشأ رمز API في الخطوة 1.

7. في حقل كلمة المرور، أدخل مفتاح API الذي أنشأته في الخطوة 1.

8. في قسم الجسم المخصص، استبدل <YOUR-SPACE-KEY> بمفتاح الفضاء الذي نسخته في الخطوة 1.

9. (اختياري) إذا لم يستخدم فضاؤك نوع العمل المهمة، أو يحتاج إلى حقول إضافية لعناصر العمل الجديدة، قم بتحرير الجسم وفقًا لذلك.

10. انقر اختبار.
    يتم إنشاء عنصر عمل اختبار في مساحة Jira، ويتم عرض الرسالة "الاختبار نجح بنجاح". يمكنك حذف عنصر العمل الاختباري فيما بعد.

11. انقر حفظ.

الشروط المسبقة

• المستخدم ذو الدور itil

الخطوة 1: تكوين الإعدادات المطلوبة في ServiceNow

لتهيئة الإعدادات في ServiceNow:

1. قم بتسجيل الدخول إلى حسابك في ServiceNow كمسؤول وانتقل إلى إدارة المستخدمين > المستخدمون.

2. انقر على جديد.

3. قم بإدخال معرف المستخدم وعنوان البريد الإلكتروني واختر وصول خدمة الإنترنت فقط.

4. انقر على إرسال.

5. افتح سجل المستخدم الذي أنشأته:

   1. انقر تعيين كلمة مرور ثم قم بتوليد كلمة مرور. قم بنسخ وحفظ كلمة المرور لتتمكن من إدخالها في CMA.

   2. انقر على احفظ كلمة المرور.  

   3. في علامة تبويب الأدوار، انقر على تحرير وأضف دور ITIL.

   4. انقر حفظ

الخطوة 2: تكوين الويبه هوك في CMA

لتكوين الويبه هوك في CMA:

1. في CMA، انتقل إلى الحساب > الاشتراكات.

2. في علامة التبويب الويبه هوك، انقر على جديد.

3. أضف اسم.

4. من القائمة المنسدلة ابدأ من النموذج، اختر تذكرة فحص الوضع ServiceNow Create Posture Check Ticket.

5. في حقل عنوان URL، استبدل <YOUR-INSTANCE-NAME> باسم مثيل ServiceNow الخاص بك، بحيث يكون عنوان URL هو https://<instance>.service-now.com/api/now/table/incident.

   اسم مثيلك هو الجزء الأول من عنوان URL الخاص بـ ServiceNow. على سبيل المثال، إذا قمت بتسجيل الدخول إلى https://acme.service-now.com، فإن اسم المثيل هو acme، والعنوان URL هو https://acme.service-now.com/api/now/table/incident.

6. في حقل اسم المستخدم، أدخل معرف المستخدم الخاص بـ ServiceNow الذي قمت بإنشائه في الخطوة 1.

7. في حقل كلمة المرور، أدخل كلمة المرور الخاصة بـ ServiceNow المستخدم الذي أنشأته في الخطوة 1.

8. (اختياري) في قسم الجسم المخصص، قم بتغيير الأولوية الافتراضية، الاستعجال والتأثير للحوادث، أو أضف حقول مثل مجموعة التعيين.

9. انقر اختبار.
   تم إنشاء حادث اختبار في ServiceNow، ويتم عرض رسالة "اختبار نجح بنجاح". يمكنك حل أو إغلاق عنصر العمل الاختباري بعد ذلك.

10. انقر حفظ.

إذا فشل إنشاء التذكرة، تظهر رسالة الخطأ حالة النظام التي تم إرجاعها:

• 401 (غير مصرح): بيانات الاعتماد غير صحيحة أو انتهت صلاحية الرمز. تحقق من حقول اسم المستخدم وكلمة المرور للويب هوك، ثم انقر اختبار. بالنسبة لـ Jira، استخدم عنوان البريد الإلكتروني للموظف ورمز API. إذا انتهت صلاحية الرمز، قم بإنشاء رمز جديد وقم بتحديث حقل كلمة مرور الويب هوك.

• 403 (ممنوع): المستخدم ليس لديه الأذونات المطلوبة. بالنسبة لـ Jira، تأكد أن المستخدم يمتلك الأذونات الخاصة بـ استعراض المساحات وإنشاء عناصر العمل في المساحة ذات الصلة. بالنسبة لـ ServiceNow، تأكد أن المستخدم يمتلك الدور itil.

• 400 (طلب غير صالح): النظام رفض جسم الطلب. تحقق من وجود مفتاح مساحة غير صحيح أو حقل مطلوب مفقود في الجسم المخصص.

• معرف التذكرة مفقود: تم إنشاء التذكرة، لكن Cato لم يتمكن من قراءة المعرف من الرد. تحقق أن تطابق تعيين الرد الخاص بالويب هوك يلائم القالب.