mut
v6.2.1 - Authentication updates
A ferramenta de atualização de massa não oficial e all-in-one projetada para ser o companheiro perfeito para atribuir administradores
Bem -vindo ao Mut V6. Se você estiver familiarizado com o Mut V5 e o Mut Classic, o Mut V6 provavelmente se sentirá muito familiar para você. Se esta é a sua primeira vez aqui, recomendo que você leia o ReadMe na íntegra.
Se você quiser um rápido tour em vídeo dos novos recursos do V6, verifique nosso vídeo Intro aqui: https://www.youtube.com/watch?v=G1CWOWBR_TI
O Mut é uma ferramenta incrivelmente poderosa e, com grande poder, vem uma grande capacidade de fazer coisas. Sempre, sempre execute uma pequena atualização de teste em apenas alguns dispositivos para garantir que suas atualizações estejam funcionando conforme o pretendido, e seu escopo não quebre devido às atualizações.
O MUT é um aplicativo MacOS nativo escrito no SWIFT, que permite que os administradores do JAMF façam atualizações em massa para atributos (como nome de usuário, tag de ativo ou atributo de extensão) de seus dispositivos e usuários em JAMF.
Os administradores também podem fazer alterações em massa nos grupos estáticos e o escopo das matrículas de prestígio via MUT.
O MUT realizará verificações em suas credenciais automaticamente ao fazer login. Se ele sentir um problema com as credenciais que você fornece, isso informará quais são esses problemas.
O MUT executa essas verificações gerando um token para o novo JPAPI. Qualquer usuário é capaz de gerar um token para o JPAPI, portanto, não há mais a necessidade de existir a caixa de seleção "Autenticação de desvio". Esta caixa de seleção foi alterada para uma caixa de seleção "Permitir SSL insegura". Você pode usar esta caixa de seleção se quiser permitir SSL inseguro, mas o MUT executará verificações SSL padrão por ATS por padrão.
Todos os privilégios serão encontrados nas ações do Jamf Pro Server e só precisam ter atualização verificada - a menos que indicado de outra forma.
Modelo de computador - computadores, usuários
Grupos e modelos de prestígio (recomendados para ter usuários separados para obter menos acesso ao privilégio):
Grupos de Computadores / Prestagem - Grupos de Computadores estáticos, Inscritos de Prestagem de Computadores
Grupos de dispositivos / Prestação - Grupos de dispositivos móveis estáticos, Inscrição de Prestação de dispositivos móveis
Grupos de usuários - Grupos de usuários estáticos
Modelo de dispositivo móvel - dispositivos móveis, usuários
Modelo de Usuário - Usuários (Atualizar, Criar)
Quando você se autentica pela primeira vez, você receberá uma tela relativamente simplista, que terá um botão grande para baixar os modelos CSV necessários para usar o MUT. Observe que esses modelos tendem a mudar com as atualizações do MUT, a fim de permitir novos recursos, por isso é recomendável que você download novamente esses modelos após atualizações.
Ao pressionar o botão Download CSV Models, o MUT perguntará onde você deseja salvar os modelos mut modelos.zip. O Mut.log não está mais localizado no diretório de modelos e agora pode ser encontrado no menu Configurações na parte superior da página.
Para atualizar as informações para um objeto (como um computador ou dispositivo móvel) no Jamf Pro, você precisará usar o modelo CSV associado que o Mut salvou onde você especificou. Por exemplo, para atualizar objetos de computador, você precisará usar o "computerTemplate.csv".
O MUT executa verificações de verificação em relação à linha do cabeçalho deste arquivo CSV, e é muito importante que você não modifique a linha do cabeçalho (como excluir colunas ou reorganizar as colunas) antes de enviar seu arquivo CSV. Se o fizer, o MUT rejeitará o arquivo.
Um uso comum para o MUT é atualizar atributos únicos, como atualizar o nome de usuário atribuído a um conjunto de dispositivos ou preencher a tag de ativo ou código de barras para um dispositivo.
A coisa mais importante a lembrar é que qualquer célula deixada completamente em branco no seu CSV será ignorada. Observe que um espaço não é o mesmo que completamente em branco. Há uma grande diferença entre "" e "".
Se um campo for ignorado no MUT, sua verificação de pré -voo mostrará a frase "(inalterada)" em azul para esse campo.
Se você quiser atualizar o nome de usuário em um conjunto de dispositivos, o arquivo CSV ficaria assim (com mais colunas após as elipsis.):
| Série de computador | Nome de exibição | Tag de ativo | Código de barras 1 | Código de barras 2 | Nome de usuário | Nome real | ... |
|---|---|---|---|---|---|---|---|
| C13371337 | 1337 |
E o MUT exibirá uma tela como a seguinte quando você executar sua verificação antes do voo:
Talvez o recurso mais solicitado para o MUT tenha sido a capacidade de atualizar vários atributos de uma só vez. Esse recurso está agora disponível no MUT.
Para atualizar vários atributos para um objeto de uma só vez, basta preencher todos esses campos no arquivo CSV. Ao executar sua verificação antes do voo, você receberá todas as informações que atualizarão (e quaisquer campos em branco ainda serão exibidos como "(inalterados)").
Se você quiser atualizar a tag de ativos, códigos de barras, nome de usuário e nome real em um conjunto de dispositivos, o arquivo CSV ficaria assim (com mais colunas após as elips.):
| Série de computador | Nome de exibição | Tag de ativo | Código de barras 1 | Código de barras 2 | Nome de usuário | Nome real | ... |
|---|---|---|---|---|---|---|---|
| C11111111 | MUT-111 | 0123456789 | 0123456789 | Mike.levenick | Mike Levenick | ||
| C22222222 | MUT-222 | 1234567890 | 1234567890 | ben.whitis | Ben Whitis |
E o MUT exibirá uma tela como a seguinte quando você executar sua verificação antes do voo:
A partir do JAMF PRO 10.33, há um ponto de extremidade que permite que a caixa de seleção da aplicação da aplicação seja verificada ou desmarcada pela API JAMF PRO.
O Mut V6 pode aproveitar esse ponto de extremidade e permitir que você aplique ou não reforce o nome do seu dispositivo móvel. Há um novo campo "Nome da aplicação" no modelo de dispositivos móveis, e esse campo aceita um valor booleano de verdadeiro ou falso.
Essas atualizações podem ser feitas por conta própria ou em combinação com outras atualizações. Para definir um nome de dispositivo móvel e aplicar esse nome, além de atualizar a tag de ativo, código de barras e nome de usuário, seu CSV ficaria algo assim:
| Série de computador | Nome de exibição | Aplicar o nome | Tag de ativo | Código de barras 1 | Código de barras 2 | Nome de usuário | ... |
|---|---|---|---|---|---|---|---|
| C11111111 | Mikes iPhone | verdadeiro | MUT-111 | 0123456789 | Mike.levenick | ||
| C22222222 | Mikes iPad | verdadeiro | MUT-222 | 1234567890 | ben.whitis |
O MUT também pode atualizar atributos de extensão para um dispositivo ou usuário. Para fazer isso, você deve primeiro identificar o número de identificação do atributo de extensão. Você pode encontrar esse número na URL enquanto estiver visualizando um atributo de extensão no GUI do Jamf Pro em Configurações (ícone de engrenagem)> Gerenciamento de computadores> Atributos de extensão> Clique no EA que você deseja atualizar para trazê -lo.
Por exemplo, o EA ID do atributo de extensão exibido aqui é "2".
Para atualizar um atributo de extensão, basta adicionar seu próprio cabeçalho para uma nova coluna depois de todas as colunas existentes do seu modelo e coloque a string "ea_ #" no cabeçalho, onde # é o id do ea que você gostaria de atualizar .
Por exemplo, para atualizar um atributo de extensão com o ID: "2", adicionaríamos uma nova coluna com o cabeçalho "EA_2" e, em seguida, colocamos os valores para esse EA na coluna.
Seu CSV seria algo assim (algumas colunas foram removidas simplesmente para fazê -lo se encaixar. Por favor, não remova as colunas do seu CSV):
| Série de computador | Nome de exibição | Tag de ativo | Código de barras 1 | ... | ... | Site (ID ou nome) | Ea_2 |
|---|---|---|---|---|---|---|---|
| C11111111 | MUT-111 | 0123456789 | Novo valor | ||||
| C22222222 | MUT-222 | 1234567890 | Novo valor |
E o MUT exibirá uma tela como a seguinte quando você executar sua verificação antes do voo. Observe o novo campo adicionado na parte inferior com EA_2. Observe também que você precisará rolar para baixo na janela da mão direita para ver todos os campos que o Mut pode atualizar agora. Existem alguns!:
Outro fluxo de trabalho comum com o MUT é limpar os atributos existentes. Isso acontece, por exemplo, em situações em que um grupo de dispositivos está sendo redistribuído a novos usuários ou aposentado e precisa do nome de usuário e das informações relacionadas a eles.
Como o Mut ignora os campos em branco no seu CSV agora, uma string específica deve ser usada para dizer ao MUT para limpar os valores. Esta string está atualmente "clara!" (Com o ponto de exclamação, sem cotações.) Na GUI de pré -voo, o MUT exibirá a string "será limpa" em todo o vermelho, para que você saiba que o campo está sendo limpo.
Se você quisesse limpar as informações do usuário de um dispositivo, seu CSV ficaria algo assim (com mais colunas após a elipse.):
| Série de computador | Nome de exibição | Tag de ativo | Código de barras 1 | Código de barras 2 | Nome de usuário | Nome real | ... |
|---|---|---|---|---|---|---|---|
| C11111111 | MUT-111 | 0123456789 | 0123456789 | CLARO! | CLARO! | ||
| C22222222 | MUT-222 | 1234567890 | 1234567890 | CLARO! | CLARO! |
E o MUT exibirá uma tela como a seguinte quando você executar sua verificação antes do voo (eu exagerei um pouco com valores de limpeza para esta captura de tela ...):
O Mut V6 é capaz de atualizar o conteúdo de um grupo estático (computadores, dispositivos móveis ou usuários). Ele é capaz de adicionar objetos a um grupo, remover objetos de um grupo ou substituir todo o conteúdo atual desse grupo.
Para fazer isso, seu arquivo CSV deve conter nada além de uma única coluna de identificadores para que os objetos sejam adicionados, removidos ou substituídos no escopo desse grupo. Esse identificador pode ser número de série ou ID para computadores e dispositivos móveis, ou nome de usuário ou ID para usuários.
Seu arquivo CSV deve ficar assim:
| Números de série ou nomes de usuário |
|---|
| C11111111 |
| C22222222 |
| C3333333 |
| C4444444 |
| C5555555 |
Quando você carrega esse CSV para o MUT, você será levado para uma tela ligeiramente diferente que contém suspensos. Essas suspensas são como você selecionará qual ação ocorrer. Ele também contém uma caixa, onde você deve colocar o ID do grupo estático a ser modificado. Esse ID pode ser encontrado no URL enquanto visualiza o grupo a ser modificado.
Por exemplo, o ID do grupo para o grupo a seguir é "3".
Mas vamos fingir que o número do nosso grupo era 1337; Para adicionar os dispositivos em questão ao grupo estático do computador 1337, sua GUI mut seria assim:
Um dos novos recursos do MUT V6 é a capacidade de modificar o escopo das proteções. Esse recurso requer Jamf Pro v10.24+ para funcionar corretamente.
Para fazer isso, seu arquivo CSV deve conter nada além de uma única coluna de identificadores para que os objetos sejam adicionados, removidos ou substituídos no escopo dessa prestragem. Esse identificador pode ser número de série ou ID para computadores e dispositivos móveis.
Seu arquivo CSV deve ficar assim:
| Números de série ou nomes de usuário |
|---|
| C11111111 |
| C22222222 |
| C3333333 |
| C4444444 |
| C5555555 |
Quando você carrega esse CSV para o MUT, você será levado para uma tela ligeiramente diferente que contém suspensos. Essas suspensas são como você selecionará qual ação ocorrer. Ele também contém uma caixa, onde você deve colocar o ID da prestação a ser modificado. Esse ID pode ser encontrado no URL enquanto visualiza a prestação a ser modificada.
Por exemplo, o ID de prestígio para o grupo a seguir é "1".
Para adicionar os dispositivos em questão ao Prestage 1, sua GUI Mut seria a seguinte:
O Mut V5 usou um novo método para atualizar grupos e proteções. Esse novo método era muito mais eficiente, mas exigia que o CSV fosse perfeito. Quaisquer linhas com dispositivos que já estavam no escopo, ou não no ambiente, causariam a falha de toda a atualização. Por esse motivo, o Mut Classic foi disponibilizado, que atualizou o grupo ou a linha a linha, assim como o Mut V4.
Esses envios de linha a linha são muito menos eficientes e levam significativamente mais tempo, mas se houver uma linha ruim no CSV, o MUT simplesmente o pulará e seguirá em frente.
Agora, no Mut V6, você obtém o melhor dos dois mundos. O Mut V6 tentará inicialmente o novo método de atualização mais eficiente, mas, com a chance de que ele falhe, você receberá a opção de tentar uma atualização do "modo clássico".
É importante observar que as linhas incorretas ainda falharão com este modo clássico, mas essas linhas serão relatadas no Mut.log para revisão posterior, e quaisquer outras linhas ainda passarão com sucesso.
É importante observar que o modo clássico não é compatível com as tentativas de atualização "Substituir" via MUT, pois todo o grupo ou prestação seria simplesmente substituído pela última linha de trabalho do CSV.
Provavelmente, os veteranos do MUT são usados para precisar executar uma verificação de pré -voo antes de cada atualização e, em seguida, revisar as informações antes de enviar.
As verificações de pré -voo no V6 para atualizações de atributo de objeto agora acontecem assim que você enviar seu CSV. Se houver um problema com o seu arquivo CSV, você será alertado assim que tentar enviá -lo. O MUT também não deve permitir que você execute nenhuma atualização se o seu CSV contiver erros.
As verificações de pré -voo no V6 para atualizações de escopo de grupo e prestação acontecerão em parte quando você enviar o CSV, mas você deve executar uma verificação de pré -voo separada depois de preencher as suspensas e caixas de identificador. O botão Enviar atualizações não aparecerá até que você tenha preenchido esses campos e, em seguida, execute a verificação de pré -voo.
É altamente recomendável que você faça uma pequena atualização de teste de apenas alguns dispositivos antes de fazer atualizações em massa com o MUT-especialmente se você for novo na ferramenta.
Depois de confiar nas atualizações a serem enviadas ao seu servidor Jamf Pro, você pode pressionar o botão "Enviar atualizações".
Muito pouca informação de status/resultado é exibida na GUI principal do MUT. Agora você encontrará um mut.log indo para o menu Configurações na parte superior da tela. Este novo arquivo de log contém informações muito mais detalhadas sobre o status de suas atualizações e deve ajudar na solução de problemas significativamente.
O arquivo de log se parece um pouco assim:
