اتصال IBSng — Provisioning

> version: 1.0 | last_updated: 2026-07-27 | audience: admin

معرفی

ماژول `ibsng` از **JSON-RPC / XML-RPC** رسمی IBSng برای مدیریت کاربران RADIUS استفاده می‌کند.

عملیات پشتیبانی‌شده:

ایجاد کاربر (`user.addNewUsers`)

تنظیم username/password (`user.updateUserAttrs`)

تعلیق (`lock`)

فعال‌سازی (`unlock`)

حذف (`user.delUser`)

تغییر پلن (`group_name`)

---

پیکربندی Tenant

**Provisioning → ماژول‌های Provisioning → ایجاد**

| فیلد config | مثال | توضیح |
|-------------|------|--------|
| `host` | `http://192.168.1.10` | آدرس سرور IBSng |
| `port` | `1237` | 1237=JSON-RPC، 1235=XML-RPC |
| `protocol` | `json` | `json` یا `xml` |
| `auth_name` | `system` | کاربر API |
| `auth_pass` | `***` | رمز API |
| `auth_type` | `ADMIN` | نوع احراز هویت |
| `isp_name` | `Main` | ISP/Owner |
| `group_name` | `ftth-100` | گروه پیش‌فرض |

**Sandbox:** تا زمان دریافت credentials واقعی، گزینه Sandbox را فعال نگه دارید.

---

پیکربندی محصول

در **کاتالوگ محصول → Provision**:

**ماژول:** `ibsng`

**provisioning_config:**

- `group_name` = نام گروه در IBSng (مثلاً `ftth-100`)

---

تست

ماژول IBSng را در Filament ذخیره کنید

**تست اتصال** — در sandbox پیام موفقیت sandbox نمایش داده می‌شود

Sandbox را خاموش کنید و با سرور واقعی تست کنید

---

جریان BSS

```
سفارش → Workflow → ProvisioningService → IbsngModule → IbsngClient
```

داده‌های برگشتی در `subscription.provisioning_data`:

`username`, `password`, `user_id`, `group_name`

---

منابع

[IBSng JSON-RPC Docs](https://github.com/ParspooyeshFanavar/ibsng-docs)