Versión: 4.42

Referencia de la API — Consulta de eventos

Descripción general

La API de administración expone tres tipos de eventos que puedes consultar y exportar:

Eventos de certificado: registran cada uso de un certificado (firma, autenticación, operaciones denegadas por política).
Eventos de sistema: registran las acciones realizadas en la consola de administración (cambios de configuración, gestión de usuarios, creación de políticas).
Eventos de HA: registran la actividad del clúster de alta disponibilidad.

Antes de empezar

Antes de probar estos métodos, necesitas configurar SoapUI.

important

Los comentarios  que aparecen en las solicitudes SOAP se generan automáticamente y pueden marcar de forma incorrecta campos obligatorios como opcionales.

Esta documentación indica explícitamente qué campos son obligatorios u opcionales. Confía siempre en esta documentación.

Eventos de certificado

`ListEvents`

Devuelve la lista de eventos de uso de certificados que coinciden con los parámetros indicados, ordenados por fecha.

Nombre	Tipo	Requerido	Descripción
`filter`	string	No	Texto que deben contener los resultados. Si está vacío, devuelve todos los eventos.
`numBlock`	integer	Sí	Número de bloque de resultados a devolver (paginación). El primer bloque es `0`.
`orderColumn`	string	Sí	Columna de ordenación: `ORDER_BY_DATE`, `ORDER_BY_IP`, `ORDER_BY_USER`, `ORDER_BY_CONTEXT`, `ORDER_BY_CERTIFICATE`, `ORDER_BY_DESCRIPTION`, `ORDER_BY_URL`.
`orderType`	string	Sí	Dirección de ordenación: `ORDER_ASCENDING`, `ORDER_DESCENDING`.
`filterType`	string	Sí	Filtra por tipo de evento: `NO_FILTER`, `FILTER_BY_SECURITY` (sesión), `FILTER_BY_CERTIFICATE_OPERATION` (uso de certificado), `FILTER_BY_PERMISSION_DENIED`, `FILTER_BY_PERMISSION_ALLOWED`, `FILTER_BY_CERT_LIFECYCLE`.
`dateFilterType`	string	Sí	Filtro de fecha predefinido: `NO_DATE_FILTER`, `DATE_FILTER_TODAY`, `DATE_FILTER_THIS_WEEK`, `DATE_FILTER_THIS_MONTH`, `DATE_FILTER_LAST_THREE_MONTHS`, `DATE_FILTER_LAST_SIX_MONTHS`, `DATE_FILTER_THIS_YEAR`, `DATE_FILTER_CUSTOM_FILTER`. Usa `DATE_FILTER_CUSTOM_FILTER` para especificar un rango con `from` y `to`.
`from`	datetime	No	Fecha de inicio del rango personalizado. Solo se usa cuando `dateFilterType` es `DATE_FILTER_CUSTOM_FILTER`.
`to`	datetime	No	Fecha de fin del rango personalizado. Solo se usa cuando `dateFilterType` es `DATE_FILTER_CUSTOM_FILTER`.

Petición
Respuesta

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:urn="urn:evolium:redtrust:administration:ws">
    <soap:Header/>
    <soap:Body>
        <urn:ListEvents>
            <urn:filter></urn:filter>
            <urn:numBlock>0</urn:numBlock>
            <urn:orderColumn>ORDER_BY_DATE</urn:orderColumn>
            <urn:orderType>ORDER_DESCENDING</urn:orderType>
            <urn:filterType>NO_FILTER</urn:filterType>
            <urn:dateFilterType>DATE_FILTER_TODAY</urn:dateFilterType>
        </urn:ListEvents>
    </soap:Body>
</soap:Envelope>

