أتمتة المهام باستخدام مستخدمي الآلات

عند استخدام موفِّر هوية خارجي مع Edge API، تكون العملية العادية للحصول على رموز مميّزة للوصول إلى OIDC/OAuth2 من واجهة سطر الأوامر هي مسار رمز الجهاز في OAuth 2.0. باستخدام هذا المسار، يمكنك استخدام الأداة المساعدة get_token التي تطلب منك الانتقال إلى عنوان URL في متصفّح للمصادقة من خلال موفّر الهوية، ثم تلغي حظر Terminal تلقائيًا.

ومع ذلك، قد تتيح بيئة التطوير التشغيل الآلي لمهام التطوير الشائعة، مثل التشغيل الآلي للاختبار أو مسارات CI/CD. لتنفيذ هذه المهام آليًا عند تفعيل موفّر خدمة هوية خارجي، يجب توفير طريقة للحصول على رموز OAuth2 المميزة وتحديثها بدون واجهة مستخدم، أي بدون الحاجة إلى التفاعل مع المتصفّح.

يتيح Edge إنشاء الرموز المميّزة تلقائيًا من خلال استخدام مستخدمي الأجهزة بلا واجهة مستخدم رسومية. يمكن لمستخدم الآلة الحصول على رموز مميّزة لبروتوكول OIDC/OAuth2 من خلال منح كلمات المرور العادية بدون الحاجة إلى متصفّح. وهذا يعني أنه يمكنك أتمتة عملية الحصول على الرموز المميزة وإعادة تحميلها للنصوص البرمجية بالكامل.

إنشاء مستخدم آلي

يمكنك إنشاء مستخدم آلي تستخدمه جميع مؤسساتك، أو إنشاء مستخدم آلي منفصل لكل مؤسسة.

يتم إنشاء مستخدم الجهاز وتخزينه مباشرةً في دليل OpenLDAP المحلي ووضع علامة عليه صراحةً كمستخدم جهاز (employeeType: machineuser). يتيح ذلك لخدمة الدخول الموحّد (SSO) في Apigee مصادقة مستخدم الجهاز بأمان من خلال منح كلمة مرور حتى في حال فرض استخدام SAML/OIDC الموحّد بشكل صارم على المستخدمين البشريين.

للحصول على تعليمات تفصيلية حول إنشاء مستخدمي الآلة وإدراجهم وإدارتهم، يُرجى الاطّلاع على إدارة مستخدمي الآلة باستخدام apigee-machineuser.sh.

الحصول على رموز مميّزة لمستخدمي الأجهزة وإعادة تحميلها

يمكنك استخدام أداتَي get_token وacurl المتاحتَين في /opt/apigee/apigee-openldap/bin/ أو curl العادي للحصول على رموز مميّزة لمستخدمي الأجهزة.

• استخدام أدوات Apigee: تعالج برامج التغليف get_token وacurl تلقائيًا تخزين الرموز المميزة مؤقتًا وإنشاء الحمولة وإعادة التحميل تلقائيًا. للحصول على تعليمات وأمثلة مفصّلة حول استخدام هذه الأدوات، يُرجى الاطّلاع على استخدام أداتَي get_token وacurl.
• باستخدام curl العادي: إذا لم تكن نصوص التشغيل الآلي لديك تملك إذن الوصول إلى برامج تضمين Apigee، يمكنك التفاعل مباشرةً مع الدخول الموحّد (SSO) في Apigee باستخدام أوامر curl العادية التالية:

للحصول على الرموز المميزة وإعادة تحميلها باستخدام curl العادي:

1. استخدِم طلب البيانات التالي من واجهة برمجة التطبيقات لإنشاء الرمز المميز الأولي للوصول والرمز المميز لإعادة التحميل مباشرةً من خدمة الدخول الموحّد في Apigee:

   curl -H "Content-Type: application/x-www-form-urlencoded;charset=utf-8" \
     -H "accept: application/json;charset=utf-8" \
     -X POST http://Edge_SSO_IP_DNS:9099/token -s \
       -d 'grant_type=password&username=machineUserEmail&password=machineUserPassword&client_id=edgecli&client_secret=edgeclisecret&scope=openid%20profile%20email%20offline_access'
     

2. مرِّر رمز الدخول إلى طلب Edge management API في العنوان Authorization: Bearer:

   curl -H "Authorization: Bearer access_token" \
     http://MS_IP_DNS:8080/v1/organizations/org_name

3. لتحديث الرمز المميز للدخول لاحقًا بشكلٍ أصلي، استخدِم طلب البيانات التالي الذي يتضمّن الرمز المميز لإعادة التحميل:

   curl -H "Content-Type:application/x-www-form-urlencoded;charset=utf-8" \
     -H "Accept: application/json;charset=utf-8" \
     -X POST http://Edge_SSO_IP_DNS:9099/token \
     -d 'grant_type=refresh_token&refresh_token=refreshToken&client_id=edgecli&client_secret=edgeclisecret'