Users API

Los usuarios se utilizan para controlar el acceso a la Interfaz Web de Astra, así como el acceso a las salidas HTTP MPEG-TS y HLS.

Configuración de usuario

{
    "enable": true,
    "type": 0,
    "comment": "...",

    "token": "...",
    "ip": "...",
    "expire": 0,
    "conlimit": 0
}

• enable – cuenta habilitada o no
• type – tipo de usuario
  • 1 - admin. acceso completo a la Interfaz Web de Astra
  • 2 - observador. acceso solo de lectura a la Interfaz Web de Astra
  • 3 - usuario regular. sin acceso a la Interfaz Web de Astra
• comment - campo opcional, para la descripción del usuario

Campos opcionales para la autorización interna de acceso a canales HLS o HTTP MPEG-TS:

• token - token utilizado en las solicitudes HTTP. Por ejemplo: http://server:8000/play/a001/index.m3u8?token=secret
• ip - permite el acceso a los canales por la dirección IP del cliente
• expire - fecha en formato de timestamp unix, cuando el acceso a los canales será restringido
• connlimit - limita las conexiones a los canales

Obtener usuario

Solicitud: POST /control/

{
    "cmd": "get-user",
    "id": "..."
}

• id - login del usuario

En la respuesta se recibirá un JSON con la configuración del usuario

Crear o actualizar usuario

Solicitud: POST /control/

{
    "cmd": "set-user",
    "id": "...",
    "user": {
        "enable": true,
        "type": 0,
        "password": "..."
    }
}

• id – login del usuario
• user - configuración del usuario
• password - contraseña en texto plano, en la configuración se guardará el hash de la contraseña

Ejemplo

Puedes crear un nuevo usuario ejecutando el siguiente comando:

curl -X POST --user login -d @- http://server:8000/control/ <<END
{
  "cmd": "set-user",
  "id": "new-admin",
  "user": {
    "enable": true,
    "type": 1,
    "password": "secret"
  }
}
END

si tiene éxito Astra devuelve:

{ "set-user": "ok" }

Eliminar usuario

Solicitud: POST /control/

{
    "cmd": "set-user",
    "id": "...",
    "user": {
        "remove": true
    }
}

Activar o desactivar usuario

Solicitud: POST /control/

Activar o desactivar un usuario:

{
    "cmd": "toggle-user",
    "id": "..."
}

• id - login del usuario

Ejemplo

Puedes habilitar o deshabilitar un usuario ejecutando el siguiente comando:

curl \
    -X POST \
    --user login \
    -d '{"cmd":"toggle-user", "id":"login"}' \
    http://server:8000/control/

si tiene éxito Astra devuelve:

{ "toggle-user": "ok" }