Guía de Referencia de Servicios Web SealSign DSR

ElevenPaths, innovación radical y disruptiva en seguridad

Página 2 de 25

2015 © Telefónica Digital Identity & Privacy, S.L.U. All Rights Reserved.

Contenidos

1 Introducción ............................................................................................................... 3

2 Interfaces de Servicios Web de SealSign DSR ............................................................... 4

2.1 Clases Comunes ........................................................................................................................ 4

2.1.1 FileMetadata .............................................................................................................................. 4

2.1.2 TagValueTypes ............................................................................................................................ 5

2.1.3 DSRMetadata.............................................................................................................................. 5

2.1.4 DSRFileInfo ................................................................................................................................. 5

2.1.5 DSRMetadataCondition .............................................................................................................. 6

2.1.6 Operator ..................................................................................................................................... 7

3 Servicio de Archivado seguro de documentos (SOAP 1.1) ............................................. 8

3.1 Métodos .................................................................................................................................... 8

3.1.1 InsertDocument .......................................................................................................................... 8

3.1.2 InsertURLFile .............................................................................................................................. 9

3.1.3 InsertURL .................................................................................................................................. 10

3.1.4 GetDocument ........................................................................................................................... 11

3.1.5 GetDocumentEx ....................................................................................................................... 12

3.1.6 GetDocumentSignature ............................................................................................................ 12

3.1.7 ReSignDocument ...................................................................................................................... 13

3.1.8 GetDocumentMetadata ........................................................................................................... 13

3.1.9 ModifyDocumentMetadata ...................................................................................................... 14

3.1.10 DeleteDocumentMetadata ...................................................................................................... 15

3.1.11 DeleteDocument ...................................................................................................................... 16

3.1.12 Search ....................................................................................................................................... 17

3.1.13 SearchEx ................................................................................................................................... 18

3.1.14 SearchEx2 ................................................................................................................................. 19

3.1.15 EnumObjects ............................................................................................................................ 20

3.1.16 CreateMetadata (Metodo Administrativo) .............................................................................. 21

3.1.17 GetMetadata (Metodo Administrativo) ................................................................................... 21

3.1.18 DeleteMetadata (Metodo Administrativo) .............................................................................. 22

3.1.19 GetFileInfo ................................................................................................................................ 22

4 Recursos .................................................................................................................... 24

Página 3 de 25


1 Introducción

SealSign DSR (Digital Signature Repository) es un producto desarrollado íntegramente por ElevenPaths dirigido a facilitar la integración de un sistema de custodia de documentos seguro en las aplicaciones corporativas.

DSR es un componente de SealSign que permite custodiar todos los objetos documentales que están sujetos a periodos de permanencia establecidos, normalmente, por un marco legislativo. Un caso paradigmático de preservación es el de los documentos firmados electrónicamente, a los que hay que realizar un refirmado y resellado de tiempo de forma periódica.

Independientemente del soporte original del documento, los objetivos de DSR son:

Consultar y recuperar documentos, además de garantizar su preservación e integridad a largo plazo.

Aplicar medidas de seguridad sobre los documentos.

Auditar las operaciones realizadas sobre los documentos.

Proteger y asegurar los documentos mediante aplicación de técnicas criptográficas.

Garantizar la validez legal de las firmas digitales asociadas a los documentos.

Las funcionalidades de DSR son:

Firma avanzada y sellado de tiempo del documento insertado.

Refirmado y resellado de tiempo cuando corresponda según configuración.

Borrado lógico.

Custodia de evidencias digitales de cualquier operación que se realice con el repositorio.

Disposición de Web Services para la integración con sistemas cliente del repositorio: ingreso, búsqueda, recuperación.

DSR incluye una Aplicación Web de Administración y Búsqueda, que permite a los administradores definir los parámetros del repositorio así como buscar elementos documentales insertados y recuperar tanto su contenido como los valores de sus metadatos asociados.

Este documento no pretende ser un manual sobre los aspectos concretos sobre el archivado seguro de documentos sino un manual de referencia técnica, orientado al desarrollador, que recoge la descripción de dichos servicios para ayudar a la integración de aplicaciones con el servicio de archivado de SealSign.

Para ejemplos de integración de los casos de uso más habituales, se pueden consultar las diversas guías de integración de aplicaciones de SealSign DSR, disponibles para cada una de las tecnologías de desarrollo soportadas.

Página 4 de 25


2 Interfaces de Servicios Web de SealSign DSR

Dada la heterogeneidad de tecnologías disponibles en el mercado y con el objetivo de ser accesibles desde la gran mayoría de aplicaciones corporativas, los servicios web de SealSign DSR están accesibles a través de dos interfaces:

