Versión: 4.42

Referencia de la API — Gestión de grupos de políticas

Descripción general

Los grupos de políticas son los recursos que definen el contexto de aplicación de una política. Antes de crear una política, debes crear los grupos de aplicaciones y los grupos de sitios que usará.

Los grupos de aplicaciones definen qué aplicaciones de escritorio pueden usar los certificados bajo una política.
Los grupos de sitios definen qué sitios web pueden usar los certificados bajo una política.

Una vez creados, usa los IDs de estos grupos como parámetros applicationGroupIds y siteGroupIds en AddPolicy y EditPolicy.

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.

Grupos de aplicaciones

`ListApplicationGroups`

Devuelve la lista de grupos de aplicaciones definidos en el sistema.

Nombre	Tipo	Requerido	Descripción
`filter`	string	No	Texto que deben contener los resultados. Si está vacío, devuelve todos los grupos.

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:ListApplicationGroups>
            <urn:filter></urn:filter>
        </urn:ListApplicationGroups>
    </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/ListApplicationGroupsResponse</a:Action>
    </s:Header>
    <s:Body>
        <ListApplicationGroupsResponse 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:GroupsResponse" xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">
                    <b:globalApps>true</b:globalApps>
                    <b:groups>
                        <b:BaseGroup i:type="b:ApplicationGroup">
                            <b:friendlyName>Javaw</b:friendlyName>
                            <b:groupId>1</b:groupId>
                            <b:roleId>0</b:roleId>
                            <b:roleName i:nil="true"/>
                            <b:applications>
                                <b:Application>
                                    <b:expType>PROCESS</b:expType>
                                    <b:id>5</b:id>
                                    <b:name>javaw</b:name>
                                </b:Application>
                            </b:applications>
                            <b:mappedSites xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
                        </b:BaseGroup>
                    </b:groups>
                </ResultData>
            </Result>
        </ListApplicationGroupsResponse>
    </s:Body>
</s:Envelope>

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

`GetApplicationGroup`

Devuelve los datos completos de un grupo de aplicaciones.

Nombre	Tipo	Requerido	Descripción
`appGroupId`	integer	Sí	ID del grupo de aplicaciones. Encuentra el valor en `ListApplicationGroups`.

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:GetApplicationGroup>
            <urn:appGroupId>1</urn:appGroupId>
        </urn:GetApplicationGroup>
    </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/GetApplicationGroupResponse</a:Action>
    </s:Header>
    <s:Body>
        <GetApplicationGroupResponse 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:ApplicationGroup" xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">
                    <b:friendlyName>Javaw</b:friendlyName>
                    <b:groupId>1</b:groupId>
                    <b:roleId>0</b:roleId>
                    <b:roleName i:nil="true"/>
                    <b:applications>
                        <b:Application>
                            <b:expType>PROCESS</b:expType>
                            <b:id>5</b:id>
                            <b:name>javaw</b:name>
                        </b:Application>
                    </b:applications>
                    <b:mappedSites xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
                </ResultData>
            </Result>
        </GetApplicationGroupResponse>
    </s:Body>
</s:Envelope>

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

`AddApplicationGroup`

Crea un grupo de aplicaciones en el sistema.

Nombre	Tipo	Requerido	Descripción
`name`	string	Sí	Nombre del grupo de aplicaciones.
`applications`	array de Application	Sí	Lista de aplicaciones del grupo. Cada elemento incluye: `expType` (tipo de expresión: `PROCESS` para nombre de proceso, `REGEXP` para expresión regular estándar, `RTREGEXP` para expresión regular de Redtrust, `COMMAND_LINE` para línea de comandos), `id` (entero positivo único que no esté ya asignado a otra aplicación) y `name` (nombre del proceso o patrón).
`mappedSites`	array de strings	No	Lista de sitios web asociados al grupo de aplicaciones.

