Skip to main content

Chaves de API

As chaves de API permitem que sistemas externos se autentiquem e interajam com o workspace via API REST. Cada chave pode ter escopo limitado de acesso, expiração programada e restrição por endereço IP.

Permissão necessária

Somente administradores do workspace têm acesso às chaves de API.

Criar uma chave de API

  1. Clique em Criar chave de API.
  2. Preencha as configurações da chave:

Nome

Identificação da chave. Use um nome descritivo que indique o sistema ou finalidade, como Integração ERP ou Sistema de Monitoramento.

Data de expiração

Define quando a chave deixará de funcionar. Deixe em branco para criar uma chave sem expiração.

IPs permitidos

Restringe o uso da chave a endereços IP específicos. Adicione um IP por vez — o campo aceita endereços separados por vírgula ou espaço.

Deixe em branco para permitir acesso de qualquer IP.

Permissões

Define quais robôs do workspace a chave pode acessar. Selecione os robôs individualmente ou deixe sem seleção para dar acesso a todos.

Período de rotação

Tempo em dias para expirar automaticamente e renovar a chave. Campo opcional.

  1. Clique em Criar.
caution

A chave gerada é exibida uma única vez após a criação. Copie e armazene em local seguro antes de fechar a janela — não é possível recuperá-la depois.

Editar uma chave de API

Clique no ícone de engrenagem ao lado da chave para editar nome, expiração, IPs e permissões. A chave em si não é alterada.

Excluir uma chave de API

Clique no ícone de lixeira ao lado da chave e confirme a exclusão.

Para excluir várias chaves ao mesmo tempo, selecione-as com o checkbox e use a ação em lote Excluir.

caution

Excluir uma chave revoga imediatamente o acesso de qualquer sistema que a utilize.