<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:a="http://www.w3.org/2005/08/addressing">
    <s:Header>
        <a:Action s:mustUnderstand="1">urn:evolium:redtrust:administration:ws/RTAdminService/ListEventsResponse</a:Action>
    </s:Header>
    <s:Body>
        <ListEventsResponse xmlns="urn:evolium:redtrust:administration:ws">
            <Result xmlns:b="http://schemas.datacontract.org/2004/07/RTAdminService.Types" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <ResultStatus xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">SUCCESS</ResultStatus>
                <ErrorCode xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">OK</ErrorCode>
                <ResultMessage xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">Operation finalized successfully</ResultMessage>
                <ResultData i:type="b:ArrayOfEventView" xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">
                    <b:EventView>
                        <b:certificate/>
                        <b:context xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
                            <c:string>Process: chrome</c:string>
                            <c:string>Original process: chrome.exe</c:string>
                            <c:string>Agent id: XXXX-XXXXX-XXXXX-XXXXX</c:string>
                        </b:context>
                        <b:date>2026-04-22T09:30:00</b:date>
                        <b:description>Application connection accepted</b:description>
                        <b:ip>192.168.1.100</b:ip>
                        <b:url>{"process":"chrome","browserType":"CH","fullUrl":"https://example.com","policyName":"Corporate portal access","agentId":"XXXX-XXXXX-XXXXX-XXXXX"}</b:url>
                        <b:user>juan.garcia@local.users</b:user>
                    </b:EventView>
                </ResultData>
                <TotalItems xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">1</TotalItems>
            </Result>
        </ListEventsResponse>
    </s:Body>
</s:Envelope>

Consulta la referencia completa de los campos de EventView en Objetos de respuesta.

Eventos de sistema

`ListSystemEvents`

Devuelve la lista de eventos de actividad en la consola de administración que coinciden con los parámetros indicados, ordenados por fecha.

Nombre	Tipo	Requerido	Descripción
`filter`	string	No	Texto que deben contener los resultados. Si está vacío, devuelve todos los eventos.
`numBlock`	integer	Sí	Número de bloque de resultados a devolver (paginación). El primer bloque es `0`.
`orderColumn`	string	Sí	Columna de ordenación: `ORDER_BY_DATE`, `ORDER_BY_IP`, `ORDER_BY_USER`, `ORDER_BY_SECTION`, `ORDER_BY_INFORMATION`.
`orderType`	string	Sí	Dirección de ordenación: `ORDER_ASCENDING`, `ORDER_DESCENDING`.
`dateFilterType`	string	Sí	Filtro de fecha predefinido. Mismos valores que en `ListEvents`.
`from`	datetime	No	Fecha de inicio del rango personalizado. Solo se usa cuando `dateFilterType` es `DATE_FILTER_CUSTOM_FILTER`.
`to`	datetime	No	Fecha de fin del rango personalizado. Solo se usa cuando `dateFilterType` es `DATE_FILTER_CUSTOM_FILTER`.

Petición
Respuesta

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:urn="urn:evolium:redtrust:administration:ws">
    <soap:Header/>
    <soap:Body>
        <urn:ListSystemEvents>
            <urn:filter></urn:filter>
            <urn:numBlock>0</urn:numBlock>
            <urn:orderColumn>ORDER_BY_DATE</urn:orderColumn>
            <urn:orderType>ORDER_DESCENDING</urn:orderType>
            <urn:dateFilterType>DATE_FILTER_THIS_WEEK</urn:dateFilterType>
        </urn:ListSystemEvents>
    </soap:Body>
</soap:Envelope>

