Validar permisos del usuario

Utiliza este endpoint para comprobar si un usuario tiene permiso para ejecutar una acción específica sobre un recurso. Normalmente se usa en la autenticación M2M con Midaz.

POST /v1/authorize

Validar permisos del usuario

cURL

curl --request POST \
  --url https://auth.sandbox.lerian.net/v1/authorize \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": "post",
  "resource": "ledger",
  "sub": "admin"
}
'

200

1

{
  "authorized": true,
  "timestamp": "1744052319"
}

Encabezados

Authorization · string · requerido

Token de autorización.

Cuerpo

application/json

Información utilizada para validar si un usuario tiene permiso para realizar una acción específica sobre un recurso determinado.

action · string · requerido

Operación que se ejecuta sobre el recurso.

resource · string · requerido

Recurso al que se aplica la acción, normalmente un servicio o dominio dentro del sistema.

sub · string

Sujeto que solicita acceso. Generalmente un midaz_role o un user_id. Si no se proporciona, se extrae del token.

Respuesta

200

application/json

Indica que el recurso se creó correctamente y que la operación se completó según lo esperado.

Información devuelta como respuesta correcta del endpoint de validación de permisos de usuario.

authorized · boolean

true indica que el usuario está autorizado para realizar la acción.

timestamp · string<date-time>

Momento en el que se verificó el permiso.