Interfaz basado en la especificación SOAP 1.1 (BasicHttpBinding).

Interfaz basado en la especificación SOAP 1.2 y WS-Addressing (WsHttpBinding).

Según la tecnología y las capacidades de la aplicación cliente, se podrá invocar a uno u otro interfaz.

El interfaz SOAP 1.1 expone los siguientes Servicios Web:

Servicio de Archivado de documentos (SecureStorageBasic.svc): permite realizar operaciones de archivado y extracción de documentos del repositorio documental.

El interfaz SOAP 1.2 expone los siguientes Servicios Web:

Servicio de Archivado (SecureStorage.svc): permite realizar operaciones de archivado y extracción de documentos del repositorio documental.

Los servicios estarán accesibles en el directorio virtual SealSignDSRService. Por ejemplo: http://localhost/sealsigndsrservice/securestorage.svc.

2.1 Clases Comunes

Las siguientes clases se utilizan como parámetros en los servicios Web independientemente del interfaz que publiquen:

2.1.1 FileMetadata

Cada objeto de esta clase representa la información (metadatos) asociada a un documento almacenado en el servicio de archivado. Esta clase se utiliza en las operaciones tanto de archivado como de consulta de metadatos asociados a un documento. Los metadatos de un documento se utilizan principalmente para clasificación y búsquedas de documentos en el servicio de archivado.

La clase FileMetadata está definida del siguiente modo:

public class FileMetadata

{

public int tagID;

public string name;

public string value;

public TagValueTypes type;

}

Miembros

tagID: Identificador del metadato asociado al documento.

name: Nombre del metadato asociado al documento.

value: Valor del metadato asociado al documento.

type: Tipo del metadato asociado al documento.

http://localhost/sealsigndsrservice/securestorage.svc

Página 5 de 25


2.1.2 TagValueTypes

Esta enumeración representa el tipo de metadato asociado a un documento almacenado en el servicio de archivado. La enumeración TagValueTypes está definida del siguiente modo:

public enum TagValueTypes

{

tvtBoolean = 1,

tvtString = 2,

tvtDateTime = 3,

tvtNumber = 4,

tvtAnsiString = 100,

tvtUnknown = int.MaxValue

}

Valores

tvtBoolean: Indica que el tipo del metadato asociado al documento es de tipo Booleano (true o false).

tvtString: Indica que el tipo del metadato asociado al documento es de tipo cadena (unicode).

tvtDateTime: Indica que el tipo del metadato asociado al documento es de tipo fecha.

tvtNumber: Indica que el tipo del metadato asociado al documento es de tipo numérico.

tvtAnsiString: Indica que el tipo del metadato asociado al documento es de tipo cadena (ansi).

tvtUnknown: Valor por defecto asignado al tipo de un metadato asociado al documento.

2.1.3 DSRMetadata

La clase DSRMetadata se utiliza para la creación y obtención de metadatos y sus valores asociados a documentos. Está definida del siguiente modo:

public class DSRMetadata

{

public int tagID;

public string name;

public string value;

public TagValueTypes type;

}

Miembros

tagID: Identificador del metadato asociado al documento.

name: Nombre del metadato asociado al documento.

value: Valor del metadato asociado al documento.

type: Tipo del metadato asociado al documento.

2.1.4 DSRFileInfo

La clase DSRFileInfo se utiliza para la obtención de toda la información referente a un documento almacenado en el servicio de archivado. Está definida del siguiente modo:

public class DSRFileInfo

{

public string uri;

public string fullName;

public string name;

public string path;

Página 6 de 25


public long size;

public DateTime creationTime;

public DateTime lastAccessTime;

public DateTime modificationTime;

public string url;

public string mimeType;

}

Miembros

uri: Identificador único del documento en el servicio de archivado. El formato del uri es:"urn:file:path:guid" donde path es la ruta de almacenamiento del documento (similar a un sistema de ficheros tradicional con jerarquía de directorios) y guid es un identificador único asignado al documento en el momento de la inserción en el servicio de archivado.

fullName: Nombre completo del documento (path + name) almacenado en el servicio de archivado.

name: Nombre del documento (sin el path) almacenado en el servicio de archivado.

path: Ruta de almacenamiento del documento almacenado en el servicio de archivado (similar a un sistema de ficheros tradicional con jerarquía de directorios).

size: Tamaño del documento almacenado en el servicio de archivado (en bytes).

creationTime: Fecha de creación del documento almacenado en el servicio de archivado.

lastAccessTime: Fecha del ultimo acceso al documento almacenado en el servicio de archivado.

modificationTime: Fecha de la última modificación del documento almacenado en el servicio de archivado.

