Command Throttling in .NET EPP Client

 image

Bij de introductie van de EPP Interface heeft de SIDN besloten een “Acceptable Use Policy” te introduceren voor de EPP Interface.

Dit betekent dat u, als deelnemer van de SIDN, beperkt wordt in het aantal verzoeken dat u via de EPP Interface kunt doen naar de SIDN per tijdsinterval.

Volgens de “Acceptable Use Policy DRS5” worden deelnemers de volgende limieten opgelegd voor het opvragen van informatie via EPP;

  • CHECK-Commando’s: Maximaal 60 per 60 seconden en maximaal 60.000 per dag.
  • INFO-Commando’s: Maximaal 30 per 60 seconden, maximaal 5.000 plus het aantal door de deelnemer geregistreerde domeinnamen  per dag (naar beneden afgerond op een duizendtal) en met als bovengrens 100.000 per dag.
  • POLL-Commando’s: Maximaal 20 per 60 seconden en maximaal 5.000 per dag.

Als u meer verzoeken doet dan volgens de “Acceptable Use Policy” is toegestaan krijgt u de volgende EPP Melding;

Excessive querying; command not executed

Om te voorkomen dat u te veel verzoeken naar de registry stuurt, implementeert de .NET EPP Client nu “Command Throttling”.

Via “Command Throttling” beheerst u het aantal verzoeken dat u naar de registry doet binnen een bepaalde periode. De EPP Client houdt dit per type bericht (“CHECK”, “INFO” of “POLL”) bij.

U kunt “Command Throttling” aan zetten in de EPP Client door de methode “EnableThrottling(CommandType commandType, int maxCommands, int interval)” te gebruiken;

image

Via de methode “DisableThrottling(CommandType commandType)” wordt de throttling weer uitgeschakeld.

Indien “Command Throttling” actief wordt, wordt het versturen van het bericht vetraagd. De vertraging wordt bepaald door het aantal reeds gedane verzoeken in het afgelopen interval. Om de gebruiker van de EPP Client op de hoogte te stellen van deze wachttijd, is een nieuw event beschikbaar: “CommandThrottlingInEffectEvent”.

Dit event vertelt u voor welk commando-type de throttling is ingegaan, en hoe lang er gewacht wordt.

Let er bij het gebruik van “Command Throttling” wel op dat de EPP Client alleen zicht heeft op commando’s binnen hetzelfde object. Als u vanaf meerdere computers tegelijk de EPP Interface van de registry gebruikt, kan het alsnog zijn dat u teveel verzoeken naar de registry stuurt. Daarnaast houdt de EPP Client niet bij hoeveel verzoeken u gedurende de hele dag gedaan heeft. (Dit mede omdat het niet in de lijn van de verwachting ligt dat één enkel EppClient object een hele dag zal bestaan, geen historie kan worden opgevraagd en de EppClient niet weet hoeveel domeinnaam u geregistreerd heeft.)

U kunt de “Acceptable Use Policy DRS5” van de SIDN hier downloaden.

Wij hopen dat “Command Throttling” voor u een nuttige toevoeging is aan de .NET EPP Client.

Tags: , , , ,

Leave a Reply