2
AFIP: Web Services, Arquitectura El intercambio de información entre AFIP y los Entes Externos (EE) se implementa a través de web services SOAP sobre transporte HTTPS. Todos estos web services de negocio (WSN) están directamente accesibles a través de Internet, no se requiere el establecimiento de canales especiales de comunicaciones ni VPNs. El acceso a los WSN está regulado por otro WS llamado Web Service de Autenticación y Autorización (WSAA), el cual autentica a los clientes y les concede permiso de acceso a cada uno de los WSN mediante el otorgamiento de un Ticket de Acceso (TA). Cada TA es válido para un WSN en particular y tiene una validez limitada en el tiempo (actualmente, doce horas). El cliente será responsable de presentar al WSN el TA otorgado por el WSAA, de lo contrario el WSN rechazará su solicitud de acceso. Autenticación y Autorización La autenticación del cliente se realiza utilizando criptografía de clave pública basada en certificados digitales X.509. A estos efectos, AFIP actúa como Autoridad Certificante y emite estos certificados sin aplicar ningún cargo a los EE. Una vez obtenido el certificado digital el EE llevará a cabo los trámites requeridos en cada caso para obtener la autorización inicial para acceder a un WSN y lo relacionará con un certificado digital. El cliente solicitará al WSAA que le conceda un TA para un WSN en particular mediante el envío de una estructura CMS (ver PKCS#7, S/MIME) conteniendo la solicitud propiamente dicha (ver TRA en Manual para el desarrollador del WSAA) más su firma digital separada más su certificado X.509. Basado en el análisis de estos datos, el WSAA autenticará al cliente mediante la verificación de su firma digital y la comprobación en su base de datos de que el EE haya completado los trámites de autorización inicial para acceder al WSN para el cual solicita permiso en el TRA; si estos controles son superados, entonces el WSAA contestará devolviendo un TA, de lo contrario, devolverá un mensaje de error explicativo. El cliente del WSN extraerá del TA dos componentes -Token y Sign- y los enviará junto con los datos de negocio en cada solicitud que le envíe al WSN. Ambientes de ejecución Toda esta infraestructura está replicada en dos ambientes separados, el de Testing y el de Producción. El de Testing es provisto para que los EEs puedan probar sus desarrollos hasta que estén listos para pasar al ambiente de Producción. Como estos dos ambientes estan comletamente aislados uno del otro, los certificados digitales de uno no son válidos en el otro. Obtención de certificados y autorización inicial

1 AFIP WS Arquitectura

Embed Size (px)

DESCRIPTION

ff

Citation preview

  • AFIP: Web Services, Arquitectura

    El intercambio de informacin entre AFIP y los Entes Externos (EE) se implementa a travs de web services SOAP sobre transporte HTTPS.

    Todos estos web services de negocio (WSN) estn directamente accesibles a travs de Internet, no se requiere el establecimiento de canales especiales de comunicaciones ni VPNs.

    El acceso a los WSN est regulado por otro WS llamado Web Service de Autenticacin y Autorizacin (WSAA), el cual autentica a los clientes y les concede permiso de acceso a cada uno de los WSN mediante el otorgamiento de un Ticket de Acceso (TA). Cada TA es vlido para un WSN en particular y tiene una validez limitada en el tiempo (actualmente, doce horas). El cliente ser responsable de presentar al WSN el TA otorgado por el WSAA, de lo contrario el WSN rechazar su solicitud de acceso.

    Autenticacin y Autorizacin

    La autenticacin del cliente se realiza utilizando criptografa de clave pblica basada en certificados digitales X.509. A estos efectos, AFIP acta como Autoridad Certificante y emite estos certificados sin aplicar ningn cargo a los EE.

    Una vez obtenido el certificado digital el EE llevar a cabo los trmites requeridos en cada caso para obtener la autorizacin inicial para acceder a un WSN y lo relacionar con un certificado digital.

    El cliente solicitar al WSAA que le conceda un TA para un WSN en particular mediante el envo de una estructura CMS (ver PKCS#7, S/MIME) conteniendo la solicitud propiamente dicha (ver TRA en Manual para el desarrollador del WSAA) ms su firma digital separada ms su certificado X.509. Basado en el anlisis de estos datos, el WSAA autenticar al cliente mediante la verificacin de su firma digital y la comprobacin en su base de datos de que el EE haya completado los trmites de autorizacin inicial para acceder al WSN para el cual solicita permiso en el TRA; si estos controles son superados, entonces el WSAA contestar devolviendo un TA, de lo contrario, devolver un mensaje de error explicativo.

    El cliente del WSN extraer del TA dos componentes -Token y Sign- y los enviar junto con los datos de negocio en cada solicitud que le enve al WSN.

    Ambientes de ejecucin

    Toda esta infraestructura est replicada en dos ambientes separados, el de Testing y el de Produccin. El de Testing es provisto para que los EEs puedan probar sus desarrollos hasta que estn listos para pasar al ambiente de Produccin. Como estos dos ambientes estan comletamente aislados uno del otro, los certificados digitales de uno no son vlidos en el otro.

    Obtencin de certificados y autorizacin inicial

  • El mecanismo de obtencin de certificados digitales y los trmites iniciales para obtener autorizacin de acceso a los WSN es tambin diferente en ambos ambientes: en el de Testing estos dos pasos se completan mediante e-mail a [email protected]; en el de Produccin estos dos pasos deben ser completados a travs del portal de AFiP en www.afip.gov.ar, Trmites con Clave Fiscal, Administrador de Relaciones.

    Consultas Para obtener informacin adicional sobre cualquiera de los WSN, los EE pueden enviar sus consultas a [email protected]