SkyAPI Requests - Script para executar ações em lote via API
Esse script reúne diversas funções administrativas que não estão disponíveis diretamente no painel de controle por motivos de segurança. No entanto, caso você seja um administrador do domínio, ele pode ser extremamente útil para executar ações em lote de forma rápida e eficiente no seu próprio ambiente.
Realize download dos arquivos deste guia Clicando Aqui!
1. Gerando Token JWT
Para gerar o Token JWT utilizado para realizar chamadas de API você precisa de 2 informações, usuário e senha do painel de controle, chave privada do painel!
Acesse o painel de controle da Skymail. Em seguida, clique em Minha Conta e selecione Configurações da Conta, localizado no canto superior direito da tela.
Em seguida, clique em Interface API e copie a chave privada da sua organização. Certifique-se de armazená-la em um local seguro.
O próximo passo é gerar o token de autorização, este passo deve ser efetuado apenas uma vez pois este mesmo token pode ser utilizado sempre que necessário e está atrelado ao usuário do painel que foi utilizado para criá-lo, vai funcionar para sempre desde que o usuário esteja ativo.
Com a chave privada, o usuário e senha do painel de controle execute como administrador no Powershell o Script api-key-generator.ps1 e preencha os dados solicitados:
Observação: Este é o token principal de autorização que utilizaremos para as chamadas da API. Copie-o e armazene-o em um local seguro.
2. Executando as chamadas de API
Para realizar as ações em lote, basta executar o Script api-requests.ps1, ele solicitará qual ação deseja tomar, basta selecionar a desejada e preencher o que for requisitado:
Em cada chamada, o arquivo CSV informado deve seguir um formato específico. Abaixo está a lista com a estrutura esperada para cada tipo de CSV:
# Deletar Contas conta1@dominio.com.br conta2@dominio.com.br etc... # Desabilitar Contas conta1@dominio.com.br conta2@dominio.com.br etc... # Gerenciador de Senhas (trocar senha - Mesma senha para todas) conta1@dominio.com.br conta2@dominio.com.br etc... # Gerenciador de Senhas (trocar senha diferente - Cada conta com sua senha) conta1@dominio.com.br,senha1 conta2@dominio.com.br,senha2 etc... # Gerenciador de Senhas (forcar troca da senha - Não altera a senha, apenas força para trocar no próximo login) conta1@dominio.com.br conta2@dominio.com.br etc... # Deletar zonas de DNSs zona_de_dns1.com.br zona_de_dns2.com.br etc... # Deletar Grupos grupo1@dominio.com.br grupo2@dominio.com.br etc...
Qualquer BUG ou Problema reporte para nossos analistas via suporte@skymail.com.br!