Validar instalación de aplicación del cliente

Se aplica a: ISV (fabricante de software independiente)

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

Objetivos de validación

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

1. Confirme que la aplicación y el tipo de contenedor están registrados en el inquilino del cliente.
2. Confirme que se conceden los permisos esperados.
3. Confirma que la facturación es válida para las aplicaciones de transferencia.
4. Confirma que la aplicación puede crear un contenedor o acceder a él.
5. Confirme que el administrador de clientes puede ver la aplicación y el contenedor.
6. Confirme que las operaciones de contenido funcionan para un usuario de prueba.
7. Confirme que se han descartado los modos de error comunes.

Para conocer los pasos de configuración del cliente, consulte Guiar a los clientes a través de la configuración de inquilinos.

People involved

Por lo general, la validación necesita roles de ISV y cliente.

Antes de empezar

Recopile estos valores:

• Nombre o id. del inquilino del cliente.
• Id. de aplicación propietario.
• Id. de aplicación para aplicaciones invitadas, si su aplicación las usa.
• Id. 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.

Paso 1: Confirmar el registro del tipo de contenedor

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

Pida al administrador del cliente que abra el Centro de administración de SharePoint, vaya a Aplicacionesinstaladas deaplicaciones> activas de SharePoint Embedded> y compruebe que la aplicación de SharePoint Embedded aparece en la lista. El administrador del cliente puede comprobar los detalles de la aplicación SharePoint Embedded, como:

• El id. de la aplicación propietaria.
• El identificador de tipo de contenedor.

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

Paso 2: Comprobar los permisos

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

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

Confirme que el cliente ha concedido los permisos esperados y que no se ha usado ningún identificador de aplicación inesperado.

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

Valide los siguientes elementos:

• Un administrador de clientes autorizado concedió el consentimiento del Administrador para los permisos de aplicación cuando fue necesario.
• El id. de la aplicación consentido coincide con el paquete de instalación del ISV.
• El conjunto de permisos incluye los permisos de registro y contenido esperados para el modelo de aplicación.
• Los permisos de aplicación invitada están presentes cuando es necesario.
• El comportamiento delegado y de solo aplicación coincide con el diseño.
• Los usuarios de prueba están presentes en Microsoft Entra ID como miembros o invitados.

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

Paso 3: Comprobar el estado de facturación

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

Facturación Standard

Para la facturación estándar, confirma internamente que la relación de facturación del espacio empresarial de desarrollador está activa. El cliente no necesita configurar un perfil de facturación de SharePoint Embedded para la aplicación. Aún así, indique al cliente cómo se administra el consumo de SharePoint Embedded para su aplicación.

Verificar:

• La aplicación está documentada como facturación estándar.
• Su equipo de operaciones puede supervisar el consumo.
• La entrega del cliente no le pide que configure la facturación transferida.

Facturación transferida

En el caso de la facturación transferida, ningún usuario puede acceder a la aplicación hasta que el cliente configure una facturación válida. Pida al administrador del cliente que confirme la facturación en el Centro de administración de Microsoft 365.

Verificar:

• Hay una suscripción válida de Azure conectada.
• Se ha seleccionado un grupo de recursos válido.
• Se completó la configuración para las aplicaciones de SharePoint Embedded.
• El administrador de clientes que configura la facturación tiene el rol de propietario o colaborador en la suscripción de Azure cuando sea necesario.
• El cliente comprende que deshabilitar la facturación interrumpe el acceso del usuario.

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

Paso 4: Crear o abrir 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 notifica los errores de una manera que el cliente y el soporte técnico de ISV puedan solucionar.

Paso 5: Comprobar la administración del contenedor

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

• Obtenga detalles de los contenedores para la aplicación SharePoint Embedded.
• Ver los detalles de un contenedor específico.
• Vea los 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 sea necesario.

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

Paso 6: Comprobar las expectativas de uso compartido y cumplimiento

SharePoint Embedded usa las capacidades de seguridad y cumplimiento de Microsoft 365. Pide al administrador de clientes que valide la configuración que es importante para la aplicación:

• Comportamiento de uso compartido externo.
• Acceso de usuarios invitados.
• Expectativas de etiquetas de confidencialidad.
• Expectativas de retención o eliminación.
• Requisitos de auditoría o revisión de cumplimiento.
• Excepciones a la directiva del 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, documenta el impacto en el producto antes de que los usuarios empiecen a usar la aplicación.

Modos de error comunes

Use esta tabla durante la incorporación.

Lista de comprobación de validación

Utilice esta lista de comprobación como la aprobación final del cliente.

• [ ] El administrador de clientes concedió el consentimiento de administrador para la aplicación.
• [ ] El registro del tipo de contenedor se ha completado.
• [ ] El administrador del cliente ve su 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.
• [ ] Las operaciones de archivos de prueba funcionan.
• El administrador de clientes puede ver la aplicación o el contenedor en las herramientas de administración.
• [ ] Las expectativas de uso compartido y cumplimiento están documentadas.
• [ ] El contenido de prueba se elimina o conserva por acuerdo.
• [ ] La transferencia de soporte técnico está completa.

Tras validación

Después de que la validación se realice correctamente:

1. Registre la fecha, el inquilino, el id. de aplicación y el id. de tipo de contenedor.
2. Guarde el modelo de facturación y el resultado de la configuración del cliente.
3. Comparta el registro de validación con el cliente.
4. Mueve la aplicación al siguiente paso de lanzamiento o lanzamiento.

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

Pasos siguientes

• Información general de administración
• Instalar una aplicación de SharePoint Embedded
• Solución de problemas