BuilderIO/agent-native / packages/core/docs
agent-native-docs
UnverifiedHow to look up version-matched Agent-Native framework docs and source in node_modules. Use before coding against @agent-native/core APIs or advanced features.
content/locales/ar-SA/organizations-teams-permissions.mdx
View on GitHub---
title: المؤسسات والفرق والأذونات
description: إدارة سياق المؤسسة وأدوار الفريق والتطبيق ومشاركة الموارد.
---
# المؤسسات والفرق والأذونات
تحدد المؤسسة عضوية الفريق وحدود المستأجر. تجمع مساحة العمل التطبيقات وإعدادات النشر لكنها لا تستبدل المؤسسة. يجب أن يتحقق الخادم من الصلاحية. إخفاء زر في الواجهة ليس تفويضاً.
## نطاقات الأدوار الثلاثة
- أدوار المؤسسة `owner` و`admin` و`member` تتحكم بإدارة الفريق. يدير المالكون والمسؤولون الانضمام التلقائي حسب نطاق البريد الإلكتروني، ويدير المالك وحده سر A2A المشترك بين التطبيقات.
- أدوار التطبيق تتحكم بما يمكن فعله داخل تطبيق واحد. يمكن للعضو امتلاك عدة أدوار.
- أدوار المورد `viewer` و`editor` و`admin` تتحكم بالوصول إلى سجل واحد.
يعرّف التطبيق الأدوار ومفاتيح الأذونات في الشيفرة. يستطيع المسؤول استبدال مجموعة أدوار العضو وربط الأذونات المعرّفة بالأدوار من صفحة الفريق. عند غياب التخصيص تسري القيم الافتراضية للتطبيق. يمكن أن تتضمن الدعوة أدوار تطبيق مسبقة. دور مسؤول التطبيق لا يمنح صلاحيات إدارة المؤسسة.
للدعوات المُدارة راجع [عمليات النشر المُدارة](/docs/administered-deployments). وللوصول إلى البيانات راجع [نطاق البيانات](/docs/security#data-scoping).
## سياسات أذونات اختيارية
تتطلب عمليات التحقق من الأذونات افتراضيًا دور تطبيق مُعيّنًا. تغيّر الوسيطة الثانية الاختيارية في `defineAppRoles` هذه السياسة على الخادم. يستخدم Forms ما يلي:
```ts
const formsAccess = defineAppRoles(
{
appId: "forms",
roles: ["editor", "reviewer"] as const,
defaultRole: "editor",
permissions: {
"forms.edit": ["editor"],
"forms.review": ["editor", "reviewer"],
},
},
{ unassignedRole: "editor", allowOrgAdmins: true },
);
```
- يطبّق `unassignedRole` أذونات دور مُعلن على الأعضاء النشطين الذين ليس لديهم أي تعيينات لأدوار التطبيق. تظل تجاوزات الأذونات سارية. لا ينشئ تعيينًا ولا ينطبق على الأعضاء الذين تمت إزالتهم أو التعيينات التي تحتوي فقط على أدوار تم إيقافها. تؤدي إزالة جميع التعيينات إلى استعادة هذا السلوك الافتراضي.
- يسمح `allowOrgAdmins: true` لمالكي المؤسسة ومسؤوليها النشطين باجتياز أي تحقق من إذن تطبيق مُعلن، بغض النظر عن أدوار التطبيق أو تجاوزات الأذونات. ولا يمنح مسؤولي التطبيق صلاحيات إدارة المؤسسة.
تؤثر هذه الخيارات فقط في `requirePermission` و`assertPermission`. تظل `resolve` و`requireAny` و`assertAny` تعتمد على التعيينات الصريحة؛ ويبقى `defaultRole` للعرض فقط. يؤدي حذف الخيارات إلى الإبقاء على السياسة الصارمة. ولا يحل أي منهما محل تفويض الموارد: احتفظ بعمليات التحقق `accessFilter` و`assertAccess`.
يحافظ Forms على صلاحية التحرير للأعضاء الحاليين الذين ليس لديهم دور مُعيّن. يستطيع Reviewer المُعيّن صراحةً مراجعة الردود، لكنه لا يستطيع تحرير النماذج؛ ويستطيع Editor تنفيذ الأمرين. تظل مشاركة الموارد هي التي تحدد النماذج والردود التي يمكنهم الوصول إليها.
يتطلب تحرير النماذج التابعة لمؤسسة ومراجعة ردودها عضوية نشطة في مؤسسة النموذج، إلا إذا تعرّف نظام المشاركة على المستدعي بوصفه مالك النموذج. المشاركة المباشرة وحدها لا تكفي لاجتياز هذا التحقق من إذن التطبيق.
## مجموعات المستخدمين {#user-groups}
يمكن أن تضم المؤسسة مجموعات مستخدمين قابلة لإعادة الاستخدام من أعضائها الحاليين. يدير المالكون والمسؤولون العضوية، ويمكن للشخص الانتماء إلى أكثر من مجموعة. يمكن للتطبيقات استخدام المجموعة لمشاركة مورد يدعم مشاركة المجموعات أو لتقييد الوصول إلى اتصال مساحة العمل.
المجموعة قائمة وصول وليست فريقًا فرعيًا. ليس لها أدوار مستقلة للمؤسسة أو التطبيق، ولا حد بيانات منفصل، ولا إعدادات أو تعليمات أو سياق أو مهارات أو ذاكرة أو مساحة عمل خاصة بالفريق. تمنح مشاركة المجموعة دور المورد نفسه لكل عضو حالي فيها. ويظل الوصول مشروطًا بعضوية الشخص في المؤسسة التي ينتمي إليها المورد.
راجع [المشاركة والخصوصية → مشاركة المجموعات](/docs/sharing#group-grants) و[اتصالات مساحة العمل](/docs/workspace-connections) لمعرفة التفاصيل.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file). | Stars: 198k | Updated | Claude CodeCodex | Unverified | Install |
| doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |