Políticas de configuração de aplicativo do Microsoft IntuneApp configuration policies for Microsoft Intune

As políticas de configuração de aplicativos podem ajudar a eliminar os problemas de instalação do aplicativo ao permitir que você atribua configurações a uma política atribuída aos usuários antes da execução do aplicativo.App configuration policies can help you eliminate app setup up problems by letting you assign configuration settings to a policy that is assigned to end-users before they run the app. As configurações são então fornecidas automaticamente quando o aplicativo é configurado no dispositivo dos usuários finais e os usuários finais não precisam realizar nenhuma ação.The settings are then supplied automatically when the app is configured on the end-users device, and end-users don't need to take action. As definições de configuração são exclusivas para cada aplicativo.The configuration settings are unique for each app.

Crie e use políticas de configuração de aplicativos para fornecer definições de configuração para aplicativos iOS ou Android.You can create and use app configuration policies to provide configuration settings for both iOS or Android apps. Essas definições de configuração permitem que um aplicativo seja personalizado usando o gerenciamento e a configuração de aplicativos.These configuration settings allow an app to be customized by using app configuration and management. As definições da política de configuração são usadas quando o aplicativo verifica se elas existem, normalmente, na primeira vez em que o aplicativo é executado.The configuration policy settings are used when the app checks for these settings, typically the first time the app is run.

Por exemplo, uma configuração de aplicativos pode exigir que você especifique um dos seguintes detalhes:An app configuration setting, for example, might require you to specify any of the following details:

  • Um número de porta personalizadoA custom port number
  • Configurações de idiomaLanguage settings
  • Configurações de segurançaSecurity settings
  • Configurações de identidade visual, como um logotipo da empresaBranding settings such as a company logo

Se os usuários finais inserirem essas configurações, eles poderão fazer isso incorretamente.If end-users were to enter these settings instead, they could do this incorrectly. As políticas de configuração de aplicativos podem ajudar a fornecer consistência em toda a empresa e a reduzir as chamadas de assistência técnica dos usuários finais que tentam definir as configurações por conta própria.App configuration policies can help provide consistency across an enterprise and reduce helpdesk calls from end-users trying to configure settings on their own. Com o uso das políticas de configuração de aplicativos, a adoção de novos aplicativos pode ser mais fácil e rápida.By using app configuration policies, the adoption of new apps can be easier and quicker.

Em última análise, os parâmetros de configuração disponíveis são decididos pelos desenvolvedores do aplicativo.The available configuration parameters are ultimately decided by the developers of the app. A documentação do fornecedor do aplicativo deve ser examinada para verificar se um aplicativo dá suporte à configuração e quais configurações estão disponíveis.Documentation from the application vendor should be reviewed to see if an app supports configuration and what configurations are available. Para alguns aplicativos, o Intune populará as definições de configuração disponíveis.For some applications, Intune will populate the available configuration settings.

Observação

Na Google Play Store Gerenciada, os aplicativos que dão suporte à configuração serão marcados da seguinte maneira:In the Managed Google Play Store, apps that support configuration will be marked as such:

Captura de tela de um aplicativo configurado

Você só verá aplicativos da Google Play Store Gerenciada, não da Google Play Store, ao usar Dispositivos Gerenciados como o Tipo de Registro para dispositivos Android.You will only see apps from Managed Google Play store, not the Google Play store, when using Managed Devices as the Enrollment Type for Android devices. A Google Play Store Gerenciada, que você também pode conhecer como AfW (Android for Work) e Android Enterprise, são os aplicativos no Perfil de Trabalho que contêm as versões do aplicativo que dão suporte à configuração de aplicativos.Managed Google Play Store, which you may also know as Android for Work (AfW) and Android Enterprise, are the apps in the Work Profile that contain the app versions that support app configuration.

Você pode atribuir uma política de configuração de aplicativos a um grupo de usuários finais e dispositivos usando uma combinação de atribuições de inclusão e exclusão.You can assign an app configuration policy to a group of end-users and devices by using a combination of include and exclude assignments. Depois de adicionar uma política de configuração de aplicativo, você pode definir as atribuições para política de configuração de aplicativo.Once you add an app configuration policy, you can set the assignments for the app configuration policy. Ao definir as atribuições para a política, você pode optar por incluir ou excluir os grupos de usuários finais para os quais a política se aplica.When you set the assignments for the policy, you can choose to include and exclude the groups of end-users for which the policy applies. Ao optar por incluir um ou mais grupos, você pode optar por selecionar grupos específicos para incluir ou selecionar grupos internos.When you choose to include one or more groups, you can choose to select specific groups to include or select built-in groups. Os grupos internos incluem Todos os Usuários, Todos os Dispositivos e Todos os Usuários + Todos os Dispositivos.Built-in groups include All Users, All Devices, and All Users + All Devices.

