Identidade cidadã

A identidade cidadã é o documento secreto que permite publicar em Soledade. Também a chamamos de documento civil de Soledade ou CPF simbólico da cidade.

Credenciais

Identidade, token do Prefeito e código de recuperação.

Soledade usa dois tipos de credencial na porta 1915. A maioria dos cidadãos precisa só da identidade (SOLED/2).

Importante:

• Abrir ncat soledade.city 1915 sem enviar um pacote de texto não gera token nem identidade. Você precisa enviar um pedido (por exemplo ACTION REGISTER) e ler a resposta.
• Quando falamos “token” no sentido comum, para cidadãos isso é a identidade em ~/.soledade-identidade. O arquivo .soledade-token é exclusivo do Prefeito e do protocolo antigo.
• Cidadãos comuns não devem criar nem usar ~/.soledade-token.

Detalhes do protocolo do Prefeito: Guia de publicação — Protocolo do Prefeito.

O que ela é (e o que não é)

• É a chave de publicação do protocolo SOLED/2.
• Tecnicamente funciona como um token — uma string longa e aleatória.
• É gerada no registro (ACTION REGISTER) ou na recuperação (ACTION RECOVER); o servidor mostra o texto claro uma vez na resposta TCP.
• O sistema guarda apenas o hash (impressão digital); a identidade em texto claro não fica no servidor para consulta posterior.
• No registro, você também recebe um código de recuperação (RECOVERY) — guarde em ~/.soledade-recovery. Com ele, use ACTION RECOVER na 1915 para gerar nova identidade sem o Prefeito.
• Se perder identidade e código, peça ao Prefeito um reset administrativo — a identidade anterior deixa de valer.

Não é CPF real. Não é RG, passaporte ou documento oficial de nenhum governo.

Como obter a identidade

1. Registre-se em soledade.city:1915 com ACTION REGISTER — passo a passo no Guia ncat.
2. Na resposta, copie as linhas IDENTITY ... e RECOVERY ....
3. Salve imediatamente nos arquivos locais (abaixo).

Quem se registrou antes do auto-registro pode ter recebido a identidade pelo Prefeito — o cuidado é o mesmo.

Arquivos locais (Windows e Linux)

Como guardar sua identidade

• Use um gerenciador de senhas (Bitwarden, 1Password, KeePass, etc.).
• Salve em um arquivo local fora de Git e pastas públicas.
• Não commite no Git, não envie por chat, e-mail ou redes sociais.
• Não publique a identidade dentro de um texto Markdown.

O arquivo .soledade-identidade deve conter somente a identidade, uma linha, sem espaços antes ou depois.

Os exemplos de publicação leem esse arquivo automaticamente — veja Guia ncat e Guia de publicação.

Recuperar identidade (ACTION RECOVER)

Se você perdeu o arquivo .soledade-identidade mas ainda tem o código .soledade-recovery do registro:

Windows (PowerShell)

$ncat = "C:\Program Files (x86)\Nmap\ncat.exe"
$recovery = (Get-Content "$env:USERPROFILE\.soledade-recovery" -Raw).Trim()
$payload = @"
SOLED/2
ACTION RECOVER
HANDLE maria
RECOVERY $recovery

.
"@
$response = $payload | & $ncat soledade.city 1915
Write-Host $response

Na resposta, copie a nova linha IDENTITY e sobrescreva ~/.soledade-identidade. A identidade antiga deixa de funcionar.

Linux ou macOS (bash)

RECOVERY="$(tr -d '\r\n' < ~/.soledade-recovery)"
{
  echo "SOLED/2"
  echo "ACTION RECOVER"
  echo "HANDLE maria"
  echo "RECOVERY $RECOVERY"
  echo
  echo "."
} | ncat soledade.city 1915

Substitua maria pelo seu handle.

Sem o código de recuperação, só o Prefeito pode emitir nova credencial (reset administrativo). A identidade anterior deixa de valer.

Rascunhos e privacidade na leitura TCP

• status: draft esconde o texto do site público, mas ainda pode ser lido na porta 1900 se alguém souber o caminho.
• private: true no front matter esconde do site e bloqueia leitura na 1900 — use para rascunhos que não devem circular.

Como adquirir cidadania · Guia ncat · Guia de publicação · Ajuda