Validar a instalação da aplicação do cliente

Aplica-se a: ISV

Utilize este artigo depois de um cliente instalar uma aplicação Do SharePoint Embedded. A validação confirma que o registo do tipo de contentor, o consentimento, a faturação, a visibilidade da administração e as operações básicas de contentores estão a funcionar. Execute estas verificações com o administrador do cliente antes de anunciar a aplicação aos utilizadores.

Importante

Valide no inquilino do cliente que irá executar a carga de trabalho de produção. Um teste bem-sucedido no inquilino do programador não prova que o inquilino do cliente está registado, consentido ou faturado corretamente.

Objetivos de validação

Conclua estes objetivos antes de fechar a integração do cliente:

Confirme que a aplicação e o tipo de contentor estão registados no inquilino do cliente.
Confirme que as permissões esperadas são concedidas.
Confirme que a faturação é válida para aplicações pass-through.
Confirme que a aplicação pode criar ou aceder a um contentor.
Confirme que o administrador do cliente pode ver a aplicação e o contentor.
Confirme que as operações de conteúdo funcionam para um utilizador de teste.
Confirme que os modos de falha comuns foram excluídos.

Para obter os passos de configuração do cliente, veja Orientar os clientes através da configuração do inquilino.

People envolvido

Normalmente, a validação precisa de funções ISV e de cliente.

Função	Responsabilidade
Programador ISV	Fornece IDs de aplicação esperados, ID do tipo de contentor, comportamento da aplicação e resolução de problemas de suporte.
Administrador Global do Cliente ou Administrador Incorporado do SharePoint	Confirma a configuração, faturação e visibilidade da administração da aplicação SharePoint Embedded.
Proprietário ou contribuidor de faturação Azure cliente	Ajuda a resolve problemas de configuração da faturação pass-through.
Utilizador de teste do cliente	Inicia sessão e executa ações de documento ao nível da aplicação.

Antes de começar

Recolha estes valores:

Nome ou ID do inquilino do cliente.
ID da aplicação proprietária.
ID da aplicação para aplicações convidadas, se a sua aplicação as utilizar.
ID do tipo de contentor.
Nome do tipo de contentor.
Modelo de faturação.
Comportamento de partilha esperado.
Pedido de suporte ou registo de inclusão.

Dica

Mantenha o registo de validação com o pacote de instalação do cliente. Ajuda as equipas de suporte futuras a distinguir os problemas de configuração das regressões de produtos.

Passo 1: Confirmar o registo do tipo de contentor

Confirme que o tipo de contentor está registado no inquilino que está a consumir. Uma aplicação não pode criar ou interagir com contentores até que o tipo de contentor seja registado nesse inquilino. Utilize o portal de configuração do produto ou o fluxo de registo para mostrar o estado de registo.

Peça ao administrador do cliente para abrir o centro de administração do SharePoint, aceda aAplicações> do SharePoint Embedded> ActiveApps Instaladas e verifique se a aplicação SharePoint Embedded está listada. O administrador do cliente pode verificar os detalhes da sua aplicação SharePoint Embedded, tais como:

O ID da aplicação proprietária.
O ID do tipo de contentor.

Se o registo não estiver concluído, regresse a Guiar clientes através da configuração do inquilino.

Passo 2: Verificar as permissões

Para verificar se a aplicação está corretamente instalada no inquilino do cliente:

Com a aplicação proprietária, peça um token de acesso para o âmbito do Microsoft Graph .default no inquilino que está a consumir.
Verifique se o token de acesso inclui FileStorageContainer.Selected e FileStorageContainerTypeReg.Selected na scp afirmação (para acesso em nome de um utilizador) ou roles afirmação (para acesso sem um utilizador).
Utilize o token para obter o registo do tipo de contentor no inquilino. Se for devolvido um registo, significa que a aplicação SharePoint Embedded está corretamente instalada.

Dica

