Cliente OAuth para C++: biblioteca liboauth para autorización

Cliente OAuth para C++: biblioteca liboauthcpp

En el desarrollo web moderno, la integración con APIs externas mediante el protocolo OAuth se ha convertido en un estándar de facto. Para los desarrolladores de C++, crear un cliente OAuth robusto puede ser una tarea no trivial debido a la falta de soporte integrado en la biblioteca estándar. liboauthcpp es una biblioteca ligera y multiplataforma en C++ que proporciona mecanismos listos para trabajar con OAuth 1.0a y soporte parcial para OAuth 2.0. Es ideal para integrarse en aplicaciones de escritorio, utilidades de servidor y dispositivos IoT, donde el rendimiento y las dependencias mínimas son críticos.

Características principales

• Soporte para OAuth 1.0a — implementación completa de firmas HMAC-SHA1 y RSA-SHA1.
• Mecanismos básicos de OAuth 2.0 — obtención de Authorization Code y Client Credentials (sin Refresh Token).
• Dependencias mínimas — solo requiere un compilador C++11/14 y OpenSSL (o un proveedor criptográfico alternativo).
• Multiplataforma — funciona en Linux, macOS, Windows (MinGW/MSVC).
• API simple — clases intuitivas OAuthClient, OAuthToken, OAuthRequest.

Instalación

La forma recomendada de instalación es a través del sistema de paquetes vcpkg o compilando desde el código fuente:

# Mediante vcpkgvcpkg install liboauthcpp

# O compilando desde GitHubgit clone https://github.com/lyokato/liboauthcpp.gitcd liboauthcppmkdir build && cd buildcmake .. -DCMAKE_INSTALL_PREFIX=/usr/localmake && sudo make install

Después de la instalación, incluya el archivo de cabecera y enlace con la biblioteca:

#include <oauthcpp/oauthcpp.hpp>// Enlace: -loauthcpp -lssl -lcrypto

Ejemplo: OAuth 1.0a (API de Twitter)

Consideremos el escenario clásico: enviar un tuit a través de la API de Twitter v1.1 usando OAuth 1.0a:

#include <iostream>#include <oauthcpp/oauthcpp.hpp>#include <curl/curl.h>  // Para transporte HTTP

int main() {    // 1. Inicialización de credenciales    oauthcpp::OAuthClient client(        "YOUR_CONSUMER_KEY",        "YOUR_CONSUMER_SECRET",        oauthcpp::OAuthClient::HttpMethod::POST    );

    // 2. Configuración de tokens de usuario (obtenidos previamente)    oauthcpp::OAuthToken accessToken(        "USER_ACCESS_TOKEN",        "USER_TOKEN_SECRET"    );    client.setToken(accessToken);

    // 3. Formación de la solicitud    std::string url = "https://api.twitter.com/1.1/statuses/update.json";    oauthcpp::OAuthRequest request(url);    request.addParameter("status", "¡Hola desde el cliente OAuth en C++!");

    // 4. Firma de la solicitud    std::string signedUrl = client.sign(request);

    // 5. Envío mediante libcurl    CURL* curl = curl_easy_init();    curl_easy_setopt(curl, CURLOPT_URL, signedUrl.c_str());    curl_easy_setopt(curl, CURLOPT_POST, 1L);    // ... configuración de SSL y manejo de respuesta    curl_easy_perform(curl);    curl_easy_cleanup(curl);

    return 0;}

Ejemplo: OAuth 2.0 (API de Google)

Para trabajar con OAuth 2.0, use el mecanismo simplificado OAuth2Client (incluido en liboauthcpp):

#include <iostream>#include <oauthcpp/oauth2.hpp>

int main() {    oauthcpp::OAuth2Client client(        "YOUR_CLIENT_ID",        "YOUR_CLIENT_SECRET",        "https://oauth2.googleapis.com/token"    );

    // Obtención del token mediante Authorization Code    std::string authCode = "AUTH_CODE_FROM_REDIRECT";    oauthcpp::OAuthToken token = client.getAccessToken(authCode,         "https://your-app.com/callback");

    std::cout << "Access Token: " << token.getAccessToken() << std::endl;    std::cout << "Expires in: " << token.getExpiresIn() &