<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:a="http://www.w3.org/2005/08/addressing">
    <s:Header>
        <a:Action s:mustUnderstand="1">urn:evolium:redtrust:administration:ws/RTAdminService/ListSystemEventsResponse</a:Action>
    </s:Header>
    <s:Body>
        <ListSystemEventsResponse xmlns="urn:evolium:redtrust:administration:ws">
            <Result xmlns:b="http://schemas.datacontract.org/2004/07/RTAdminService.Types" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <ResultStatus xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">SUCCESS</ResultStatus>
                <ErrorCode xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">OK</ErrorCode>
                <ResultMessage xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">Operation finalized successfully</ResultMessage>
                <ResultData i:type="b:ArrayOfSystemEventView" xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">
                    <b:SystemEventView>
                        <b:context xmlns:c="http://schemas.datacontract.org/2004/07/System">
                            <c:ValueTupleOfstringstring>
                                <c:Item1>Friendly Name</c:Item1>
                                <c:Item2>maria</c:Item2>
                            </c:ValueTupleOfstringstring>
                            <c:ValueTupleOfstringstring>
                                <c:Item1>Email</c:Item1>
                                <c:Item2>maria@test.com</c:Item2>
                            </c:ValueTupleOfstringstring>
                            <c:ValueTupleOfstringstring>
                                <c:Item1>Domain</c:Item1>
                                <c:Item2>local.users</c:Item2>
                            </c:ValueTupleOfstringstring>
                        </b:context>
                        <b:dateTime>2026-03-23T11:12:57</b:dateTime>
                        <b:information>El usuario maria.lopez@local.users ha sido creado.</b:information>
                        <b:ip>172.22.0.7</b:ip>
                        <b:newData>{"username":"maria.lopez","email":"maria@test.com","active":true,"name":"maria","domain":"local.users"}</b:newData>
                        <b:oldData i:nil="true"/>
                        <b:section>Admin WS: AddLocalUser</b:section>
                        <b:user>admin@local</b:user>
                    </b:SystemEventView>
                </ResultData>
                <TotalItems xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">1</TotalItems>
            </Result>
        </ListSystemEventsResponse>
    </s:Body>
</s:Envelope>

Consulta la referencia completa de los campos de SystemEventView en Objetos de respuesta.

Eventos de HA

`ListHAEvents`

Devuelve la lista de eventos del clúster de alta disponibilidad que coinciden con los parámetros indicados, ordenados por fecha. Devuelve objetos SystemEventView con el mismo formato que ListSystemEvents.

Nombre	Tipo	Requerido	Descripción
`filter`	string	No	Texto que deben contener los resultados. Si está vacío, devuelve todos los eventos.
`numBlock`	integer	Sí	Número de bloque de resultados a devolver (paginación). El primer bloque es `0`.
`orderColumn`	string	Sí	Columna de ordenación: `ORDER_BY_DATE`, `ORDER_BY_IP`, `ORDER_BY_USER`, `ORDER_BY_SECTION`, `ORDER_BY_INFORMATION`.
`orderType`	string	Sí	Dirección de ordenación: `ORDER_ASCENDING`, `ORDER_DESCENDING`.
`dateFilterType`	string	Sí	Filtro de fecha predefinido. Mismos valores que en `ListEvents`.
`from`	datetime	No	Fecha de inicio del rango personalizado. Solo se usa cuando `dateFilterType` es `DATE_FILTER_CUSTOM_FILTER`.
`to`	datetime	No	Fecha de fin del rango personalizado. Solo se usa cuando `dateFilterType` es `DATE_FILTER_CUSTOM_FILTER`.

Petición
Respuesta

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:urn="urn:evolium:redtrust:administration:ws">
    <soap:Header/>
    <soap:Body>
        <urn:ListHAEvents>
            <urn:filter></urn:filter>
            <urn:numBlock>0</urn:numBlock>
            <urn:orderColumn>ORDER_BY_DATE</urn:orderColumn>
            <urn:orderType>ORDER_DESCENDING</urn:orderType>
            <urn:dateFilterType>NO_DATE_FILTER</urn:dateFilterType>
        </urn:ListHAEvents>
    </soap:Body>
</soap:Envelope>

