Proxy-seller

Autorizações

Atualizado:

Gerar e gerenciar credenciais exclusivas para acesso por proxy, por pedido.

Como funciona

  1. Fazer pedido

    POST /order/make

  2. generateAuth=Y

    Credenciais únicas emitidas

  3. Gerenciar em /auth

    Listar · atualizar · revogar

Gerar autenticação na criação do pedido

Enviar generateAuth=Y para /order/make para emitir credenciais exclusivas vinculadas ao valor retornado orderNumber.

POST/pt-BR/order/make?generateAuth=Y

Salve essas credenciais. As autorizações geradas com generateAuth=Y não estão listados por /proxy/list. Recupere-os por meio do valor retornado orderNumber.

Gerenciar autorizações

Quatro operações relacionadas às credenciais vinculadas a uma ordem de proxy.

GET/auth
Listar autorizações
Quais pares de nome de usuário/senha ou quais IPs da lista de permissões têm acesso.
Use when: auditing all data tied to a client email.
POST/auth
Criar autorização
Emitir credenciais personalizadas ou aleatórias para cada novo pedido.
Use when: onboarding a team member or sub-user.
PATCH/auth/{id}
Autorização de alteração
Modificar os direitos de acesso existentes de um usuário.
Use when: leak suspected or scope needs tightening.
DELETE/auth/{id}
Autorização de exclusão
Remova as permissões que não são mais necessárias.
Use when: access period expires.

Relacionado

GET/pt-BR/proxy/list - find the orderNumber
POST/pt-BR/order/make - place a new proxy order

Perguntas frequentes

Uma configuração típica: um conjunto de nomes de usuário e senhas e um número limitado de endereços IP para autorização.

login:senha: scripts e clientes móveis com IP dinâmico. Lista de IPs autorizados: servidores com IP estático estável. Ambos podem coexistir na mesma ordem — são registros de autenticação distintos.

As conexões começam a falhar imediatamente. Ligue para change-authorization com o novo ip para atualizar o registro sem precisar recriá-lo. As conexões em andamento são encerradas em questão de segundos.

Apenas para esse conjunto de credenciais. Outros registros de autenticação na mesma ordem continuam funcionando.

Sim. /auth/list retornos login e password em texto simples para cada autorização na conta, juntamente com id, active e orderNumber. Para registros de lista de endereços IP autorizados, o ip também é retornado. Não há um endpoint “reveal” separado — a listagem é o mecanismo de recuperação.

Se você preferir girar em vez de recuperar, use change-authorization para definir uma nova senha.

Não — por padrão, os novos pedidos são autenticados com as credenciais compartilhadas no nível da conta. Para obter um login:password vinculado a um pedido específico, passar generateAuth=Y para /order/make (ou /prolong/make (em renovações). Sem essa opção, todos os pedidos reutilizam o mesmo par padrão.

As credenciais exclusivas estão vinculadas ao valor retornado orderNumber e pode ser recuperado posteriormente por meio de /auth/list. Se você pulou generateAuth=Y e quiser adicionar um par exclusivo a um pedido já existente, use /auth/add explicitamente.

São suportados endereços IPv4 e IPv6 únicos. A notação CIDR é não suportado — liste os endereços de que você precisa.

As sessões TCP abertas são encerradas em questão de segundos. Não há um encerramento gradual; considere a exclusão da autenticação como um mecanismo de desligamento imediato.

On this page

Autorizações | Proxy-seller