Versión: 4.42

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

Descripción general

Las políticas controlan qué certificados pueden usar qué usuarios, en qué aplicaciones y sitios, y cuándo. Esta documentación describe los métodos para gestionar el ciclo de vida completo de las políticas: crearlas, consultarlas, editarlas, activarlas o desactivarlas y eliminarlas.

nota

Antes de crear una política necesitas los IDs de los grupos de aplicaciones y grupos de sitios que quieres asociar. Consulta la referencia de gestión de grupos de políticas para crear esos recursos primero.

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.

Crea una política

`AddPolicy`

Crea una nueva política en el sistema.

Nombre	Tipo	Requerido	Descripción
`name`	string	Sí	Nombre de la política.
`comment`	string	No	Descripción o comentario libre sobre la política.
`priority`	integer	Sí	Prioridad de la política. Los valores más bajos tienen mayor prioridad.
`active`	boolean	Sí	Si es `true`, la política está activa desde el momento de su creación.
`certificateIds`	array de enteros	No	IDs de los certificados individuales incluidos en la política.
`certificateGroupIds`	array de enteros	No	IDs de los grupos de certificados incluidos en la política.
`userUIds`	array de strings	No	UID de los usuarios incluidos en la política, en formato `USER:<id>@<dominio>`. Encuentra los valores en `ListUsersInDomain`.
`applicationGroupIds`	array de enteros	No	IDs de los grupos de aplicaciones donde se aplica la política. Encuentra los valores en `ListApplicationGroups`.
`siteGroupIds`	array de enteros	No	IDs de los grupos de sitios donde se aplica la política. Encuentra los valores en `ListSiteGroups`.
`dss`	boolean	Sí	Si es `true`, la política permite el uso del servicio DSS.
`macAgent`	boolean	Sí	Si es `true`, la política permite el uso del Agente macOS.
`whens`	When	Sí	Planificación horaria de la política. Incluye: `always` (`true` para que la política sea siempre válida; `false` para usar franjas horarias personalizadas) y `entries` (lista de `WhenEntry` con `days` (días de la semana), `startDate`, `endDate`, `startTime` y `endTime`). Si `always` es `true`, envía `entries` vacío.
`action`	string	Sí	Acción de la política: `ALLOW` para permitir el uso del certificado, `DENY` para denegarlo.
`allowAllBrowsers`	boolean	Sí	Si es `true`, la política aplica a todos los navegadores y `allowedBrowsers` se ignora.
`allowedBrowsers`	array de SupportedBrowsers	No	Navegadores a los que aplica la política cuando `allowAllBrowsers` es `false`. Valores: `IE`, `FF`, `CH`, `EDGE`.
`userPinPolicy`	string	Sí	Comportamiento del PIN de usuario: `DO_NOTHING` (no afecta al PIN), `ASK_FOR_USER_PIN` (solicita PIN al usuario), `DONT_ASK_FOR_USER_PIN` (no solicita PIN aunque el certificado lo requiera).

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" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <soap:Header/>
    <soap:Body>
        <urn:AddPolicy>
            <urn:name>Acceso portal corporativo</urn:name>
            <urn:comment></urn:comment>
            <urn:priority>1</urn:priority>
            <urn:active>true</urn:active>
            <urn:certificateIds/>
            <urn:certificateGroupIds/>
            <urn:userUIds/>
            <urn:applicationGroupIds/>
            <urn:siteGroupIds/>
            <urn:dss>false</urn:dss>
            <urn:macAgent>false</urn:macAgent>
            <urn:whens>
                <rtad:always>true</rtad:always>
                <rtad:entries/>
            </urn:whens>
            <urn:action>ALLOW</urn:action>
            <urn:allowAllBrowsers>true</urn:allowAllBrowsers>
            <urn:allowedBrowsers>
                <rtad:SupportedBrowsers></rtad:SupportedBrowsers>
            </urn:allowedBrowsers>
            <urn:userPinPolicy>DO_NOTHING</urn:userPinPolicy>
        </urn:AddPolicy>
    </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/AddPolicyResponse</a:Action>
    </s:Header>
    <s:Body>
        <AddPolicyResponse 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">10</ResultData>
            </Result>
        </AddPolicyResponse>
    </s:Body>
