Configurar IPs confiáveis no site Cielo

A funcionalidade Gerenciar IPs confiáveis permite cadastrar e administrar os endereços IP autorizados a usar recursos da integração com a API E-commerce Cielo.

Por meio dessa funcionalidade, é possível adicionar e remover IPs e acompanhar o resultado das alterações realizadas.

ℹ️
Permissões necessárias
As configurações indicadas só podem ser realizadas por usuários com permissões de Administrador ou Analista.
Para gerenciar permissões de acesso, acesse Meu cadastro > Gestão de acessos.

Como acessar

No Site Cielo:

Selecione o estabelecimento (EC) desejado;
No menu superior, clique em E-commerce;
Acesse Gestão API E-commerce;
Clique em Configurações > Gerenciar IPs confiáveis.

Adicionar e remover IPs

Use o campo de cadastro para informar um ou mais endereços IP que deverão ser autorizados para utilização na integração.

Ao informar os endereços IP:

Utilize vírgulas para separar múltiplos endereços;
Endereços IP já cadastrados não serão adicionados novamente;
Endereços IP duplicados informados na mesma solicitação serão ignorados.

Após clicar em Adicionar, os endereços informados serão exibidos na lista de IPs adicionados.

Para remover um endereço da lista, clique no ícone X exibido ao lado do IP.

⚠️
Atenção

Recomenda-se manter até 30 IPs cadastrados;

Uma quantidade superior pode aumentar a latência dos processos transacionais;

IPs não cadastrados serão recusados, podendo impactar o funcionamento da integração.

Após concluir as alterações desejadas:

Clique em Salvar;
Conclua a autenticação da operação por meio do aplicativo Cielo Gestão.

Ao final do processamento, a plataforma apresenta o resultado das alterações realizadas para cada endereço IP informado.

Os seguintes status podem ser apresentados:

Ativo: o endereço IP foi validado com sucesso e está autorizado para utilização;
IP inválido: o endereço informado não atende às regras de validação e não foi cadastrado;
Excluído: o endereço IP foi removido da lista de IPs confiáveis.

Impacto de IPs não autorizados

Quando uma transação ou requisição for realizada por um endereço IP não autorizado, a comunicação poderá ser bloqueada.

Nesses casos, poderão ser retornados as seguintes mensagens:

HTTP 403 – Forbidden

A requisição foi realizada por um endereço IP que não está cadastrado na lista de IPs confiáveis.

Código de erro da API 301 – Request IP is not allowed

O recurso de restrição por IP está habilitado e o endereço informado não está autorizado para utilização.

Para regularizar o acesso, cadastre o IP na lista de IPs confiáveis ou solicite apoio da equipe responsável pela integração.

📘
Importante
Ao tentar realizar uma transação ou requisição utilizando um IP não autorizado, o acesso será bloqueado até que o endereço seja devidamente cadastrado e validado na lista de IPs confiáveis.

Histórico de ações

As ações relacionadas as configurações dos IPs confiáveis também ficam registradas no Histórico de ações da Gestão API E-commerce.

Para mais informações, consulte a página Histórico de ações.