Você tem duas opções para usar as políticas de configuração de aplicativos com o Intune:You have two options to use app configuration policies with Intune:

  • Dispositivos gerenciados – o dispositivo é gerenciado pelo Intune como o provedor de MDM (gerenciamento de dispositivo móvel).Managed devices - The device is managed by Intune as the mobile device management (MDM) provider. O aplicativo precisa ser projetado para dar suporte à configuração de aplicativos.The app must be designed to support the app configuration.

  • Aplicativos gerenciados – um aplicativo desenvolvido para integrar o SDK de Aplicativo do Intune.Managed apps - An app that has been developed to integrate the Intune App SDK. Isso é conhecido como gerenciamento de aplicativo móvel sem registro (MAM-WE).This is known as Mobile Application Management without enrollment (MAM-WE). Você também pode encapsular um aplicativo para implementar o SDK de Aplicativo do Intune e dar suporte a ele.You can also wrap an app to implement and support the Intune App SDK. Para obter mais informações sobre como encapsular esse aplicativo, confira Preparar aplicativos de linha de negócios para políticas de proteção de aplicativos.For more information about wrapping an app, see Prepare line-of-business apps for app protection policies.

    Observação

    Os aplicativos gerenciados do Intune farão o check-in com um intervalo de 30 minutos no status da Política de Configuração de Aplicativos do Intune, quando implantados em conjunto com uma Política de Proteção de Aplicativo do Intune.Intune managed apps will check-in with an interval of 30 minutes for Intune App Configuration Policy status, when deployed in conjunction with an Intune App Protection Policy. Se uma Política de Proteção de Aplicativo do Intune não for atribuída ao usuário, o intervalo de check-in da Política de Configuração de Aplicativos dos Intune será definido como 720 minutos.If an Intune App Protection Policy isn't assigned to the user, then the Intune App Configuration Policy check-in interval is set to 720 minutes.

Aplicativos que dão suporte à configuração de aplicativoApps that support app configuration

Dispositivos gerenciadosManaged devices

Use políticas de configuração de aplicativos para aplicativos que dão suporte a elas.You can use app configuration policies for apps that support it. Para dar suporte à configuração de aplicativos no Intune, os aplicativos precisam ser escritos tendo em vista o suporte ao uso de configurações de aplicativo, conforme definido pelo sistema operacional.To support app configuration in Intune, apps must be written to support the use of app configurations as defined by the OS. Consulte o fornecedor do aplicativo para obter mais detalhes sobre quais chaves de configuração de aplicativo são compatíveis.Consult your app vendor for details for which app config keys they support.

Aplicativos gerenciadosManaged apps

Prepare seus aplicativos de linha de negócios incorporando o SDK de Aplicativo do Intune no aplicativo ou encapsulando o aplicativo depois que ele for desenvolvido usando a Ferramenta de Encapsulamento de Aplicativo do Intune.You can prepare your line-of-business apps by either incorporating the Intune App SDK into the app, or wrapping the app after it is developed using the Intune App Wrapping Tool. O SDK de Aplicativo do Intune se esforça para minimizar a quantidade de alterações de código necessárias pelo desenvolvedor do aplicativo.The Intune App SDK strives to minimize the amount of code changes required from the app developer. Para obter mais informações, consulte a Visão geral do SDK de Aplicativo do Intune.For more information, see the Intune App SDK overview. Para obter uma comparação entre o SDK de Aplicativo do Intune e a Ferramenta de Encapsulamento de Aplicativo do Intune, confira Preparar aplicativos de linha de negócios para políticas de proteção do aplicativo.For a comparison between the Intune App SDK and the Intune App Wrapping Tool, see Prepare line-of-business apps for app protection policies.

A seleção da opção Aplicativos gerenciados como o Tipo de Registro de Dispositivo refere-se especificamente aos aplicativos configurados pelas políticas de configuração do Intune em um dispositivo que não está registrado no gerenciamento de dispositivo, enquanto a opção Dispositivos gerenciados se aplica aos aplicativos implantados por meio do canal MDM e, portanto, são gerenciados pelo Intune.Selecting Managed apps as the Device Enrollment Type specifically refers to apps configured by Intune configuration policies on a device that is not enrolled in device management, whereas Managed devices applies to apps deployed through the MDM channel and thus are managed by Intune. Selecione a opção apropriada com base nessas descrições.Select the appropriate choice based on these descriptions.

Tipo de registro do dispositivo

Observação

