Validación de la instalación de la aplicación de cliente

Se aplica a: ISV/desarrollador

Use este artículo después de que un cliente instale una aplicación de SharePoint Embedded. La validación confirma que el registro del tipo de contenedor, el consentimiento, la facturación, la visibilidad de la administración y las operaciones básicas de contenedor están funcionando. Ejecute estas comprobaciones con el administrador del cliente antes de anunciar la aplicación a los usuarios.

Importante

Valide en el inquilino del cliente que ejecutará la carga de trabajo de producción. Una prueba correcta en el inquilino para desarrolladores no demuestra que el inquilino del cliente está registrado, consentido o facturado correctamente.

Objetivos de validación

Complete estos objetivos antes de cerrar la incorporación de clientes:

Confirme que la aplicación y el tipo de contenedor están registrados en el inquilino del cliente.
Confirme que se conceden los permisos esperados.
Confirme que la facturación es válida para las aplicaciones de paso a través.
Confirme que la aplicación puede crear o acceder a un contenedor.
Confirme que el administrador del cliente puede ver la aplicación y el contenedor.
Confirme que las operaciones de contenido funcionan para un usuario de prueba.
Confirme que se han descartado los modos de error comunes.

Para ver los pasos de configuración del cliente, consulte Guía de los clientes a través de la configuración del inquilino.

People implicados

La validación normalmente necesita roles de ISV y cliente.

Función	Responsabilidad
Desarrollador de ISV	Proporciona los identificadores de aplicación esperados, el identificador de tipo de contenedor, el comportamiento de la aplicación y la solución de problemas de soporte técnico.
Administrador global del cliente o administrador de SharePoint Embedded	Confirma la configuración, la facturación y la visibilidad de la administración de aplicaciones de SharePoint Embedded.
Cliente Azure propietario o colaborador de facturación	Ayuda a resolver problemas de configuración de facturación de paso a través.
Usuario de prueba del cliente	Inicia sesión y realiza acciones de documento de nivel de aplicación.

Antes de empezar

Recopile estos valores:

Nombre o identificador del inquilino del cliente.
Identificador de aplicación propietario.
Id. de aplicación para las aplicaciones invitadas, si la aplicación las usa.
Identificador de tipo de contenedor.
Nombre del tipo de contenedor.
Modelo de facturación.
Comportamiento de uso compartido esperado.
Incidencia de soporte técnico o registro de incorporación.

Sugerencia

Mantenga el registro de validación con el paquete de instalación del cliente. Ayuda a los futuros equipos de soporte técnico a distinguir los problemas de configuración de las regresiones del producto.

Paso 1: Confirmar el registro del tipo de contenedor

Confirme que el tipo de contenedor está registrado en el inquilino de consumo. Una aplicación no puede crear ni interactuar con contenedores hasta que su tipo de contenedor se registre en ese inquilino. Use el portal de instalación del producto o el flujo de registro para mostrar el estado de registro.

Pida al administrador del cliente que use el Centro de administración de SharePoint para comprobar que la aplicación de SharePoint Embedded aparece en la pestaña Aplicaciones instaladas en la página Aplicaciones activas en SharePoint Embedded. El administrador del cliente puede comprobar los detalles de la aplicación de SharePoint Embedded, como:

Identificador de la aplicación propietaria.
Identificador de tipo de contenedor.

Si no se ha completado el registro, vuelva a Guía a los clientes a través de la configuración del inquilino.

Paso 2: Comprobar permisos

Para comprobar que la aplicación está instalada correctamente en el inquilino del cliente:

Con la aplicación propietaria, solicite un token de acceso para el ámbito de Microsoft Graph .default en el inquilino de consumo.
Compruebe que el token de acceso incluye FileStorageContainer.Selected y en la scp notificación (para el acceso en nombre de un usuario) o roles la notificación (para el acceso FileStorageContainerTypeReg.Selected sin un usuario).
Use el token para obtener el registro del tipo de contenedor en el inquilino. Si se devuelve un registro, significa que la aplicación de SharePoint Embedded está instalada correctamente.

