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 serão mostradas. 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:
IntuneMode
PayloadContent Nome da Marca AwesomeCorp AlterarPasswordMode Extensão SSO CoresPersonalizadas PrimaryColor #00A0D0 AccentColor #45637A Ações Nome Reiniciar a área de transferência? Comando painel killall Nome Reiniciar o Agente do Intune ⚡️ Comando /usr/bin/osascript -e 'fazer shell script "sudo killall IntuneMdmAgent" com privilégios de administrador' Nome ️Alguma ação incrível Comando echo "Eu sou incrível" Ícone AppleFinder NotificationTitle AwesomeCorp TI PayloadDisplayName SupportCompanion PayloadIdentifier SupportCompanion PayloadType SupportCompanion PayloadUUID a7a0d79f-1cf0-42f2-bc7e-e67d7413a3c5 PayloadVersion 1 E-mail de suporte [email protected] Telefone de suporte 123-456-789 SupportUrl https://awesomecorp.support PayloadDisplayName SupportCompanion PayloadIdentifier 9c4a8e5e-4c70-4b82-83f7-44a053c146f4 PayloadType Configuração PayloadUUID 3D47F3E6-62ED-4668-A30F-6DA1DAE87B18 PayloadVersion 1
AvaloniaUI
SukiUI