</s:Envelope>

El campo ResultData contiene el ID de la nueva política.

Consulta políticas

`ListPolicies`

Devuelve la lista de políticas del sistema con sus datos principales.

Nombre	Tipo	Requerido	Descripción
`viewType`	string	Sí	Filtra las políticas por tipo: `VIEW_ALL`, `VIEW_ALLOWED` (solo acción ALLOW), `VIEW_DENIED` (solo acción DENY), `VIEW_ACTIVE`, `VIEW_INACTIVE`.
`filter`	string	No	Texto que deben contener los resultados. Si está vacío, devuelve todas las políticas.
`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_PRIORITY`, `ORDER_BY_STATUS`, `ORDER_BY_NAME`, `ORDER_BY_PERMISSION`.
`orderType`	string	Sí	Dirección de ordenación: `ORDER_ASCENDING`, `ORDER_DESCENDING`.

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:ListPolicies>
            <urn:viewType>VIEW_ALL</urn:viewType>
            <urn:filter></urn:filter>
            <urn:numBlock>0</urn:numBlock>
            <urn:orderColumn>ORDER_BY_PRIORITY</urn:orderColumn>
            <urn:orderType>ORDER_ASCENDING</urn:orderType>
        </urn:ListPolicies>
    </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/ListPoliciesResponse</a:Action>
    </s:Header>
    <s:Body>
        <ListPoliciesResponse 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:ArrayOfPolicyView" xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">                        
                    <b:PolicyView>
                        <b:action>ALLOW</b:action>
                        <b:active>false</b:active>
                        <b:certificates xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
                        <b:context>
                            <b:apps xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
                            <b:browsers xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
                                <c:string>All browsers</c:string>
                            </b:browsers>
                            <b:dss>false</b:dss>
                            <b:macAgent>false</b:macAgent>
                            <b:sites xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
                                <c:string>SSO eCAC</c:string>
                                <c:string>DCTF eCAC</c:string>
                            </b:sites>
                        </b:context>
                        <b:groups xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
                            <c:string>cert_group2</c:string>
                        </b:groups>
                        <b:idRole>-1</b:idRole>
                        <b:name>eCAC DCTF</b:name>
                        <b:policyId>6</b:policyId>
                        <b:priority>1</b:priority>
                        <b:role/>
                        <b:userGroups xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
                            <c:string>UserGroup_local.users@local.users</c:string>
                        </b:userGroups>
                        <b:userPinPolicy>DO_NOTHING</b:userPinPolicy>
                        <b:users xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
                    </b:PolicyView>
                </ResultData>
                <TotalItems xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">1</TotalItems>
            </Result>
        </ListPoliciesResponse>
    </s:Body>
</s:Envelope>

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

`GetPolicyData`

Devuelve los datos completos de una política, incluyendo los detalles de los certificados, usuarios, grupos de aplicaciones y grupos de sitios asociados.

