Importante
Consulte siempre la documentación oficial tanto de MongoDB Atlas como Hasura Para obtener la información más actualizada y precisa. Los pasos específicos pueden variar según los detalles de su proyecto y las tecnologías utilizadas.
Hasura permite a los desarrolladores crear e implementar rápidamente APIs GraphQL y REST en MongoDB y muchas otras fuentes de datos. Al reducir drásticamente los tiempos de desarrollo de las API, Hasura facilita un acceso rápido a los datos, reduce la fricción entre equipos y servicios, y permite a las empresas acortar el tiempo de comercialización de productos y funciones basados en datos.
Antes de comenzar
Si aún no lo ha hecho, cree una cuenta en el sitio web de Hasura cloud.hasura.io.
Migrar a Hasura
Migrar los puntos finales de la API GraphQL desde MongoDB Atlas App Services a Hasura es un proceso de varios pasos que abarca la configuración del entorno en Hasura, la configuración de las conexiones a la base de datos, la migración de esquemas y la implementación de mecanismos de autorización y autenticación. A continuación, encontrará una guía ampliada que detalla cada paso, centrándose en la autorización y el control de acceso basado en roles (RBAC) dentro de Hasura. Para más información, consulte la documentación de Hasura.
Para migrar a Hasura:
Autorizar Hasura para MongoDB
Hasura puede conectarse a una base de datos MongoDB Atlas nueva o existente y generar la API GraphQL para usted.
Vete a cloud.mongodb.com y navegue a la página de Acceso a la red en el panel de Atlas.
Haga clic en el ADD IP ADDRESS Presione el botón e 0.0.0.0/0 ingrese. Describa esta entrada como Hasura. Para obtener una dirección IP única, contacte con el departamento de ventas de Hasura para la implementación en DDN privado.
Ahora, Hasura Cloud puede comunicarse con su instancia de MongoDB Atlas.
En la página Base de datos, busque el clúster Atlas conectado a su aplicación de App Services y haga clic en Connect. Seleccione la opción Controladores y copie la cadena de conexión.
Crea un nuevo proyecto y conéctate a Hasura
Los documentos de Hasura contienen los detalles para realizar los siguientes pasos:
Instalar CLI (Requisitos previos)
Iniciar sesión mediante la CLI
Inicializar un nuevo supergrafo en un directorio vacío
Conectarse a los datos
Introspeccione su fuente de datos
Construye tu supergrafo local
Comienza tu supergrafo
Crea un proyecto en la nube de Hasura
Construye e implementa tu supergrafo
Pruebe sus GraphQL queries
Puede utilizar la página del Explorador de API en la Consola Hasura para probar algunas consultas GraphQL.
Hasura también utiliza la interfaz GraphiQL, que es similar a cómo se prueban las consultas en Atlas App Services.
Autorización y autenticación
Hasura no gestiona la autenticación directamente. En su lugar, se basa en variables de sesión proporcionadas por un servicio de autenticación externo. Estas variables de sesión incluyen información de usuario, rol y organización, crucial para determinar los derechos de acceso a los datos. Para obtener más información, consulte la documentación de autenticación de Hasura.
Los permisos de acceso a datos, incluidos los roles y las expresiones de reglas, se pueden convertir en reglas de permisos basadas en roles de Hasura.
Todos los métodos de autenticación que ofrece Atlas son compatibles con los métodos de autenticación webhook y JWT de Hasura. Si utiliza autenticación por correo electrónico/contraseña, anónima o con clave API, utilice el webhook de Hasura. Si utiliza un JWT personalizado, intégrelo directamente con el método de autenticación JWT de Hasura.
Hasura recomienda usar un IdP externo para gestionar los procesos de autenticación y así mejorar la seguridad y la flexibilidad. Puede integrar Hasura con cualquier proveedor de autenticación de su elección, como Auth0, Firebase Auth, AWS Cognito o incluso una solución personalizada, para verificar al usuario y configurar las variables de sesión necesarias. Para configurar la autenticación mediante JWT o webhook en Hasura, consulte la documentación en:
Configurar solucionadores personalizados o lógica empresarial
Si sus puntos finales de API GraphQL existentes incluyen resolvers personalizados o lógica de negocio, deberá implementarlos en Hasura. Hasura admite:
Esquemas remotos a través de su conector GraphQL
Consultas personalizadas a través de consultas nativas para MongoDB
Mutaciones personalizadas mediante mutaciones nativas para MongoDB
Actualizar aplicaciones cliente
Actualice todas las aplicaciones cliente que interactúan con los puntos finales de su API GraphQL para que apunten a las nuevas URL de puntos finales de Hasura. Cualquier cliente Apollo existente funcionará con Hasura. Refactorice las consultas y mutaciones GraphQL de su aplicación para que se ajusten a la sintaxis y el esquema de Hasura, garantizando así la compatibilidad con la nueva estructura de la API GraphQL.
Desactivar los puntos finales de los servicios de aplicaciones de MongoDB Atlas
Una vez que haya verificado que sus puntos de conexión de la API GraphQL están completamente migrados y operativos en Hasura, puede eliminar su aplicación MongoDB Atlas App Services para evitar costos innecesarios. Le recordamos que los puntos de conexión Atlas GraphQL dejarán de ser compatibles a partir del 30 de septiembre del 2025.