skill
معرف وكيل Entra
توفير مخططات هوية وكيل Microsoft Entra، و BlueprintPrincipals، وهويات الوكيل لكل مثيل عبر Microsoft Graph، وتكوين تبادل رموز OAuth 2.0 (fmi_path، OBO، عبر المستأجرين) بما في ذلك Microsoft Entra SDK ل AgentID sidecar. يستخدم ل: مخطط هوية الوكيل، BlueprintPrincipal، OAuth الوكيل، تبادل رموز fmi_path، OBO الوكيل، اتحاد هوية حمل العمل للوكلاء، مصادقة الوكيل متعدد اللغات، Microsoft.Identity.Web.AgentIdentities. لا يستخدم ل: تسجيل تطبيقات Entra القياسي...
نبذة
# هوية وكيل Microsoft Entra
أنشئ وادر هويات وكلاء الذكاء الاصطناعي القادرة على OAuth 2.0 باستخدام Microsoft Graph. تحصل كل نسخة وكيل على هوية مميزة، وسجل تدقيق، ومنح أذونات ذات نطاق مستقل.
## مرجع سريع
| الخاصية | القيمة | |----------|-------| | الخدمة | هوية وكيل Microsoft Entra | | واجهة برمجة التطبيقات (API) | Microsoft Graph (`https://graph.microsoft.com/v1.0`) | | الدور المطلوب | مطور هوية الوكيل، مسؤول هوية الوكيل، أو مسؤول التطبيقات | | نموذج الكائن | مخطط (تطبيق) ← BlueprintPrincipal (SP) ← هوية الوكيل (SP) | | تبادل وقت التشغيل | تبادل `fmi_path` بخطوتين (مستقل و OBO) | | مساعد .NET | `Microsoft.Identity.Web.AgentIdentities` | | مساعد متعدد اللغات | Microsoft Entra SDK لهوية الوكيل (حاوية جانبية) |
## متى تستخدم هذه المهارة
- توفير مخطط هوية وكيل جديد و BlueprintPrincipal - إنشاء هويات وكيل لكل نسخة تحت مخطط - تكوين بيانات الاعتماد (FIC، الهوية المدارة، أو سر العميل) على المخطط - تنفيذ تبادل الرمز المميز لوقت التشغيل `fmi_path` بخطوتين (مستقل أو OBO) - تدفقات رمز الوكيل عبر المستأجرين - نشر حاوية Microsoft Entra SDK الجانبية لهوية الوكيل للوكلاء متعددي اللغات (Python، Node، Go، Java) - منح أذونات التطبيق (`appRoleAssignments`) أو الأذونات المفوضة (`oauth2PermissionGrants`) لكل هوية وكيل - تشخيص أخطاء هوية الوكيل مثل `AADSTS82001`، `AADSTS700211`، أو `PropertyNotCompatibleWithAgentIdentity`
## أدوات MCP
| الأداة | الاستخدام | |------|-----| | `mcp_azure_mcp_documentation` | ابحث في Microsoft Learn عن إعداد هوية الوكيل الحالي، وأشكال Graph API، وتكوين SDK |
لا يوجد خادم MCP مخصص لهوية الوكيل اليوم. ترشد هذه المهارة مكالمات Microsoft Graph API المباشرة (PowerShell أو Python `requests`). استخدم `mcp_azure_mcp_documentation` للتحقق من نصوص الطلبات ونقاط النهاية مقابل المستندات الحالية قبل التشغيل.
## قبل أن تبدأ
استخدم أداة `mcp_azure_mcp_documentation` للبحث في Microsoft Learn عن وثائق هوية الوكيل الحالية: - "تعليمات إعداد هوية وكيل Microsoft Entra" - "Microsoft Entra SDK لهوية الوكيل"
تحقق من نصوص الطلبات ونقاط النهاية مقابل إصدار SDK المثبت — تتطور أشكال Graph API.
## النموذج المفاهيمي
``` Agent Identity Blueprint (application) ← واحد لكل نوع/مشروع وكيل └── BlueprintPrincipal (service principal) ← يجب إنشاؤه صراحة ├── Agent Identity (SP): agent-1 ← واحد لكل نسخة وكيل ├── Agent Identity (SP): agent-2 └── Agent Identity (SP): agent-3 ```
| المفهوم | الوصف | |---------|-------------| | **المخطط (Blueprint)** | كائن التطبيق الذي يحدد نوع/فئة الوكيل. يحمل بيانات الاعتماد (سر، شهادة، هوية موحدة). | | **BlueprintPrincipal** | كيان الخدمة للمخطط في المستأجر. لا يتم إنشاؤه تلقائيا. | | **هوية الوكيل (Agent Identity)** | هوية كيان خدمة فقط لنسخة وكيل واحدة. لا يمكنها الاحتفاظ ببيانات اعتمادها الخاصة. | | **الراعي (Sponsor)** | مستخدم (أو مجموعة، لهوية الوكيل) مسؤول عن الهوية. مطلوب عند الإنشاء. |
## المتطلبات الأساسية
### أدوار Entra المطلوبة
أحد الأدوار التالية: **مطور هوية الوكيل**، **مسؤول هوية الوكيل**، أو **مسؤول التطبيقات**.
### PowerShell (إعداد تفاعلي)
```powershell # PowerShell 7+ Install-Module Microsoft.Graph.Applications -Scope CurrentUser -Force ```
### Python (توفير برمجي)
```bash pip install azure-identity requests ```
## المصادقة
> **`DefaultAzureCredential` غير مدعوم.** تحمل رموز Azure CLI المميزة `Directory.AccessAsUser.All`، والتي ترفضها واجهات برمجة تطبيقات هوية الوكيل بشدة (403). استخدم تسجيل تطبيق مخصص مع `client_credentials`، أو `Connect-MgGraph` مع نطاقات مفوضة صريحة.
### PowerShell (مفوض)
```powershell Connect-MgGraph -Scopes @( "AgentIdentityBlueprint.Create", "AgentIdentityBlueprint.ReadWrite.All", "AgentIdentityBlueprintPrincipal.Create", "AgentIdentity.Create.All", "User.Read" ) ```
### Python (تطبيق)
```python import os, requests from azure.identity import ClientSecretCredential
credential = ClientSecretCredential( tenant_id=os.environ["AZURE_TENANT_ID"], client_id=os.environ["AZURE_CLIENT_ID"], client_secret=os.environ["AZURE_CLIENT_SECRET"], ) token = credential.get_token("https://graph.microsoft.com/.default")
GRAPH = "https://graph.microsoft.com/v1.0" headers = { "Authorization": f"Bearer {token.token}", "Content-Type": "application/json", "OData-Version": "4.0", } ```
## سير العمل الأساسي
### الخطوة 1: إنشاء مخطط هوية الوكيل
استخدم نقطة النهاية المكتوبة. يجب أن يكون الرعاة **مستخدمين** عند إنشاء المخطط. يفترض هذا المقتطف عميل `requests` وقاموس `headers` من كتلة مصادقة Python أعلاه.
```python import subprocess import requests
user_id = subprocess.run( ["az", "ad", "signed-in-user", "show", "--query", "id", "-o", "tsv"], capture_output=True, text=True, check=True, ).stdout.strip()
blueprint_body = { "displayName
التثبيت
شغل هذا الأمر
npx skills add microsoft/azure-skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add microsoft/azure-skills`، أو استنسخ المستودع وانسخ مجلد `skills/entra-agent-id` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة معرف وكيل Entra؟
توفير مخططات هوية وكيل Microsoft Entra، و BlueprintPrincipals، وهويات الوكيل لكل مثيل عبر Microsoft Graph، وتكوين تبادل رموز OAuth 2.0 (fmi_path، OBO، عبر المستأجرين) بما في ذلك Microsoft Entra SDK ل AgentID sidecar. يستخدم ل: مخطط هوية الوكيل، BlueprintPrincipal، OAuth الوكيل، تبادل رموز fmi_path، OBO الوكيل، اتحاد هوية حمل العمل للوكلاء، مصادقة الوكيل متعدد اللغات، Microsoft.Identity.Web.AgentIdentities. لا يستخدم…
كيف أثبت معرف وكيل Entra؟
شغل هذا الأمر في الطرفية:
npx skills add microsoft/azure-skillsمع أي أدوات ذكاء اصطناعي تعمل معرف وكيل Entra؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور معرف وكيل Entra؟
طورها microsoft، وتصدر بترخيص MIT.
هل معرف وكيل Entra مجانية؟
نعم، يمكنك استخدامها مجانا وفق ترخيص MIT.
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى