Configuración de Integraciones y Entrega
Para qué sirve esta pantalla
Integraciones y Entrega es uno de los ocho grupos de propósito de Configuración de Plataforma, y responde a qué alcanza tu instalación fuera de sí misma: el correo saliente, el almacén de licencias y el enrutamiento por el que viaja el consumo, el enriquecimiento de ubicación de los registros de inicio de sesión, y la puerta de enlace del mercado. Al abrir la tarjeta del grupo se listan cuatro subgrupos como tarjetas — Correo y Notificaciones, Licenciamiento, Geolocalización y Puerta de Enlace RapidAPI, en ese orden.
Ninguno de los cuatro administra registros propios, así que ninguno tiene pantalla propia y los cuatro se describen aquí.
Cuatro valores de este grupo se pueden escribir desde esta pantalla, y dos de esos cuatro son secretos, de modo que la superficie editable y no secreta de todo el grupo son dos valores, ambos en Correo y Notificaciones. Del resto, algunos son propiedad del despliegue, otros son observaciones de solo lectura y dos son secretos que administra otra persona.
Lo que este grupo contiene sobre todo es custodia de credenciales y datos de conexión, no ajustes. La plataforma trae sus propios valores predeterminados y ninguna credencial del cliente, así que cada conector de aquí queda inerte hasta que el despliegue entrega una.
Qué debe existir antes
Configuración de Plataforma es una pantalla de plataforma: se alcanza en el contexto de plataforma y solo se sirve al tenant de plataforma. Antes de trabajar aquí necesitas:
- El permiso de lectura de la configuración de plataforma. Es lo que muestra la entrada Configuración de Plataforma del menú lateral y lo que carga el catálogo que estas tarjetas cuentan.
- El permiso de escritura de la configuración de plataforma, para cualquier cambio de un valor. Ningún valor de aquí está clasificado como peligroso, así que el tercer permiso, el de valores peligrosos, nunca se pide en estas cuatro pantallas.
- Un permiso aparte para leer la cadena de entrega, en la pestaña Entrega de Correo y Notificaciones. Tener la lectura de la configuración de plataforma no lo incluye.
- Otros permisos aparte para cambiar la cadena de entrega, que la escritura de la configuración de plataforma no incluye ni sustituye: en Entrega, el permiso de escritura de proveedores de notificación para guardar y el permiso de prueba para un envío de prueba; en Por tenant, los permisos de escritura y de prueba de proveedores del tenant. Escritura y prueba son independientes, así que puedes tener uno sin el otro. Solo los tiene el superadministrador de plataforma.
- Un permiso de lectura de auditoría de plataforma para la pestaña Actividad. Sin él, Licenciamiento, Geolocalización y la Puerta de Enlace RapidAPI no muestran barra de pestañas, porque Configuración es entonces su única vista.
- Un despliegue alojado como SaaS para la Puerta de Enlace RapidAPI, que se retira en los demás.
Decisiones que tomas aquí
Cada tarjeta de este grupo lleva una insignia de estado en lugar de un recuento de filas, porque las cuatro son conectores. Tres de ellas — Licenciamiento, Geolocalización y la Puerta de Enlace RapidAPI — derivan esa insignia del propio catálogo: el subgrupo marca Activo cuando al menos uno de sus valores tiene un valor efectivo no vacío distinto de su predeterminado, y Sin configurar en caso contrario; un secreto almacenado cuenta como asignado.
Correo y Notificaciones es la excepción: le pide a la plataforma un veredicto de entrega, porque es el único subgrupo de aquí con una cadena de entrega real sobre la que la plataforma puede informar.
Correo y Notificaciones
Dos valores, y la única pantalla con pestañas de este grupo. La barra exterior ofrece Configuración, Por tenant y Actividad; dentro de Configuración están General y Entrega.
General contiene los dos valores del catálogo: el nombre visible que acompaña a la dirección del remitente, y el asunto que se aplica a una notificación que no trae ninguno. Cada uno se aplica al siguiente mensaje enviado, sin reiniciar nada. Cada uno rechaza un salto de línea, y ese rechazo es lo importante: un salto de línea aquí permitiría inyectar cabeceras de correo adicionales en todos los mensajes salientes.
Entrega no es una tabla de configuración y no lleva recuento. Un proveedor de correo, SMS o WhatsApp es un registro con ciclo de vida propio y no un valor, así que su servidor, su puerto, su dirección de remitente y la elección de principal y respaldo son propiedades de ese registro. Su credencial se sella por proveedor y no es una entrada del catálogo, así que nada en esta pantalla la nombra.
Por tenant aprovisiona la cadena de entrega de un tenant desde el lado de la plataforma. El tenant se elige en un selector explícito, de modo que sigue siendo aprovisionamiento a ciegas y no actuar como ese tenant. Sus controles de guardar y de prueba dependen de los permisos de proveedores del tenant indicados arriba, cada uno por su lado.
Licenciamiento
Valores en tres secciones: dónde está el almacén de licencias, cómo se le hace llegar el consumo, y sus secretos. Todos son de solo lectura. No queda ningún valor de licenciamiento editable en el catálogo, y una escritura sobre cualquiera de ellos se rechaza como método no permitido.
Las dos entradas de tema merecen una segunda mirada, porque nombran el mismo tema de eventos desde dos lados: uno es el tema al que se publica el consumo, el otro el tema del que consume el servicio de licencias. Coinciden de forma predeterminada y nada los mantiene sincronizados, así que un despliegue que cambia uno y no el otro deja de hacer llegar el consumo al servicio de licencias sin que nada se ponga en rojo. Léelos juntos, y cámbialos juntos en el entorno.
Los dos secretos los administra el operador: la contraseña del rol de la base de datos de licencias, y la clave que firma los registros de consumo de licencias de prueba para detectar manipulación. Ninguno de los dos valores se muestra nunca. Lo que la entrada te dice es si hay uno almacenado.
Geolocalización
Valores en tres secciones: el interruptor maestro y la consulta asíncrona, la API del proveedor, y su resiliencia. Exactamente uno de ellos se puede escribir aquí: el token de la API del proveedor, un secreto enmascarado. Escribir uno nuevo reemplaza por completo lo almacenado, se aplica sin reiniciar, y nunca se te devuelve.
Los demás se dividen en dos. La mayoría son propiedad del despliegue — el interruptor maestro, el tiempo de espera de finalización asíncrona, el tiempo de espera de la petición al proveedor y los valores del cortacircuitos — y cada una de esas entradas nombra el ajuste del despliegue que la fija, que es donde la cambias. La URL base del proveedor es una observación de solo lectura.
Un token equivocado o vencido no se detecta al guardarlo. A partir de ahí cada consulta falla del lado del proveedor, lo que pierde la ubicación del registro de inicio de sesión y además abre el cortacircuitos del proveedor, así que confirma un inicio de sesión enriquecido después de rotarlo. Rótalo solo con la geolocalización activada: con la función activada, un token en blanco impide que el servicio arranque.
Puerta de Enlace RapidAPI
Un valor: el secreto compartido que la puerta de enlace del mercado presenta en cada petición que reenvía. Está enmascarado, y aquí puedes reemplazarlo.
El subgrupo no se ofrece en una instalación operada por el cliente. Su tarjeta, su nodo del menú lateral, su dirección y su entrada en la paleta de comandos se retiran a la vez, y un enlace directo te deja en la pantalla inicial de este grupo en lugar de en una pantalla oculta. Es además la única clave de todo el catálogo que la plataforma rechaza por tipo de despliegue: en una instalación operada por el cliente, una escritura se rechaza como no aplicable antes de llegar a cualquier otra comprobación.
Cómo se relaciona con otras pantallas
La raíz de esta superficie explica lo que comparten todas las pantallas que cuelgan de ella: el filtro de postura, el buscador, cómo se comportan los secretos y cuándo surte efecto un valor guardado. Otras dos pantallas responden a preguntas que este grupo plantea pero no decide: a qué está conectada tu instalación, y qué concede la licencia.
Dónde leer más
Estas páginas están en inglés: