Register a NAS

POST /api/v1/admin/nas prm_nas_create

اعرض الصفحة بصيغة Markdown

Creates the device record and its RADIUS shared secret. At least one of nas_identifier, nas_ip and called_station_id must be present — that is what an incoming RADIUS packet will be matched on.

A 409 here can be caused by a device belonging to a tenant you cannot see. The three identity columns are globally unique because RADIUS resolves on the bare key before any tenant is known, so "already taken" does not mean "already in your list".

نظرة سريعة

المصادقة
رمز موظّف أو جلسة
تتطلب صلاحية
prm_nas_create Add NAS
حد المعدل
t_mutate

المعاملات

المعامل الوصف
shared_secretمطلوب body · string The RADIUS shared secret. Required.
nas_identifier body · string NAS-Identifier. Unique across the whole platform.
nas_ip body · string NAS-IP-Address. Unique across the whole platform.
called_station_id body · string Called-Station-Id. Unique across the whole platform.
vendor body · string Device vendor. Validated against the known-vendor catalogue.
coa_port body · integer RFC 5176 port. Omit for the schema default of 3799.
ip_accounting_enabled body · boolean Defaults to true when omitted. An explicit false is honoured.

الأخطاء

الرمز متى تُرجَع
ERR_VALIDATION400 shared_secret missing, no identity field supplied, or an unknown vendor
ERR_CONFLICT409 the nas_ip, nas_identifier or called_station_id is already registered — possibly by another tenant

جرّبه على شبكتك.

50 مشترك لمدة 7 أيام، من غير ما تدفع حاجة.