Petición
Respuesta

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:urn="urn:evolium:redtrust:administration:ws" xmlns:rtad="http://schemas.datacontract.org/2004/07/RTAdminService.Types">
    <soap:Header/>
    <soap:Body>
        <urn:AddApplicationGroup>
            <urn:name>Navegadores web</urn:name>
            <urn:applications>
                <rtad:Application>
                    <rtad:expType>PROCESS</rtad:expType>
                    <rtad:id>1</rtad:id>
                    <rtad:name>msedge.exe</rtad:name>
                </rtad:Application>
                <rtad:Application>
                    <rtad:expType>PROCESS</rtad:expType>
                    <rtad:id>2</rtad:id>
                    <rtad:name>chrome.exe</rtad:name>
                </rtad:Application>
            </urn:applications>
            <urn:mappedSites/>
        </urn:AddApplicationGroup>
    </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/AddApplicationGroupResponse</a:Action>
    </s:Header>
    <s:Body>
        <AddApplicationGroupResponse 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="c:int" xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult" xmlns:c="http://www.w3.org/2001/XMLSchema">1</ResultData>
            </Result>
        </AddApplicationGroupResponse>
    </s:Body>
</s:Envelope>

El campo ResultData contiene el ID del nuevo grupo de aplicaciones.

`UpdateApplicationGroup`

Actualiza un grupo de aplicaciones existente. La lista de aplicaciones reemplaza los valores actuales por completo; omitir un elemento lo elimina del grupo.

Nombre	Tipo	Requerido	Descripción
`appGroupId`	integer	Sí	ID del grupo que quieres actualizar. Encuentra el valor en `ListApplicationGroups`.
`name`	string	Sí	Nuevo nombre del grupo de aplicaciones.
`applications`	array de Application	Sí	Nueva lista completa de aplicaciones. Reemplaza la lista actual. Cada elemento incluye: `expType` (tipo de expresión: `PROCESS`, `REGEXP`, `RTREGEXP`, `COMMAND_LINE`), `id` (entero positivo único que no esté ya asignado a otra aplicación) y `name` (nombre del proceso o patrón).
`mappedSites`	array de strings	No	Nueva lista de sitios web asociados. Reemplaza la lista actual.

Petición
Respuesta

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:urn="urn:evolium:redtrust:administration:ws" xmlns:rtad="http://schemas.datacontract.org/2004/07/RTAdminService.Types">
    <soap:Header/>
    <soap:Body>
        <urn:UpdateApplicationGroup>
            <urn:appGroupId>1</urn:appGroupId>
            <urn:name>Navegadores web</urn:name>
            <urn:applications>
                <rtad:Application>
                    <rtad:expType>PROCESS</rtad:expType>
                    <rtad:id>1</rtad:id>
                    <rtad:name>msedge.exe</rtad:name>
                </rtad:Application>
                <rtad:Application>
                    <rtad:expType>PROCESS</rtad:expType>
                    <rtad:id>2</rtad:id>
                    <rtad:name>chrome.exe</rtad:name>
                </rtad:Application>
                <rtad:Application>
                    <rtad:expType>PROCESS</rtad:expType>
                    <rtad:id>3</rtad:id>
                    <rtad:name>firefox.exe</rtad:name>
                </rtad:Application>
            </urn:applications>
            <urn:mappedSites/>
        </urn:UpdateApplicationGroup>
    </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/UpdateApplicationGroupResponse</a:Action>
    </s:Header>
    <s:Body>
        <UpdateApplicationGroupResponse 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="c:int" xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult" xmlns:c="http://www.w3.org/2001/XMLSchema">1</ResultData>
            </Result>
        </UpdateApplicationGroupResponse>
    </s:Body>
</s:Envelope>

El campo ResultData contiene el ID del grupo de aplicaciones actualizado.

`DeleteApplicationGroups`

Elimina uno o más grupos de aplicaciones.

Nombre	Tipo	Requerido	Descripción
`appGroupIds`	array de enteros	Sí	IDs de los grupos que quieres eliminar. Encuentra los valores en `ListApplicationGroups`.
`forceDelete`	boolean	Sí	Si es `true`, elimina el grupo aunque esté en uso en políticas. Si es `false`, la operación falla si el grupo está en uso.