Nombre	Tipo	Requerido	Descripción
`policyId`	integer	Sí	ID de la política. Encuentra el valor en `ListPolicies` o `ListPolicyIds`.

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:GetPolicyData>
            <urn:policyId>10</urn:policyId>
        </urn:GetPolicyData>
    </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/GetPolicyDataResponse</a:Action>
    </s:Header>
    <s:Body>
        <GetPolicyDataResponse 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:Policy" xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">
                    <b:action>ALLOW</b:action>
                    <b:active>false</b:active>
                    <b:allowAllBrowser>true</b:allowAllBrowser>
                    <b:allowedBrowsers i:nil="true"/>
                    <b:applications/>
                    <b:certificateGroups/>
                    <b:certificates>
                        <b:Certificate>
                            <b:active>true</b:active>
                            <b:alias>another-certificate</b:alias>
                            <b:certificateHandler>1021</b:certificateHandler>
                            <b:certificateUserPinPolicy>NO_USER_PIN</b:certificateUserPinPolicy>
                            <b:expirationDate>2028-10-30T10:06:59</b:expirationDate>
                            <b:groupHandlers i:nil="true" xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
                            <b:needPin>false</b:needPin>
                            <b:policyHandlers i:nil="true" xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
                            <b:usageReason>false</b:usageReason>
                            <b:userHandlers i:nil="true" xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
                        </b:Certificate>
                    </b:certificates>
                    <b:comment/>
                    <b:dss>false</b:dss>
                    <b:macAgent>false</b:macAgent>
                    <b:name>Izenpe - Egoitza Gipuzkoa</b:name>
                    <b:policyId>14</b:policyId>
                    <b:priority>1</b:priority>
                    <b:sites/>
                    <b:userPinPolicy>DO_NOTHING</b:userPinPolicy>
                    <b:users>
                        <b:UserView>
                            <b:consumeLicense>true</b:consumeLicense>
                            <b:domain>elena.local</b:domain>
                            <b:email>final@mail.com</b:email>
                            <b:friendlyName>final</b:friendlyName>
                            <b:groupType>USER</b:groupType>
                            <b:lastCertificateUsage>2026-04-28T12:25:18.483</b:lastCertificateUsage>
                            <b:passwordExpirationDate i:nil="true"/>
                            <b:status>true</b:status>
                            <b:type>LOCAL_USER</b:type>
                            <b:uid>USER:4@elena.local</b:uid>
                            <b:userHandler>4</b:userHandler>
                            <b:username>final</b:username>
                        </b:UserView>
                    </b:users>
                    <b:when>
                        <b:always>true</b:always>
                        <b:entries/>
                    </b:when>
                </ResultData>
            </Result>
        </GetPolicyDataResponse>
    </s:Body>
</s:Envelope>

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

`ListPolicyIds`

Devuelve la lista de IDs de políticas. Usa este método para obtener los valores de policyId o policyIds.

Nombre	Tipo	Requerido	Descripción
`viewType`	string	Sí	Filtra las políticas por tipo: `VIEW_ALL`, `VIEW_ALLOWED`, `VIEW_DENIED`, `VIEW_ACTIVE`, `VIEW_INACTIVE`.
`filter`	string	No	Texto que deben contener los resultados. Si está vacío, devuelve todos los IDs.
`filterByAction`	string	No	Filtra por acción: `ALLOW` o `DENY`. No puede enviarse vacío.
`filterByActive`	boolean	No	Si es `true`, devuelve solo políticas activas. Si es `false`, solo inactivas. No puede enviarse vacío.

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:ListPolicyIds>
            <urn:viewType>VIEW_ALL</urn:viewType>
            <urn:filter></urn:filter>
            <urn:filterByAction>ALLOW</urn:filterByAction>
            <urn:filterByActive>true</urn:filterByActive>
        </urn:ListPolicyIds>
    </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/ListPolicyIdsResponse</a:Action>
    </s:Header>
    <s:Body>
        <ListPolicyIdsResponse 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:ArrayOfint" xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult" xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
                    <c:int>10</c:int>
                    <c:int>11</c:int>
                    <c:int>12</c:int>
                </ResultData>
                <TotalItems xmlns="http://schemas.datacontract.org/2004/07/RTService.ModelsResult">3</TotalItems>
            </Result>
        </ListPolicyIdsResponse>
    </s:Body>
</s:Envelope>

Actualiza una política

`EditPolicy`

Actualiza una política existente. Todos los parámetros reemplazan los valores actuales por completo.

