تكوين المستخدمين الداخليين من خلال إستدعاءات JSON أو XML و API في ISE 3.3 مع Insominia

المقدمة

يصف هذا المستند تكوين المستخدمين الداخليين في Cisco ISE من خلال الاستفادة من تنسيقات بيانات JSON أو XML بالاقتران مع مكالمات API.

المتطلبات الأساسية

• معيار ISE 3. 0 أو أعلى.
• برنامج عميل واجهة برمجة التطبيقات.

المكونات المستخدمة

• ISE 3.3

• Insominia 9.3.2

تم إنشاء المعلومات الواردة في هذا المستند من الأجهزة الموجودة في بيئة معملية خاصة. بدأت جميع الأجهزة المُستخدمة في هذا المستند بتكوين ممسوح (افتراضي). إذا كانت شبكتك قيد التشغيل، فتأكد من فهمك للتأثير المحتمل لأي أمر.

الرسم التخطيطي للشبكة

طوبولوجيا عامة

GET و POST هما أسلوبان من أكثر أساليب HTTP شيوعا المستخدمة في مكالمات API (واجهة برمجة التطبيقات). يتم إستخدامها للتفاعل مع الموارد الموجودة على الخادم، عادة لاسترداد البيانات أو إرسال البيانات لمعالجتها.

الحصول على مكالمة API

يتم إستخدام أسلوب GET لطلب البيانات من مورد محدد. تعد طلبات GET أكثر الطرق شيوعا وأكثرها إستخداما في واجهات برمجة التطبيقات ومواقع الويب. عندما تقوم بزيارة صفحة ويب، يقوم المستعرض الخاص بك بإجراء طلب GET إلى الخادم الذي يستضيف صفحة الويب.

إستدعاء Post API

يستخدم أسلوب POST لإرسال البيانات إلى الخادم لإنشاء مورد أو تحديثه. غالبا ما يتم إستخدام طلبات الترحيل عند إرسال بيانات النموذج أو تحميل ملف.

التكوينات

نحتاج إلى إرسال المعلومات الدقيقة من برنامج عميل واجهة برمجة التطبيقات (API) إلى عقدة ISE لإنشاء مستخدم داخلي.

تكوينات ISE

قم بتمكين ميزة ERS.

1. انتقل إلى إدارة > نظام > إعدادات > إعدادات واجهة برمجة التطبيقات > إعدادات خدمة API.

2. قم بتمكين خيار ERS (قراءة/كتابة).

إعدادات API

طلب JSON.

1. الأرق المفتوح.
2. قم بإضافة طلب HTTPS جديد على الجانب الأيسر.

طلب JSON

3. يجب إختيار POST لإرسال المعلومات إلى عقدة ISE.

يعتمد URL الذي تحتاج إلى إدخاله على عنوان IP الخاص بعقدة ISE لديك.

URL: https://x.x.x.x/ers/config/internaluser

جون بوست

4. ثم انقر فوق نص واختر JSON

جي إس بي

5. يمكنك لصق الصياغة وتغيير المعلمات وفقا لما تريده.

بناء جملة JSON

بناء جملة JSON

{

  "InternalUser": {

    "name": "name",

    "description": "description",

    "enabled": true,

    "email": "email@domain.com",

    "accountNameAlias": "accountNameAlias",

    "password": "password",

    "firstName": "firstName",

    "lastName": "lastName",

    "changePassword": true,

    "identityGroups": "identityGroups",

    "passwordNeverExpires": false,

    "daysForPasswordExpiration": 60,

    "expiryDateEnabled": false,

    "expiryDate": "2016-12-11",

    "enablePassword": "enablePassword",

    "dateModified": "2015-12-20",

    "dateCreated": "2015-12-15",

    "customAttributes": {

      "key1": "value1",

      "key2": "value3"

    },

    "passwordIDStore": "Internal Users"

  }

}

6. انقر المصادقة واختر أساسي.

جاسون أوث

7. أدخل بيانات اعتماد واجهة المستخدم الرسومية (GUI) ل ISE.

بيانات اعتماد Admin JSON

8. انقر فوق رؤوس لإضافة الأساليب التالية:
   • نوع المحتوى: التطبيق/json
   • قبول: الطلب/json

JSON Headers

9. أخيرا، انقر إرسال.

التحقق من الصحة

1. بعد إرسال طلب POST، سترى الحالة "تم إنشاء 201". وهذا يعني أن العملية قد اكتملت بنجاح.

تم بنجاح طلب JSON

2. افتح واجهة المستخدم الرسومية ISE وانتقل إلى الإدارة > إدارة الهوية > الهويات > المستخدمين > مستخدمي الوصول إلى الشبكة

حساب مستخدم JSON

طلب XML

1. الأرق المفتوح.
2. قم بإضافة طلب HTTPS جديد على الجانب الأيسر.

طلب XML

3. يجب إختيار POST لإرسال المعلومات إلى عقدة ISE.

