Importante
Servicios de terceros y notificaciones push obsoletos
Los servicios de terceros y las notificaciones push en App Services han quedado obsoletos en favor de la creación de puntos finales HTTP que usan dependencias externas en funciones.
Los webhooks se han renombrado como puntos finales HTTPS sin cambios en su comportamiento. Debe migrar los webhooks existentes.
Los servicios existentes continuarán funcionando hasta el de septiembre 30 2025de.
Dado que los servicios de terceros y las notificaciones push ya no se utilizan, se han eliminado de forma predeterminada de la interfaz de usuario de App Services. Si necesita administrar un servicio de terceros o una notificación push existente, puede volver a agregar las configuraciones a la interfaz de usuario siguiendo estos pasos:
En la navegación izquierda, debajo del Manage sección, haga clic en App Settings.
Habilite el interruptor junto a Temporarily Re-Enable 3rd Party Services y luego guarde los cambios.
Introducción
Las aplicaciones modernas suelen utilizar múltiples servicios externos para gestionar casos de uso complejos, como mensajería, análisis y gestión de datos. Puede conectarse a estos servicios a través de Atlas App Services mediante la creación y configuración de interfaces de servicio.
Las interfaces de servicio especifican los detalles de conexión para un servicio externo específico y le permiten definir el alcance de las capacidades de ese servicio con configuraciones personalizadas. Reglas de servicio. Una vez configurada una interfaz para un servicio, puede instanciar un cliente de servicio que se conecte a la interfaz y exponga las acciones del servicio como métodos. También puede crear webhooks entrantes que permitan que los servicios externos se comuniquen directamente con su aplicación mediante HTTP.
Nota
Clientes de servicios integrados
App Services incluye clientes para ciertos servicios externos, como Twilio y AWS. También puedes usar el servicio HTTP para crear una interfaz personalizada para cualquier servicio externo que ofrezca una API REST.
Conceptos
Clientes de servicio
Un cliente de servicio es un objeto que se conecta a una interfaz de servicio y permite ejecutar acciones asociadas a este. Se pueden instanciar clientes de servicio en funciones (mediante el contexto de función), así como en el código de la aplicación cliente.
Para obtener detalles sobre cómo crear instancias y utilizar clientes de servicio,consulte Llamar a una acción de servicio.
Acciones de servicio
Una acción de servicio es un método que gestiona un caso de uso específico para un servicio en particular, como enviar un mensaje de texto con Twilio o colocar un objeto en un bucket de AWS S.3 Las acciones encapsulan detalles de implementación, como la autenticación de solicitudes y los métodos HTTP, tras métodos semánticos específicos de cada servicio.
Cuando se llama a una acción de servicio, App Services evalúa cada regla de servicio que se aplica a la acción y evita la ejecución a menos que una de las reglas se evalúe como true.
Importante
App Services bloquea todas las acciones de servicio de forma predeterminada. Debe configurar una regla de servicio que habilite una acción específica antes de poder ejecutarla.
Reglas de servicio
Una regla de servicio es una expresión que App Services evalúa para determinar si un usuario puede o no ejecutar una o más acciones en un servicio.
Por ejemplo, puede crear una regla de Twilio que solo permita a los usuarios enviar un mensaje de texto desde un número de teléfono específico o una regla de AWS que impida que los usuarios coloquen objetos en un3 depósito S que no esté incluido en una lista de depósitos aprobados.
Nota
Variables de expresión
Las variables de expresión son variables que se pueden incluir en las reglas de servicio para representar información dinámica sobre la aplicación y la ejecución de una acción. Se pueden configurar reglas de servicio según el usuario autenticado que%%user realizó la acción () y los argumentos que proporcionó (). También se%%args pueden crear reglas complejas que invoquen una función %function() y evalúen su valor de retorno.
Webhooks entrantes
Un webhook entrante es un controlador personalizado para eventos que se originan en un servicio externo, como cuando alguien abre una solicitud de extracción en GitHub o envía un mensaje de texto a un número de teléfono de Twilio. Empieza a usar los webhooks entrantes configurando un webhook de servicio.
Los webhooks entrantes constan de dos componentes principales: la URL del webhook y la función del webhook.
Componente | Descripción |
|---|---|
Webhook URL | Una URL que identifica de forma única el webhook entrante. Los servicios externos pueden interactuar con el webhook enviando una solicitud HTTP que coincida con la configuración del webhook y su URL. Para utilizar un webhook, proporcione la URL del webhook al controlador de solicitud HTTP de un servicio externo, que también puede denominarse webhook saliente, URL de devolución de llamada o similar. NotaSi un webhook entrante requiere un parámetro de consulta secreto, asegúrese de agregar el parámetro de consulta a la URL del webhook antes de proporcionárselo al servicio externo. |
Webhook Function | Una función webhook es una función Atlas que acepta una solicitud HTTP entrante con datos del servicio externo como argumento y, opcionalmente, devuelve una respuesta HTTP. |
Guías
Guide | Descripción |
|---|---|
Aprenda a crear una nueva interfaz de servicio externo. | |
Aprenda a configurar y ejecutar un webhook entrante para manejar eventos en servicios externos. | |
Aprenda a exponer de forma segura una acción de servicio para su uso en una función o aplicación cliente. | |
Aprenda a llamar a una acción de servicio desde una función o aplicación cliente. |
Servicios incorporados
Sujeto | Descripción |
|---|---|
Incluye parámetros de configuración del servicio, instrucciones para agregar un webhook a Twilio e información adicional sobre las acciones del servicio Twilio. | |
Incluye información adicional sobre acciones de servicio HTTP y webhooks. | |
Incluye parámetros de configuración del servicio, información adicional sobre acciones específicas del servicio de AWS e instrucciones genéricas para conectarse a cualquier servicio de AWS. | |
Incluye parámetros de configuración del servicio, instrucciones para agregar un webhook a GitHub y orientación sobre cómo validar solicitudes entrantes de GitHub. |
Documentación de referencia
Sujeto | Descripción |
|---|---|
Describe cómo verificar solicitudes entrantes, analizar una carga útil de solicitud y enviar una respuesta en funciones de webhook de servicio. |