# المصادقة

> المصادقة مع واجهة برمجة تطبيقات تاروت

# المصادقة

واجهة برمجة تطبيقات تاروت تدعم طريقتين للمصادقة: مفاتيح API ورموز الجلسة.

## مفاتيح API

مفاتيح API توفر وصولاً طويل الأمد لواجهة API. استخدمها لتكامل الخادم بالخادم وأنابيب CI/CD.

### إنشاء مفتاح API

1. اذهب إلى **الإعدادات ← مفاتيح API** في لوحة التحكم.
2. انقر **إنشاء مفتاح API**.
3. أعطِ المفتاح اسمًا وصفيًا.
4. انسخ المفتاح - يُعرض مرة واحدة فقط.

### استخدام مفتاح API

أضف مفتاح API في رأس `Authorization`:

```bash
curl https://tarout.sa/api/v1/applications \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

### نطاقات مفتاح API

مفاتيح API لها نفس صلاحيات المستخدم الذي أنشأها. المفاتيح المنشأة بواسطة مالك المنظمة لها وصول كامل.

## رموز الجلسة

رموز الجلسة تُستخدم بواسطة لوحة التحكم وواجهة سطر الأوامر. وهي قصيرة العمر وتُجدَّد تلقائيًا.

### مصادقة سطر الأوامر

```bash
# تسجيل الدخول (يفتح المتصفح لـ OAuth)
tarout login

# التحقق من الحالة
tarout whoami
```

واجهة سطر الأوامر تخزن رمز الجلسة بأمان وتجدده تلقائيًا.

## أفضل ممارسات الأمان

- **جدّد المفاتيح بانتظام** - احذف وأعد إنشاء مفاتيح API دوريًا.
- **استخدم متغيرات البيئة** - لا تضع مفاتيح API في الكود المصدري أبدًا.
- **حدّد النطاق** - أنشئ مفاتيح منفصلة لتكاملات مختلفة.
- **راقب الاستخدام** - راجع نشاط مفاتيح API في لوحة التحكم.
- **ألغِ المفاتيح المخترقة** - إذا تعرض مفتاح للكشف، احذفه فورًا من الإعدادات.

---

## Every Tarout agent guide

- [Start Here (Agents)](https://tarout.sa/docs/for-ai/start.md)
- [Overview](https://tarout.sa/docs/for-ai.md)
- [Deploying an app](https://tarout.sa/docs/for-ai/deploy.md)
- [Databases](https://tarout.sa/docs/for-ai/database.md)
- [Object storage](https://tarout.sa/docs/for-ai/storage.md)
- [Custom domains](https://tarout.sa/docs/for-ai/domains.md)
- [Plans and upgrades](https://tarout.sa/docs/for-ai/billing.md)
- [Troubleshooting](https://tarout.sa/docs/for-ai/troubleshoot.md)
- [Agent Onboarding](https://tarout.sa/docs/for-ai/onboarding.md)
- [CLI Reference](https://tarout.sa/docs/for-ai/cli-reference.md)
- [CLI JSON Schema](https://tarout.sa/docs/for-ai/cli-json-schema.md)

Whole corpus in one file: https://tarout.sa/llms-full.txt · index: https://tarout.sa/llms.txt
Any docs page is raw markdown at the same URL + `.md`. Short link to the entry point: https://tarout.sa/deploy.md