Também pode confirmar que as suas aplicações convidadas estão corretamente configuradas ao pedir um token de acesso para o âmbito do Microsoft Graph .default no inquilino que está a consumir e validar que os âmbitos/funções esperados estão presentes e que pode utilizar o token para interagir com o conteúdo. Apenas a aplicação proprietária pode aceder a um registo de tipo de contentor num inquilino.

Confirme que o cliente concedeu as permissões esperadas e que não foi utilizado nenhum ID de aplicação inesperado.

Para a maioria das instalações do cliente, valide, pelo menos, estas permissões:

Permissão	Utilização típica	Nota de validação
`FileStorageContainerTypeReg.Selected`	Registe o tipo de contentor no inquilino que está a consumir.	A aplicação pode pedir esta permissão como delegada ou permissão de aplicação. Se for utilizado o registo delegado, o utilizador que efetua o registo tem de ser um Administrador Incorporado do SharePoint ou Administrador Global.
`FileStorageContainer.Selected`	Aceder a contentores e conteúdos da aplicação instalada.	A permissão da aplicação requer consentimento do administrador; a permissão delegada não. Confirme se a concessão corresponde ao comportamento da aplicação que o cliente aprovou.

Valide os seguintes itens:

Administração consentimento foi concedido por um administrador de cliente autorizado para permissões de aplicação, quando necessário.
O ID da aplicação consentido corresponde ao pacote de instalação ISV.
O conjunto de permissões inclui as permissões de registo e conteúdo esperadas para o modelo de aplicação.
As permissões da aplicação convidada estão presentes quando necessário.
O comportamento delegado e apenas da aplicação corresponde à sua estrutura.
Os utilizadores de teste estão presentes no Microsoft Entra ID como membros ou convidados.

Cuidado

Não continue a validação se o ID da aplicação ou o publicador não corresponderem ao pacote de instalação. Pare e resolve primeiro o erro de correspondência de consentimento.

Se a aplicação proprietária ou qualquer aplicação convidada tiver permissões em falta, regresse a Guiar os clientes através da configuração do inquilino.

Passo 3: Verificar status de faturação

A validação da faturação depende do modelo de faturação selecionado.

Standard faturação

Para faturação padrão, confirme internamente que a relação de faturação do inquilino do programador está ativa. O cliente não precisa de configurar um perfil de faturação do SharePoint Embedded para a sua aplicação. Ainda assim, diga ao cliente como o consumo do SharePoint Embedded é processado para a sua aplicação.

Verificar:

A aplicação está documentada como faturação padrão.
A sua equipa de operações pode monitorizar o consumo.
A entrega do cliente não pede ao cliente para configurar a faturação pass-through.

Faturação pass-through

Para faturação pass-through, nenhum utilizador pode aceder à aplicação até que o cliente configure a faturação válida. Peça ao administrador do cliente para confirmar a faturação no Centro de administração do Microsoft 365.

Verificar:

Está ligada uma subscrição Azure válida.
Está selecionado um grupo de recursos válido.
A configuração foi concluída para aplicações Do SharePoint Embedded.
O administrador de faturação do cliente tem permissões de proprietário ou contribuidor, sempre que necessário.
O cliente compreende que a desativação da faturação interrompe o acesso do utilizador.

Para obter orientações sobre o modelo de faturação, veja Escolher um modelo de faturação para a sua aplicação.

Passo 4: Criar ou abrir um contentor de teste

Utilize o fluxo de produto normal da sua aplicação para criar ou abrir um contentor de teste no inquilino do cliente. Não utilize um caminho de validação oculto que ignore as mesmas permissões e o registo de tipo de contentor utilizado pelos utilizadores de produção.

Validar:

A aplicação pode criar um contentor do tipo de contentor esperado.
A aplicação pode abrir um contentor de teste existente.
A aplicação pode carregar um pequeno documento de teste.
A aplicação pode ler o documento de teste.
A aplicação pode atualizar ou eliminar o documento de teste se essas ações fizerem parte do produto.
A aplicação comunica erros de uma forma que o suporte ao cliente e ao ISV pode resolver.