Sugerencia

También puede validar que las aplicaciones invitadas están configuradas correctamente solicitando un token de acceso para el ámbito de Microsoft Graph .default en el inquilino de consumo y validando que los ámbitos o roles esperados están presentes y que puede usar el token para interactuar con el contenido. Solo la aplicación propietaria puede acceder a un registro de tipo contenedor en un inquilino.

Confirme que el cliente concedió los permisos esperados y no se usó ningún identificador de aplicación inesperado.

Para la mayoría de las instalaciones de clientes, valide al menos estos permisos:

Permiso	Uso típico	Nota de validación
`FileStorageContainerTypeReg.Selected`	Registre el tipo de contenedor en el inquilino de consumo.	La aplicación puede solicitarlo como permiso delegado o de aplicación. Si se usa el registro delegado, el usuario que realiza el registro debe ser administrador de SharePoint Embedded o administrador global.
`FileStorageContainer.Selected`	Acceso a contenedores y contenido para la aplicación instalada.	El permiso de aplicación requiere el consentimiento del administrador; el permiso delegado no lo hace. Confirme que la concesión coincide con el comportamiento de la aplicación que aprobó el cliente.

Valide los siguientes elementos:

Administración consentimiento fue concedido por un administrador de cliente autorizado para los permisos de aplicación cuando sea necesario.
El identificador de aplicación consentido coincide con el paquete de instalación de ISV.
El conjunto de permisos incluye los permisos de registro y contenido esperados para el modelo de aplicación.
Los permisos de aplicación invitado están presentes cuando es necesario.
El comportamiento delegado y solo de la aplicación coincide con el diseño.
Los usuarios de prueba están presentes en Microsoft Entra ID como miembros o invitados.

Precaución

No continúe la validación si el identificador de la aplicación o el publicador no coinciden con el paquete de instalación. Detenga y resuelva primero la falta de coincidencia de consentimiento.

Si a la aplicación propietaria o a cualquier aplicación invitada le faltan permisos, vuelva a Guía a los clientes a través de la configuración del inquilino.

Paso 3: Comprobar el estado de facturación

La validación de facturación depende del modelo de facturación seleccionado.

facturación de Standard

Para la facturación estándar, confirme internamente que la relación de facturación del inquilino del desarrollador está activa. El cliente no necesita configurar un perfil de facturación de SharePoint Embedded para la aplicación. Indique al cliente cómo se controla el consumo de SharePoint Embedded para la aplicación.

Compruebe lo siguiente:

La aplicación se documenta como facturada estándar.
El equipo de operaciones puede supervisar el consumo.
La entrega del cliente no pide al cliente que configure la facturación de paso a través.

Facturación de paso a través

Para la facturación de paso a través, ningún usuario puede acceder a la aplicación hasta que el cliente configure la facturación válida. Pida al administrador del cliente que confirme la facturación en el Centro de administración de Microsoft 365.

Compruebe lo siguiente:

Se conecta una suscripción Azure válida.
Se selecciona un grupo de recursos válido.
La instalación se completó para aplicaciones de SharePoint Embedded.
El administrador de facturación del cliente tiene permisos de propietario o colaborador cuando sea necesario.
El cliente entiende que deshabilitar la facturación interrumpe el acceso del usuario.

Para obtener instrucciones sobre el modelo de facturación, consulta Elegir un modelo de facturación para la aplicación.

Paso 4: Creación o apertura de un contenedor de prueba

Use el flujo de producto normal de la aplicación para crear o abrir un contenedor de prueba en el inquilino del cliente. No use una ruta de validación oculta que omita los mismos permisos y el mismo registro de tipo de contenedor que usan los usuarios de producción.

Validar:

La aplicación puede crear un contenedor del tipo de contenedor esperado.
La aplicación puede abrir un contenedor de prueba existente.
La aplicación puede cargar un pequeño documento de prueba.
La aplicación puede leer el documento de prueba.
La aplicación puede actualizar o eliminar el documento de prueba si esas acciones forman parte del producto.
La aplicación informa de errores de una manera que el cliente y el soporte técnico de ISV pueden solucionar problemas.

