cs-membership-user-migration

(0 reviews)

Job de migración automatizada de usuarios desde base de datos Membership hacia Azure B2C, con sincronización de credenciales, validación de identidad, y actualización de atributos extendidos de usuario empresarial

🛡️ cs-membership-user-migration-job

Job automatizado de migración masiva de usuarios desde base de datos Membership hacia Azure AD B2C. Sincroniza credenciales, valida identidades, actualiza atributos extendidos empresariales y mantiene trazabilidad completa del proceso de migración con soporte para reintentos y manejo de errores robusto.

🌐 Información Base

Título del Job: cs-membership-user-migration-job
Versión: 1.0.0-SNAPSHOT
Plataforma: MuleSoft Anypoint Platform
Runtime: Mule 4.4.0
Tipo: Process API + Scheduled Job
URL Base QA: https://cs-membership-user-migration-job-qa.us-e1.cloudhub.io/api/
URL Base Producción: https://cs-membership-user-migration-job-prod.us-e1.cloudhub.io/api/
Protocolo: REST + SOAP
Formato de Datos: JSON/XML
Autenticación: OAuth 2.0 + Client ID/Secret

🚀 Cómo Comenzar

Autenticación: Asegúrate de tener el client_id y client_secret configurados correctamente para acceso a Azure B2C y servicios backend.
URL Base: Usa la URL Base proporcionada como prefijo para todos los endpoints de la API.
Encabezados: Agrega los siguientes encabezados en tus solicitudes de API:

-H "Content-Type: application/json"
-H "client_id: TU_CLIENT_ID"
-H "Authorization: Bearer TU_ACCESS_TOKEN"
-H "X-Correlation-ID: TU_CORRELATION_ID"  # Recomendado para trazabilidad

🚀 Cómo Consumir

Puedes acceder y consumir esta API a través de las siguientes plataformas:

📍 Endpoints Disponibles

Método	Endpoint	Descripción
GET	`/api/obtain-users-by-b2c`	Obtener información de usuario desde Azure B2C por parámetro query `sub` (ObjectId B2C) - Requerido
GET	`/api/identity-validation/{b2cObjectId}`	Validar identidad de usuario en Azure B2C con reglas de validación usando ObjectId B2C como parámetro URI
SOAP	`ObtenerCredencialesMembership`	Obtener credenciales de usuarios desde base de datos Membership para proceso de migración (servicio backend)
JOB	Scheduler Automático (Cron)	Job programado que ejecuta migración masiva de usuarios de Membership a Azure B2C cada minuto

⚠️ Manejo de Errores

Se utilizan códigos de estado HTTP estándar para el manejo de errores:

📊 Códigos de Respuesta

Código	Estado	Descripción	Causa Común	Acción Recomendada
`200`	✅ OK	La solicitud fue exitosa	Usuario encontrado o migrado correctamente	Continuar con el procesamiento
`400`	❌ Bad Request	Parámetros faltantes o inválidos	Formato de documento incorrecto, datos faltantes	Revisar estructura del JSON y campos requeridos
`401`	🔒 Unauthorized	Autenticación fallida	Token expirado o client_id/secret inválido	Renovar token OAuth de autenticación
`403`	🚫 Forbidden	Sin permisos suficientes	Client_id sin permisos para Graph API o Membership	Verificar permisos asignados al client_id
`404`	🔍 Not Found	Usuario no encontrado	ObjectId B2C no existe, usuario no migrado	Verificar ObjectId o proceder con migración
`409`	⚠️ Conflict	Usuario ya existe en B2C	Intento de crear usuario duplicado	Usar PATCH para actualizar en lugar de POST
`429`	⏰ Rate Limited	Demasiadas solicitudes	Exceso de requests a Microsoft Graph API	Implementar retry con exponential backoff
`500`	💥 Internal Server Error	Error inesperado en el servidor	Fallo en Membership DB, error en desencriptación	Contactar soporte técnico con correlation ID
`502`	🔗 Bad Gateway	Error en servicio backend	Membership DB no disponible, Portal Clientes caído	Verificar conectividad con servicios backend
`503`	🛠️ Service Unavailable	Servicio temporalmente no disponible	Microsoft Graph API en mantenimiento	Reintentar más tarde, verificar status de Azure
`504`	⏱️ Gateway Timeout	Timeout en servicio backend	Membership DB lento, timeout en SOAP service	Aumentar timeouts, verificar rendimiento de DB

📞 Soporte

Para asistencia, contacta al equipo de Coordinación de Servicios de Integración y Aplicaciones.

Correo electrónico: epalma@fgs.co

📅 Información Adicional

Documentación creada en Noviembre 2025 por epalma@fgs.co - Edna Nayibe Palma

📋 Nota Importante: Esta documentación se actualiza continuamente. Para la versión más reciente y cambios en tiempo real, consulta siempre el Portal de Exchange oficial.

🔒 Aviso de Seguridad: Nunca compartas credenciales de Azure B2C, secrets de OAuth, o keys de desencriptación en repositorios públicos o documentación. Usa siempre secure properties encriptadas con MuleSoft Secure Configuration Properties y rota secrets regularmente.

⚙️ Nota de Configuración: El scheduler ejecuta cada minuto por defecto (0 0/01 * * * ?). Ajusta el batch size (totalRegistros) según la capacidad del servidor y la carga de Microsoft Graph API para evitar throttling.

home