Biblioteca cpp-httplib: Cliente OAuth 2.0 en C++ para aplicaciones web

Cliente OAuth 2.0 en C++ usando cpp-httplib

En el desarrollo de software moderno, la integración con servicios externos a través de OAuth 2.0 se ha convertido en un estándar de facto. Para el lenguaje C++, que tradicionalmente se asocia con la programación de sistemas, existen varias formas de implementar un cliente OAuth. Una de las soluciones más ligeras y eficientes es la biblioteca cpp-httplib, una biblioteca HTTP/HTTPS de un solo archivo de cabecera que permite crear aplicaciones tanto de servidor como de cliente sin dependencias externas.

En este artículo, analizaremos cómo usar cpp-httplib para construir un cliente OAuth 2.0 completo que pueda autenticarse a través de Google, GitHub, VK y otros proveedores. El material está dirigido a programadores de C++ que deseen agregar autenticación a aplicaciones de escritorio o integradas.

¿Qué es cpp-httplib?

cpp-httplib (también conocida como httplib.h) es una biblioteca header-only para C++11/14/17, escrita por Yuji Hirose. Proporciona una API simple e intuitiva para realizar solicitudes HTTP y crear servidores HTTP. Soporta SSL/TLS (a través de OpenSSL o MbedTLS), proxies, cookies y solicitudes asíncronas.

\n
• Header-only — basta con copiar un archivo en el proyecto.
\n
• Soporte HTTPS — conexión segura para OAuth.
\n
• Tamaño pequeño — alrededor de 8000 líneas de código.
\n
• Multiplataforma — Windows, Linux, macOS, BSD.
\n

Para OAuth 2.0, necesitaremos realizar solicitudes GET y POST a los endpoints del proveedor, así como manejar redirecciones. cpp-httplib maneja esto de manera excelente.

Arquitectura del cliente OAuth 2.0 en C++

Un flujo típico de OAuth 2.0 Authorization Code Flow incluye los siguientes pasos:

\n
1. La aplicación abre el navegador del usuario con la URL de autorización.
\n
2. El usuario confirma el acceso.
\n
3. El proveedor redirige a la URL de callback con un código temporal.
\n
4. La aplicación intercambia el código por un access token.
\n
5. Con el token, se realizan solicitudes a la API.
\n

En C++, podemos implementar esto iniciando un servidor HTTP local (con cpp-httplib) para interceptar el callback. Alternativamente, se puede usar un navegador integrado y rastrear la URL a través de eventos del sistema, pero el enfoque del servidor es más simple.

Ejemplo de implementación: OAuth a través de GitHub

Consideremos un ejemplo completo de un cliente que se autentica a través de GitHub OAuth. Para que funcione, deberá registrar una OAuth App en GitHub y obtener un Client ID y un Client Secret.

#include <httplib.h>\n#include <iostream>\n#include <string>\n#include <thread>\n#include <regex>\n\n// Configuración\nconst std::string CLIENT_ID = "su_client_id";\nconst std::string CLIENT_SECRET = "su_client_secret";\nconst std::string REDIRECT_URI = "http://localhost:8080/callback";\nconst std::string AUTH_URL = "https://github.com/login/oauth/authorize";\nconst std::string TOKEN_URL = "https://github.com/login/oauth/access_token";\nconst std::string API_URL = "https://api.github.com/user";\n\nstd::string auth_code;\n\nvoid start_local_server() {\n    httplib::Server svr;\n    \n    svr.Get("/callback", [&](const httplib::Request& req, httplib::Response& res) {\n        // Extraemos el código de los parámetros de consulta\n        if (req.has_param("code")) {\n            auth_code = req.get_param_value("code");\n            res.set_content("<h2>¡Autorización exitosa! Cierre la ventana.</h2>", "text/html");\n            svr.stop();\n        } else {\n            res.set_content("<h2>Error de autorización</h2>", "text/html");\n        }\n    });\n    \n    std::cout << "Servidor iniciado en el puerto 8080..." << std::endl;\n    svr.listen("0.0.0.0", 8080);\n}\n\nint main() {\n    // Paso 1: Formamos la URL de autorización\n    std::string auth_url = AUTH_URL + "?clien