Advertencia

Evite la validación destructiva en un contenedor de producción existente. Use un contenedor de pruebas claramente identificado y quite el contenido de prueba cuando se complete la validación.

Paso 5: Comprobación de la administración de contenedores

Los administradores de clientes pueden usar el Centro de administración de SharePoint para administrar su instalación de la aplicación de SharePoint Embedded y sus contenedores:

Obtenga detalles de los contenedores de la aplicación de SharePoint Embedded.
Ver los detalles de un contenedor específico.
Ver contenedores ordenados por almacenamiento.
Establezca una etiqueta de confidencialidad cuando corresponda.
Administre los contenedores eliminados cuando corresponda.
Restaure o elimine permanentemente los contenedores de prueba solo cuando esté previsto.

Para obtener instrucciones de administración de clientes, vea Administrar contenedores en el Centro de administración de SharePoint.

SharePoint Embedded usa funcionalidades de seguridad y cumplimiento de Microsoft 365. Pida al administrador del cliente que valide la configuración que importa para la aplicación:

Comportamiento de uso compartido externo.
Acceso de usuario invitado.
Expectativas de etiqueta de confidencialidad.
Expectativas de retención o eliminación.
Requisitos de revisión de auditoría o cumplimiento.
Excepciones de directiva de cliente, si las hubiera.

Si la aplicación requiere colaboración externa, confirme que las directivas de uso compartido de inquilinos del cliente permiten el comportamiento previsto. Si el uso compartido está restringido, documente el impacto del producto antes de que los usuarios empiecen a usar la aplicación.

Modos de error comunes

Use esta tabla durante la incorporación.

Modo de error	Qué comprobar	Dónde vincular
La aplicación no aparece para el administrador	Registro de tipo de contenedor e identificador de aplicación	Información general de administración
Error de consentimiento	Administración rol y permisos esperados	Concesión del consentimiento del administrador
No se puede acceder a la aplicación de paso a través	Configuración de facturación y suscripción de Azure	Guía de los clientes a través de la configuración del inquilino
Error en la creación de contenedores	Registro, permisos y facturación	Instalación de una aplicación de SharePoint Embedded
El usuario invitado no puede acceder al contenido	Directiva de identidad y uso compartido de invitados	Concesión de permisos y consentimiento de administrador
error en las herramientas de Administración	Asignación de roles y acceso a herramientas administrativas	Información general de administración
La facturación se desconectó	Se bloquea la creación de nuevos contenedores; Los contenedores existentes siguen siendo accesibles	Configuración de la facturación en Centro de administración de Microsoft 365

Lista de comprobación de validación

Use esta lista de comprobación como la firma final del cliente.

[ ] El administrador del cliente concedió el consentimiento del administrador para la aplicación.
[ ] Se ha completado el registro del tipo de contenedor.
[ ] El administrador del cliente ve la aplicación de SharePoint Embedded en el Centro de administración de SharePoint.
[ ] La facturación es válida o no es necesaria para el inquilino del cliente.
[ ] El usuario de prueba puede iniciar sesión en la aplicación.
[ ] El contenedor de prueba se puede crear o abrir.
[ ] Probar el trabajo de las operaciones de archivo.
[ ] El administrador del cliente puede ver la aplicación o el contenedor en las herramientas de administración.
[ ] Se documentan las expectativas de uso compartido y cumplimiento.
[ ] El contenido de la prueba se quita o se conserva por contrato.
[ ] La entrega de soporte técnico está completa.

Después de la validación

Una vez que la validación se realiza correctamente:

Registre la fecha, el inquilino, el identificador de la aplicación y el identificador de tipo de contenedor.
Guarde el modelo de facturación y el resultado de la configuración del cliente.
Comparta el registro de validación con el cliente.
Mueva la aplicación al siguiente paso de lanzamiento o versión.

Si se produce un error en la validación, mantenga al cliente en la fase de configuración y resuelva el error antes de un amplio acceso de usuario.

Pasos siguientes

Last updated on 2026-07-15