Introducción
Incorporar contenido externo a la intranet plantea dos preguntas al administrador: qué sale del inquilino y qué entra. RSS Reader se distingue de otros productos Vitextra porque su contenido sí pasa por un servidor de Vitextra: el servicio que descarga las fuentes. Este artículo detalla qué contiene la solicitud, qué puede hacer el elemento en el inquilino, dónde reside la configuración, qué conserva el navegador y cómo trata el HTML de los editores.
Resumen para administradores
| Pregunta | Respuesta |
|---|---|
| ¿Qué permisos de API solicita el paquete? | Ninguno |
| ¿Lee listas, archivos o perfiles de SharePoint? | No |
| ¿Quién descarga las fuentes? | El servicio de fuentes de Vitextra, a petición del navegador |
| ¿Qué contiene la solicitud al servicio? | Direcciones de fuentes, identificador del inquilino, identificador de objeto del usuario, dirección del sitio, producto y versión |
| ¿Se envía contenido del inquilino a Vitextra? | No |
| ¿Dónde se guarda la configuración? | En las propiedades del elemento de la página; para la aplicación personal de Teams, en el servicio de Vitextra para el inquilino |
| ¿Qué conserva el navegador? | Los últimos artículos cargados en el almacenamiento de sesión; la caché se reutiliza durante un máximo de 30 minutos |
| ¿Se ejecuta el HTML de la fuente en la página? | No: se analiza de forma inerte y solo se utilizan texto sin formato y direcciones de imágenes |
Permisos de la solución
RSS Reader es un elemento de SharePoint Framework implementado desde el catálogo de aplicaciones.
- El paquete no solicita ningún permiso de API. No aparece nada en Acceso a API del centro de administración de SharePoint y no se llama a Microsoft Graph ni a la API REST de SharePoint para obtener datos.
- Del contexto de página solo lee lo disponible para cualquier elemento: tema, idioma, dirección del sitio (para licencia y solicitud de fuentes) e identidad del usuario conectado (identificador de objeto, para las mismas solicitudes).
- No guarda contenido de las fuentes en SharePoint, OneDrive ni Microsoft Entra ID.
Permisos necesarios de los usuarios
| Tarea | Permiso necesario |
|---|---|
| Cargar el paquete en el catálogo y agregarlo a Teams | Administrador de SharePoint o propietario del catálogo |
| Agregar el elemento a una página y configurar fuentes | Permiso de edición en la página |
| Guardar la configuración predeterminada de la aplicación personal de Teams | Permiso de edición en una página con el elemento |
| Leer, cambiar de origen, filtrar y buscar | Permiso de lectura en la página |
Cómo se cargan las fuentes y qué se envía
Los navegadores limitan las solicitudes de scripts entre orígenes salvo que el editor las permita mediante encabezados CORS. RSS Reader utiliza un servicio de fuentes en vitextra.com: el navegador envía las direcciones y el servicio descarga y analiza las fuentes, devolviendo canales y artículos como datos estructurados.
Cada carga y actualización automática produce una solicitud con este contenido:
| Campo | Valor |
|---|---|
| Sources | Direcciones de las fuentes configuradas |
| TenantId | Identificador del inquilino de Microsoft 365 |
| UserId | Identificador de objeto (GUID) del usuario conectado en Microsoft Entra ID |
| SiteUrl | Dirección del sitio donde se ejecuta el elemento |
| ProductId, ProductName, ProductVersion | Identificador, nombre interno y versión del producto |
La respuesta contiene artículos -títulos, enlaces, descripciones, fechas, autores, categorías y direcciones de imágenes- y la lista de orígenes que no se pudieron descargar. El servicio no recibe ni devuelve contenido del inquilino; el usuario se identifica mediante un GUID, no por nombre ni correo.
Esto tiene tres consecuencias:
- Las direcciones de las fuentes configuradas se envían al servicio. No utilice direcciones con secretos, como tokens personales o claves de API: esas credenciales quedarían disponibles para el servicio y para cualquiera que pueda leer la página.
- No se pueden mostrar fuentes accesibles solo dentro de su red.
- El navegador no se conecta a los editores para obtener la fuente, pero sí para obtener las imágenes, que carga directamente como cualquier imagen web; el editor ve la solicitud habitual del navegador del usuario.
📝 Nota
La Política de privacidad describe el tratamiento de estas solicitudes. La solicitud indica qué fuentes tiene configuradas una página, no qué artículos abre un usuario: los enlaces llevan directamente al editor y no se notifican clics a Vitextra.
Dónde se almacena la configuración
En una página de SharePoint, la configuración -fuentes con direcciones, nombres y orden, diseño e interruptores- se guarda en las propiedades del elemento web, dentro de la página de la biblioteca Páginas del sitio. Cualquiera que pueda leer la página puede leerla; las versiones de página conservan configuraciones anteriores.
Para la aplicación personal de Teams, un administrador guarda la configuración con Guardar configuración en Aplicación personal (Microsoft Teams). El servicio de Vitextra la almacena para el inquilino y producto -los mismos campos, sin el título- porque la aplicación no tiene una página donde guardarla. La leen las aplicaciones personales de todos los usuarios del inquilino y se sobrescribe al volver a seleccionar Guardar configuración. Solo contiene ajustes y direcciones, no datos de usuario.
En una pestaña de canal de Teams, se almacena con la pestaña, de forma similar a una página.
Qué conserva el navegador
Tras una carga correcta, el elemento guarda los artículos en el almacenamiento de sesión, con el conjunto de direcciones como clave. Reutiliza una caché de hasta 30 minutos de antigüedad mientras carga artículos nuevos en segundo plano. Este plazo limita la reutilización, no implica una eliminación automática. La caché contiene artículos, no información del usuario. Pertenece a la sesión de pestaña y puede recuperarse al restaurar esa sesión en el navegador. La caché de fuentes en sí no utiliza almacenamiento local ni cookies.
El elemento no registra qué artículos abre el usuario. El navegador puede conservar el historial y utiliza su propio estado de enlaces visitados para atenuar los títulos abiertos.
Cómo se representa el contenido de las fuentes
Los artículos contienen HTML del editor: descripciones con marcado, imágenes incrustadas y, a veces, scripts o píxeles de seguimiento. RSS Reader nunca inserta ese HTML en la página:
- La descripción se analiza en un documento separado con
DOMParser: no se ejecutan scripts y solo se muestra texto sin formato. El análisis inerte no garantiza que no se soliciten recursos incrustados. - La imagen procede de los elementos multimedia de la fuente o de la descripción. Al buscar en la descripción, se omiten las imágenes cuya anchura o altura declarada es de un píxel o menos; esto no bloquea todas las imágenes de seguimiento. La imagen elegida se muestra como un elemento
<img>normal con la dirección del editor. - Los enlaces abren el artículo original en una pestaña nueva del sitio del editor, sin agregar parámetros de seguimiento.
Un artículo mal formado -elementos ausentes o marcado dañado- se muestra con los datos disponibles y no impide representar los demás.
Solicitudes a servicios de Vitextra
| Finalidad | Qué se envía | Destino |
|---|---|---|
| Servicio de fuentes | Consulte la tabla anterior | vitextra.com |
| Comprobación de licencia | Inquilino, objeto del usuario, sitio, identificador, nombre y versión del producto | vitextra.com |
| Configuración de la aplicación personal de Teams | Se lee en cada carga; Guardar configuración escribe los campos indicados arriba | vitextra.com |
| Telemetría de uso | Evento al cargar: producto y versión, identificador y dirección del sitio, objeto del usuario, idioma y si se ejecuta en Teams; detalles técnicos de errores | Azure Application Insights |
| Archivos del producto | Solicitud normal de archivos para scripts e iconos | static.vitextra.com, vitextra-storage.azureedge.net |
Para todos los productos, consulte KB10363. Dónde almacenan sus datos los productos de Vitextra: privacidad, residencia de datos y RGPD.
Requisitos de red
Permita HTTPS saliente desde la red de los usuarios y el cliente de Teams hacia vitextra.com, static.vitextra.com y vitextra-storage.azureedge.net. Bloquear el servicio impide cargar artículos nuevos; aparece un error si no hay datos anteriores disponibles. Bloquear los servidores de archivos del producto puede impedir que se cargue el elemento. Las imágenes proceden de los servidores de los editores y pueden faltar si se bloquean esas solicitudes.
Recomendaciones
- Utilice fuentes de editores de confianza para su organización, como con cualquier contenido externo: los títulos, textos e imágenes les pertenecen y cambian sin revisión suya.
- Prefiera direcciones HTTPS para fuentes e imágenes. El navegador puede convertir las solicitudes de imágenes HTTP a HTTPS o bloquearlas; utilice directamente direcciones HTTPS para que se muestren de forma fiable.
- No configure fuentes con tokens personales en la dirección: se comparte con los lectores y con el servicio.
- En equipos compartidos, borre los datos de los sitios del navegador al cerrar sesión. Cerrar la pestaña no garantiza su eliminación si el navegador puede restaurar la sesión.
