Langsung ke konten utama
POST
/
sites
/
{siteId}
/
transient-accesses
Buat sesi akses sementara
curl --request POST \
  --url https://api.altostrat.io/sites/{siteId}/transient-accesses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "expire_after_minutes": 60,
  "type": "winbox",
  "full_access": true,
  "allow_rfc1918": false,
  "allow_only_cidr": "203.0.113.42/32"
}'
{
  "id": "f0e9d8c7-b6a5-4f3e-2d1c-0b9a8e7f6d5c",
  "username": "transient-user-abc123",
  "password": "P@ssw0rdABC123XYZ",
  "port": 45821,
  "type": "winbox",
  "full_access": true,
  "allow_rfc1918": false,
  "allow_only_cidr": "198.51.100.10/32",
  "revoked_early": false,
  "expires_at": "2025-10-29T12:15:49Z",
  "expired": false,
  "entry_point": "edge-us-east-1a.ostrat.io",
  "time_to_expire": "15 menit dari sekarang",
  "onclick": "winbox://edge-us-east-1a.ostrat.io:45821?username=transient-user-abc123&password=P@ssw0rdABC123XYZ"
}

Authorizations

โ€‹
Authorization
string
header
required

Masukkan token JWT bearer Anda.

Path Parameters

โ€‹
siteId
string<uuid>
required

Pengidentifikasi unik untuk situs.

Example:

"d290f1ee-6c54-4b01-90e6-d701748f0851"

Body

application/json
โ€‹
expire_after_minutes
integer
required

Jumlah menit hingga sesi kedaluwarsa secara otomatis.

Required range: 15 <= x <= 1440
Example:

60

โ€‹
type
enum<string>
required

Jenis protokol akses.

Opsi yang tersedia:
winbox,
ssh
Example:

"winbox"

โ€‹
full_access
boolean
required

Apakah akan memberikan hak administratif penuh.

Example:

true

โ€‹
allow_rfc1918
boolean
required

Apakah akan mengizinkan koneksi dari alamat IP pribadi (RFC1918). Biasanya harus salah demi keamanan.

Example:

false

โ€‹
allow_only_cidr
string
required

Batasi akses ke satu alamat IP sumber atau rentang CIDR. Gunakan /32 untuk satu IP.

Example:

"203.0.113.42/32"

Response

Objek akses sementara yang baru dibuat.

โ€‹
id
string<uuid>

Pengidentifikasi unik untuk sesi akses sementara.

Example:

"f0e9d8c7-b6a5-4f3e-2d1c-0b9a8e7f6d5c"

โ€‹
username
string

Nama pengguna sementara untuk sesi ini.

Example:

"transient-user-abc123"

โ€‹
password
string

Kata sandi sementara untuk sesi ini.

Example:

"P@ssw0rdABC123XYZ"

โ€‹
port
integer

Porta publik di server manajemen Altostrat untuk koneksi.

Example:

45821

โ€‹
type
enum<string>

Jenis protokol akses.

Opsi yang tersedia:
winbox,
ssh
Example:

"winbox"

โ€‹
full_access
boolean

Apakah sesi memiliki hak administratif penuh.

Example:

true

โ€‹
allow_rfc1918
boolean

Apakah akses diizinkan dari rentang IP pribadi (RFC1918).

Example:

false

โ€‹
allow_only_cidr
string

CIDR sumber yang secara eksklusif diizinkan untuk terhubung.

Example:

"198.51.100.10/32"

โ€‹
revoked_early
boolean

Benar jika sesi dicabut secara manual sebelum kedaluwarsa.

Example:

false

โ€‹
expires_at
string<date-time>

Stempel waktu saat sesi ini akan kedaluwarsa secara otomatis.

Example:

"2025-10-29T12:15:49Z"

โ€‹
expired
boolean

Benar jika sesi telah kedaluwarsa atau dicabut.

Example:

false

โ€‹
entry_point
string

Nama hos dari server manajemen Altostrat untuk koneksi.

Example:

"edge-us-east-1a.ostrat.io"

โ€‹
time_to_expire
string

String yang dapat dibaca manusia yang menunjukkan berapa lama lagi sesi akan kedaluwarsa.

Example:

"15 menit dari sekarang"

โ€‹
onclick
string

String koneksi Winbox untuk akses sekali klik yang mudah.

Example:

"winbox://edge-us-east-1a.ostrat.io:45821?username=transient-user-abc123&password=P@ssw0rdABC123XYZ"