O arquivo personalizado permite que você faça o upload do seu próprio perfil de configuração para aplicar configurações que nenhum controle de TI incorporado Factorial cobre. Ele aceita o formato nativo de cada plataforma no macOS, iOS/iPadOS, Windows e Android. No Windows, você pode produzir o arquivo SyncML a partir do catálogo Policy CSP com o CSP Builder.

Recurso/Funcionalidade

Visão Geral

Cada plataforma usa seu próprio formato de arquivo:

Como usar

1. Vá para MDM > Controles > Adicionar novo controle e escolha Arquivo personalizado.
2. Adicione sua configuração. Faça o upload do seu arquivo de configuração: ele chega aos dispositivos através do MDM, como qualquer outro controle.
   • No macOS e iOS/iPadOS, você pode colar o perfil em vez de fazer o upload de um arquivo. Escolha Colar conteúdo e cole o XML de um perfil de configuração ou o JSON de uma declaração DDM em Conteúdo do perfil. Quando o conteúdo for válido, o console mostrará seu tipo e o nome do arquivo que será salvo: o PayloadIdentifier do perfil mais .mobileconfig, ou o Identifier da declaração mais .json. Perfis assinados não podem ser colados: faça o upload do arquivo .mobileconfig em vez disso.
   • No Windows, você pode construir o arquivo com o CSP Builder em vez de escrevê-lo você mesmo. Veja Windows abaixo.
   Factorial IT não verifica as configurações dentro de um arquivo personalizado. No Windows, ele apenas verifica se os elementos de nível superior são <Replace>, <Add> ou <Exec>. Certifique-se de que a configuração está correta antes de implantá-la: um perfil quebrado ou conflitante pode fazer com que os dispositivos se comportem de maneiras inesperadas.
3. Dê ao controle um nome claro, para que você possa encontrá-lo depois.
4. Escolha onde o controle se aplica: todos os dispositivos, grupos de dispositivos específicos ou um alvo personalizado.

macOS

Os perfis do macOS (.mobileconfig) são arquivos XML, assinados ou não assinados, enviados como cargas do MDM. Algumas cargas de configuração também podem ser enviadas como .json.

Ferramentas recomendadas para criar perfis:

• iMazing Profile Editor: gratuito, feito para criar e editar arquivos .mobileconfig.
• Apple Configurator: disponível na Mac App Store.

Usos típicos incluem cargas de certificado personalizadas, perfis de VPN e configurações de VPN por aplicativo.

iOS / iPadOS

iPhone e iPad usam o mesmo formato .mobileconfig que o macOS.

Windows

Os arquivos do Windows usam SyncML, que mapeia para os CSPs do MDM do Windows (Provedores de Serviços de Configuração, as configurações que o Windows expõe ao MDM). Você pode definir qualquer política do MDM do Windows que os controles de TI incorporados Factorial não cobrem.

Inicie e termine o XML com <Replace> ou <Add>. Deixe de fora as linhas de cabeçalho e rodapé do SyncML.

Construa o arquivo com o CSP Builder

A maneira recomendada de criar o arquivo é o CSP Builder, uma ferramenta gratuita. Ele produz o SyncML a partir do catálogo Policy CSP da Microsoft, portanto, não há XML para escrever à mão.

1. Clique em Criar no CSP Builder. O botão fica abaixo da área de upload do controle Arquivo personalizado do Windows, até que um arquivo tenha sido adicionado. O CSP Builder abre em uma nova aba.
2. Escolha as configurações que você precisa e defina seus valores. Quando uma configuração tem um Estado, escolha Ativado ou Desativado. Não Configurado exporta um comando <Delete>, e o controle é rejeitado quando você o salva.
3. Deixe o formato de exportação em Compatível com a frota. É o padrão na seção Exportar e o único formato aceito. Os outros formatos envolvem os comandos em <SyncML> ou <SyncBody>, que também são rejeitados quando você salva o controle.
4. Clique em Carregar em Factorial IT. Uma nova aba se abre em um controle Arquivo personalizado do Windows com o arquivo já adicionado. Termine a configuração lá: nomeie o controle, escolha o direcionamento e clique em Salvar.

O CSP Builder também pode carregar templates ADMX. Com o formato padrão, políticas de um template carregado só se aplicam após o template ter sido ingerido no dispositivo, e o arquivo não inclui essa etapa de ingestão. Entre em contato com nossa equipe em support@factorial.it antes de implantar configurações de um template ADMX.

Exemplo: definir as imagens da área de trabalho e da tela de bloqueio

Passo 1. Permita o CSP Personalization no Windows Pro:

<Replace>
  <!-- Permite que os CSPs de Personalização sejam implantados em versões não-Enterprise do Windows.
  Definir este valor como true dispara a ação para configurar um dispositivo como ambiente educacional.
      Testes exaustivos são cruciais para garantir que não interfira nos fluxos de trabalho ou crie problemas de compatibilidade. -->
  <Item>
    <Meta>
      <Formato xmlns="syncml:metinf">bool</Formato>
    </Meta>
    <Target>
      <LocURI>./Vendor/MSFT/SharedPC/SetEduPolicies</LocURI>
    </Target>
    <Data>true</Data>
  </Item>
