Existem dois tipos de chave e elas ficam em lugares diferentes. Uma chave de projeto traduz conteúdo para um site. Uma chave de espaço de trabalho gerencia a conta. Se um plugin ou uma integração estiver pedindo uma chave para traduzir, ele quer a do projeto.
A chave do projeto
Abra o projeto e, em seguida, Configurações de API. A chave fica mascarada até que você escolha Mostrar chave de API e Copiar a coloca na sua área de transferência.
Esta é a chave que o plugin do WordPress usa e com a qual a API de Tradução se autentica. Cada projeto tem a sua: uma chave de um projeto não traduzirá o site de outro projeto.
Regenerar a substitui. A chave antiga para de funcionar no momento em que a nova existe, então qualquer coisa que ainda a use para de traduzir até que você cole a nova. Use-a quando uma chave for comprometida, não para organizar.
A chave do espaço de trabalho
Abra o espaço de trabalho e, em seguida, Chaves de API e, em seguida, Criar chave. Estas são chaves com escopo de espaço de trabalho para acessar a API da Plataforma, que gerencia idiomas, regras de glossário, sites e traduções armazenadas.
Quatro diferenças da chave de projeto:
- Você a vê uma vez. A chave é mostrada quando você a cria e nunca mais, então copie-a nesse momento. Se você a perder, revogue-a e crie outra.
- Não há regeneração. As chaves são criadas e revogadas. A revogação é imediata e quebra qualquer coisa que use essa chave, o que a torna a resposta correta para um vazamento.
- Elas expiram. Expira em é um campo obrigatório ao criar uma, oferecendo 30, 90, 180 ou 365 dias, e 180 é o padrão. Não há como estendê-la e nada superior a um ano. Uma chave expirada retorna um erro de autenticação, então crie uma substituta e troque-a antes da data. Uma integração que para de funcionar aproximadamente seis meses após você a ter criado geralmente é isso.
- Elas carregam apenas as permissões que você marca. As permissões são escolhidas na criação e não podem exceder suas próprias permissões nesse espaço de trabalho, então uma chave criada sem nenhuma selecionada não pode acessar nada. Dê a uma chave o mínimo necessário.
Mantendo uma chave segura
Uma chave é uma senha com seu total de palavras anexado. Qualquer um que a possua pode gastá-la.
- Mantenha-a no lado do servidor. Uma chave em JavaScript de front-end, em um pacote de aplicativo móvel ou em um repositório público é uma chave que foi entregue.
- Não a cole em um ticket de suporte, uma captura de tela ou uma mensagem de chat. Se você já o fez, substitua-a.
- Rotacione por suspeita, não por agendamento: Regenerar para uma chave de projeto, Revogar para uma chave de espaço de trabalho.