Para aplicativos de várias identidades, como o Microsoft Outlook, as preferências do usuário podem ser consideradas.For multi-identity apps, such as Microsoft Outlook, user preferences may be considered. A Caixa de Entrada Destaques, por exemplo, respeitará a configuração do usuário e não alterará a configuração.Focused Inbox, for example, will respect the user setting and not change the configuration. Outros parâmetros permitem controlar se um usuário pode ou não alterar a configuração.Other parameters do let you control whether a user can or cannot change the setting. Para obter mais informações, confira Como implantar as definições de configuração de aplicativos para Outlook para iOS e Android.For more information, see Deploying Outlook for iOS and Android app configuration settings.

Validar a política de configuração de aplicativos aplicadaValidate the applied app configuration policy

Valide a política de configuração de aplicativos usando os três seguintes métodos:You can validate the app configuration policy using the following three methods:

  1. Visivelmente no dispositivo.Visibly on the device. O aplicativo de destino está apresentando o comportamento aplicado na política de Configuração de Aplicativos?Is the targeted app exhibiting the behavior applied in the App Configuration policy?

  2. Por meio dos Logs de Diagnóstico (confira a seção Logs de Diagnóstico abaixo).Via Diagnostic Logs (see the Diagnostic Logs section below).

  3. No portal do Intune.In the Intune Portal. A seção Monitor de uma política pode fornecer o status relevante:The Monitor section of a policy can provide the relevant status:

    Primeira captura de tela do status de instalação do dispositivo

    Segunda captura de tela do status de instalação do dispositivo

    Além disso, em Intune -> Dispositivos -> Todos os Dispositivos, no lado esquerdo da tela, a opção Configuração de Aplicativos exibirá todas as políticas atribuídas e seu estado:Additionally, under Intune -> Devices -> All Devices on the left side of the screen, the App Configuration option will display all the assigned policies and their state:

    Captura de tela da configuração de aplicativos

Logs de diagnósticoDiagnostic Logs

Configuração do iOS em dispositivos não gerenciadosiOS configuration on unmanaged devices

Você pode validar a configuração do iOS com o Log de diagnóstico do Intune em dispositivos não gerenciados para configuração de aplicativo gerenciado.You can validate iOS configuration with the Intune Diagnostic Log on unmanaged devices for managed app configuration.

  1. Se ainda não estiver instalado no dispositivo, baixe e instale o Intune Managed Browser da App Store.If not already installed on the device, download and install the Intune Managed Browser from the App Store. Para obter mais informações, confira Aplicativos protegidos do Microsoft Intune.For more information, see Microsoft Intune protected apps.

  2. Inicie o Intune Managed Browser e selecione sobre > ajudaintune na barra de navegação.Launch the Intune Managed Browser and select about > intunehelp from the navigation bar.

  3. Clique em Introdução.Click Get Started.

  4. Clique em Compartilhar Logs.Click Share Logs.

  5. Use o aplicativo de email de sua escolha para enviar o log a você mesmo para poder visualizá-los em seu computador.Use the mail app of your choice to send the log to yourself so they can be viewed on your PC.

  6. Examine IntuneMAMDiagnostics.txt no visualizador de arquivos de texto.Review IntuneMAMDiagnostics.txt in your text file viewer.

  7. Pesquise por ApplicationConfiguration.Search for ApplicationConfiguration. Os resultados serão semelhantes a este:The results will look like the following:

        {
            (
                {
                    Name = "com.microsoft.intune.mam.managedbrowser.BlockListURLs";
                    Value = "https://www.aol.com";
                },
                {
                    Name = "com.microsoft.intune.mam.managedbrowser.bookmarks";
                    Value = "Outlook Web|https://outlook.office.com||Bing|https://www.bing.com";
                }
            );
        },
        {
            ApplicationConfiguration =             
            (
                {
                Name = IntuneMAMUPN;
                Value = "CMARScrubbedM:13c45c42712a47a1739577e5c92b5bc86c3b44fd9a27aeec3f32857f69ddef79cbb988a92f8241af6df8b3ced7d5ce06e2d23c33639ddc2ca8ad8d9947385f8a";
                },
                {
                Name = "com.microsoft.outlook.Mail.NotificationsEnabled";
                Value = false;
                }
            );
        }
    

Os detalhes de configuração do aplicativo devem corresponder às políticas de configuração de aplicativo definidas para seu locatário.Your application configuration details should match the application configuration policies configured for your tenant.

Configuração do aplicativo de destino

Configuração do iOS em dispositivos gerenciadosiOS configuration on managed devices