</Replace>

Passo 2. Defina as imagens da área de trabalho e da tela de bloqueio. O CSP Personalization funciona no Windows Enterprise e Education. No Windows Pro, ele só funciona uma vez que SetEduPolicies no CSP SharedPC é definido, como no passo 1.

<Replace>
  <CmdID>1</CmdID>
  <Item>
    <Target>
      <LocURI>
        ./Vendor/MSFT/Personalization/LockScreenImageUrl
      </LocURI>
    </Target>
    <Meta>
      <Formato xmlns="syncml:metinf">chr</Formato>
      <Tipo>text/plain</Tipo>
    </Meta>
    <Data> … sua URL aqui … </Data>
  </Item>
</Replace>
<Replace>
  <CmdID>2</CmdID>
  <Item>
    <Target>
      <LocURI>
        ./Vendor/MSFT/Personalization/DesktopImageUrl
      </LocURI>
    </Target>
    <Meta>
      <Formato xmlns="syncml:metinf">chr</Formato>
      <Tipo>text/plain</Tipo>
    </Meta>
    <Data> … sua URL aqui … </Data>
  </Item>
</Replace>

SharedPC/SetEduPolicies coloca o dispositivo em uma configuração educacional. Teste em alguns dispositivos antes de implantar amplamente.

Android

Os arquivos do Android usam JSON para enviar configurações gerenciadas para dispositivos Android Enterprise. Eles são usados principalmente para configurar aplicativos de trabalho que suportam configuração de aplicativo gerenciada.

Mudar ou desativar o controle

Abra o controle em MDM > Controles para editá-lo ou desativá-lo. Para mudar a configuração, faça o upload do arquivo novamente com as novas configurações ou, no macOS e iOS/iPadOS, cole o conteúdo atualizado. Colar conteúdo sempre abre vazio, então cole o perfil completo. Desativar interrompe a aplicação. Não remove as configurações já aplicadas nos dispositivos.

Resolução de Problemas e FAQ

Resolução de Problemas

• O upload do arquivo falha.
  • Verifique se o arquivo usa o formato correto para o sistema operacional escolhido.
  • Verifique se o arquivo não está corrompido ou vazio.
  • Os perfis do macOS devem ser XML válidos. Verifique o arquivo com plutil -lint profile.mobileconfig.
• O console rejeita o conteúdo colado.
  • Se o XML não for válido, verifique se você copiou todo o perfil, até </plist>. Sempre que possível, a mensagem fornece a linha com o erro.
  • O XML deve ser um perfil da Apple: sua raiz é <plist>, com um <dict> dentro.
  • Para uma declaração DDM, verifique se você copiou todo o JSON.
  • Se o conteúdo vier de um perfil assinado, faça o upload do arquivo .mobileconfig em vez disso. Factorial IT extrai o XML dele.
• Um arquivo do Windows é rejeitado ao salvar o controle. Os elementos de nível superior devem ser <Replace>, <Add> ou <Exec>. Um comando <Delete> (de uma configuração deixada como Não Configurado no CSP Builder) ou um wrapper <SyncML> ou <SyncBody> é recusado.
• Os dispositivos se comportam de maneira inesperada após a implantação de um arquivo personalizado. O perfil pode ser inválido ou conflitar com outro. Factorial IT não valida o conteúdo, então revise o arquivo.
• A imagem da área de trabalho ou da tela de bloqueio não muda no Windows Pro. O CSP Personalization só funciona no Pro uma vez que SetEduPolicies é definido. Implante essa configuração primeiro.

FAQ

1. Funciona no Linux?
   Não. Suporta macOS, iOS/iPadOS, Windows e Android.
    
2. A Factorial IT verifica meu arquivo?
   Não as configurações em si. No Windows, ele apenas verifica os elementos de nível superior. Você é responsável por garantir que a configuração esteja correta.
    
3. Como atualizo a configuração?
   Abra o controle em MDM > Controles e faça o upload do arquivo novamente com as novas configurações. No macOS e iOS/iPadOS, você pode colar o conteúdo completo atualizado em vez disso.
    
4. Posso colar um perfil em vez de fazer o upload de um arquivo?
   Sim, no macOS e iOS/iPadOS, a menos que o perfil esteja assinado. Perfis assinados devem ser carregados como um arquivo .mobileconfig.
    
5. Preciso escrever o XML do Windows à mão?
   Não. O CSP Builder o gera a partir do catálogo Policy CSP da Microsoft.
    
6. Devo incluir o cabeçalho do SyncML em arquivos do Windows?
   Não. Inicie e termine o XML com <Replace> ou <Add>.