Enviar ao Google seu feed de alertas

Esta seção fornece instruções para enviar alertas ao Google para fins de teste. Esse processo é iterativo. Nenhum alerta será publicado nesta etapa da implementação.

Proteger seus dados

Para garantir a autenticidade das suas informações importantes de alerta, manter a credibilidade do nosso sistema e fornecer os dados certos para o público, exigimos que você proteja seus dados. Seu plano de projeto e manutenção de segurança deve estar em vigor antes de você enviar dados.

Você pode usar HTTP, desde que use assinaturas digitais para assinar alertas, ou usar HTTPS, caso em que não é necessário assinar os alertas.

Preferimos que você use HTTPS.

HTTPS com o Transport Layer Security (TLS)

O HTTPS evita a necessidade de trocar novos certificados digitais quando os anteriores expiram.

Você precisa ter um certificado SSL emitido por uma autoridade certificadora confiável do Google Chrome. Veja estes exemplos de autoridades.

Recomendamos que você use HTTP/TLS ("https://...") no canal SSL tradicional.

HTTP com assinaturas digitais

Se você usar HTTP com assinaturas digitais, poderá gerar a chave para assinar por conta própria. Os Avisos Públicos do Google exigem que você:

  • Forneça sua chave pública e as atualizações subsequentes para ela, pelo menos 30 dias antes da expiração da chave antiga. Isso evita interrupções inesperadas nas atualizações de dados.
  • expirar e criar uma nova chave pelo menos a cada dois anos.
  • assine alertas com sua assinatura de acordo com estas recomendações de segurança do CAP.

Configure seu feed

Para hospedar e entregar suas mensagens de CAP, forneça-as em um feed acessível publicamente, como um dos seguintes:

Veja exemplos de práticas de CAP: feeds CAP para orientação sobre o envio de alertas CAP em um feed. Para ver orientações sobre como configurar feeds Atom ou RSS para alertas CAP, consulte Práticas de exemplo CAP: feeds CAP. Inclua um link no seu feed da Web para o alerta CAP completo conforme mostrado aqui.

Validar o feed

Use nossa ferramenta CAP Validator para validar o feed.

Como atualizar alertas e feeds

Quando um alerta mudar, emita um novo alerta referente ao anterior, em vez de mudar ou remover o atual do feed. Após um período apropriado (por exemplo, de 24 a 48 horas), remova os alertas cancelados, atualizados ou expirados do seu feed.

<msgType>Atualizar ou cancelar precisa incluir pelo menos um elemento <references>. Conforme especificado no padrão CAP, qualquer mensagem de alerta que atualize um alerta anterior deve usar <msgType>Update</msgType> e definir <references>code</references> para todas as mensagens relacionadas anteriores que não atingiram a data <expires>. UPDATE ou CANCEL precisam ser aplicadas a um alerta não vencido.

Há três maneiras de CANCELAR eventos, em ordem de preferência:

  1. Defina uma data e hora <expires> para cada evento, com a descrição da mensagem definindo a expectativa de que esse alerta terminará por conta própria.
  2. Emita um novo <alert> com <msgType>UPDATE, <responseType>"All Clear" e <expires> por um curto período no futuro.
  3. Emita um novo <alert> com <msgType>CANCEL.

Veja exemplos em Alertas de atualizações e cancelamentos.

Próxima etapa: testar a integração de alertas