Petición
Respuesta

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:urn="urn:evolium:redtrust:administration:ws" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <soap:Header/>
    <soap:Body>
        <urn:DeleteApplicationGroups>
            <urn:appGroupIds>
                <arr:int>1</arr:int>
                <arr:int>2</arr:int>
            </urn:appGroupIds>
            <urn:forceDelete>false</urn:forceDelete>
        </urn:DeleteApplicationGroups>
    </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/DeleteApplicationGroupsResponse</a:Action>
    </s:Header>
    <s:Body>
        <DeleteApplicationGroupsResponse 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>
            </Result>
        </DeleteApplicationGroupsResponse>
    </s:Body>
</s:Envelope>

`TestValueInWheres`

Comprueba si un valor coincide con una o más expresiones. Útil para verificar que los patrones de un grupo funcionan correctamente antes de usarlos en una política.

Nombre	Tipo	Requerido	Descripción
`value`	string	Sí	Valor que quieres comprobar (por ejemplo, el nombre de un proceso).
`itemTests`	array de WhereItemTest	Sí	Lista de expresiones contra las que se comprueba el valor. Cada elemento de la petición debe incluir: `expType` (requerido; tipo de expresión: `PROCESS`, `REGEXP`, `RTREGEXP`, `COMMAND_LINE`), `value` (requerido; patrón o nombre) e `itemId` (requerido; identificador externo para correlacionar resultados). No incluyas `matchExpression` en la petición: el servidor devuelve un error si está presente. En la respuesta, cada elemento también incluye `internalId`, `postData` y `matchExpression` (`true` si el valor coincide con la expresión, `false` si no).

Petición
Respuesta

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:urn="urn:evolium:redtrust:administration:ws" xmlns:rtad="http://schemas.datacontract.org/2004/07/RTAdminService.Types">
    <soap:Header/>
    <soap:Body>
        <urn:TestValueInWheres>
            <urn:value>msedge.exe</urn:value>
            <urn:itemTests>
                <rtad:WhereItemTest>
                    <rtad:expType>PROCESS</rtad:expType>
                    <rtad:value>msedge.exe</rtad:value>
                    <rtad:itemId>test-1</rtad:itemId>
                </rtad:WhereItemTest>
                <rtad:WhereItemTest>
                    <rtad:expType>PROCESS</rtad:expType>
                    <rtad:value>chrome.exe</rtad:value>
                    <rtad:itemId>test-2</rtad:itemId>
                </rtad:WhereItemTest>
            </urn:itemTests>
        </urn:TestValueInWheres>
    </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/TestValueInWheresResponse</a:Action>
    </s:Header>
    <s:Body>
        <TestValueInWheresResponse 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:ArrayOfWhereItemTest" xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">
                    <b:WhereItemTest>
                        <b:expType>PROCESS</b:expType>
                        <b:internalId>0</b:internalId>
                        <b:postData i:nil="true"/>
                        <b:value>msedge.exe</b:value>
                        <b:itemId>test-1</b:itemId>
                        <b:matchExpression>true</b:matchExpression>
                    </b:WhereItemTest>
                    <b:WhereItemTest>
                        <b:expType>PROCESS</b:expType>
                        <b:internalId>0</b:internalId>
                        <b:postData i:nil="true"/>
                        <b:value>chrome.exe</b:value>
                        <b:itemId>test-2</b:itemId>
                        <b:matchExpression>false</b:matchExpression>
                    </b:WhereItemTest>
                </ResultData>
            </Result>
        </TestValueInWheresResponse>
    </s:Body>
</s:Envelope>

Cada elemento de ResultData incluye el campo matchExpression: true si el valor coincide con la expresión, false si no.

`DownloadApplicationsCSV`

Descarga un archivo CSV con la lista de grupos de aplicaciones del sistema. 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 grupos.

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>
    </soap:Header>
    <soap:Body>
        <urn:DownloadApplicationsCSV/>
    </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/DownloadApplicationsCSVResponse</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">Applications_202605070928.csv</Filename>
        </h:result>
    </s:Header>
    <s:Body>
        <ResultFileStream xmlns="urn:evolium:redtrust:administration:ws">
            <stream>
                <xop:Include href="cid:http://tempuri.org/1/639137428825129817" xmlns:xop="http://www.w3.org/2004/08/xop/include"/>
            </stream>
        </ResultFileStream>
    </s:Body>
</s:Envelope>

Grupos de sitios

`ListSiteGroups`