<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:a="http://www.w3.org/2005/08/addressing">
    <s:Header>
        <a:Action s:mustUnderstand="1">urn:evolium:redtrust:administration:ws/RTAdminService/ListHAEventsResponse</a:Action>
    </s:Header>
    <s:Body>
        <ListHAEventsResponse xmlns="urn:evolium:redtrust:administration:ws">
            <Result xmlns:b="http://schemas.datacontract.org/2004/07/RTAdminService.Types" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <ResultStatus xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">SUCCESS</ResultStatus>
                <ErrorCode xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">OK</ErrorCode>
                <ResultMessage xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">Operation finalized successfully</ResultMessage>
                <ResultData i:type="b:ArrayOfSystemEventView" xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">
                    <b:SystemEventView>
                        <b:context i:nil="true"/>
                        <b:dateTime>2026-04-20T03:00:00</b:dateTime>
                        <b:information>Node failover completed</b:information>
                        <b:ip>192.168.1.51</b:ip>
                        <b:newData i:nil="true"/>
                        <b:oldData i:nil="true"/>
                        <b:section>HA</b:section>
                        <b:user i:nil="true"/>
                    </b:SystemEventView>
                </ResultData>
                <TotalItems xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">1</TotalItems>
            </Result>
        </ListHAEventsResponse>
    </s:Body>
</s:Envelope>

Consulta la referencia completa de los campos de SystemEventView en Objetos de respuesta.

Exporta eventos

`DownloadCSVEvents`

Descarga un archivo CSV con los eventos de certificado que coinciden con los parámetros indicados. Los parámetros van en la cabecera SOAP, no en el cuerpo.

Nombre	Tipo	Requerido	Descripción
`basicFilter` (cabecera)	string	No	Texto que deben contener los resultados. Si está vacío, incluye todos los eventos.
`filterType` (cabecera)	string	Sí	Filtra por tipo de evento. Mismos valores que en `ListEvents`.
`dateFilterType` (cabecera)	string	Sí	Filtro de fecha predefinido. Mismos valores que en `ListEvents`.
`from` (cabecera)	datetime	No	Fecha de inicio del rango personalizado. Solo se usa cuando `dateFilterType` es `DATE_FILTER_CUSTOM_FILTER`.
`to` (cabecera)	datetime	No	Fecha de fin del rango personalizado. Solo se usa cuando `dateFilterType` es `DATE_FILTER_CUSTOM_FILTER`.

Petición
Respuesta

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:urn="urn:evolium:redtrust:administration:ws">
    <soap:Header>
        <urn:basicFilter></urn:basicFilter>
        <urn:filterType>NO_FILTER</urn:filterType>
        <urn:dateFilterType>NO_DATE_FILTER</urn:dateFilterType>
    </soap:Header>
    <soap:Body>
        <urn:CSVFilteredWithDatesMessage/>
    </soap:Body>
</soap:Envelope>

El estado del resultado y el nombre del archivo se devuelven en la cabecera SOAP de la respuesta. El contenido del archivo va en el cuerpo como un adjunto binario MTOM.

<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:a="http://www.w3.org/2005/08/addressing">
    <s:Header>
        <a:Action s:mustUnderstand="1">urn:evolium:redtrust:administration:ws/RTAdminService/DownloadCSVEventsResponse</a:Action>
        <h:result s:mustUnderstand="1" xmlns:h="urn:evolium:redtrust:administration:ws" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <ResultStatus xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">SUCCESS</ResultStatus>
            <ErrorCode xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">OK</ErrorCode>
            <ResultMessage xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">Operation finalized successfully</ResultMessage>
            <Filename xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">Events_202605061401.csv</Filename>
        </h:result>
    </s:Header>
    <s:Body>
        <ResultFileStream xmlns="urn:evolium:redtrust:administration:ws">
            <stream>
                <xop:Include href="cid:http://tempuri.org/1/639136728960186888" xmlns:xop="http://www.w3.org/2004/08/xop/include"/>
            </stream>
        </ResultFileStream>
    </s:Body>
</s:Envelope>

¿Te ha resultado útil esta página?

Descripción general​

Antes de empezar​

Eventos de certificado​

ListEvents​

Eventos de sistema​

ListSystemEvents​

Eventos de HA​

ListHAEvents​

Exporta eventos​

DownloadCSVEvents​