Postream

Carregando o índice…

Documentação: Autenticação

Autenticação

Cada site tem chaves secretas sk_ para o servidor e publicáveis pk_ para o navegador, mostradas uma única vez.

Toda requisição leva uma chave do site no cabeçalho Authorization:

GET /public/v1/sites/7c0e…/posts HTTP/1.1
Authorization: Bearer sk_...

Sem chave, com chave inválida ou revogada, a API responde 401:

{ "statusCode": 401, "code": "UNAUTHENTICATED" }

Dois tipos de chave

TipoPrefixoOnde usarRestrição
Secretask_Só no servidor: server components, route handlers, build.Recusada com 403 SECRET_KEY_IN_BROWSER se a requisição vier de um navegador (com Origin), a não ser que o site libere.
Publicávelpk_Código do navegador.Só funciona em páginas dos domínios permitidos do site; sem origem, 403 ORIGIN_NOT_ALLOWED. Limite de requisições menor, por chave e IP.

O caminho recomendado é a chave secreta no servidor do blog, na rota por site, que fica guardada na borda do Cloudflare. A publicável existe para quem precisa chamar a API do navegador.

Chaves pst_ criadas antes dos dois tipos continuam funcionando, como secretas.

Gerar uma chave

No painel, em API pública, com o site escolhido no topo: dê um nome, escolha o tipo e clique para gerar. A mesma tela mostra o id do site (siteId), usado na rota por site.

Cada site pode ter até 5 chaves ativas de cada tipo. A lista mostra o nome, o tipo, o começo da chave, quando foi criada e o último uso.

Trocar uma chave sem queda

  1. Clique em Rotacionar: o Postream gera uma chave nova do mesmo tipo e nome. A antiga continua valendo por 24 horas (o painel mostra até quando).
  2. Troque no blog e faça o deploy dentro desse prazo.

Para uma chave vazada, use Revogar: vale na hora, e a chave passa a responder 401.

Alertas de uso

O painel avisa, com a origem e quantas vezes aconteceu, quando:

  • uma chave secreta chega com Origin de navegador: provavelmente está no código do site. Rotacione e passe a chamada para o servidor;
  • uma chave publicável é usada fora dos domínios permitidos.