SupportCompanion
1.4.0.80845
O Support Companion é um aplicativo auxiliar do macOS, projetado para capacitar os usuários finais, fornecendo-lhes acesso rápido e fácil a informações e ações cruciais. Este aplicativo foi desenvolvido para agilizar uma variedade de tarefas, eliminando a necessidade de pesquisas extensas e navegação complexa. O Support Companion está equipado com uma variedade de recursos que aumentam a produtividade do usuário.
Ele se integra ao Munki e ao Intune para obter informações e atualizações de aplicativos, fornecendo uma plataforma unificada para gerenciar esses serviços. Os usuários podem visualizar rapidamente informações do sistema, como versão, modelo e número de série do macOS, e realizar ações como alteração de senhas, reinicialização e muito mais com apenas alguns cliques.
Esta versão inicial depende do Munki e/ou do Intune para obter informações e atualizações do aplicativo. Se você não estiver usando Munki ou Intune, este aplicativo pode não fornecer informações tão detalhadas no momento.
Se desejar adicionar outras ações e informações específicas do MDM, entre em contato. Estou aberto a adicionar mais provedores de MDM no futuro, se houver demanda. Só posso testar com o Intune, portanto, se você tiver outro provedor de MDM, agradeceria sua ajuda nos testes.
Ações : execute ações como alterar senha, encerrar o agente MDM do Intune, coletar logs, reinicializar e muito mais.
Informações do sistema : visualize rapidamente informações do sistema, como versão do macOS, modelo, número de série e última hora de inicialização.
Evergreen : veja de quais catálogos Munki os dispositivos são membros (requer um manifesto de dispositivo local com o SN como nome).
Bateria : visualize informações da bateria, como contagem de ciclos e integridade.
MDM : visualize informações do MDM, como status e data de inscrição.
Disco : visualize informações do disco, como espaço em disco e status do FileVault.
Progresso da aplicação de patches : visualize o progresso da aplicação de patches.
Atualizações pendentes : visualize atualizações pendentes para aplicativos.
Aplicativos : visualize os aplicativos instalados e suas versões.
Identidade : visualize as informações de perfil do usuário atual e informações de SSO Kerberos ou SSO de plataforma.
Informações da área de trabalho : mostra informações na área de trabalho, como nome do dispositivo, número de série, versão do macOS e endereço IP.
Widgets personalizados : adicione widgets personalizados à visualização inicial, o que permite exibir informações específicas da sua organização.
Autoatendimento : Mostra todas as ações do app configuradas no perfil MDM. Isso permite uma experiência de autoatendimento para o usuário usando a IU e não apenas o ícone da barra de menu.
O aplicativo está localizado em Swedish , Norwegian , French e German . O aplicativo será exibido no idioma preferido do usuário se estiver definido para um desses idiomas no macOS. Se o idioma preferido do usuário não for um destes, o aplicativo usará o inglês como padrão.
Contribuições para outros idiomas são bem-vindas!
Obtenha o instalador PKG mais recente das versões.
Baixe e instale o pacote MacAdmins Python aqui.
Isso é necessário para que o aplicativo execute os scripts, como a coleta de informações do MDM.
Execute o instalador do PKG.
Opcional
Instale o pacote Launch Agent anexado à versão para iniciar e manter o aplicativo em execução automaticamente.
O aplicativo é instalado na pasta /Applications/Utilities e os seguintes arquivos e pastas são instalados:
/Applications/Utilities/SupportCompanion.app - O pacote de aplicativos
/Library/Application Support/SupportCompanion - Pasta contendo os seguintes arquivos:
Scripts - Scripts usados para obter informações como status do MDM
Arquivos JSON gerados pelos scripts para leitura do aplicativo
/Library/LaunchDaemons/com.almenscorner.supportcompanion.plist - LaunchDaemon para o aplicativo executar os scripts
~/Library/Application Support/SupportCompanion/ - Pasta contendo dados do aplicativo, como carimbos de data e hora de notificação
Um script de desinstalação está incluído no pacote de aplicativos. O script pode ser encontrado no seguinte local: /Applications/Utilities/Support Companion.app/Contents/Resources/Uninstall.sh
O Launch Agent fornecido como um pacote assinado, autenticado e grampeado irá, se instalado e carregado:
Inicie o aplicativo se ele não estiver em execução
Inicie o aplicativo novamente se for encerrado pelo usuário
Inicie o aplicativo no login
Este Launch Agent é opcional e você pode criar seu próprio Launch Agent se preferir.
O pacote suíte é um pacote assinado, autenticado e grampeado que contém o aplicativo e o pacote Launch Agent. Este pacote é fornecido por conveniência e pode ser usado para instalar o aplicativo e o Launch Agent ao mesmo tempo.
Uma receita para AutoPkg está disponível aqui.
Ao configurar ícones para widgets ou ações customizadas, o nome do ícone deve ser um nome de ícone de material de https://pictogrammers.com/library/mdi/. Por exemplo, o localizador de maçã seria AppleFinder.
Quando o aplicativo for iniciado, um ícone na barra de menu aparecerá. Clicar no ícone mostrará as ações disponíveis a serem executadas, como abrir o aplicativo. Nenhum ícone de encaixe será mostrado para o aplicativo e o aplicativo deve ser acessado a partir do ícone da barra de menu. Isso mantém o aplicativo fora do caminho e não sobrecarrega o dock e torna mais fácil para os administradores iniciarem o aplicativo a partir de um terminal ou script sem mostrar o aplicativo ao usuário final. Inicializar o aplicativo dessa forma envia notificações ao usuário se ele tiver atualizações de software disponíveis, por exemplo.
Os logs podem ser visualizados executando o seguinte comando no terminal: log stream --debug --info --predicate 'subsystem contains "com.almenscorner.supportcompanion"'
Ou pesquisando o subsystem: com.almenscorner.supportcompanion no aplicativo Console.
Muitos aspectos do aplicativo podem ser configurados usando perfis MDM, as seguintes chaves estão disponíveis:
| Chave | Tipo | Padrão | Obrigatório | Descrição |
|---|---|---|---|---|
BrandName | Corda | Nenhum | Falso | Configura o nome da marca mostrado no menu |
BrandColor | Corda | Azul | Falso | Configura a cor da marca mostrada no app, as cores disponíveis são: Azul, Verde, Vermelho, Laranja |
BrandLogo | Corda | Nenhum | Falso | Configura o logotipo da marca mostrado no menu lateral dos apps. Especifique um caminho local ou string base64 |
SupportPageUrl | Corda | Nenhum | Falso | Configura a URL para abrir quando o usuário clicar no botão Obter suporte |
ChangePasswordUrl | Corda | Nenhum | Falso | Configura a URL para abrir quando o usuário clicar no botão Alterar Senha |
ChangePasswordMode | Corda | local | Falso | Configura o modo para o botão Alterar Senha, os modos disponíveis são: local , SSOExtension , url |
SupportEmail | Corda | Nenhum | Falso | Configura o endereço de e-mail mostrado quando o usuário clica no botão Informações de suporte |
SupportPhone | Corda | Nenhum | Falso | Configura o número de telefone mostrado quando o usuário clica no botão Informações de suporte |
HiddenWidgets | Variedade | Nenhum | Falso | Configura quais widgets ocultar, os widgets disponíveis são: DeviceInfo , MunkiPendingApps , MunkiUpdates , IntunePendingApps , IntuneUpdates , Storage , MdmStatus , Actions , Battery , EvergreenInfo |
HiddenActions | Variedade | Nenhum | Falso | Configura quais ações ocultar, as ações disponíveis são: Support , ManagedSoftwareCenter , ChangePassword , Reboot , KillAgent , SoftwareUpdates , GatherLogs |
NotificationInterval | Inteiro | 4 | Falso | Configura o intervalo de notificações em horas para notificações de atualizações de aplicativos e atualizações de software. Definir como 0 desativa notificações |
NotificationTitle | Corda | Companheiro de suporte | Falso | Configura o título para notificações |
NotificationImage | Corda | Nenhum | Falso | Configura uma imagem para adicionar às notificações. O caminho deve ser especificado |
SoftwareUpdateNotificationMessage | Corda | Você tem atualizações de software disponíveis. Tome uma atitude agora! ud83cudf89 | Falso | Configura a mensagem para notificações de atualizações de software |
SoftwareUpdateNotificationButtonText | Corda | Detalhes ud83dudc40 | Falso | Configura o texto do botão para notificações de atualizações de software |
AppUpdateNotificationMessage | Corda | Você tem atualizações de aplicativos disponíveis. Tome uma atitude agora! ud83cudf89 | Falso | Configura a mensagem para notificações de atualizações de aplicativos |
AppUpdateNotificationButtonText | Corda | Detalhes ud83dudc40 | Falso | Configura o texto do botão para notificações de atualizações de aplicativos |
CustomColors | Variedade | Nenhum | Falso | Configura cores personalizadas para o aplicativo, devendo ser especificadas em formato hexadecimal, veja exemplo abaixo. Não use BrandColor em conjunto com esta chave |
IntuneMode | Bool | Falso | Falso | Configura o aplicativo para usar o Intune para obter informações do aplicativo. Suporta apenas aplicativos do tipo PKG e DMG, não LOB. |
LogFolders | Variedade | /Biblioteca/Logs/Microsoft | Falso | Configura as pastas de log das quais coletar logs. Usado apenas ao coletar logs. |
Actions | Variedade | Nenhum | Falso | Configura ações personalizadas para adicionar ao menu da bandeja. Veja o exemplo abaixo. |
ShowMenuToggle | Bool | Verdadeiro | Falso | Configura se o botão de alternância de menu deve ser mostrado no menu lateral dos aplicativos. |
ShowDesktopInfo | Bool | Falso | Falso | Configura se as informações serão mostradas na área de trabalho. |
DesktopPosition | Corda | Superior direito | Falso | Configura a posição das informações da área de trabalho, as posições disponíveis são: TopLeft , TopRight , BottomLeft , BottomRight |
DesktopInfoLevel | Corda | Completo | Falso | Configura o nível de informação a ser exibido na área de trabalho, os níveis disponíveis são: Minimal , Hardware , Full , Custom |
DesktopInfoCustomItems | Variedade | Nenhum | Falso | Se DesktopInfoLevel estiver definido como Custom , use essa matriz para determinar quais informações mostrar. As informações disponíveis são: HostName , Model , SerialNumber , Processor , IpAddress , MemSize , OsBuild , OsVersion , LastBootTime , StorageInfo , SupportPhone , SupportEmail , Separator |
DesktopInfoBackgroundColor | Corda | Transparente | Falso | Configura a cor de fundo das informações da área de trabalho. Configurar usando formato hexadecimal |
DesktopInfoBackgroundOpacity | Real | 1,0 | Falso | Configura a opacidade do plano de fundo para as informações da área de trabalho. Configure um valor entre 1,0 - 0,1 |
DesktopInfoColorHighlight | Bool | Verdadeiro | Falso | Configura se o texto deve ser destacado nas informações da área de trabalho. |
DesktopInfoFontSize | Inteiro | 17 | Falso | Configura o tamanho da fonte das informações da área de trabalho. |
CustomWidgetsPath | Corda | Nenhum | Falso | Configura um caminho para um arquivo JSON contendo widgets personalizados para mostrar na visualização inicial. |
SystemProfilerApps | Bool | Nenhum | Falso | Configura o aplicativo para listar todos os aplicativos instalados em /Applications e suas versões. Útil se Munki ou Intune não forem usados. |
Para mudar do Munki para o Intune para obter informações do aplicativo, adicione a seguinte chave ao perfil:
<key>IntuneMode</key> <verdadeiro/>
<?xml versão="1.0" codificação="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<versão plist="1.0">
<dict>
<key>PayloadContent</key>
<matriz>
<dict>
<key>Nome da Marca</key>
<string>AwesomeCorp</string>
<key>AlterarPasswordMode</key>
<string>Extensão SSO</string>
<key>CoresPersonalizadas</key>
<matriz>
<dict>
<key>PrimaryColor</key>
<string>#00A0D0</string>
<key>AccentColor</key>
<string>#45637A</string>
</dict>
</array>
<key>Ações</key>
<matriz>
<dict>
<key>Nome</key>
<string>Reiniciar a área de transferência?</string>
<key>Comando</key>
<string>painel killall</string>
</dict>
<dict>
<key>Nome</key>
<string>Reiniciar o Agente do Intune ⚡️</string>
<key>Comando</key>
<string>/usr/bin/osascript -e 'fazer shell script "sudo killall IntuneMdmAgent" com privilégios de administrador'</string>
</dict>
<dict>
<key>Nome</key>
<string>️Alguma ação incrível</string>
<key>Comando</key>
<string>echo "Eu sou incrível"</string><!-- Chave opcional para especificar um ícone para a ação que será exibida na visualização de autoatendimento --><key>Ícone</key>
<string>AppleFinder</string>
</dict>
</array>
<key>NotificationTitle</key>
<string>AwesomeCorp TI</string>
<key>PayloadDisplayName</key>
<string>SupportCompanion</string>
<key>PayloadIdentifier</key>
<string>SupportCompanion</string>
<key>PayloadType</key>
<string>SupportCompanion</string>
<key>PayloadUUID</key>
<string>a7a0d79f-1cf0-42f2-bc7e-e67d7413a3c5</string>
<key>PayloadVersion</key>
<inteiro>1</inteiro>
<key>E-mail de suporte</key>
<string>[email protected]</string>
<key>Telefone de suporte</key>
<string>123-456-789</string>
<key>SupportUrl</key>
<string>https://awesomecorp.support</string>
</dict>
</array>
<key>PayloadDisplayName</key>
<string>SupportCompanion</string>
<key>PayloadIdentifier</key>
<string>9c4a8e5e-4c70-4b82-83f7-44a053c146f4</string>
<key>PayloadType</key>
<string>Configuração</string>
<key>PayloadUUID</key>
<string>3D47F3E6-62ED-4668-A30F-6DA1DAE87B18</string>
<key>PayloadVersion</key>
<inteiro>1</inteiro>
</dict>
</plist>AvaloniaUI
SukiUI
