Gerar a chave de criptografia
Antes de fazer qualquer coisa, o REDA Pay precisa de uma chave de criptografia. O REDA Pay usa essa chave para criptografar todos os segredos que armazena na sua organização: a chave de API da Payload, os identificadores que a Payload atribui ao seu perfil, às contas de processamento, aos clientes e aos métodos de pagamento, e os identificadores escondidos dentro dos links de pagamento. Gerar a chave é uma etapa única, de um clique, na guia REDA Pay Admin. Enquanto ela não for feita, todas as telas do REDA Pay param com a mensagem "REDA Pay setting(s) are invalid or not defined. Please contact your system administrator."
- O REDA Pay está instalado (Configuração → Pacotes instalados lista o REDA Pay).
- Você tem o conjunto de permissões REDA Pay - Admin User; consulte Quem pode fazer o quê. Os botões da guia Admin não fazem nada para outros usuários.
Por que a chave existe
A Payload identifica sua organização, cada conta de estabelecimento, cada cliente e cada cartão ou conta bancária salvos por um identificador. Se esses identificadores pudessem ser lidos por qualquer pessoa que abre um registro, alguém com acesso de leitura à sua organização poderia descobrir o suficiente para chamar a Payload em seu nome. Por isso o REDA Pay os armazena criptografados, e a única coisa capaz de descriptografá-los é a chave guardada na sua organização. A mesma chave protege sua chave de API da Payload, e é por isso que a chave de API deve ser informada pelo botão Update API Token em vez de digitada no campo: o botão a criptografa com esta chave.
A chave é criada uma vez e nunca é mostrada a ninguém. O REDA Pay a mantém em uma configuração protegida que só o próprio pacote consegue ler.
Gerar a chave
- Abra o Iniciador de aplicativos (a grade de nove pontos no canto superior esquerdo), procure REDA Pay e abra o aplicativo.
- Clique na guia REDA Pay Admin.
- No cartão Encryption Key Setup, leia a nota: "REDA Pay "Encryption Key" is must for REDA Pay App to function. If the "Encryption Key" is not generated, generate the key using following button." (a chave de criptografia é indispensável para o aplicativo funcionar; se ela não foi gerada, gere-a com o botão).
- Clique em Generate Key.
- O botão muda para Generated e fica acinzentado. Essa é a etapa inteira: não há nada para copiar, salvar ou informar em lugar nenhum.
Depois que a chave é gerada, o botão mostra "Generated". Nada mais muda neste cartão depois disso.
Se o botão já mostrar Generated quando você chegar, alguém já fez esta etapa e você pode seguir para Criar um Pay Profile.
O que você não pode fazer depois
- Você não pode gerar a chave uma segunda vez. O botão fica desativado quando existe uma chave. Tudo o que o REDA Pay criptografou depende dessa chave, então substituí-la deixaria ilegível cada segredo armazenado.
- Você não pode ver nem exportar a chave. Ela não aparece em nenhuma tela e não fica em nenhum campo que você consiga ler.
- Verifique cada organização separadamente. Depois de criar ou atualizar um sandbox, abra a guia REDA Pay Admin do sandbox antes de confiar no REDA Pay ali. Se o botão mostrar Generate Key, gere a chave nesse sandbox e depois configure lá um Pay Profile com uma chave de API do seu ambiente de teste.
O que a chave protege
| Criptografado com esta chave | Onde fica |
|---|---|
| O token de API da Payload | Pay Profile → API Token |
| O identificador da sua organização na Payload | Pay Profile → Profile Id |
| Os identificadores de cada conta de estabelecimento na Payload | Processing Account → Processing Account Id, Parent Id |
| O identificador de cada cliente na Payload | Pay Customer → Customer Id |
| O token que a Payload usa no lugar de cada cartão ou conta bancária salvos | Pay Method → Pay Method Id |
| O identificador da ordem dentro de cada link de pagamento | Pay Order → Encrypted Id, usado na Link URL |
| O identificador da conta de processamento em cada transação | Pay Transaction → Processing Id |
Quem lê esses registros vê texto criptografado. A chave em si fica em uma configuração protegida que só o próprio código do REDA Pay consegue ler; ela não aparece na Configuração, não pode ser consultada e não pode ser exportada.
O que dizer a um auditor
- Os segredos e os identificadores são criptografados em repouso com uma chave gerada dentro da organização e nunca exibida.
- Números de cartão, códigos de segurança e números de conta bancária nunca são armazenados; consulte Segurança e dados de cartão.
- A chave é criada uma vez por organização por um administrador com o conjunto de permissões REDA Pay - Admin User, e não pode ser gerada de novo, substituída nem exportada.
Verificar se funcionou
Abra a guia Pay Profiles e crie um Pay Profile como descrito em Criar um Pay Profile. Quando você pressionar Update API Token nele e salvar uma chave, o token será aceito e o campo API Token mostrará um valor criptografado. Se, em vez disso, aparecer "REDA Pay setting(s) are invalid or not defined. Please contact your system administrator.", a chave de criptografia está faltando: volte à guia Admin e gere-a.
Erros comuns a evitar
| Erro | O que você vê | Solução |
|---|---|---|
| Tentar usar o REDA Pay antes de gerar a chave | "REDA Pay setting(s) are invalid or not defined. Please contact your system administrator." em todas as telas | Gere a chave na guia REDA Pay Admin |
| Esperar uma chave para copiar ou baixar | Nada aparece depois de pressionar o botão | Nada deve aparecer. A chave fica dentro da organização |
| Supor que um sandbox atualizado está pronto | "REDA Pay setting(s) are invalid or not defined…" no sandbox | Abra a guia Admin do sandbox; gere a chave ali se o botão ainda mostrar Generate Key |
| Alguém que não é administrador pressionar Generate Key | O botão não faz nada ou informa um erro | Atribua o REDA Pay - Admin User e tente de novo |
Perguntas frequentes
Não. A chave de API da Payload é emitida pela Payload e identifica sua conta para eles. A chave de criptografia é criada pelo REDA Pay dentro da sua organização e serve apenas para proteger a chave de API da Payload e os outros identificadores enquanto estão armazenados no Salesforce. Você informa a chave de API da Payload na próxima etapa; nunca vê a chave de criptografia.
Não. Ela cria um valor dentro da sua organização do Salesforce, e nada sai da organização.
Verifique se você está na organização em que pensa estar: um sandbox e sua organização de produção têm cada um a própria chave. Se estiver na organização certa, escreva para support@reda.one com o nome da organização.
O que vem a seguir
- Criar um Pay Profile e armazenar sua chave de API da Payload: a próxima etapa.
- Roteiro de configuração: onde esta etapa se encaixa na configuração completa.