url: URL de origen si la inserción del documento se realizó con el método InsertURLFile o si se hizo un Snapshot de una URL mediante el método InsertURL. Si la inserción del documento se realizó con el método InsertDocument, este valor será nulo.

mimeType: Tipo MIME del documento almacenado en el servicio de archivado.

2.1.5 DSRMetadataCondition

La clase DSRMetadataCondition se utiliza para la creación de filtros basados en metadatos en la operaciones de búsqueda de documentos almacenados en el servicio de archivado.

Está definida del siguiente modo:

public class DSRMetadataCondition

{

public string metadataName;

public string searchValue;

public Operator searchOperator;

}

Miembros

metadataName: Nombre del metadato asociado al documento.

searchValue: Valor del metadato por el cual vamos a realizar el filtrado (búsqueda) del documento.

searchOperator: Operador utilizado para comparar el metadato.

Página 7 de 25


2.1.6 Operator

La enumeración Operator se utiliza para la creación de filtros basados en metadatos en la operaciones de búsqueda de documentos almacenados en el servicio de archivado. Su uso se ciñe a la definición del tipo de operador a utilizar en las comparaciones de los metadatos a buscar.

Está definida del siguiente modo:

public enum Operator

{

Equal,

Distint,

Less,

Greater,

LessOrEqual,

GreaterOrEqual,

Like

}

Valores

Equal: Para la realización de la búsqueda, utilizaremos el operador de “igualdad” en la comparación del valor del metadato.

Distint: Para la realización de la búsqueda, utilizaremos el operador “distinto a” en la comparación del valor del metadato.

Less: Para la realización de la búsqueda, utilizaremos el operador “menor a” en la comparación del valor del metadato.

Greater: Para la realización de la búsqueda, utilizaremos el operador “mayor a” en la comparación del valor del metadato.

LessOrEqual: Para la realización de la búsqueda, utilizaremos el operador “menor o igual a” en la comparación del valor del metadato.

GreaterOrEqual: Para la realización de la búsqueda, utilizaremos el operador “mayor o igual a” en la comparación del valor del metadato.

Like: Para la realización de la búsqueda, utilizaremos el operador “como” en la comparación del valor del metadato. Este operador es el mismo que el de igualdad pero soporta la utilización de caracteres comodín (%). Este operador es similar al operador “Like” en la sintaxis de consultas SQL.

Página 8 de 25


3 Servicio de Archivado seguro de documentos (SOAP 1.1)

El servicio SecureStorageBasic.svc de SealSign DSR permite realizar operaciones de archivado y consulta de documentos electrónicos al servicio de archivado de SealSign a través de SOAP 1.1.

3.1 Métodos

3.1.1 InsertDocument

Realiza la inserción de un documento en el servicio de archivado de documentos y retorna un id que lo identifica unívocamente.

La inserción del documento en el servicio de archivado incluye lo siguiente:

El documento se firma electrónicamente mediante los parámetros configurados en la herramienta de administración de SealSign (Repositorio Seguro)

Una vez firmado electrónicamente, el documento y su firma se almacenan junto a los metadatos pasados como parámetros si los hubiera.

Sintaxis public string InsertDocument(

byte[] documentBinary,

string targetFile,

FileMetadata[] fileMetadata);

Parámetros de Entrada

documentBinary: Documento en formato binario a insertar en el servicio de archivado.

targetFile: Fichero de destino en el que insertar el documento en formato binario. Se compone de ruta (path) más el nombre de fichero, al estilo de un sistema de ficheros tradicional (ej: FAT, NTFS). Ejemplos:

o "\\fileToInsert.ext" (Fichero situado en el Raíz del servicio de archivado) o "\\dir1\fileToInsert.ext" o "\\dir1\subdir1\fileToInsert.ext"

fileMetadata: Array de valores de metadatos asociados al documento que se quieren añadir en la inserción. Este parámetro puede ser nulo si no se quieren añadir valores de metadatos al nuevo documento insertado en el servicio de archivado. Si este parámetro no es nulo, los metadatos utilizados en la llamada deben haber sido previamente creados desde el interfaz de administración de SealSign (Repositorio Seguro).

Retorno

Retorna un valor de tipo cadena (string) que corresponderá con el identificador único del documento dentro del sistema de archivado, también llamado Uri (Universal Resource Identifier) en el servicio de archivado.

El formato del Uri es: "urn:file:path:guid" donde path es la ruta de almacenamiento del documento (similar a un sistema de ficheros tradicional con jerarquía de directorios) y guid es un identificador

Página 9 de 25


único asignado al documento en el momento de la inserción en el servicio de archivado. Urn y file son cadenas constantes. Ejemplos:

