PLANTILLA PARA ESPECIFICAR CONTRATOS DE SERVICIOS. MEPROC Documento de Especificación de Servicios (Contrato): Servicio-S15 Versión 1.0 MEPROC Documento de especificación de un servicio SOA (Contrato) Versión: 1.0 Fecha: 16/05/2010 Revisión Fecha Versión Descripción Autor Aprobaciones Nombre / Rol Derechos Reservados Jorge Arias Consultor Independiente Fecha Plantilla para levantar contratos de Servicios Firma Pág. 2 de 7 MEPROC Documento de especificación de un servicio SOA (Contrato) Versión: 1.0 Fecha: 16/05/2010 Tabla de Contenido 1. Breve Descripción 4 2. Versión del servicio 4 3. Roles 4 4. Dueños del servicio 4 5. Descripción de la interfaz del servicio 4 6. Detalle del contrato del servicio 4 6.1 <Coloque aquí el nombre de función o método para la cual desee describir el contrato>Error! Bookmark not defined. 6.1.1 Mensaje de entrada 5 6.1.2 Mensaje de Salida 5 6.1.3 Excepciones 5 7. Implementación del servicio 6 8. Manejo de requerimientos no funcionales 6 Derechos Reservados Jorge Arias Consultor Independiente Plantilla para levantar contratos de Servicios Pág. 3 de 7 MEPROC Documento de especificación de un servicio SOA (Contrato) Versión: 1.0 Fecha: 16/05/2010 Documento de Especificación del Servicio S15 1. Breve Descripción Servicio de autenticación contra un servidor LDAP : Realiza la autenticación de usuario contra un servidor LDAP o también puede cerrar sesion. 2. Versión del servicio 1.0 3. Roles Role Sistema Proveedor Descripción LDAP Potenciales Sistemas consumidores 4. Todos los sistemas Dueños del servicio <De acuerdo a una matriz RACI (Resposible, Accountable, Consulted, Informed> indique las áreas de negocio o personas responsables del servicio> Resposible Accountable Informed Administrador de servidores Area de auditoria desarrolladores Nota: Recuerde que el secreto de SOA es la gobernabilidad, la cual es un principio de base de la organización alrededor de su visión de arquitectura empresarial. 5. Descripción de la interfaz del servicio Nombre de la operación Autenticar Descripción de la operación Autentica al usuario usando un nombre de usuario y contraseña Cerrar Sesión Saca de sesión el usuario que lo solicite 6. Mensaje de entrada Nombre de usuario y contraseña encriptada Nombre de usuario Mensaje de salida Acceso exitoso o no Excepciones El usuario no existe Fallo en la autenticación Detalle del contrato del servicio Derechos Reservados Jorge Arias Consultor Independiente Plantilla para levantar contratos de Servicios Pág. 4 de 7 MEPROC Documento de especificación de un servicio SOA (Contrato) Versión: 1.0 Fecha: 16/05/2010 6.1 Autenticar 6.1.1 Mensaje de entrada (en su defecto coloco una referencia al archivo XSD que contiene la definición del mensaje de entrada) Atributo Nombre de usuario Descripción Nombre de usuario a autenticar Contraseña del usuario Password Tipo Obligatorio String Si String Si Valores (Dominio, Valor por default, etc.) Regla de negocio 6.1.2 Mensaje de Salida (en su defecto coloco una referencia al archivo XSD que contiene la definición del mensaje de entrada) Atributo Acceso Descripción Acceso exitoso o no al sistema Tipo String Obligatorio Valores (Dominio, Valor por default, etc.) Regla de negocio Si 6.1.3 Excepciones En esta sección se debe describir todas las posibles excepciones que puede llegar a generar la ejecución de la operación que está siendo descrita. Nombre de la excepción Error Error Descripción El usuario a autenticar no existe en el sistema El acceso no ha sido exitoso no puede acceder al sistema Regla de negocio 6.2 Cerrar Sesión 6.2.1 Mensaje de entrada (en su defecto coloco una referencia al archivo XSD que contiene la definición del mensaje de entrada) Derechos Reservados Jorge Arias Consultor Independiente Plantilla para levantar contratos de Servicios Pág. 5 de 7 MEPROC Documento de especificación de un servicio SOA (Contrato) Atributo Nombre de usuario Descripción Nombre de usuario único que va a cerrar sesión Tipo Obligatorio String Versión: 1.0 Fecha: 16/05/2010 Valores (Dominio, Valor por default, etc.) Regla de negocio Si 6.2.2 Mensaje de Salida (en su defecto coloco una referencia al archivo XSD que contiene la definición del mensaje de entrada) Atributo Mensaje Descripción Mensaje de salida exitosa Tipo Obligatorio String Valores (Dominio, Valor por default, etc.) Regla de negocio Si 6.2.3 Excepciones En esta sección se debe describir todas las posibles excepciones que puede llegar a generar la ejecución de la operación que está siendo descrita. Nombre de la excepción 7. Regla de negocio Implementación del servicio Función Procesos de activar productos 8. Descripción Detalles de implementación En el sistema deberá estar implementado este servicio donde se requiera el acceso por parte del cliente a servicios como de activación de sus productos y todos los que tenga que ver sobre estos Manejo de requerimientos no funcionales Derechos Reservados Jorge Arias Consultor Independiente Plantilla para levantar contratos de Servicios Pág. 6 de 7 MEPROC Documento de especificación de un servicio SOA (Contrato) Agrupador Requerimiento Invocación Seguridad Calidad de Servicio Transacciones Derechos Reservados Jorge Arias Consultor Independiente Versión: 1.0 Fecha: 16/05/2010 Requerimiento Detalle del requerimiento Tipo de invocación Protocolo Autenticación Autorización Integridad & No repudio Síncrono Privacidad Tiempo de respuesta (Segs.) Numero de invocaciones / segundo Transacciones SOAP/HTTP 0.3 3000 Plantilla para levantar contratos de Servicios Pág. 7 de 7