Nombre	Tipo	Requerido	Descripción
`policyId`	integer	Sí	ID de la política que quieres actualizar. Encuentra el valor en `ListPolicies`.
`name`	string	Sí	Nombre de la política.
`comment`	string	No	Descripción o comentario libre sobre la política.
`priority`	integer	Sí	Prioridad de la política. Los valores más bajos tienen mayor prioridad.
`active`	boolean	Sí	Estado de la política.
`certificateIds`	array de enteros	No	IDs de los certificados individuales incluidos en la política.
`certificateGroupIds`	array de enteros	No	IDs de los grupos de certificados incluidos en la política.
`userUIds`	array de strings	No	UID de los usuarios incluidos en la política.
`applicationGroupIds`	array de enteros	No	IDs de los grupos de aplicaciones donde se aplica la política.
`siteGroupIds`	array de enteros	No	IDs de los grupos de sitios donde se aplica la política.
`dss`	boolean	Sí	Si es `true`, la política permite el uso del servicio DSS.
`macAgent`	boolean	Sí	Si es `true`, la política permite el uso del Agente macOS.
`whens`	When	Sí	Planificación horaria de la política. Misma estructura que en `AddPolicy`.
`action`	string	Sí	Acción de la política: `ALLOW` o `DENY`.
`allowAllBrowsers`	boolean	Sí	Si es `true`, la política aplica a todos los navegadores.
`allowedBrowsers`	array de SupportedBrowsers	No	Navegadores específicos cuando `allowAllBrowsers` es `false`. Valores: `IE`, `FF`, `CH`, `EDGE`.
`userPinPolicy`	string	Sí	Comportamiento del PIN: `DO_NOTHING`, `ASK_FOR_USER_PIN`, `DONT_ASK_FOR_USER_PIN`.

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" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <soap:Header/>
    <soap:Body>
        <urn:EditPolicy>
            <urn:policyId>10</urn:policyId>
            <urn:name>Acceso portal corporativo</urn:name>
            <urn:comment>Permite el uso de certificados en el portal de la empresa</urn:comment>
            <urn:priority>1</urn:priority>
            <urn:active>true</urn:active>
            <urn:certificateIds>
                <arr:int>101</arr:int>
            </urn:certificateIds>
            <urn:certificateGroupIds/>
            <urn:userUIds>
                <arr:string>USER:1007@local.users</arr:string>
            </urn:userUIds>
            <urn:applicationGroupIds>
                <arr:int>1</arr:int>
            </urn:applicationGroupIds>
            <urn:siteGroupIds>
                <arr:int>2</arr:int>
            </urn:siteGroupIds>
            <urn:dss>false</urn:dss>
            <urn:macAgent>false</urn:macAgent>
            <urn:whens>
                <rtad:always>false</rtad:always>
                <rtad:entries>
                    <rtad:WhenEntry>
                        <rtad:days>
                            <rtad:DayOfWeek>Monday</rtad:DayOfWeek>
                            <rtad:DayOfWeek>Tuesday</rtad:DayOfWeek>
                            <rtad:DayOfWeek>Wednesday</rtad:DayOfWeek>
                            <rtad:DayOfWeek>Thursday</rtad:DayOfWeek>
                            <rtad:DayOfWeek>Friday</rtad:DayOfWeek>
                        </rtad:days>
                        <rtad:startTime>08:00:00</rtad:startTime>
                        <rtad:endTime>18:00:00</rtad:endTime>
                    </rtad:WhenEntry>
                </rtad:entries>
            </urn:whens>
            <urn:action>ALLOW</urn:action>
            <urn:allowAllBrowsers>false</urn:allowAllBrowsers>
            <urn:allowedBrowsers>
                <rtad:SupportedBrowsers>CH</rtad:SupportedBrowsers>
                <rtad:SupportedBrowsers>EDGE</rtad:SupportedBrowsers>
                <rtad:SupportedBrowsers>FF</rtad:SupportedBrowsers>
            </urn:allowedBrowsers>
            <urn:userPinPolicy>DO_NOTHING</urn:userPinPolicy>
        </urn:EditPolicy>
    </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/EditPolicyResponse</a:Action>
    </s:Header>
    <s:Body>
        <EditPolicyResponse 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">10</ResultData>
            </Result>
        </EditPolicyResponse>
    </s:Body>