"urn:file:\\:A7B0E753-83DF-4F35-AD6B-F6DAC79C1070"

"urn:file:\\dir1:A7B0E753-83DF-4F35-AD6B-F6DAC79C1070"

"urn:file:\\dir1\subdir1:A7B0E753-83DF-4F35-AD6B-F6DAC79C1070"

Para cualquier error el servicio devuelve una excepción para que sea manejada desde la parte cliente.

3.1.2 InsertURLFile

Realiza la inserción de un documento descargado desde una URL en el servicio de archivado de documentos y retorna un id que lo identifica unívocamente. La descarga del documento se hace desde el propio servicio de archivado de documentos de SealSign, permitiendo así disminuir considerablemente el tráfico entre el cliente y el servicio de archivado.




Sintaxis public string InsertURLFile(

string urlString,

string targetFile,



urlString: URL origen del documento a descargar y cuyo contenido en formato binario será insertado en el servicio de archivado.

targetFile: Fichero de destino en el que insertar el documento en formato binario. Se compone de ruta (path) más nombre de fichero, al estilo de un sistema de ficheros tradicional (ej: FAT, NTFS). Ejemplos:



Retorno


Página 10 de 25


El formato del Uri es:"urn:file:path:guid" donde path es la ruta de almacenamiento del documento (similar a un sistema de ficheros tradicional con jerarquía de directorios) y guid es un identificador único asignado al documento en el momento de la inserción en el servicio de archivado. Urn y file son cadenas constantes. Ejemplos:





3.1.3 InsertURL

Realiza la inserción de un documento de tipo MHT y su miniatura correspondiente descargados desde una URL en el servicio de archivado de documentos y retorna un id que lo identifica unívocamente. La descarga del documento se hace desde el propio servicio de archivado de documentos de SealSign, permitiendo así disminuir considerablemente el tráfico entre cliente y el servicio de archivado.

Esta funciona realiza una foto estática de una Web en un momento concreto, crea una imagen miniatura y lo inserta todo ello en el servicio de archivado de SealSign.




Sintaxis public string InsertURL(

string urlString,

string targetFile,



urlString: URL origen del documento MHT a descargar y cuyo contenido en formato binario además de su miniatura será insertado en el servicio de archivado.

targetFile: Fichero destino en el que insertar el documento en formato binario. Se compone de ruta (path) más nombre de fichero, al estilo de un sistema de ficheros tradicional (ej: FAT, NTFS). Ejemplos:



Página 11 de 25


Retorno







3.1.4 GetDocument

Realiza la extracción de un documento contenido en el servicio de archivado, retornando su contenido en binario.

Sintaxis public byte[] GetDocument(string uriDocument);


uriDocument: Valor de tipo cadena (string) que corresponderá con el identificador único del documento dentro del sistema de archivado, también llamado Uri (Universal Resource Identifier) en el servicio de archivado.

El formato del Uri es: "urn:file:path:guid" donde path es la ruta de almacenamiento del documento (similar a un sistema de ficheros tradicional con jerarquía de directorios) y guid es un identificador único asignado al documento en el momento de la inserción en el servicio de archivado. Urn y file son cadenas constantes. Ejemplos:

o "urn:file:\\:A7B0E753-83DF-4F35-AD6B-F6DAC79C1070"

o "urn:file:\\dir1:A7B0E753-83DF-4F35-AD6B-F6DAC79C1070"

o "urn:file:\\dir1\subdir1:A7B0E753-83DF-4F35-AD6B-F6DAC79C1070"

Retorno

Array de bytes correspondiente al contenido del documento cuyo identificador es igual a uriDocument. Para cualquier error el servicio devuelve una excepción para que sea manejada desde la parte cliente.

Comentarios

uriDocument es devuelto por funciones tales como InsertDocument, InsertURLFile o InsertURL El llamador tiene que ser el owner del documento identificado por uriDocument para poder extraer el contenido del documento. El owner del documento es el usuario autenticado bajo el que se realiza la operación de inserción en el servicio de archivado.

Página 12 de 25


3.1.5 GetDocumentEx

Realiza la extracción de un documento contenido en el servicio de archivado, retornando su contenido en binario.

Sintaxis public byte[] GetDocumentEx(string uriDocument);







Retorno

Array de bytes correspondiente al contenido del documento cuyo identificador es igual a uriDocument. Para cualquier error el servicio devuelve una excepción para que sea manejada desde la parte cliente.

Comentarios

uriDocument es devuelto por funciones tales como InsertDocument, InsertURLFile o InsertURL El llamador tiene que ser Administrador de SealSign para poder extraer el contenido del documento.

3.1.6 GetDocumentSignature

Realiza la extracción del bloque binario correspondiente a la firma electrónica de un documento contenido en el servicio de archivado.

Sintaxis public byte[] GetDocumentSignature(string uriDocument);




o "urn:file:\\:A7B0E753-83DF-4F35-AD6B-F6DAC79C1070" o "urn:file:\\dir1:A7B0E753-83DF-4F35-AD6B-F6DAC79C1070" o "urn:file:\\dir1\subdir1:A7B0E753-83DF-4F35-AD6B-F6DAC79C1070"

Página 13 de 25


Retorno

Array de bytes correspondiente a la firma electrónica del documento identificado por uriDocument. Para cualquier error el servicio devuelve una excepción para que sea manejada desde la parte cliente.

Comentarios

uriDocument es devuelto por funciones tales como InsertDocument, InsertURLFile o InsertURL El llamador tiene que ser el owner del documento identificado por uriDocument para poder extraer la firma electrónica del documento. El owner del documento es el usuario autenticado bajo el que se realiza la operación de inserción en el servicio de archivado.

3.1.7 ReSignDocument

Realiza una firma electrónica sobre un documento contenido en el servicio de archivado que ya estaba previamente firmado. Este método es utilizado para el soporte de firma longeva en el servicio de archivado.

Sintaxis public void ReSignDocument(string uriDocument);







Retorno

Esta función no devuelve ningún valor. Para cualquier error el servicio devuelve una excepción para que sea manejada desde la parte cliente.

Comentarios

uriDocument es devuelto por funciones tales como InsertDocument, InsertURLFile o InsertURL El llamador tiene que ser el owner del documento identificado por uriDocument para poder realizar la operación de refirma. El owner del documento es el usuario autenticado bajo el que se realiza la operación de inserción en el servicio de archivado.

3.1.8 GetDocumentMetadata

Obtiene los metadatos y sus valores asociados a un documento contenido en el servicio de archivado. Los metadatos son utilizados para clasificación y filtrados en procesos de búsqueda en el servicio de archivado.

Página 14 de 25


Sintaxis public FileMetadata[] GetDocumentMetadata(string uriDocument);







Retorno

Array de objetos FileMetadata correspondiente al conjunto de metadatos y sus valores asociados al documento identificado por uriDocument. Para cualquier error el servicio devuelve una excepción para que sea manejada desde la parte cliente.

Comentarios

uriDocument es devuelto por funciones tales como InsertDocument, InsertURLFile o InsertURL El llamador tiene que ser el owner del documento identificado por uriDocument para poder obtener los metadatos y sus valores asociados al documento. El owner del documento es el usuario autenticado bajo el que se realiza la operación de inserción en el servicio de archivado.

3.1.9 ModifyDocumentMetadata

Modifica los metadatos y sus valores asociados a un documento contenido en el servicio de archivado. Los metadatos son utilizados para la clasificación y los filtrados en procesos de búsqueda en el servicio de archivado.

Sintaxis public void ModifyDocumentMetadata(

string uriDocument,








Página 15 de 25


fileMetadata: Array de metadatos y sus valores asociados al documento que se quieren modificar. Este parámetro no puede ser nulo. Si este parámetro es nulo, la plataforma devuelve una excepción controlada indicando ese hecho. Los metadatos a modificar del documento deben haber sido previamente creados desde el interfaz de administración de SealSign (Repositorio Seguro).

Retorno


Comentarios

uriDocument es devuelto por funciones tales como InsertDocument, InsertURLFile o InsertURL El llamador tiene que ser el owner del documento identificado por uriDocument para poder modificar los metadatos asociados al documento. El owner del documento es el usuario autenticado bajo el que se realiza la operación de inserción en el servicio de archivado.

Previa a la llamada a esta función se pueden obtener los metadatos y sus valores asociados al documento con la llamada a la función GetDocumentMetadata.

3.1.10 DeleteDocumentMetadata

Borra los valores de los metadatos asociados a un documento contenido en el servicio de archivado. Los metadatos son utilizados para clasificación y filtrados en procesos de búsqueda en el servicio de archivado.

Sintaxis public void DeleteDocumentMetadata(

string uriDocument,








fileMetadata: Array de metadatos y sus valores asociados al documento que se quieren eliminar. Este parámetro no puede ser nulo. Si este parámetro es nulo, la plataforma devuelve una excepción controlada indicando ese hecho. Los metadatos a modificar del documento deben haber sido previamente creados desde el interfaz de administración de SealSign (Repositorio Seguro).

Página 16 de 25


Retorno


Comentarios

uriDocument es devuelto por funciones tales como InsertDocument, InsertURLFile o InsertURL El llamador tiene que ser el owner del documento identificado por uriDocument para poder borrar los metadatos asociados al documento. El owner del documento es el usuario autenticado bajo el que se realiza la operación de inserción en el servicio de archivado.

Previa a la llamada a esta función se pueden obtener los metadatos del documento con la llamada a la función GetDocumentMetadata.

3.1.11 DeleteDocument

Borra el documento identificado por su Uri contenido en el servicio de archivado.

Sintaxis public void DeleteDocument(string uriDocument);







Retorno


Comentarios

uriDocument es devuelto por funciones tales como InsertDocument, InsertURLFile o InsertURL El llamador tiene que ser el owner del documento identificado por uriDocument para poder modificar los metadatos asociados al documento. El owner del documento es el usuario autenticado bajo el que se realiza la operación de inserción en el servicio de archivado.

Físicamente el documento no es borrado del servicio de archivado, únicamente se activa un flag que indica que esta borrado (borrado lógico), que evita que aparezca en búsquedas, que se consulte su contenido, etc. Una vez borrado, no se puede realizar ninguna operación con el documento, sea cual sea la naturaleza de la operación.

Página 17 de 25


3.1.12 Search

Este método realiza búsquedas de documentos basados en criterios de búsqueda construidos a partir de los valores de los metadatos asociados en el servicio de archivado. Los metadatos son utilizados para clasificación y filtrados en procesos de búsqueda en el servicio de archivado.

Sintaxis public string[] Search(

string basePath,

DSRMetadataCondition[] searchCriteria);


basePath: Valor de tipo cadena (string) que corresponderá con el directorio desde el cual se comenzara la búsqueda del documento (similar a un sistema de ficheros tradicional con jerarquía de directorios). Si basePath es nulo, la búsqueda se comenzara desde el directorio raíz. Ejemplos:

o "\\"

o "\\DIR1"

o "\\DIR1\SUBDIR1"

searchCriteria: Array de criterios de búsqueda utilizados para filtrar los resultados devueltos por el servicio de archivado. Este parámetro no puede ser nulo. Si este parámetro es nulo, la plataforma devuelve una excepción controlada indicando ese hecho. Para ver más acerca del tipo de este parámetro véase DSRMetadataCondition.

Retorno

Retorna un array de valores de tipo cadena (string) que corresponderá con los identificadores únicos de documentos dentro del sistema de archivado, también llamado Uri (Universal Resource Identifier) en el servicio de archivado que cumplen con los criterios de búsqueda y están almacenados en el path basePath o alguno de sus hijos.






Comentarios

Los criterios contenidos en searchCriteria se encadenan lógicamente con la operación AND. Los resultados son identificadores de documentos pertenecientes únicamente al propietario del documento.

Página 18 de 25


3.1.13 SearchEx


Sintaxis public DSRFileInfo[] SearchEx(

string fileName,

string basePath,

string uriDocument,

DateTime startDate,

DateTime endDate,

DSRMetadataCondition[] searchcriteria)


fileName: Nombre de fichero destino que se desea buscar. Permite la utilización de comodines (%). Ejemplos:

o "fileToInsert.ext" (buscamos por el nombre exacto) o "file%" (buscamos todos los ficheros cuyo nombre comience con “file”)


o "\\"

o "\\DIR1"

o \\DIR1\SUBDIR1


El formato del Uri es: "urn:file:path:guid" donde path es la ruta de almacenamiento del documento (similar a un sistema de ficheros tradicional con jerarquía de directorios) y guid es un identificador único asignado al documento en el momento de la inserción en el servicio de archivado. Urn y file son cadenas constantes. Se permite la utilización de comodines (%). Ejemplos:


o "urn:file:\\dir1:A7B0E753-83DF% "

o "urn:file:\\dir1\%"

startDate : La búsqueda devolverá documentos insertados en el servicio de archivado en fecha igual o mayores a startDate.

endDate: La búsqueda devolverá documentos insertados en el servicio de archivado en fecha igual o menores a endDate.


Página 19 de 25


Retorno

Retorna un array de valores de tipo DSRFileInfo que corresponderá con la información de cada uno de los documentos dentro del sistema de archivado que cumplen con los criterios de búsqueda indicados mediante los parámetros de entrada de la función. Para ver más acerca del tipo devuelto por la función véase DSRFileInfo.


Comentarios

Los criterios contenidos en searchCriteria se encadenan lógicamente con la operación AND. Los resultados pertenecen a documentos pertenecientes a todos los usuarios, por tanto para invocar esta función hay que pertenecer al grupo de administradores de SealSign.

3.1.14 SearchEx2


Sintaxis public DSRFileInfo[] SearchEx(

string fileName,

string basePath,

string uriDocument,

DateTime startDate,

DateTime endDate,

DSRMetadataCondition[] searchcriteria)


fileName: Nombre de fichero destino que se desea buscar. Permite la utilización de comodines (%). Ejemplos:

o "fileToInsert.ext" (buscamos por el nombre exacto) o "file%" (buscamos todos los ficheros cuyo nombre comience con “file”)

basePath: Valor de tipo cadena (string) que corresponderá con el directorio desde el cual se comenzara la búsqueda del documento (similar a un sistema de ficheros tradicional con jerarquía

de directorios). Si basePath es nulo, la búsqueda se comenzara desde el directorio raíz. Ejemplos:

o "\\"

o "\\DIR1"

o \\DIR1\SUBDIR1


El formato del Uri es: "urn:file:path:guid" donde path es la ruta de almacenamiento del documento (similar a un sistema de ficheros tradicional con jerarquía de directorios) y guid es un identificador único asignado al documento en el momento de la inserción en el servicio de archivado. Urn y file son cadenas constantes. Se permite la utilización de comodines (%).

Página 20 de 25


Ejemplos:

o "urn:file:\\:A7B0E753-83DF-4F35-AD6B-F6DAC79C1070" o "urn:file:\\dir1:A7B0E753-83DF% " o "urn:file:\\dir1\%"

startDate: La búsqueda devolverá documentos insertados en el servicio de archivado en fecha igual o mayores a startDate.

endDate: La búsqueda devolverá documentos insertados en el servicio de archivado en fecha igual o menores a endDate.


Retorno

Retorna un array de valores de tipo DSRFileInfo que corresponderá con la información de cada uno de los documentos dentro del sistema de archivado que cumplen con los criterios de búsqueda indicados mediante los parámetros de entrada de la función. Para ver más acerca del tipo devuelto por la función véase DSRFileInfo.


Comentarios

Los criterios contenidos en searchCriteria se encadenan lógicamente con la operación AND. Los resultados pertenecen a documentos pertenecientes al usuario llamante, por tanto para invocar esta función hay que pertenecer al grupo Power Users de SealSign.

3.1.15 EnumObjects

Este método se mantiene por compatibilidad con versiones anteriores y es similar al método Search.

Sintaxis public string[] EnumObjects(string basePath, uint filter)



o "\\"

o "\\DIR1"

o \\DIR1\SUBDIR1

Filter: Reservado para uso futuro.

Retorno

Retorna un array de valores de tipo cadena (string) que corresponderá con los identificadores únicos de documentos dentro del sistema de archivado, también llamado Uri (Universal Resource Identifier)

Página 21 de 25


en el servicio de archivado que cumplen con los criterios de búsqueda y están almacenados en el path basePath o alguno de sus hijos.






Comentarios

Los criterios contenidos en searchCriteria se encadenan lógicamente con la operación AND. Los resultados son identificadores de documentos pertenecientes únicamente al propietario del documento.

3.1.16 CreateMetadata (Metodo Administrativo)

Crea metadatos para que puedan asociarse a documentos en el servicio de archivado. Los metadatos son utilizados para clasificación y filtrados en procesos de búsqueda en el servicio de archivado.

Sintaxis public void CreateMetadata(DSRMetadata metadata)


metadata: Valor de tipo DSRMetadata que corresponderá con el metadato nuevo a insertar en el servicio de archivado.

Retorno


Comentarios

El llamante de esta función debe pertenecer al grupo de usuarios Administradores de SealSign.

3.1.17 GetMetadata (Metodo Administrativo)

Obtiene los metadatos disponibles que pueden asociarse a un documento contenido en el servicio de archivado. Los metadatos son utilizados para clasificación y filtrados en procesos de búsqueda en el servicio de archivado.

Sintaxis public DSRMetadata[] GetMetadata()

Página 22 de 25


Retorno

Array de tipo DSRMetadata que corresponderá con los metadatos disponibles que pueden ser asociados a los documentos insertados en el servicio de archivado. Para cualquier error el servicio devuelve una excepción para que sea manejada desde la parte cliente.

Comentarios


3.1.18 DeleteMetadata (Metodo Administrativo)

Borra los metadatos disponibles que pueden asociarse a un documento contenido en el servicio de archivado referenciado por el parámetro tagID. Los metadatos son utilizados para clasificación y filtrados en procesos de búsqueda en el servicio de archivado.

Sintaxis public void DeleteMetadata(int tagID)

Retorno


Comentarios


3.1.19 GetFileInfo

Obtiene información relativa a un documento contenido en el servicio de archivado.

Sintaxis public DSRFileInfo GetFileInfo(string uriDocument);



El formato del Uri es: "urn:file:path:guid" donde path es la ruta de almacenamiento del documento (similar a un sistema de ficheros tradicional con jerarquía de directorios) y guid es un identificador único asignado al documento en el momento de la inserción en el servicio de archivado. Urn y file son cadenas constantes. Ejemplos: o "urn:file:\\:A7B0E753-83DF-4F35-AD6B-F6DAC79C1070" o "urn:file:\\dir1:A7B0E753-83DF-4F35-AD6B-F6DAC79C1070" o "urn:file:\\dir1\subdir1:A7B0E753-83DF-4F35-AD6B-F6DAC79C1070"

Retorno

Objeto tipo DSRFileInfo correspondiente al conjunto datos y sus valores asociados referentes al documento identificado por uriDocument. Para cualquier error el servicio devuelve una excepción para que sea manejada desde la parte cliente.

Página 23 de 25


Comentarios

uriDocument es devuelto por funciones tales como InsertDocument, InsertURLFile o InsertURL El llamador tiene que ser el owner del documento identificado por uriDocument para poder obtener los metadatos y sus valores asociados al documento. El owner del documento es el usuario autenticado bajo el que se realiza la operación de inserción en el servicio de archivado.

Página 24 de 25


4 Recursos

Para información acerca de los distintos servicios de SealSign puede accederse a esta dirección: https://www.elevenpaths.com/es/tecnologia/sealsign/index.html

Además en el blog de ElevenPaths es posible encontrar artículos interesantes y novedades acerca de este producto.

Puede encontrarse más información acerca de los productos de Eleven Paths en YouTube, en Vimeo y en Slideshare.

https://www.elevenpaths.com/es/tecnologia/sealsign/index.html

http://blog.elevenpaths.com/

https://www.youtube.com/user/ElevenPaths

http://vimeo.com/elevenpaths

http://www.slideshare.net/elevenpaths/

Página 25 de 25


La información contenida en el presente documento es propiedad de Telefónica Digital Identity & Privacy, S.L.U. (“TDI&P”) y/o de cualquier otra entidad dentro del Grupo Telefónica o sus licenciantes. TDI&P y/o cualquier compañía del Grupo Telefónica o los licenciantes de TDI&P se reservan todos los derechos de propiedad industrial e intelectual (incluida cualquier patente o copyright) que se deriven o recaigan sobre este documento, incluidos los derechos de diseño, producción, reproducción, uso y venta del mismo, salvo en el supuesto de que dichos derechos sean expresamente conferidos a terceros por escrito. La información contenida en el presente documento podrá ser objeto de modificación en cualquier momento sin necesidad de previo aviso.

La información contenida en el presente documento no podrá ser ni parcial ni totalmente copiada, distribuida, adaptada o reproducida en ningún soporte sin que medie el previo consentimiento por escrito por parte de TDI&P.

El presente documento tiene como único objetivo servir de soporte a su lector en el uso del producto o servicio descrito en el mismo. El lector se compromete y queda obligado a usar la información contenida en el mismo para su propio uso y no para ningún otro.

TDI&P no será responsable de ninguna pérdida o daño que se derive del uso de la información contenida en el presente documento o de cualquier error u omisión del documento o por el uso incorrecto del servicio o producto. El uso del producto o servicio descrito en el presente documento se regulará de acuerdo con lo establecido en los términos y condiciones aceptados por el usuario del mismo para su uso.

TDI&P y sus marcas (así como cualquier marca perteneciente al Grupo Telefónica) son marcas registradas. TDI&P y sus filiales se reservan todo los derechos sobre las mismas.

PUBLICACIÓN:

Junio 2015

En ElevenPaths pensamos de forma diferente cuando hablamos de seguridad. Liderados por Chema Alonso, somos un equipo de expertos con inquietud para replantearnos la industria y gran experiencia y conocimiento en el sector de la seguridad. Dedicamos toda nuestra experiencia y esfuerzos en crear productos innovadores para que la vida digital sea más segura para todos.

La evolución de las amenazas de seguridad en la tecnología es cada vez más rápida y constante. Por eso, desde junio de 2013, nos hemos constituido como una start-up dentro de Telefónica para trabajar de forma ágil y dinámica, y ser capaces de transformar el concepto de seguridad anticipándonos a los futuros problemas que afecten a nuestra identidad, privacidad y disponibilidad online.

Con sede en Madrid, estamos presentes también en Londres, EE.UU, Brasil, Argentina, y Colombia.

TIENES ALGO QUE CONTARNOS, PUEDES HACERLO EN:

elevenpaths.com Blog.elevenpaths.com @ElevenPaths Facebook.com/ElevenPaths YouTube.com/ElevenPaths

Technology

Guía de Referencia de Servicios Web SealSign DSR