![[Resuelto] Error al obtener el certificado del emisor local en Postman](https://assets.apidog.com/blog/2024/05/postman-unable-to-get-local-issuer-certificate-error-cover.png)
Cuando se trabaja con APIs (Interfaces de Programación de Aplicaciones) en Postman, una herramienta fundamental para los desarrolladores, encontrarse con el mensaje de error "Unable to Get Local Issuer Certificate" (No se puede obtener el certificado del emisor local) puede interrumpir el flujo de trabajo. Este error surge debido a una discrepancia entre el certificado presentado por la API y los certificados de confianza almacenados en su sistema.
Para obtener más información sobre los numerosos beneficios que Apidog puede proporcionar, ¡haga clic en el botón de abajo!
Esta guía profundiza en la causa raíz de este error y presenta una serie de soluciones para resolverlo eficazmente, garantizando una conexión fluida y segura entre Postman y la API de destino.
¿Qué es Postman?
Postman es una plataforma integral diseñada específicamente para trabajar con APIs. Simplifica todo el proceso de desarrollo de API, desde el diseño inicial y las pruebas hasta la documentación y la gestión. También actúa como un cliente API, proporcionando una interfaz fácil de usar para enviar solicitudes a las APIs, analizar las respuestas y agilizar todo el ciclo de vida del desarrollo de la API.
¿Qué es un certificado de emisor local?
Los certificados de emisor local pertenecen a un certificado digital emitido por una Autoridad de Certificación (CA) que reside dentro del almacén de certificados de confianza de su dispositivo o sistema operativo. Este almacén de certificados de confianza funciona como una lista seleccionada de CAs aprobadas. Cuando su sistema encuentra un certificado durante la comunicación API, comprueba el almacén de confianza para verificar si el certificado fue emitido por una CA reconocida.
Hay algunos términos avanzados que se encuentran dentro del párrafo anterior, así que para proporcionar más contexto, aquí están algunos de los términos clave.
Certificado Digital:
Autoridad de Certificación (CA):
Almacén de Certificados de Confianza:
Posibles razones para el error "Unable to Get Local Issuer Certificate" (No se puede obtener el certificado del emisor local)
Autoridad de Certificación (CA) no confiable
El servidor API podría estar presentando un certificado emitido por una CA que no es reconocida o de confianza para su sistema. Esto podría deberse a que la CA no es ampliamente conocida o a que su sistema no ha sido configurado para confiar en ella.
Cadena de Certificados Incompleta
El servidor API podría estar enviando una cadena de certificados incompleta. Los certificados digitales se basan en una cadena de confianza, donde cada certificado está firmado por otro certificado de confianza. Si falta algún certificado en la cadena o no es reconocido por su sistema, puede producirse un error.
Configuración del Sistema Desactualizada o Incorrecta
La configuración del almacén de certificados de confianza de su sistema podría estar desactualizada o mal configurada. Esto podría impedir que Postman acceda a los certificados necesarios para verificar la identidad del servidor API.
Problemas de Red o Firewall
En casos raros, las restricciones de red o los firewalls podrían interferir con la capacidad de Postman para recuperar o verificar la cadena de certificados del servidor API.
Certificado Autofirmado
Algunas APIs, particularmente en entornos de desarrollo, podrían utilizar certificados autofirmados. Estos certificados no son emitidos por una CA de confianza y activarán este error por defecto en Postman.
TLS no configurado correctamente
Si TLS (Transport Layer Security) no está implementado correctamente, puede experimentar el mismo problema con otros clientes.
Guía paso a paso para solucionar el error "Unable to Get Local Issuer Certificate" (No se puede obtener el certificado del emisor local)
Para asegurarse de que el error ya no moleste a su Postman, primero compruebe si una raíz de CA (Autoridades de Certificación) interna y otros certificados intermedios están listos. Si este es el caso, entonces tendrá que añadirlos.
Añadir certificados raíz/intermedios de CA interna
En primer lugar, abra la configuración de Postman, como se ve en la imagen de arriba.
A continuación, seleccione la sección Certificates y añada los certificados de CA y de cliente necesarios para que su API funcione sin problemas.
Activar la verificación del certificado SSL
Proceda activando la verificación del certificado SSL si su Postman no lo ha hecho.
Apidog - Aprovechando la simplicidad para un proceso de desarrollo de API más eficiente
Apidog es una plataforma de desarrollo de API todo en uno que permite a sus usuarios convertirse en desarrolladores de API en cuestión de minutos. Con Apidog, puede construir, simular, probar, documentar - esencialmente manipular todo el ciclo de vida de la API dentro de una sola aplicación
Potencie las interacciones seguras de la API con Apidog
Apidog ofrece funcionalidades para configurar los ajustes de certificación Secure Sockets Layer (SSL) de su API, garantizando un entorno seguro para los consumidores de su API.
Al igual que Postman, Apidog le ofrece la flexibilidad de activar o desactivar la verificación del certificado SSL. Además, ofrece un control granular sobre la configuración avanzada de los certificados, lo que le permite adaptar la postura de seguridad de su API para que se ajuste con precisión a su visión de diseño.
También puede añadir y gestionar certificados SSL por dominio, y activarlos o desactivarlos en función de sus necesidades.
Mantenimiento de la funcionalidad de la API con las funciones de prueba de Apidog
La naturaleza siempre cambiante del desarrollo puede introducir consecuencias no deseadas dentro de su API. Apidog proporciona un conjunto de pruebas robusto que le permite evaluar meticulosamente cada punto final de la API después de las modificaciones, garantizando la funcionalidad continua según su diseño.
Para interactuar con una función deseada dentro de una API, debe proporcionar la URL del punto final específico. Es importante tener en cuenta que algunos puntos finales requieren la inclusión de parámetros adicionales para su correcta ejecución. Asegúrese de incorporar estos parámetros cuando sea necesario.
Sin embargo, si Apidog no le parece la herramienta adecuada, consulte otras posibles herramientas de prueba de automatización.
Conclusión
Resolver con éxito el error "Unable to Get Local Issuer Certificate" (No se puede obtener el certificado del emisor local) en Postman le permite reanudar las interacciones fluidas y seguras con sus APIs de destino. Siguiendo las soluciones descritas en esta guía, puede abordar eficazmente la causa raíz del error, ya sea una CA no confiable, una cadena de certificados incompleta o una configuración del sistema desactualizada. Recuerde que mantener un almacén de certificados de confianza actualizado y bien configurado en su sistema es crucial para una comunicación API sin problemas.
Para futuros proyectos, considere la posibilidad de familiarizarse con los requisitos específicos de los certificados de las APIs con las que pretende interactuar. Este enfoque proactivo puede ayudarle a evitar posibles errores y garantizar un flujo de trabajo más eficiente dentro de Postman.