Você pode validar a configuração do iOS com o Log de diagnóstico do Intune em dispositivos gerenciados para configuração de aplicativo gerenciado.You can validate iOS configuration with the Intune Diagnostic Log on managed devices for managed app configuration.

  1. Se ainda não estiver instalado no dispositivo, baixe e instale o Intune Managed Browser da App Store.If not already installed on the device, download and install the Intune Managed Browser from the App Store. Para obter mais informações, confira Aplicativos protegidos do Microsoft Intune.For more information, see Microsoft Intune protected apps.
  2. Inicie o Intune Managed Browser e selecione sobre > ajudaintune na barra de navegação.Launch the Intune Managed Browser and select about > intunehelp from the navigation bar.
  3. Clique em Introdução.Click Get Started.
  4. Clique em Compartilhar Logs.Click Share Logs.
  5. Use o aplicativo de email de sua escolha para enviar o log a você mesmo para poder visualizá-los em seu computador.Use the mail app of your choice to send the log to yourself so they can be viewed on your PC.
  6. Examine IntuneMAMDiagnostics.txt no visualizador de arquivos de texto.Review IntuneMAMDiagnostics.txt in your text file viewer.
  7. Pesquise por AppConfig.Search for AppConfig. Os resultados devem corresponder às políticas de configuração de aplicativo definidas para seu locatário.Your results should match the application configuration policies configured for your tenant.

Configuração do Android em dispositivos gerenciadosAndroid configuration on managed devices

Você pode validar a configuração do iOS com o Log de diagnóstico do Intune em dispositivos gerenciados para configuração de aplicativo gerenciado.You can validate iOS configuration with the Intune Diagnostic Log on managed devices for managed app configuration.

Para coletar logs de um dispositivo Android, você ou o usuário final deve baixar os logs do dispositivo por meio de uma conexão USB (ou no File Explorer equivalente no dispositivo).To collect logs from an Android device, you or the end user must download the logs from the device via a USB connection (or the File Explorer equivalent on the device). Estas são as etapas:Here are the steps:

  1. Conecte o dispositivo Android ao computador com o cabo USB.Connect the Android device to your computer with the USB cable.

  2. No computador, procure um diretório com o nome do seu dispositivo.On the computer, look for a directory that has the name of your device. Nesse diretório, localize Android Device\Phone\Android\data\com.microsoft.windowsintune.companyportal.In that directory, find Android Device\Phone\Android\data\com.microsoft.windowsintune.companyportal.

  3. Na pasta com.microsoft.windowsintune.companyportal, abra a pasta Arquivos e abra OMADMLog_0.In the com.microsoft.windowsintune.companyportal folder, open the Files folder and open OMADMLog_0.

  4. Pesquise por AppConfigHelper para localizar as mensagens relacionadas à configuração do aplicativo.Search for AppConfigHelper to find app configuration related messages. Os resultados serão semelhantes ao seguinte bloco de dados:The results will look similar to the following block of data:

    2019-06-17T20:09:29.1970000 INFO AppConfigHelper 10888 02256 Returning app config JSON [{"ApplicationConfiguration":[{"Name":"com.microsoft.intune.mam.managedbrowser.BlockListURLs","Value":"https:\/\/www.aol.com"},{"Name":"com.microsoft.intune.mam.managedbrowser.bookmarks","Value":"Outlook Web|https:\/\/outlook.office.com||Bing|https:\/\/www.bing.com"},{"Name":"com.microsoft.intune.mam.managedbrowser.homepage","Value":"https:\/\/www.arstechnica.com"}]},{"ApplicationConfiguration":[{"Name":"IntuneMAMUPN","Value":"AdeleV@M365x935807.OnMicrosoft.com"},{"Name":"com.microsoft.outlook.Mail.NotificationsEnabled","Value":"false"},{"Name":"com.microsoft.outlook.Mail.NotificationsEnabled.UserChangeAllowed","Value":"false"}]}] for user User-875363642

Suporte de API do Graph para configuração de aplicativoGraph API support for app configuration

Use a API do Graph para realizar tarefas de configuração de aplicativos.You can use Graph API to accomplish app configuration tasks. Para saber mais, confira Configuração direcionada do MAM na referência da API do Graph.For details, see Graph API Reference MAM Targeted Config.

Solução de problemasTroubleshooting

Como usar os logs para mostrar um parâmetro de configuraçãoUsing logs to show a configuration parameter

Quando os logs mostram um parâmetro de configuração que é confirmado como estando aplicado, mas não parece funcionar, pode haver um problema com a implementação da configuração pelo desenvolvedor do aplicativo.When the logs show a configuration parameter that is confirmed to be applying but doesn't seem to work, there may be an issue with the configuration implementation by the app developer. Ao contatar o desenvolvedor do aplicativo primeiro ou verificar sua base de dados de conhecimento, talvez você não precise fazer uma chamada de suporte para a Microsoft.Reaching out to that app developer first, or checking their knowledge base, may save you a support call with Microsoft. Se esse for um problema referente ao modo de tratamento da configuração em um aplicativo, ele precisará ser resolvido em uma versão atualizada futura do aplicativo.If it is an issue with how the configuration is being handled within an app, it would have to be addressed in a future updated version of that app.

Próximas etapasNext steps

Dispositivos gerenciadosManaged devices

Aplicativos gerenciadosManaged apps