Plantilla para elaborar documentos
Contents
1. REP BLICA DEL ECUADOR SECRETAR A NACIONAL DE LA ADMINISTRACI N P BLICA Sistema BUS DE SERVICIOS GUBERNAMENTALES BSG Manual T cnico de Servicio Web AUTENTICACI N Y AUTORIZACI N DE USUARIOS DEL BSG FEBRERO 2013 QUITO ECUADOR SNAP STI Manual T cnico de SW 1 INTRODUCCION 1 1 PROP SITO 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 l deres 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 Secretar a 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 n2. 463703 opci n 1 Aplicaciones 7 8 SNAP STI Manual T cnico de SW CONTROL DE CAMBIOS DEL DOCUMENTO uta FECHA DESCRIPCI N CAMBIO 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 usojSTI Direcci n de Interoperabilidad exclusivo del componente CXF del 8 8
3. y autorizaci 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 BSGSWO8 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 BSGSWO8_ Acceder _BSG wsdl URL DEL SW Pruebas httos pru bsg gob ec sw STI BSGSWO8 Acceder _BSG wsadl 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 est 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 sea
4. lt Nonce gt string Obligatorio Valor rand mico para calcular el Digest BOY e ES a C digo de error enviado por el SW AA A A Descripci n de error enviado por el Sw o lt Digest gt string Obligatorio contrase a en base 64 calculada a partir de Fecha Nonce y la contrase a registrada en m dulo de seguridad del BSG Ejemplo MENSAJE XML DE RESPUESTA lt soap Envelope xmins soap http schemas xmisoap org soap envelope gt lt ns2 ValidarPermisoResponse xmins ns2 http bsg gob ec AccesoBSGService gt lt return gt lt Digest gt zlv RsGBMnl1RVKA lKaukL67hs 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 I0edVGgKaEdwKEOpOi Cgw 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 r 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 jusuario autorizado Contacte al existe o no esta registrado administrador del SW del BSG de su instituci n 5 8 SNAP STI Manual T cnico de SW ciudadan a el valor no el valor no puede estar vac o estar vac o Sn E A par metro URL del SW Enviar URL cd SW a consumir el valor
5. n realizadas 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 TIPO DESCRIPCI N SECCI N PAR METRO 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 E a URL del SW del BSG invocado Ejemplo MENSAJE XML DE PETICION lt soapenv Envelope xmins soapenv http schemas xmisoap org soap envelope xmins acc http bsg gob ec AccesoBSGsService gt lt soapenv Header gt lt acc ValidarPermisoF lt Optional gt lt ValidarPermisoPeticion lt Optional gt lt Cedula gt 1710362789 lt Cedula gt lt Optional gt lt Urlsw gt https lwww bsg gob ec SENESCYT BSGSW01_Consultar_Titulos wsdl lt JUrlsw gt lt MalidarPermisoPeticion gt lt acc ValidarPermiso gt lt soapenv Envelope gt MENSAJE XML DE RESPUESTA validarPermisoRespuesta 4 8 SNAP STI Manual T cnico de SW TIPO z sEccion PAR METRO LONGITUD OCURRENCIA DESCRIPCION Body lt Digest gt string Obligatorio Contrase a en base 64 calculada a partir de Fecha Nonce y un contrase a registrada en el m dulo de seguridad del BSG a cc O Fecha y hora de emisi n del token PA NA token
6. no puede estar vac o 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 BSGSW0O9 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 www bsg gob ec sw STI BSGSWO0O8_Acceder_BSG wsdl gt gt Pruebas BSG lt lt https pru bsg gob ec sw STI BSGSWO8_Acceder_BSG wsdl gt gt y enviando los par metros del mensaje XML de petici n descritos en las secciones anteriores Se recomienda 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 desoporte Winformatica gob ec 2 2
Download Pdf Manuals
Related Search