Devuelve la lista de grupos de sitios definidos en el sistema.

Nombre	Tipo	Requerido	Descripción
`q`	string	No	Texto que deben contener los resultados. Si está vacío, devuelve todos los grupos.

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:ListSiteGroups>
            <urn:q></urn:q>
        </urn:ListSiteGroups>
    </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/ListSiteGroupsResponse</a:Action>
    </s:Header>
    <s:Body>
        <ListSiteGroupsResponse 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:GroupsResponse" xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">
                    <b:globalApps>true</b:globalApps>
                    <b:groups>
                        <b:BaseGroup i:type="b:SiteGroup">
                            <b:friendlyName>all.sites</b:friendlyName>
                            <b:groupId>3</b:groupId>
                            <b:roleId>0</b:roleId>
                            <b:roleName i:nil="true"/>
                            <b:mappedSites xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
                            <b:sites>
                                <b:Site>
                                    <b:expType>REGEXP</b:expType>
                                    <b:id>3</b:id>
                                    <b:name>.*</b:name>
                                    <b:postdata/>
                                </b:Site>
                            </b:sites>
                        </b:BaseGroup>
                    </b:groups>
                </ResultData>
            </Result>
        </ListSiteGroupsResponse>
    </s:Body>
</s:Envelope>

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

`GetSitesGroup`

Devuelve los datos completos de un grupo de sitios.

Nombre	Tipo	Requerido	Descripción
`sitesGroupId`	integer	Sí	ID del grupo de sitios. Encuentra el valor en `ListSiteGroups`.

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:GetSitesGroup>
            <urn:sitesGroupId>3</urn:sitesGroupId>
        </urn:GetSitesGroup>
    </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/GetSitesGroupResponse</a:Action>
    </s:Header>
    <s:Body>
        <GetSitesGroupResponse 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:SiteGroup" xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">
                    <b:friendlyName>all.sites</b:friendlyName>
                    <b:groupId>3</b:groupId>
                    <b:roleId>0</b:roleId>
                    <b:roleName i:nil="true"/>
                    <b:mappedSites xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
                    <b:sites>
                        <b:Site>
                            <b:expType>REGEXP</b:expType>
                            <b:id>3</b:id>
                            <b:name>.*</b:name>
                            <b:postdata/>
                        </b:Site>
                    </b:sites>
                </ResultData>
            </Result>
        </GetSitesGroupResponse>
    </s:Body>
</s:Envelope>

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

`AddSitesGroup`

Crea un grupo de sitios en el sistema.

Nombre	Tipo	Requerido	Descripción
`name`	string	Sí	Nombre del grupo de sitios.
`sites`	array de Site	Sí	Lista de sitios del grupo. Cada elemento incluye: `expType` (tipo de expresión: `REGEXP` para expresión regular estándar, `RTREGEXP` para expresión regular de Redtrust), `id` (entero positivo único que no esté ya asignado a otro sitio), `name` (URL o patrón del sitio) y `postdata` (datos POST opcionales para distinguir sitios con la misma URL; usa un elemento vacío si no aplica).
`mappedSites`	array de strings	No	Lista de sitios web adicionales asociados al grupo.

Petición
Respuesta

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:urn="urn:evolium:redtrust:administration:ws" xmlns:rtad="http://schemas.datacontract.org/2004/07/RTAdminService.Types">
    <soap:Header/>
    <soap:Body>
        <urn:AddSitesGroup>
            <urn:name>Portal corporativo</urn:name>
            <urn:sites>
                <rtad:Site>
                    <rtad:expType>REGEXP</rtad:expType>
                    <rtad:id>1</rtad:id>
                    <rtad:name>portal.example.com</rtad:name>
                    <rtad:postdata/>
                </rtad:Site>
            </urn:sites>
            <urn:mappedSites/>
        </urn:AddSitesGroup>
    </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/AddSitesGroupResponse</a:Action>
    </s:Header>
    <s:Body>
        <AddSitesGroupResponse 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="c:int" xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult" xmlns:c="http://www.w3.org/2001/XMLSchema">2</ResultData>
            </Result>
        </AddSitesGroupResponse>
    </s:Body>
</s:Envelope>

El campo ResultData contiene el ID del nuevo grupo de sitios.

