Ctrlk
Woowup
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Requisitos de conexión y seguridad

Esta página describe los protocolos de transporte y los requisitos de seguridad para conectarse a la API y endpoints públicos de WoowUp (por ej. api.woowup.com).

Transporte: solo HTTPS

Todas las conexiones deben usar HTTPS. Los requests HTTP planos al puerto 80 se redirigen automáticamente a 443 (HTTPS). No existe acceso a la API sin cifrar.

  • Puerto: 443

  • Esquema: https://

TLS

WoowUp requiere TLS 1.2 o superior (se soportan TLS 1.2 y TLS 1.3). Las versiones anteriores (TLS 1.1, TLS 1.0, SSLv3) no están soportadas y serán rechazadas.

Cipher suites

Solo se aceptan cipher suites modernos y seguros. Todos los suites negociados proveen:

  • Forward secrecy — intercambio de claves ECDHE

  • Cifrado autenticado (AEAD) — AES-GCM y ChaCha20-Poly1305

Los ciphers legacy (RC4, 3DES, intercambio RSA estático, suites basados en SHA-1) no están soportados.

SNI requerido

El endpoint usa SNI (Server Name Indication). Tu cliente TLS debe enviar la extensión SNI con el hostname destino durante el handshake. Casi todos los clientes modernos lo hacen automáticamente; solo librerías muy viejas pueden requerir actualización.

Certificado

  • Emitido por una CA pública de confianza (Amazon)

  • Clave RSA-2048, firma SHA-256

  • Tu cliente HTTP debe confiar en las root CAs públicas estándar (por defecto en todos los trust stores de OS/runtime modernos)

No fijes certificados ni IPs

WoowUp usa certificados gestionados que rotan automáticamente, y las direcciones IP de los endpoints cambian sin previo aviso. No hagas certificate pinning ni hardcodees IPs: conectá siempre por hostname y validá contra la cadena de CAs públicas. Fijar un certificado o una IP hará que tu integración falle cuando estos roten.

Versiones de HTTP

WoowUp soporta:

  • HTTP/2 (negociado vía ALPN sobre TLS) — preferido, usado automáticamente por clientes modernos

  • HTTP/1.1

Checklist del cliente HTTP

  • Usá TLS 1.2 o superior — por defecto en casi todo el software desde 2015 en adelante.

  • Enviá SNI durante el handshake TLS (automático en clientes modernos).

  • Confiá en las root CAs públicas estándar.

  • Preferí HTTP/2; HTTP/1.1 está totalmente soportado.

Prestá atención a stacks muy viejos: Java < 8u161, OpenSSL < 1.0.1, Python < 2.7.9, .NET Framework < 4.6, o Windows Server 2008/2012 sin actualizaciones — pueden no negociar TLS 1.2 por defecto.

Cómo probar

Confirmá que tu cliente negocia TLS 1.2+ correctamente:

Verificá la versión de TLS, cipher y versión de HTTP negociadas:

Política de cambios de seguridad

WoowUp puede elevar la versión mínima de TLS o retirar cipher suites que dejen de considerarse seguros, para proteger la seguridad de las conexiones. Los cambios que puedan romper compatibilidad (por ejemplo, el retiro de una versión de TLS) se anuncian con al menos 30 días de anticipación a los contactos técnicos / de integración de cada cuenta, y se reflejan en esta página. Recomendamos mantener tu cliente HTTP con soporte de TLS actualizado y probar tu integración periódicamente (ver "Cómo probar").

¿Necesitás ayuda?

Si tu integración no puede negociar TLS 1.2 o un cipher suite soportado, contactá a soporte de WoowUp con los detalles de tu librería cliente y versión.

AnteriorPrimeros Pasos (ES)
SiguienteUsers

Última actualización

¿Te fue útil?