توقيع التعليمات البرمجية باستخدام Azure DevOps

يقدم هذا البرنامج التعليمي مقدمة حول توقيع التعليمات البرمجية باستخدام Azure DevOps ، باستخدام شهادة مخزنة في Azure Key Vault. لاتباع هذه التعليمات سوف تحتاج:

• An حساب Azure
• A مشروع DevOps
• A مفتاح Vault
• A شهادة توقيع الرمز مثبتة في Key Vault الخاص بك. يمكنك إما:
  • توليد CSR وتثبيت شهادة في Key Vault or
  • قم باستيراد شهادة في Key Vault

قم بتسجيل تطبيق Azure

أولاً ، ستحتاج إلى تسجيل تطبيق Azure جديد حتى تتمكن من الاتصال بـ Key Vault للتوقيع.

1. قم بتسجيل الدخول إلى بوابة أزور.
   
2. انتقل إلى أزور أكتيف ديركتوري. (انقر المزيد من الخدمات إذا لم تكن أيقونة Azure Active Directory مرئية.)
   
3. انقر تسجيلات التطبيق، في العمود الأيمن.
   
4. انقر تسجيل جديد.
   
5. امنح طلبك أ الاسم وانقر فوق تسجيل زر. اترك الإعدادات الأخرى على قيمها الافتراضية.
   
6. تم تسجيل تطبيقك الجديد. انسخ واحفظ القيمة المعروضة لـ معرف التطبيق (العميل)، لأنك ستحتاج إليها لاحقًا.
   

قم بإنشاء سر العميل

بعد ذلك ، قم بإنشاء سر العميل ، والذي سيكون بمثابة بيانات اعتماد عند التوقيع.

1. انقر الشهادات والأسرار في القائمة اليسرى.
   
2. انقر سر العميل الجديد.
   
3. امنح العميل سرًا أ الوصف، قم بتعيين انتهاء الصلاحية حسب الرغبة ، وانقر فوق أضف .
   
4. نسخ القيم من سر عميلك الجديد فورا واحفظه في مكان آمن. في المرة التالية التي يتم فيها تحديث الصفحة ، سيتم إخفاء هذه القيمة ولا يمكن استرجاعها.
   
   

تفعيل الوصول في Key Vault

الآن ، ستحتاج إلى تمكين الوصول لتطبيقك في Azure Key Vault.

1. انتقل إلى Key Vault الذي يحتوي على الشهادة التي تريد استخدامها للتوقيع وانقر فوق سياسات الوصول الرابط.
   
2. انقر أضف نهج الوصول.
   
3. تحت أذونات المفتاح، تمكين Verify,  Sign, Getو List.
   
4. تحت أذونات سرية، تمكين Get و List.
   
5. تحت أذونات الشهادة، تمكين Get و List.
   
6. انقر على لم يتم تحديد أي منها رابط تحت حدد رأس المال، ثم استخدم حقل البحث لتحديد التطبيق الذي أنشأته في القسم السابق وتحديده.
   
7. انقر على أختار .
   
8. انقر على أضف .
   
9. انقر حفظ.
   
10. تم تعيين سياسة الوصول الخاصة بك.
    

تكوين DevOps Build

الآن يمكنك تكوين البناء الخاص بك. افتح مشروعك في Azure DevOps.

تخزين أوراق اعتماد التطبيق كمتغيرات

يمكنك تضمين معرّف التطبيق وسر العميل مباشرةً في ملف خط أنابيب YAML الخاص بك ، ولكنه يكون أكثر أمانًا إذا قمت بتخزينهما كمتغيرات في DevOps.

1. انقر خطوط الأنابيب.
   
2. انقر المكتبة.
   
3. انقر + مجموعة متغيرة.
   
4. امنح مجموعتك المتغيرة اسمًا.
   
5. انقر أضف.
   
6. أدخل اسمًا متغيرًا لمعرف التطبيق الخاص بك ، ثم الصق القيمة. انقر فوق القفل لتشفير المتغير عند الانتهاء.
   
7. كرر العملية لإضافة متغير لسر العميل.
   
8. انقر حفظ.
   
9. اربط المجموعة المتغيرة في خط الأنابيب الخاص بك. (استبدل VARIABLE-GROUP باسم مجموعة المتغيرات الفعلية الخاصة بك.)

   المتغيرات: - المجموعة: VARIABLE-GROUP

أضف خطوة خط أنابيب لتثبيت أداة تسجيل Azure

أداة تسجيل Azure هي أداة مفتوحة المصدر تقدم أداة SignTool وظائف الشهادات والمفاتيح المخزنة في Azure Key Vault. أضف الخطوة التالية في خط الأنابيب لتثبيت أداة تسجيل Azure:

- المهمة: DotNetCoreCLI @ 2 المدخلات: الأمر: "مخصص": وسيطات "الأداة": اسم العرض "install --global azuresigntool": تثبيت AzureSignTool

أضف أمر أداة Azure Sign إلى خط الأنابيب

1. الآن يمكنك إضافة مهمة لتسجيل التعليمات البرمجية الخاصة بك إلى خط الأنابيب. سوف تحتاج إلى المعلومات التالية:
   • حل متجر العقارات الشامل الخاص بك في جورجيا مفتاح Vault URI (متوفر في بوابة Azure):
     
   • الاسم المألوف لشهادتك في Key Vault:
     
   • حل متجر العقارات الشامل الخاص بك في جورجيا معرف التطبيق و سر العميل أسماء المتغيرات:
     
2. أضف استدعاء أداة Azure Sign إلى خط الأنابيب الخاص بك. استبدل القيم الموضحة في ALL-CAPS بقيمك الفعلية:

   - المهمة: CmdLine @ 2 المدخلات: البرنامج النصي: AzureSignTool sign -kvu "KEY-VAULT-URI" -kvi "$ (APPLICATION-ID-VAR)" -kvs "$ (CLIENT-SECRET-VAR)" -KVC CERTIFICATE-NAME -tr "http://ts.ssl.com" -td sha256 "FILE-TO-SIGN" displayName: Sign Code

3. يجب أن ترى مثل هذا الإخراج إذا تم التوقيع بنجاح:

   info: AzureSignTool.Program [0] => الملف: D: \ a \ 1 \ s \ x64 \ Debug \ HelloWorld.exe ملف التوقيع D: \ a \ 1 \ s \ x64 \ Debug \ HelloWorld.exe info: AzureSignTool. البرنامج [0] => الملف: D: \ a \ 1 \ s \ x64 \ Debug \ HelloWorld.exe تم التوقيع بنجاح للملف D: \ a \ 1 \ s \ x64 \ Debug \ HelloWorld.exe.