Configurar termos de serviço e declaração de privacidade para um aplicativo

Artigo
12/15/2023

Os desenvolvedores que criam e gerenciam aplicativos multilocatários que se integram ao Microsoft Entra ID e às contas da Microsoft devem incluir links para os termos de serviço e a declaração de privacidade do aplicativo. Os termos de serviço e a declaração de privacidade são apresentados aos usuários através da experiência de consentimento do usuário. Eles ajudam seus usuários a saber que podem confiar em seu aplicativo. Os termos de serviço e a declaração de privacidade são especialmente críticos para aplicativos multilocatários voltados para o usuário - aplicativos que são usados por vários diretórios ou estão disponíveis para qualquer conta da Microsoft.

Você é responsável por criar os termos de serviço e documentos de declaração de privacidade para seu aplicativo e por fornecer as URLs para esses documentos. Para aplicativos multilocatários que não fornecem esses links, a experiência de consentimento do usuário para seu aplicativo mostrará um alerta, o que pode desencorajar os usuários de consentir com seu aplicativo.

Nota

Os termos de serviço e os links da declaração de privacidade não são aplicáveis a aplicativos de locatário único
Se um ou ambos os links estiverem faltando, seu aplicativo exibirá um alerta.

O exemplo a seguir mostra a experiência de consentimento do usuário para um aplicativo multilocatário quando os termos de serviço e a declaração de privacidade são configurados e quando esses links não estão configurados.

Screenshots with and without a privacy statement and terms of service provided

Formatação de links para os termos de serviço e documentos da declaração de privacidade

Antes de adicionar links aos termos de serviço e documentos da declaração de privacidade do seu aplicativo, verifique se os URLs seguem estas diretrizes.

Diretriz	Description
Format	URL válido
Esquemas válidos	HTTP e HTTPS Recomendamos HTTPS
Comprimento máximo	2048 personagens

Exemplos: https://myapp.com/terms-of-service e ainda https://myapp.com/privacy-statement

Adicionar ligações aos termos de serviço e à declaração de privacidade

Quando os termos de serviço e a declaração de privacidade estiverem prontos, você poderá adicionar links a esses documentos em seu aplicativo usando um destes métodos:

Através do centro de administração do Microsoft Entra
Usando o objeto de aplicativo JSON
Usando a API do Microsoft Graph

Utilizar o centro de administração do Microsoft Entra

Gorjeta

As etapas neste artigo podem variar ligeiramente com base no portal a partir do qual você começou.

Siga estas etapas para adicionar links:

Entre no centro de administração do Microsoft Entra como pelo menos um desenvolvedor de aplicativos.
Navegue até Identidade>Experiências>do usuário Marca da empresa.
Selecione Introdução e, em seguida, selecione Editar para a experiência de início de sessão predefinida.
Selecione Rodapé e preencha o URL dos Termos de Utilização e Privacidade & cookies.
Selecione Rever + guardar.

Usando o objeto de aplicativo JSON

Se preferir modificar o objeto JSON do aplicativo diretamente, você pode usar o editor de manifesto para incluir links para os termos de serviço e a declaração de privacidade do seu aplicativo.

Navegue até a seção Registros de aplicativos e selecione seu aplicativo.
Abra o painel Manifesto.
Ctrl+F, procure por "informationalUrls". Preencha as informações.
Salve suas alterações baixando o manifesto do aplicativo, modificando-o e carregando-o.

    "informationalUrls": { 
        "termsOfService": "<your_terms_of_service_url>", 
        "privacy": "<your_privacy_statement_url>" 
    }

Usando a API do Microsoft Graph

Para atualizar programaticamente seu aplicativo, você pode usar a API do Microsoft Graph para atualizar todos os seus aplicativos para incluir links para os termos de serviço e documentos da declaração de privacidade.

PATCH https://graph.microsoft.com/v1.0/applications/{applicationObjectId}
{ 
    "appId": "{your application object id}", 
    "info": { 
        "termsOfServiceUrl": "<your_terms_of_service_url>", 
        "supportUrl": null, 
        "privacyStatementUrl": "<your_privacy_statement_url>", 
        "marketingUrl": null, 
        "logoUrl": null 
    }
}