Proxy-seller

Autorisations

Updated:

Générer et gérer des identifiants uniques pour l'accès par proxy, pour chaque commande.

Comment ça marche ?

  1. Passer une commande

    POST /commande/fabrication

  2. generateAuth=Y

    Identifiants uniques émis

  3. Gérer via /auth

    Répertorier · mettre à jour · révoquer

Générer des identifiants d'authentification lors de la création d'une commande

Envoyer generateAuth=Y à /order/make pour générer des identifiants uniques associés à la valeur renvoyée orderNumber.

POST/fr-FR/order/make?generateAuth=Y

Enregistrez ces identifiants. Les identifiants générés avec generateAuth=Y ne figurent pas dans la liste établie par /proxy/list. Récupérez-les via la valeur renvoyée orderNumber.

Gérer les autorisations

Quatre opérations concernant les identifiants associés à un ordre de proxy.

GET/auth
Liste des autorisations
Quels identifiants/mots de passe ou quelles adresses IP figurant sur la liste blanche ont accès au système ?
Use when: auditing all data tied to a client email.
POST/auth
Créer une autorisation
Émettre des identifiants personnalisés ou générés aléatoirement à chaque nouvelle commande.
Use when: onboarding a team member or sub-user.
PATCH/auth/{id}
Autorisation de modification
Modifier les droits d'accès existants d'un utilisateur.
Use when: leak suspected or scope needs tightening.
DELETE/auth/{id}
Autorisation de suppression
Supprimez les autorisations qui ne sont plus nécessaires.
Use when: access period expires.

À lire également

GET/fr-FR/proxy/list - find the orderNumber
POST/fr-FR/order/make - place a new proxy order

FAQ

Une configuration classique : un seul jeu d'identifiants et de mots de passe, ainsi qu'un nombre limité d'adresses IP pour l'authentification.

login:mot de passe : scripts et clients mobiles avec adresse IP dynamique. Liste blanche d'adresses IP : serveurs disposant d'une adresse IP statique fixe. Les deux peuvent coexister dans la même commande — il s'agit d'enregistrements d'authentification distincts.

Les connexions commencent immédiatement à présenter des dysfonctionnements. Appelez change-authorization avec le nouveau ip pour mettre à jour l'enregistrement sans avoir à le recréer. Les connexions en cours sont interrompues en quelques secondes.

Uniquement pour cet ensemble d'identifiants. Les autres enregistrements d'authentification de la même commande continuent de fonctionner.

Oui. /auth/list rendements login et password en clair pour chaque autorisation liée au compte, ainsi que id, active et orderNumber. Pour les entrées de liste blanche d'adresses IP, le ip est également renvoyée. Il n'existe pas de point de terminaison « reveal » distinct : la liste constitue le mécanisme de récupération.

Si vous préférez faire pivoter plutôt que de restaurer, utilisez change-authorization pour définir un nouveau mot de passe.

Non — par défaut, les nouvelles commandes s'authentifient à l'aide des identifiants partagés de votre compte. Pour obtenir un identifiant unique, login:password lié à une commande spécifique, passer generateAuth=Y à /order/make (ou /prolong/make (lors des renouvellements). Sans cet indicateur, chaque commande réutilise la même paire par défaut.

Des identifiants uniques sont associés à la valeur renvoyée orderNumber et peuvent être récupérées ultérieurement via /auth/list. Si vous avez sauté generateAuth=Y et que vous souhaitez ajouter une paire supplémentaire à une commande existante, utilisez /auth/add de manière explicite.

Les adresses IPv4 et IPv6 individuelles sont prises en charge. La notation CIDR est pas pris en charge — indiquez les adresses dont vous avez besoin.

Les sessions TCP ouvertes sont interrompues en quelques secondes. Il n'y a pas de fermeture progressive ; considérez la suppression de l'authentification comme un « kill switch » immédiat.

On this page