Skip to main content
POST
/
radius
/
nas
Create a NAS Device
curl --request POST \
  --url https://api.altostrat.io/radius/nas \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "nas_identifier": "10.0.1.1",
  "type": "mikrotik",
  "description": "Branch office AP",
  "metadata": "<any>"
}'
{
  "id": "nas_01HGM5V65A5A5A5A5A5A5A5A5C",
  "nas_identifier": "192.168.88.1",
  "type": "mikrotik",
  "description": "Main office router",
  "metadata": "<any>",
  "certificate": "<string>",
  "private_key": "<string>",
  "client_ca": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "secret": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"
}

Authorizations

โ€‹
Authorization
string
header
required

Enter your API key in the format: Bearer <token>

Body

application/json
โ€‹
nas_identifier
string
required

The IP address or hostname that the NAS will use to identify itself. Must be unique.

Example:

"10.0.1.1"

โ€‹
type
string | null

The type or vendor of the NAS.

Example:

"mikrotik"

โ€‹
description
string | null

A description for the NAS device.

Example:

"Branch office AP"

โ€‹
metadata
any

Response

The NAS device was created successfully. The response includes the generated secret and certificates.

Represents a Network Access Server (NAS) device.

โ€‹
id
string

Unique identifier for the NAS device.

Example:

"nas_01HGM5V65A5A5A5A5A5A5A5A5C"

โ€‹
nas_identifier
string

The IP address or hostname that the NAS uses to identify itself in RADIUS requests.

Example:

"192.168.88.1"

โ€‹
type
string | null

The type or vendor of the NAS device.

Example:

"mikrotik"

โ€‹
description
string | null

A brief description of the NAS device.

Example:

"Main office router"

โ€‹
metadata
any
โ€‹
certificate
string

The PEM-encoded client certificate for RadSec (TLS) authentication.

โ€‹
private_key
string

The PEM-encoded private key for the client certificate. Only returned on creation.

โ€‹
client_ca
string

The PEM-encoded Certificate Authority (CA) certificate that signed the client certificate.

โ€‹
created_at
string<date-time>
โ€‹
updated_at
string<date-time>
โ€‹
secret
string

The shared secret used for RADIUS authentication with this NAS. This is only returned upon creation.

Example:

"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"