Comece aqui · Autenticação

Duas formas de autenticação: senha ou IP autorizado.

Ambos os métodos funcionam em todas as redes e em ambos os protocolos. Escolha por servidor e misture-os livremente.

3 minutos de leitura 7 seções Atualizado 26 de setembro de 2026

Escolhendo um método#

	Nome de usuário e senha	Lista de permissões de IP
Funciona de	Qualquer IP, inclusive dinâmico e em nuvem	Os endereços IPv4 públicos que você registrou
Parâmetros de segmentação	Anexado ao nome de usuário	Envie qualquer nome de usuário para passá-los; a senha é ignorada
Credenciais em trânsito	Base64 no `Proxy-Authorization` cabeçalho	Nenhum
Melhor para	Laptops, contêineres, sem servidor, navegadores	Servidores corrigidos, navegadores antidetecção que não conseguem armazenar uma senha, sinalizadores do Chrome
Rotação	Regenere a senha a qualquer momento	Adicione ou remova endereços a qualquer momento

Nome de usuário e senha#

Sua conta possui um par de credenciais para os gateways compartilhados. É mostrado no painel em Credenciais e devolvido por GET /v1/credentials. O nome de usuário carrega o parâmetros de segmentação; a senha nunca muda com eles.

curvatura

# HTTP(S) target through the residential gateway
curl -x http://USER-cc-us:PASS@res.proxy-cyber.com:9000 https://api.ipify.org

# Same thing over SOCKS5 (socks5h = resolve the hostname at the exit)
curl --proxy socks5h://USER-cc-us:PASS@res.proxy-cyber.com:9001 https://api.ipify.org

Nos bastidores, um cliente HTTP envia Proxy-Authorization: Basic base64(username:password) a pedido ou no CONNECT; um cliente SOCKS5 usa a subnegociação de nome de usuário/senha (RFC 1929). Todo cliente principal faz isso para você quando as credenciais estão na URL do proxy.

Lista de permissões de IP#

Registre os endereços IPv4 públicos das máquinas que se conectarão e elas poderão usar todos os endpoints sem credenciais. Até 50 endereços por conta; as alterações serão aplicadas dentro de um minuto.

Encontre o endereço que o alvo verá em seu servidor: curl https://api.ipify.org sem um proxy.
Adicione-o abaixo Configurações → Lista de permissõesou ligue POST /v1/whitelist.
Conecte-se sem nome de usuário e senha. Sem nome de usuário, a saída é escolhida mundialmente e alterna em todas as conexões.
Para direcionar, continue enviando um nome de usuário com os parâmetros necessários e qualquer senha: um endereço na lista de permissões é confiável, independentemente da senha.

curvatura

# From a whitelisted server: no credentials at all
curl -x http://res.proxy-cyber.com:9000 https://api.ipify.org

# Still whitelisted, but with targeting: any password works
curl -x http://USER-cc-fr-city-paris:x@res.proxy-cyber.com:9000 https://api.ipify.org

ISP dedicado, datacenter e dispositivos móveis#

Cada endereço dedicado vem com seu próprio nome de usuário e senha, impressos em sua lista como ip:port:user:pass. A lista de permissões também se aplica a eles: de um servidor registrado ao qual você se conecta ip:8000 sem nenhuma credencial. Os parâmetros não são necessários em um endereço dedicado, pois sua localização é fixa.

Entrada de lista de exemplo

203.0.113.42:8000:u7f3a9c:kq2Lm8Pz1r        # HTTP(S)
203.0.113.42:8001:u7f3a9c:kq2Lm8Pz1r        # SOCKS5, same credentials

Subusuários#

Um subusuário é um par de credenciais extra nos gateways compartilhados com seu próprio limite de tráfego e sua própria linha de uso. Crie uma por cliente, por projeto ou por colega de equipe para que uma senha vazada exponha apenas um orçamento limitado e você possa ler o consumo por linha de negócios. Os subusuários são gerenciados no painel e por meio de POST /v1/subusers.

Girando uma senha#

Regenerar a partir do painel ou com POST /v1/credentials/rotate. O par anterior continua trabalhando por dez minutos para que os trabalhos em execução possam pegar o novo sem falhar.

Manter as credenciais fora dos lugares errados#

Leia-os em variáveis de ambiente ou em um armazenamento secreto, nunca no controle de origem.
Prefira a lista de permissões em redes compartilhadas ou não confiáveis: o salto de você para o gateway é HTTP simples, portanto, um cabeçalho Básico pode ser lido no caminho.
Dê a cada ferramenta um subusuário; revogar o subusuário em vez da senha da conta quando uma ferramenta for descontinuada.
Retire URLs de proxy dos registros. A maioria dos clientes imprime o URL completo, incluindo credenciais, em caso de erros.

Proxies

Menu