TOTVS CAROL - Carol Plataforma - Para que servem e como criar Connector Token (API Key) manualmente

Tempo aproximado para leitura: 00:05:00 min

Dúvida
Carol Plataforma - Para que servem e como criar Connector Token (API Key) manualmente?

Ambiente
TOTVS CAROL - Carol Plataforma - Todas as versões

Solução
Token é um código gerado pela Carol para autenticação na plataforma.

Além do processo convencional de autenticação do processo OAuth, é possível fazer a geração de um token persistente. Este token é chamado de "Connector Token", e o mesmo é utilizado principalmente em integração de processos sendo que é utilizado uma chave pública e uma chave privada.

Entre as diversas finalidades, alguns exemplos de utilização do "Connector Token" são:
1. Pode ser utilizados dentro do ERP (Protheus, RM, Datasul, etc) ou ferramenta customizada para consumir via API as marcações de ponto realizadas através do CLOCK IN: RH - Clock In by Carol - Connector Token.

2. Ele é gerado automaticamente quando criado uma nova conexão através da Carol Connect (2C), em nome do usuário utilizado para o Login, e necessário para ingestão de dados na Plataforma Carol, a sua revogação interrompe a conexão entre 2C e Plataforma Carol: Carol Connect (2C) - Manual do Usuário.

O "Connector Token" pode ser gerado manualmente, conforme detalhado a seguir:



Após acessar Tenant Admin, clique na aba "Tokens", a tela abaixo irá aparecer. Nesta tela podemos consultar todos os tokens disponíveis neste ambiente. Lembrando que não é possível ver o token gerado anteriormente, ele está disponível apenas logo após a criação, caso não tenha anotado deverá gerar um novo.



A criação de novos tokens ocorre pelo botão "Create token" (na tela acima). Na tela que será aberta, deverá ser selecionado o conector que será utilizado para criar o token, também é possível adicionar uma descrição para revisão futura deste token.



Ao término destes passos a tela abaixo será apresentada. Você deverá guardar as seguintes informações para utilizar nas requests à plataforma:



ConnectorID: 8097996e36404d45b43b0e8f96ddc250
Connector Token: 0741f34a100645db9a0700e7e7a2b524

Para mais detalhes técnicos sobre a utilização, revogação e diferença dos Tokens, por gentileza, verifique a documentação do time de produto Plataforma Carol - Autenticação.

Saiba Mais
CLIQUE AQUI para acessar mais artigos e FAQs do suporte relacionados a TOTVS Carol
CLIQUE AQUI para acessar a documentação técnica da TOTVS Carol no TDN
Plataforma Carol - Manual do Usuário