</s:Envelope>

El campo ResultData contiene el ID de la política actualizada.

Activa o desactiva políticas

`ChangePoliciesStatus`

Activa o desactiva una o más políticas a la vez.

Nombre	Tipo	Requerido	Descripción
`policyIds`	array de enteros	Sí	IDs de las políticas que quieres actualizar. Encuentra los valores en `ListPolicyIds`.
`status`	boolean	Sí	Estado que quieres aplicar: `true` para activar, `false` para desactivar.

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:ChangePoliciesStatus>
            <urn:policyIds>
                <arr:int>10</arr:int>
                <arr:int>11</arr:int>
            </urn:policyIds>
            <urn:status>false</urn:status>
        </urn:ChangePoliciesStatus>
    </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/ChangePoliciesStatusResponse</a:Action>
    </s:Header>
    <s:Body>
        <ChangePoliciesStatusResponse 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>
        </ChangePoliciesStatusResponse>
    </s:Body>
</s:Envelope>

Asigna políticas a un rol

`AssignRoleToPolicies`

Reasigna un conjunto de políticas a un rol diferente.

Nombre	Tipo	Requerido	Descripción
`roleId`	integer	Sí	ID del rol al que quieres asignar las políticas.
`policyIds`	array de enteros	Sí	IDs de las políticas que quieres reasignar. Encuentra los valores en `ListPolicyIds`.

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:AssignRoleToPolicies>
            <urn:roleId>3</urn:roleId>
            <urn:policyIds>
                <arr:int>10</arr:int>
                <arr:int>11</arr:int>
            </urn:policyIds>
        </urn:AssignRoleToPolicies>
    </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/AssignRoleToPoliciesResponse</a:Action>
    </s:Header>
    <s:Body>
        <AssignRoleToPoliciesResponse 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>
        </AssignRoleToPoliciesResponse>
    </s:Body>
</s:Envelope>

Elimina políticas

`DeletePolicies`

Elimina una o más políticas de forma permanente.

Nombre	Tipo	Requerido	Descripción
`policyIds`	array de enteros	Sí	IDs de las políticas que quieres eliminar. Encuentra los valores en `ListPolicyIds`.

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:DeletePolicies>
            <urn:policyIds>
                <arr:int>10</arr:int>
            </urn:policyIds>
        </urn:DeletePolicies>
    </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/DeletePoliciesResponse</a:Action>
    </s:Header>
    <s:Body>
        <DeletePoliciesResponse 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>
        </DeletePoliciesResponse>
    </s:Body>
</s:Envelope>

Exporta políticas

`DownloadPoliciesCSV`

Descarga un archivo CSV con la lista de políticas 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 todas las políticas.
`viewType` (cabecera)	string	No	Filtra las políticas por tipo: `VIEW_ALL`, `VIEW_ALLOWED`, `VIEW_DENIED`, `VIEW_ACTIVE`, `VIEW_INACTIVE`.

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:viewType>VIEW_ALL</urn:viewType>
    </soap:Header>
    <soap:Body>
        <urn:DownloadPoliciesCSV/>
    </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/DownloadPoliciesCSVResponse</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">Policies_202605071142.csv</Filename>
        </h:result>
    </s:Header>
    <s:Body>
        <ResultFileStream xmlns="urn:evolium:redtrust:administration:ws">
            <stream>
                <xop:Include href="cid:http://tempuri.org/1/639137509688734956" 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​

Crea una política​

AddPolicy​

Consulta políticas​

ListPolicies​

GetPolicyData​

ListPolicyIds​

Actualiza una política​

EditPolicy​

Activa o desactiva políticas​

ChangePoliciesStatus​

Asigna políticas a un rol​

AssignRoleToPolicies​

Elimina políticas​

DeletePolicies​

Exporta políticas​

DownloadPoliciesCSV​