يعتمد URL الذي تحتاج إلى إدخاله على عنوان IP الخاص بعقدة ISE لديك.

url: https://x.x.x.x/ers/config/internaluser

نشر XML

4. ثم انقر المتن واختر XML.

نص XML

5. يمكنك لصق الصياغة وتغيير المعلمات وفقا لما تريده.

XML Post

صياغة XML

<?xml version="1.0" encoding="UTF-8"?>

<ns0:internaluser xmlns:ns0="identity.ers.ise.cisco.com" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ns1="ers.ise.cisco.com" xmlns:ers="ers.ise.cisco.com" description="description" name="name">

   <accountNameAlias>accountNameAlias</accountNameAlias>

   <changePassword>true</changePassword>

   <customAttributes>

      <entry>

         <key>key1</key>

         <value>value1</value>

      </entry>

      <entry>

         <key>key2</key>

         <value>value3</value>

      </entry>

   </customAttributes>

   <dateCreated>2015-12-15</dateCreated>

   <dateModified>2015-12-20</dateModified>

   <daysForPasswordExpiration>60</daysForPasswordExpiration>

   <email>email@domain.com</email>

   <enablePassword>enablePassword</enablePassword>

   <enabled>true</enabled>

   <expiryDate>2016-12-11</expiryDate>

   <expiryDateEnabled>false</expiryDateEnabled>

   <firstName>firstName</firstName>

   <identityGroups>identityGroups</identityGroups>

   <lastName>lastName</lastName>

   <password>password</password>

   <passwordIDStore>Internal Users</passwordIDStore>

   <passwordNeverExpires>false</passwordNeverExpires>

</ns0:internaluser>

6. انقر المصادقة واختر أساسي

مصادقة XML

7. أدخل بيانات اعتماد واجهة المستخدم الرسومية (GUI) ل ISE.

بيانات اعتماد XML

8. انقر فوق رؤوس لإضافة الأساليب التالية:
   • نوع المحتوى: التطبيق/xml
   • قبول: التطبيق/xml

رؤوس XML

9. أخيرا، انقر إرسال.

التحقق من الصحة

1. بعد إرسال طلب POST، سترى الحالة "تم إنشاء 201". وهذا يعني أن العملية قد اكتملت بنجاح.

طلب XML ناجح

2. افتح واجهة المستخدم الرسومية ISE وانتقل إلى الإدارة > إدارة الهوية > الهويات > المستخدمين > مستخدمي الوصول إلى الشبكة

التحقق من صحة حسابات المستخدمين

استكشاف الأخطاء وإصلاحها

1. حدد معرف مجموعة الهوية.

أستخدم GET واستعلام https://X.X.X.X/ers/config/identitygroup.

الحصول على الخيار

إخراج JSON.

حدد المعرف الموجود بجوار الوصف.

مجموعة هوية المعرف 01

إخراج XML.

حدد المعرف الموجود بجوار الوصف.

مجموعة هوية المعرف 02

2. 401 خطأ غير مصرح به.

خطأ 401

الحل: تحقق من بيانات اعتماد الوصول التي تم تكوينها في قسم المصادقة

3. خطأ: تعذر الاتصال بالخادم

خطأ في الاتصال

الحل: تحقق من عنوان IP الخاص بعقدة ISE التي تم تكوينها في وقت الأرق أو تحقق من صحة الاتصال.

4. 400 سيئة.

خطأ 400

هناك عدة أسباب لمواجهة هذا الخطأ، الأكثر شيوعا هي:

•  عدم تطابق مع نهج كلمة مرور الأمان
•  تم تكوين بعض المعلمات بشكل غير صحيح.
• خطأ Sintaxis.
• معلومات مكررة.

5. خطأ: لم يتم الموافقة على شهادة نظير SSL أو مفتاح SSH البعيد

خطأ في شهادة SSL

الحل: 

1. انقر على تعطيل التحقق من صحة SSL.
2. تحت الطلب / الاستجابة، قم بتعطيل خيار التحقق من صحة الشهادات.

خيار التحقق من صحة الشهادات

6.   العيب CSCwh71435.

يتم تكوين كلمة مرور enable بشكل عشوائي على الرغم من عدم تكوينها. يحدث هذا السلوك عند إزالة بناء جملة كلمة مرور enable أو تركها فارغة كقيمة. افحص الرابط التالي للحصول على المزيد من المعلومات:

https://bst.cloudapps.cisco.com/bugsearch/bug/CSCwh71435

مراجع مكالمات API.

يمكنك الاطلاع على جميع المعلومات حول مكالمات API التي يدعمها ISE.

1. انتقل إلى إدارة > نظام > إعدادات > إعداد واجهة برمجة التطبيقات.

2. انقر فوق إرتباط معلومات واجهة برمجة تطبيقات ERS (واجهة برمجة التطبيقات).

إعدادات API

3. وانقر فوق وثائق واجهة برمجة التطبيقات (API).

وثائق واجهة برمجة التطبيقات