Saltar al contenido principal
Versión: 4.42

API de administración

La API de administración de Redtrust es un servicio SOAP/WCF que proporciona acceso programático a todas las operaciones disponibles en la consola de administración. Está pensada para administradores e integradores que necesiten automatizar tareas de gestión de Redtrust.

Qué puedes hacer con la API de administración​

La API expone las mismas operaciones que la consola de administración. Para el conjunto completo de operaciones disponibles, consulta el WSDL del servicio.

Esta documentación cubre las siguientes operaciones:

  • Gestionar usuarios locales: crear, editar, activar o desactivar, desbloquear y eliminar.
  • Gestionar usuarios de certificado: crear y editar.
  • Consultar información de dominio y listar usuarios.

Endpoint​

Todas las operaciones se realizan contra un único endpoint:

https://TU_IP_REDTRUST:8888/RTAdminService.svc/basic

Donde:

  • TU_IP_REDTRUST es la dirección IP o el nombre de host de tu servidor Redtrust.
  • 8888 es el puerto por defecto. Puedes cambiarlo desde la consola de administración.

El WSDL del servicio está disponible en https://TU_IP_REDTRUST:8888/RTAdminService.svc?wsdl.

Autenticación​

El endpoint /basic usa WS-Security UsernameToken sobre HTTPS. Debes incluir las credenciales de un usuario administrador de Redtrust en cada petición.

Para configurar SoapUI, consulta la guía de configuración de SoapUI.

Estructura de las peticiones​

Las peticiones siguen el formato SOAP 1.2 con el espacio de nombres urn:evolium:redtrust:administration:ws.

Estructura de las respuestas​

Todas las respuestas incluyen un elemento Result con los siguientes campos:

CampoTipoDescripción
ResultStatusstringSUCCESS si la operación se completó correctamente, ERROR si falló.
ErrorCodestringOK en caso de éxito. Código de error en caso de fallo.
ResultMessagestringMensaje descriptivo del resultado.
ResultDatavariableDatos devueltos por la operación. El tipo depende del método.
TotalItemsintegerNúmero total de elementos afectados o devueltos.

Próximos pasos​