Aviso

Evite a validação destrutiva num contentor de produção existente. Utilize um contentor de teste claramente identificado e remova o conteúdo de teste quando a validação estiver concluída.

Passo 5: Verificar a administração de contentores

Os administradores de clientes podem utilizar o centro de administração do SharePoint para administrar a instalação da aplicação SharePoint Embedded e dos respetivos contentores:

Obtenha detalhes dos contentores para a aplicação SharePoint Embedded.
Ver detalhes de um contentor específico.
Ver contentores ordenados por armazenamento.
Defina uma etiqueta de confidencialidade sempre que aplicável.
Gerir contentores eliminados quando aplicável.
Restaure ou elimine permanentemente os contentores de teste apenas quando pretendido.

Para obter orientações sobre a administração do cliente, veja Gerir contentores no centro de administração do SharePoint.

O SharePoint Embedded utiliza as capacidades de segurança e conformidade do Microsoft 365. Peça ao administrador do cliente para validar as definições relevantes para a aplicação:

Comportamento de partilha externa.
Acesso de utilizador convidado.
Expectativas de etiquetas de confidencialidade.
Expectativas de retenção ou eliminação.
Requisitos de auditoria ou revisão de conformidade.
Exceções da política do cliente, se existirem.

Se a aplicação precisar de colaboração externa, confirme que as políticas de partilha de inquilinos do cliente permitem o comportamento pretendido. Se a partilha for restrita, documente o impacto do produto antes de os utilizadores começarem a utilizar a aplicação.

Modos de falha comuns

Utilize esta tabela durante a integração.

Modo de falha	O que verificar	Onde ligar
A aplicação não aparece para administrador	Registo do tipo de contentor e ID da aplicação	Visão Geral do Administrador
Erro de consentimento	Administração função e permissões esperadas	Conceder consentimento do administrador
Aplicação pass-through inacessível	Configuração da faturação e subscrição Azure	Orientar os clientes através da configuração do inquilino
Falha na criação do contentor	Registo, permissões e faturação	Instalar uma aplicação Do SharePoint Embedded
O utilizador convidado não consegue aceder ao conteúdo	Identidade de convidado e política de partilha	Conceder consentimento e permissões de administrador
Administração ferramentas falham	Atribuição de funções e acesso a ferramentas administrativas	Visão Geral do Administrador
A faturação foi desligada	A criação de novo contentor está bloqueada; os contentores existentes continuam acessíveis	Configurar a faturação no Centro de administração do Microsoft 365

Lista de verificação de validação

Utilize esta lista de verificação como a final aprovação do cliente.

[ ] O administrador do cliente concedeu o consentimento do administrador para a sua aplicação.
[ ] O registo do tipo de contentor está concluído.
[ ] O administrador do cliente vê a sua aplicação SharePoint Embedded no centro de administração do SharePoint.
[ ] A faturação é válida ou não é necessária para o inquilino do cliente.
[ ] O utilizador de teste pode iniciar sessão na sua aplicação.
[ ] O contentor de teste pode ser criado ou aberto.
[ ] Teste o trabalho de operações de ficheiros.
[ ] O administrador do cliente pode ver a aplicação ou o contentor nas ferramentas de administração.
[ ] As expetativas de partilha e conformidade estão documentadas.
[ ] O conteúdo de teste é removido ou retido por contrato.
[ ] A entrega do suporte está concluída.

Após a validação

Após a validação ser concluída com êxito:

Registe a data, o inquilino, o ID da aplicação e o ID do tipo de contentor.
Guarde o modelo de faturação e o resultado da configuração do cliente.
Partilhe o registo de validação com o cliente.
Mover a aplicação para o passo de lançamento ou lançamento seguinte.

Se a validação falhar, mantenha o cliente na fase de configuração e resolve a falha antes do acesso amplo do utilizador.

Próximas etapas

Last updated on 2026-07-15