اتصال IBSng — Provisioning

> version: 1.1 | last_updated: 2026-09-20 | 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 را فعال نگه دارید.

---

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

در **تنظیمات → محصولات و پلن‌ها → ویرایش محصول → تب Provisioning**:

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

**provisioning_config:**

- `group_name` = نام گروه در IBSng (مثلاً `ftth-100` یا `lte-fd`)
- `username_type` = `subscription` (پیش‌فرض) | `msisdn` | `imsi`
- `username_prefix` = اختیاری — برای MSISDN/IMSI معمولاً خالی
- `password_type` = `fixed` برای رمز یکسان + مقدار در `password_fixed` | یا تصادفی / نام کاربری / کد ملی

> با `msisdn` / `imsi`، نام کاربری AAA همان شماره/IMSI بسته LTE تخصیص‌یافته است.

---

تست

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

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

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

---

جریان BSS

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

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

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

---

[lte-inventory.md](lte-inventory.md) — انبار LTE؛ برای `username_type=msisdn|imsi` در NetBill/IBS

---

منابع

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