Tipos, padrões e valores
Slide 27 de 85
27SecretTipos, padrões e valores

Segredos

Um Secret<T> é um valor que não pode vazar — uma senha, uma chave, um token, ou um registro deles — e o tipo transforma isso numa regra que o compilador cumpre:

  • echo, panic e a interpolação recusam um, e também qualquer coisa que guarde um: um campo, um elemento, um Result. Escrever um como JSON também. reveal(secret) é o único caminho de volta para o T.
  • T é um dado simples: texto, números, vetores, mapas, resultados e tipos declarados feitos deles. Um Secret de uma função, de um endereço, de um recurso da biblioteca ou de outro Secret é um erro de compilação, e também um Secret sozinho, que não diz o que guarda. Os segredos da biblioteca são texto, então são Secret<Str>.
  • O que ele guarda fica em bytes numa memória que o sistema operacional é instruído a nunca levar para o swap, e é zerado assim que nada mais o segura.
  • == compara o que dois guardam em tempo constante, então quanto tempo leva não diz nada sobre onde eles diferem. Um mapa é guardado em ordem de chave, então dois com os mesmos pares são iguais. Não existe ordem.

Memória travada é finita, então hide(value) responde com um Result<Secret<T>, SecretError>, que é SecretError.LimitExceeded quando o limite se esgota e SecretError.Unsupported onde a plataforma não consegue travar memória nenhuma, cada um com uma message. bypass(value) faz um Secret<T> que não falha, guardado em memória comum que pode ir para o swap — para um valor que nunca foi segredo de verdade na chegada, como um literal, que o executável já guarda de qualquer jeito. Duas chamadas da biblioteca têm um gêmeo do mesmo tipo: hive.term.readSecretBypass() e hive.crypto.decryptBypass(ciphertext, password) são o readSecret e o decrypt em memória comum, então nenhuma das duas para no limite.

Um programa que declara o seu próprio Secret ainda tem o nativo como hive.Secret<T>, e o erro dele como hive.SecretError.

Guardado, comparado, nunca mostrado
type Login {
	user:     Str
	password: Secret<Str>
}

proc main(): void {
	typed := hide("hunter2")
	if typed is Result.Error(why) {
		echo why
	} else if typed is Result.Ok(password) {
		echo reveal(password)                // hunter2
		echo password == bypass("hunter2")   // true
		echo Login("ada", password).user     // ada
		// echo password                      — um erro de compilação
		// echo Login("ada", password)        — e este também
	}
}
Qualquer valor simples
type Card {
	number: Str
	pin:    Int
}

proc main(): void {
	card := bypass(Card("4111 1111 1111 1111", 1234))
	echo reveal(card).pin                 // 1234
	codes := bypass([93, 17, 42])
	echo len(reveal(codes))               // 3
	echo codes == bypass([93, 17, 42])    // true
	// Secret<Str> s = codes              — um erro de compilação: guarda Int[3]
}