[00:00] Antes de começar esse meu script para fazer a conversão de um arquivo pro hash. Para gente fazer o cálculo do hash, eu escrevi um pequeno procedimento para gente seguir.
[00:13] Então pra eu fazer o cálculo do hash, o primeiro passo é obter o conteúdo do meu arquivo. A gente conheceu o cmdlet Get-Content que já faz isso pra gente. Só que para fazer o cálculo de hash eu preciso disso em bytes. Bom, isso parece um pequeno desafio, mas não parece nada muito complexo.
[00:35] Beleza, feito isso eu preciso fazer a computação do hash a partir desses bytes, computei o hash, aí eu vou escrever na tela, e o que eu vou obter no final, é algo exatamente nesse formato, isso daqui pessoal, são vários números inteiros concatenados no formato hexadecimal.
[01:01] Então, eu tenho um número decimal só que ao invés de escrever ele na notação decimal eu vou converter para formato de hexadecimal, e sendo hexadecimal eu vou ter uma string nesse formato aqui.
[01:18] Aqui, eu peguei, como exemplo, o hash SHA-1 do Windows 7 Home Premium. Então eu olhei de novo a listinha de procedimento que a gente vai seguir eu me deparei com esses desafios, o primeiro deles que não parece tão complexo que é fazer a conversão para bytes, de um texto, e fazer o ato de computar o hash.
[01:47] Pessoal, eu não faço a menor ideia de como se computa um hash. Eu não sou programador, eu sou administrador de sistemas, mas mesmo assim eu entrei lá no Google eu fiz uma pesquisa e aí eu descobri como se computa o hash, é só seguir essa imagem aqui, parece fácil, né?
[02:05] Não pessoal, será que eu preciso criar esse script clássico no PowerShell? Ainda lembrando que o PowerShell não é uma linguagem de programação, é uma linguagem de script, então ele não foi feito para a gente escrever código desse nível de complexidade no PowerShell. Ele foi feito para escrever scripts e diante disso pessoal eu fiz a mesma cara que vocês devem estar fazendo agora, e diante do meu desespero um colega desenvolvedor .NET me lembrou de algumas coisinhas.
[02:43] A primeira delas é que PowerShell é orientado a objetos, a outra coisa é que o PowerShell é baseado em .NET, ou seja, ele foi construído em cima do .NET. E aí o cheguei para esse meu colega e comentei, "Será que não tem uma classe, ou um objeto, que já faça esse cálculo de hash para mim?", então ele lembrou: "Sim! A gente tem a classe SHA1Managed que ele vai fazer o cálculo do hash a partir dos bytes que você der para ele".
[03:20] E a gente tem a propriedade estática "Encoding.UTF8", que vai fazer a conversão de texto para os bytes. Se classe e propriedade estática parece um pouco grego para você eu sugiro fortemente que você faça um curso aqui na Alura de orientação a objetos com C#.
[03:49] Esse curso ele vai agregar bastante como administradores e quem lida com PowerShell, não apenas porque a gente vai aprender C#, mas porque a gente vai aprender um pouco sobre .NET, e a gente vai aprender os conceitos de orientação a objetos que a gente vai usar bastante no PowerShell se a gente se aprofundar cada vez mais nele.
[04:10] Então, vamos começar a escrever o nosso script, eu tô com o Visual Studio Code aberto, eu vou criar um novo arquivo e vou chamar ele de ShaHashCode, ou melhor eu vou chamar de ShaFile e eu vou usar a extensão PS1, porque eu tô falando de um script PowerShell e o Visual Studio Code, ele já coloca o íconezinho do PowerShell.
[04:36] Então, como a gente definiu nas reuniões o nome dos nossos CMDLET eles vão ser Get-FileSHA1, a gente vai ter o SHA256, a gente vai ter o SHA384, e vamos ter também o 512.
[05:02] Para criar um CMDLET dentro de um script eu tenho uma, notação muito semelhante com várias linguagens de programação que é usar uma palavra reservada, function, e depois do nome da minha função que no PowerShell é um CMDLET eu passo uma lista de parâmetros e no fim eu tenho um bloco onde eu vou escrever o código.
[05:29] Então, eu vou fazer isso com esses outros, com os outros nomes também então, function, e passar a lista parâmetros e passar o bloco de script. fiz aqui o corpo e a lista de parâmetros para todos eles.
[05:52] Vamos lembrar o que a gente precisa. A gente vai precisar receber o arquivo, então a gente vai receber o nome, e o endereço completo de onde esse arquivo está. Então eu vou criar uma variável aqui dentro, já que a gente vai começar pelo Get-FileSHA1, eu vou colocar como parâmetro o file, vamos escrever em minúsculo, eu vou obter como parâmetro o filePath
[06:22] E a partir do filePath eu vou poder obter o seu conteúdo, então eu vou criar uma nova variável conteúdo, eu vou chamar de fileContent. Vai ser aquele CMDLET que a gente já conhece, Get-Content, e como parâmetro eu vou passar para ele o filePath.
[06:44] Segunda tarefa, converter esse conteúdo pra bytes, vamos lembrar que nosso amigo .NET, falou que a gente pode usar o Encoding.UTF-8. Lembrando que ele é um membro estático. No PowerShell pra usar um membro estático do .NET eu tenho uma sintaxe bem simples.
[07:06] Então eu vou primeiro criar a minha variável, vai ser fileBytes, e se eu quero usar um membro estático, eu coloco entre colchetes, qual é o tipo, o nome do meu tipo, e em seguida eu digo qual é o membro que eu quero acessar.
[07:25] Bom, o tipo é o Encoding, eu estou no Visual Studio Code, eu escrevi Encoding, ele deu essa sugestão para mim, eu vou dar um Enter, e ele vai auto-completar o namespace, dessa classe aqui.
[07:44] E a gente sempre precisa do nome inteiro do objeto. E aqui que eu já tenho entre colchetes qual classe a gente está usando um membro estático, eu coloco duas vezes, dois pontos, e agora eu tenho disponível os seus objetos suas propriedades e seus membros.
[08:05] E aqui eu vou usar o UTF8, e o UTF8, ele possui um método chamado GetBytes, e ele vai receber por parâmetro o texto que eu quero obter os bytes. E o texto a gente já possui lá em cima, é o fileContent. Agora nós temos o arquivo, nós temos os bytes desse arquivo, agora a gente precisa instanciar aquela classe que nosso colega .NET falou, que já possui implementado os métodos para se computar o hash.
[08:46] Então, para criar uma nova instância de uma classe no PowerShell, a gente tem um CMDLET chamado, New-Object, que faz o que a gente precisa, criar um novo objeto. Então eu vou chamar esse cara de SHA1, vou guardar nessa variável SHA1, e eu vou chamar então esse CMDLET, New-Object. E o Visual Studio Code já auto completa pra gente, porque a gente tem um parâmetro chamado TypeName. O TypeName ele também vai ser o nome inteiro, então a gente também vai incluir o namespace nesse nome.
[09:26] Vamos lembrar, que o objeto, a classe, que o nosso amigo .NET sugeriu foi esse SHA1Managed, então já vou usar esse cara aqui. O Visual Studio Code ele já auto completa o namespace para gente, facilita muito nosso trabalho.
[09:47] Então, se eu já tenho os bytes, se eu já tenho o objeto, a classe que vai fazer essa computação para gente, falta apenas passar os bytes para esse objeto de computação de hash. Então vou usar aqui o método ComputeHash da minha classe .NET SHA1.
[10:11] Eu vou passar por parâmetro os bytes do meu arquivo fileBytes. Eu vou guardar isso dentro de outra variável, eu vou guardar isso dentro de hash. E agora pessoal, eu vou escrever na tela, eu vou escrever na tela qual é o hash desse arquivo.
[10:31] E a gente espera o que? A gente espera ter uma saída muito semelhante com esse daqui, do Windows 7. Uma saída nesse formato. Então eu vou escrever na tela. Vamos lembrar que a tela do PowerShell é o host, é quem hospeda a Engine de execução do PowerShell. Então se eu quero escrever na tela, que é o nosso host, eu posso usar o CMDLET Write-Host.
[11:07] Legal, e eu vou escrever na tela o nosso resultado de hash. E pessoal, o Write-Host ele é interessante porque ele nos dá algumas opções, como mudar a cor. Se eu quero escrever colorido, eu posso escrever, se eu quiser mudar a cor do fundo para vermelho, eu posso, se eu quero mudar a cor do texto para amarelo, eu posso, então eu tenho como argumentos aqui o BackgroundColor e o ForegroundColor.
[11:39] Como background eu vou usar o vermelho, então eu vou escrever aqui, Red, e como foreground a cor do meu texto, eu vou usar o amarelo, só para a gente ter uma visualização mais interessante.
[11:54] Então, eu vou salvar meu Script, e eu vou dar um F5 aqui no Visual Studio Code, dei o F5 e aparentemente, nada aconteceu. Nada aconteceu porque eu só tô declarando funções, eu não estou chamando nenhuma função, e eu não estou executando nada de fato.
[12:15] Se eu escrevo aqui no meu terminal do PowerShell, Get-FileSHA1, que é uma função que a gente declarou aqui no nosso script, e der um Enter, ele vai ser executado. Aqui no caso, a gente teve alguns erros, porque a gente não passou o argumento do arquivo que a gente vai fazer o cálculo do hash.
[12:38] Então eu vou, para ser mais fácil, eu vou pegar esse próprio script e eu vou calcular o hash dele. Então eu vou usar o Copy Path, eu vou colar aqui, e para não precisar ficar usando o terminal a todo momento, eu vou chamar o Get-FileSHA1 logo depois de declarar, e eu vou passar ele pra esse arquivo aqui, que é o próprio arquivo de script.
[13:07] Vou salvar, vou dar um F5. A gente já teve a nossa saída aqui, então muito facilmente a gente criou a classe que faz a computação do hash, e a gente obteve os bytes do nosso arquivo e a gente escreveu na tela o hash.
[13:27] Mas pessoal, isso daqui tá num formato bem diferente do formato padrão, então a gente precisa imprimir nesse formato padrão de hash de arquivo. Aquele formato que a gente viu, nada mais é que todos esses números aqui escritos em hexadecimal e concatenados. Vamos fazer isso?