`UpdateSitesGroup`

Actualiza un grupo de sitios existente. La lista de sitios reemplaza los valores actuales por completo; omitir un elemento lo elimina del grupo.

Nombre	Tipo	Requerido	Descripción
`sitesGroupId`	integer	Sí	ID del grupo que quieres actualizar. Encuentra el valor en `ListSiteGroups`.
`name`	string	Sí	Nuevo nombre del grupo de sitios.
`sites`	array de Site	Sí	Nueva lista completa de sitios. Reemplaza la lista actual. Cada elemento incluye: `expType` (tipo de expresión: `REGEXP`, `RTREGEXP`), `id` (entero positivo único que no esté ya asignado a otro sitio), `name` (URL o patrón del sitio) y `postdata` (datos POST opcionales; usa un elemento vacío si no aplica).
`mappedSites`	array de strings	No	Nueva lista de sitios web adicionales. Reemplaza la lista actual.

Petición
Respuesta

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:urn="urn:evolium:redtrust:administration:ws" xmlns:rtad="http://schemas.datacontract.org/2004/07/RTAdminService.Types">
    <soap:Header/>
    <soap:Body>
        <urn:UpdateSitesGroup>
            <urn:sitesGroupId>2</urn:sitesGroupId>
            <urn:name>Portal corporativo</urn:name>
            <urn:sites>
                <rtad:Site>
                    <rtad:expType>REGEXP</rtad:expType>
                    <rtad:id>1</rtad:id>
                    <rtad:name>portal.example.com</rtad:name>
                    <rtad:postdata/>
                </rtad:Site>
            </urn:sites>
            <urn:mappedSites/>
        </urn:UpdateSitesGroup>
    </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/UpdateSitesGroupResponse</a:Action>
    </s:Header>
    <s:Body>
        <UpdateSitesGroupResponse 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="c:int" xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult" xmlns:c="http://www.w3.org/2001/XMLSchema">2</ResultData>
            </Result>
        </UpdateSitesGroupResponse>
    </s:Body>
</s:Envelope>

El campo ResultData contiene el ID del grupo de sitios actualizado.

`DeleteSitesGroups`

Elimina uno o más grupos de sitios.

Nombre	Tipo	Requerido	Descripción
`siteGroupIds`	array de enteros	Sí	IDs de los grupos que quieres eliminar. Encuentra los valores en `ListSiteGroups`.
`forceDelete`	boolean	Sí	Si es `true`, elimina el grupo aunque esté en uso en políticas. Si es `false`, la operación falla si el grupo está en uso.

Petición
Respuesta

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:urn="urn:evolium:redtrust:administration:ws" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <soap:Header/>
    <soap:Body>
        <urn:DeleteSitesGroups>
            <urn:siteGroupIds>
                <arr:int>2</arr:int>
            </urn:siteGroupIds>
            <urn:forceDelete>false</urn:forceDelete>
        </urn:DeleteSitesGroups>
    </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/DeleteSitesGroupsResponse</a:Action>
    </s:Header>
    <s:Body>
        <DeleteSitesGroupsResponse 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>
            </Result>
        </DeleteSitesGroupsResponse>
    </s:Body>
</s:Envelope>

`DownloadSitesCSV`

Descarga un archivo CSV con la lista de grupos de sitios del sistema. 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 grupos.

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>
    </soap:Header>
    <soap:Body>
        <urn:DownloadSitesCSV/>
    </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/DownloadSitesCSVResponse</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">Sites_202605070928.csv</Filename>
        </h:result>
    </s:Header>
    <s:Body>
        <ResultFileStream xmlns="urn:evolium:redtrust:administration:ws">
            <stream>
                <xop:Include href="cid:http://tempuri.org/1/639137428825129817" 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​

Grupos de aplicaciones​

ListApplicationGroups​

GetApplicationGroup​

AddApplicationGroup​

UpdateApplicationGroup​

DeleteApplicationGroups​

TestValueInWheres​

DownloadApplicationsCSV​

Grupos de sitios​

ListSiteGroups​

GetSitesGroup​

AddSitesGroup​

UpdateSitesGroup​

DeleteSitesGroups​

DownloadSitesCSV​