Lista de Verificación de Producción para AppFolio
Resumen
AppFolio gestiona propiedades, inquilinos, contratos de arrendamiento y órdenes de trabajo para operaciones inmobiliarias. Una integración en producción maneja datos de identificación personal (PII) sensibles de inquilinos, transacciones financieras y flujos de trabajo de mantenimiento. Fallas aquí significan cobros de alquiler perdidos, órdenes de trabajo no procesadas o exposición de datos de inquilinos bajo CCPA. Esta lista de verificación garantiza que su integración con la API de AppFolio sea resiliente, conforme y observable.
Requisitos Previos
- Un contrato de socio de producción verificado, URL base, mecanismo de autenticación, alcances de endpoint permitidos y propietarios designados para decisiones comerciales, de seguridad, operaciones y de reversión.
- Un ensayo en entorno sandbox completado con datos sintéticos, credenciales administradas separadas, un presupuesto de solicitudes y un plan de reversión/reconciliación registrado.
- Evidencia de observabilidad, minimización de PII, escrituras idempotentes y enrutamiento de alertas—no solo un elemento de la lista de verificación que afirme que esos controles existen.
Instrucciones
- Valide la configuración real del cliente emitida por el proveedor a través del administrador de secretos; no utilice un endpoint o esquema de autenticación por defecto en el código de lanzamiento.
- Ejecute las comprobaciones de preparación en staging, luego un ensayo controlado con forma de producción que realice solo lecturas seguras autorizadas.
- Revise cada control fallido, omitido o no verificable como un no-go; conserve recibos redactados de credenciales, endpoints, monitoreo y recuperación.
- Lance progresivamente solo con un propietario de reversión y reconciliación probado; pause las rutas de escritura si se desconoce el estado de pagos, órdenes de trabajo, inquilinos o contratos de arrendamiento.
Autenticación y Secretos
-
APPFOLIO_API_KEYalmacenada en el administrador de secretos (no en archivos de entorno) - ID de cliente y secreto separados del código de la aplicación
- Programa de rotación de claves documentado (recomendado cada 90 días)
- Credenciales separadas para entornos dev/staging/prod
- Credenciales de API con alcance limitado a los permisos mínimos requeridos
Integración de API
- URL base de producción y método de autenticación verificados contra el contrato de socio actual
- Manejo de límite de velocidad con retroceso exponencial
- Paginación implementada para endpoints de listas de propiedades e inquilinos
- Creación de órdenes de trabajo probada con todos los campos requeridos
- Carga de documentos de arrendamiento validada para formatos compatibles
- Webhooks configurados para eventos de inquilinos y pagos
- Claves de idempotencia utilizadas para la creación de pagos y órdenes de trabajo
Manejo de Errores y Resiliencia
- Interruptor de circuito configurado para cortes de API de AppFolio
- Reintento con retroceso para respuestas 429/5xx
- Manejo de PII de inquilinos verificado como compatible con CCPA/FCRA
- Validación de datos en todas las respuestas de API antes del almacenamiento
- Degradación gradual cuando la sincronización de propiedades no está disponible
- Detección de órdenes de trabajo duplicadas para evitar la recreación en reintentos
Monitoreo y Alertas
- Latencia de API rastreada por endpoint (propiedades, inquilinos, órdenes de trabajo)
- Alertas de tasa de error configuradas (umbral: >3% en 5 minutos)
- Sincronización de pagos fallida activa alerta P1 inmediata
- Fallas de creación de órdenes de trabajo reportadas en 5 minutos
- Conciliación diaria de conteos de propiedades sincronizadas vs origen
Script de Validación
async function checkAppFolioReadiness(): Promise<void> {
const checks: { name: string; pass: boolean; detail: string }[] = [];
const client = createVerifiedAppFolioClient(); // cliente vinculado al contrato desde appfolio-security-basics
// Conectividad de API
try {
const res = await client.get('/properties?limit=1');
checks.push({ name: 'Conectividad de API', pass: res.status >= 200 && res.status < 300, detail: `HTTP ${res.status}` });
} catch (e: any) { checks.push({ name: 'Conectividad de API', pass: false, detail: e.message }); }
// La construcción del cliente demuestra que la credencial administrada y el contrato del proveedor están disponibles.
checks.push({ name: 'Configuración de cliente verificada', pass: true, detail: 'Cargado desde configuración administrada' });
// Endpoint de órdenes de trabajo
try {
const res = await client.get('/work_orders?limit=1');
checks.push({ name: 'Órdenes de trabajo', pass: res.status >= 200 && res.status < 300, detail: `HTTP ${res.status}` });
} catch (e: any) { checks.push({ name: 'Órdenes de trabajo', pass: false, detail: e.message }); }
for (const c of checks) console.log(`[${c.pass ? 'PASS' : 'FAIL'}] ${c.name}: ${c.detail}`);
}
checkAppFolioReadiness();
Manejo de Errores
| Verificación | Riesgo si se Omite | Prioridad |
|---|---|---|
| Rotación de clave de API | Claves expiradas detienen la sincronización de propiedades | P1 |
| Falla de sincronización de pagos | Cobros de alquiler perdidos | P1 |
| Exposición de PII de inquilinos | Violación de CCPA, responsabilidad legal | P1 |
| Duplicación de órdenes de trabajo | Despacho duplicado de mantenimiento | P2 |
| Manejo de límite de velocidad | Errores 429 durante la importación masiva de propiedades | P3 |
Salida
- Un recibo de aprobación/rechazo redactado que vincula el cliente verificado, comprobaciones de lectura segura, estado de monitoreo, aprobaciones de propietarios y el plan de reversión/reconciliación
- Una lista de controles fallidos o no probados que bloquea el lanzamiento hasta que se remedien
- Una decisión de lanzamiento acotada que mantiene las rutas sensibles o de escritura desactivadas hasta que su ensayo con forma de producción tenga evidencia
Ejemplos
Para un lanzamiento de integración de órdenes de trabajo, ejecute primero la lista de verificación contra un fixture de staging sintético, luego use el cliente administrado con forma de producción para una sola lectura segura autorizada. Confirme la ruta de alerta, la redacción de PII y los controles de idempotencia/reconciliación mientras todas las escrituras permanecen deshabilitadas. Si no se puede verificar una credencial, contrato de endpoint, comprobación de preparación o ejercicio de reversión, declare no-go, conserve la revisión anterior y haga que el propietario asignado remedie antes de un nuevo ensayo.
Recursos
Próximos Pasos
Consulte appfolio-security-basics para la protección de datos de inquilinos y control de acceso.