Vai al contenuto principale
POST
/
sites
/
{siteId}
/
transient-accesses
Crea una sessione di accesso transitorio
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": "tra 15 minuti",
  "onclick": "winbox://edge-us-east-1a.ostrat.io:45821?username=transient-user-abc123&password=P@ssw0rdABC123XYZ"
}

Authorizations

​
Authorization
string
header
required

Inserisci il tuo token bearer JWT.

Path Parameters

​
siteId
string<uuid>
required

L'identificatore univoco per il sito.

Example:

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

Body

application/json
​
expire_after_minutes
integer
required

Il numero di minuti prima che la sessione scada automaticamente.

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

60

​
type
enum<string>
required

Il tipo di protocollo di accesso.

Opzioni disponibili:
winbox,
ssh
Example:

"winbox"

​
full_access
boolean
required

Indica se concedere privilegi amministrativi completi.

Example:

true

​
allow_rfc1918
boolean
required

Indica se consentire connessioni da indirizzi IP privati (RFC1918). Per motivi di sicurezza, di solito dovrebbe essere false.

Example:

false

​
allow_only_cidr
string
required

Limita l'accesso a un singolo indirizzo IP o intervallo CIDR di origine. Usa /32 per un singolo IP.

Example:

"203.0.113.42/32"

Response

L'oggetto di accesso transitorio appena creato.

​
id
string<uuid>

L'identificatore univoco per la sessione di accesso transitorio.

Example:

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

​
username
string

Il nome utente temporaneo per questa sessione.

Example:

"transient-user-abc123"

​
password
string

La password temporanea per questa sessione.

Example:

"P@ssw0rdABC123XYZ"

​
port
integer

La porta pubblica sul server di gestione Altostrat a cui connettersi.

Example:

45821

​
type
enum<string>

Il tipo di protocollo di accesso.

Opzioni disponibili:
winbox,
ssh
Example:

"winbox"

​
full_access
boolean

Indica se la sessione ha privilegi amministrativi completi.

Example:

true

​
allow_rfc1918
boolean

Indica se l'accesso è consentito da intervalli IP privati (RFC1918).

Example:

false

​
allow_only_cidr
string

Il CIDR di origine autorizzato in modo esclusivo a connettersi.

Example:

"198.51.100.10/32"

​
revoked_early
boolean

True se la sessione è stata revocata manualmente prima della sua scadenza.

Example:

false

​
expires_at
string<date-time>

La data e ora in cui questa sessione scadrà automaticamente.

Example:

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

​
expired
boolean

True se la sessione è scaduta o è stata revocata.

Example:

false

​
entry_point
string

L'hostname del server di gestione Altostrat a cui connettersi.

Example:

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

​
time_to_expire
string

Una stringa leggibile che indica quanto tempo manca alla scadenza della sessione.

Example:

"tra 15 minuti"

​
onclick
string

Una stringa di connessione Winbox per un facile accesso con un clic.

Example:

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