Plantilla para elaborar documentos
Contents
1. REP BLICA DEL ECUADOR SECRETARIA NACIONAL DE LA ADMINISTRACI N PUBLICA Sistema BUS DE SERVICIOS GUBERNAMENTALES BSG Manual T cnico de Servicio Web AUTENTICACION Y AUTORIZACION DE USUARIOS DEL BSG FEBRERO 2013 QUITO ECUADOR SNAP STI Manual T cnico de SW 1 INTRODUCCION 1 1 PROPOSITO Especificar la informaci n t cnica para utilizaci n del Servicio Web SW que autentica y autoriza el acceso al BSG y el uso de SW disponibles en el mismo mediante tokens temporales 1 2 AUDIENCIA Programadores arquitectos de informaci n especialistas de infraestructura lideres directores de reas de Tecnolog as de la Informaci n de las entidades de la Administraci n P blica Central Dependiente e Institucional APCDI 1 3 ALCANCE Se especifica los par metros t cnicos para consumo del SW de Autenticaci n y Autorizaci n de acceso y uso de SW publicados en el BSG desde sistemas inform ticos de entidades de la APCDI 2 8 SNAP STI Manual T cnico de SW 2 INFORMACI N DEL PROVEEDOR DEL SERVICIO WEB 2 1 ENTIDAD PROVEEDORA Secretaria Nacional de la Administraci n P blica SNAP 2 2 DESCRIPCI N GENERAL El SW permite acceder al BSG y utilizar los SW disponibles en el mismo El SW autentica al usuario que invoca a un SW del BSG verificando que este registrado en el sistema de directorio ligero del BSG y adicionalmente que tenga autorizaci n para invocar al SW En caso que la autenticaci n y a2. su instituci n 002 String 3 Falta el par metro c dula de Enviar n mero de c dula o v lido 5 8 SNAP STI Manual T cnico de SW el valor no puede estar vac o 009 String 3 Falta par metro URL del SW Enviar URL del SW a consumir el alor no puede estar vac o 011 String 3 Usuario no tiene autorizaci n El usuario debe tener permisos de para utilizar el SW acceso al SW Contacte al administrador del SW del BSG de su instituci n 3 PROCEDIMIENTO PARA CONSUMO DEL SW El personal t cnico de una entidad p blica que requiera utilizar un SW disponible en el BSG deber primero invocar al SW lt lt BSGSWO0O9 Acceder_BSG gt gt en caso que as se especifique en el contrato del SW Para m s informaci n acceda a http www informatica gob ec sistemas transversales bsg Si el SW lt lt BSGSWO9 Acceder_BSG gt gt responde con los par metros de un token temporal se podr invocar al SW requerido caso contrario se enviar los mensajes de error que correspondan Se deber realizar los desarrollos y pruebas internas correspondientes invocando al SW en el ambiente de producci n y pruebas del BSG Producci n BSG lt lt https wwwv bsg gob ec sw STI BSGSWO8_Acceder_BSG wsdl gt gt Pruebas BSG lt lt https pru bsg gob ec sw STI BSGSWO0O8_Acceder_BSG wsdl gt gt y enviando los par metros del mensaje XML de petici n descritos en las secciones anteriores Se r
3. ecomienda realizar los desarrollos y pruebas invocando al SW en el BSG de pruebas previo a la utilizaci n en producci n 6 8 SNAP STI Manual T cnico de SW 4 CONTACTO SOPORTE T CNICO ENTIDAD UNIDAD E MAIL TEL FONO STI Equipo de Soporte de Aplicaciones soporte Dinformatica gob ec 2 2 463703 opci n 1 718 SNAP STI Manual T cnico de SW CONTROL DE CAMBIOS DEL DOCUMENTO uta FECHA DESCRIPCI N CAMBIO RESPONSABLE 2013 04 11 Creaci n del documento STI Direcci n de Interoperabilidad 2013 04 12 Revisi n y actualizaci n STI Direcci n de Interoperabilidad 2013 05 17 Actualizaci n URL del SW para uso STI Direcci n de Interoperabilidad exclusivo del componente CXF del BSG 8 8
4. s exitosamente se genera un token temporal para utilizaci n del SW requerido Los tokens tienen una vigencia de 2 minutos luego de lo cual caducar y ser necesario solicitar uno nuevo para utilizar el SW requerido MENSAJE XML DE PETICION REQUEST ValidarPermisoPeticion 5 k TIPO a SECCI N PARAMETRO LONGITUD OCURRENCIA DESCRIPCI N Body lt Cedula gt String 10 Obligatorio N mero de c dula de ciudadan a del usuario que invoca un SW del BSG Body lt Urlsw gt Varchar Obligatorio URL del SW del BSG invocado Ejemplo MENSAJE XML DE PETICION lt soapenv Envelope xmins soapenv http schemas xmlsoap org soap envelope xmins acc http bsg gob ec AccesoBSGService gt lt soapenv Header gt lt acc ValidarPermiso gt lt Optional gt lt ValidarPermisoPeticion gt lt Optional gt lt Cedula gt 1710362789 lt Cedula gt lt Optional gt lt Urlsw gt https lwww bsg gob ecISENESCYT BSGSWO01_Consultar_Titulos wsdl lt Urlsw gt lt ValidarPermisoPeticion gt lt lacc ValidarPermiso gt lt soapenv Envelope gt MENSAJE XML DE RESPUESTA validarPermisoRespuesta 4 8 SNAP STI Manual T cnico de SW K TIPO Pi SECCION PARAMETRO LONGITUD OCURRENCIA DESCRIPCI N Body lt Digest gt string Obligatorio Contrase a en base 64 calculada al partir de Fecha Nonce y un contrase a registrada en el m dulo de seguridad del BSG Bod
5. utorizaci n sean verificadas satisfactoriamente el SW genera un token temporal que permite invocar al SW mientras el token este vigente El SW requiere el n mero de c dula de ciudadan a del usuario y el URL del SW que invoca o requiere utilizar Los tokens temporales para utilizaci n de un SW son generados en base a la especificaci n WS Basic Security Profile versi n 1 1 2 3 C DIGO DEL SW EN EL BSG BSGSWO08_Acceder_BSG 2 4 DIRECCIONES WEB DE ACCESO AL SW EN EL BSG TIPO DE AMBIENTE Producci n https www bsg gob ec sw STI BSGSWO0O8_Acceder_BSG wsdl URL DEL SW Pruebas https pru bsg gob ec sw STI BSGSWO8_ Acceder BSG wsdl 2 5 TABLA DE OPERACIONES No Denominaci n Denominaci n Denominaci n Operaci n Mensaje XML Petici n Mensaje XML Respuesta 1 ValidarPermiso ValidarPermisoPeticion ValidarPermisoRespuesta 1 OASIS Organizaci n para Est ndares Avanzados de Sistemas de Informaci n El est ndar esta disponible en https www oasis open org committees download php 16782 wss v1 1 spec os UsernameTokenProfile pdf 3 8 SNAP STI Manual T cnico de SW 2 6 DESCRIPCI N DE LAS OPERACIONES 2 6 1 OPERACI N ValidarPermiso FUNCI N Verificar que el n mero de c dula de ciudadan a enviado corresponda a un funcionario creado como usuario del BSG y si tiene permiso para acceder al URL del SW requerido En caso que la autenticaci n y autorizaci n sean realizdaa
6. y lt Fecha gt string Obligatorio Fecha y hora de emisi n del token Body lt FechaF gt string Opcional Fecha y hora de cancelaci n del token Body lt Nonce gt string Obligatorio Valor rand mico para calcular el Digest Body lt CodError gt string Obligatorio C digo de error enviado por el SW Body lt DesError gt string Obligatorio Descripci n de error enviado por el SW Body lt Digest gt string Obligatorio contrase a en base 64 calculada al partir de Fecha Nonce y la contrase a registrada en m dulo de seguridad del BSG Ejemplo MENSAJE XML DE RESPUESTA ra xmins soap http schemas xmlsoap org soap envelope gt lt ns2 ValidarPermisoResponse xmins ns2 http bsg gob ec AccesoBSGService gt lt return gt lt Digest gt zlviRsGBMnl1RVKA IKaukL67hs lt Digest gt lt Fecha gt 2013 04 23T16 10 29Z lt Fecha gt lt FechaF gt 2013 04 23T16 14 29Z lt FechaF gt lt Mensaje gt lt CodError gt 000 lt CodError gt lt DesError gt Ok lt DesError gt lt Mensaje gt lt Nonce gt I0edVGgKaEdwKEOpOiCgw lt Nonce gt lt TienePermiso gt S lt TienePermiso gt lt return gt lt ns2 ValidarPermisoResponse gt lt soap Envelope gt MENSAJES XML DE ERRORES FUNCIONALES P TIPO z CODIGO LONGITUD MENSAJE ACCION 001 String 3 C dula enviada no Enviar n mero de c dula de un corresponde a un usuario no usuario autorizado Contacte al existe o no esta registrado administrador del SW del BSG de
Download Pdf Manuals
Related Search