upmind-automation / provision-provider-domain-names Goto Github PK

Internal ticket ref: TRG-872-47899

Need to investigate whether we can determine if there's a cost associated with restore (i.e., if restore endpoint is also used for redemption) and if not, then we can automatically do a restore prior to the renewal request if the domain has already expired.

Currently it's not possible to renew expired domains due to this issue.

Currently whois privacy is always enabled by default when registering new domain names.

This should instead be configurable via RegisterParams, and possibly supplemented with functions to enable/disable.

Domain Reseller

This issue exists to track the progress of domainAvailabilityCheck() implementations on each provider class.

Implementation progress:

• CoccaEpp
• ConnectReseller
• DomainNameApi
• Enom
• Hexonet
• LogicBoxes
• NameSilo
• Nominet
• OpenProvider
• OpenSRS
• UGRegistry

domainAvailabilityCheck() checks and returns the availability (to register/transfer) of a set of domain names, and whether or not they are premium domains

This issue exists to track the progress of poll() implementations on each provider class (also see #7).

Implementation progress:

• CoccaEpp
• ConnectReseller
• DomainNameApi
• Enom
• Hexonet
• LogicBoxes
• NameSilo
• Nominet
• OpenProvider
• OpenSRS
• UGRegistry

poll() returns up to the requested number of domain events, typically via EPP polling

Send/resend the registrant data verification email if possible to do so

https://api.ovh.com/console/#/domain

Synergy Wholesale is a big provider here in Australia, some of the best rates on .com.au as well as a large offering of TLD's - They bill in AU and are generally a go to provider here.

Docs are below, would be good to see them considered.

https://synergywholesale.com/wp-content/uploads/2022/11/Synergy-Wholesale-API-Documentation-v3-8.pdf

https://upmind.com/community/topic/615-synergy-wholesale-domain-provider/

https://realtimeregister.com/

https://www.101domain.com/

The goal here is to make renew() idempotent (prevent accidental double-renewing) by passing the desired expiry date of the domain from the billing system as the point of truth, so the provider will only renew the domain up to that date (perhaps with a +/- 3 month tolerance to prevent off-by-one style bugs).

From what I can determine, it seems the ConnectReseller API no longer accepts empty Company Name (Organisation). We will push a fix out so that when no Organisation is entered, we use the Name as CompanyName in the ConnectReseller API call.

hexonet/php-sdk is abandoned in favour of the above package which uses the CNIC\Hexonet namespace. It appears to be similar-ish so hopefully won't require too big a rewrite.

https://centralnicgroup-public.github.io/rtldev-middleware-documentation/docs/hexonet/sdks/php-sdk/

For some transfers, e.g., .com.au on hexonet, renew_years must be 0. Currently min validation is 1

This issue exists to track the progress of setAutoRenew() implementations on each provider class.

Implementation progress:

• CoccaEpp
• ConnectReseller
• DomainNameApi
• Enom
• Hexonet
• LogicBoxes
• NameSilo
• Nominet
• OpenProvider
• OpenSRS
• UGRegistry

setAutoRenew() toggles registry auto-renew on or off (when on, domain renews implicitly; when off, domain requires explicit renew())

Currently the transfer() function is expected to behave in the following way:

1. Check if the domain is already active in registrar account and return a successful result if so
2. Otherwise check if a transfer is already in-progress and return an error result if so
3. Otherwise initiate a new transfer and return an error result if so

To reduce the complexity and number of responsibilities of the transfer() function we should deprecate it in favour of new functions:

• initiateTransfer(TransferParams $params): InitiateTransferResult
  • Check if the domain is already active in the registrar account and return a successful result if so; transfer_status=complete and domain_info containing the domain result
  • Otherwise check if a transfer is already in-progress and return an error result if so
  • Otherwise initiate a new transfer (and validate EPP code if possible) and return a successful result if so; transfer_status=in_progress and include the transfer order id if applicable for that provider
• finishTransfer(FinishTransferParams $params): DomainResult
  • Check if the domain is already active in registrar account and return a successful result if so
  • Otherwise return an error informing of the current state of the transfer, if any

New param/result datasets:

• InitiateTransferResult
  • domain: [required, string]
  • transfer_status: [required, string, in:in_progress,complete]
  • transfer_order_id: [nullable]
  • domain_info: [required_if:transfer_status,complete, DomainResult::class]
• FinishTransferParams
  • sld: [required, alpha-dash]
  • tld: [required, alpha-dash-dot]
  • transfer_order_id: [nullable]

https://upmind.com/community/topic/439-20i-domains/#comment-1130

Include attributes.error from the response data, if available for these 465 INVALID DATA errors.

These are structured as:
<school-name>.<local-authority>.sch.uk

Currently that would mean each <local-authority>.sch.uk needs to be modelled as a TLD which in Upmind means a different product for each region (there could be hundreds).

It would be improved if admins could set the SLD to <school-name>.<local-authority> but currently all SLD validation uses the alpha-dash rule so periods are not allowed.

If we loosened SLD validation to alpha-dash-dot it would permit this use case. On the Upmind side would need to be careful to ensure the SLD provision field remains alpha-dash-dot for customers but allow more freedom to admins to be able to manage these orders manually.

Domain reseller

This is for providers such as RealtimeRegister which do not support spec-compliant EPP polling but offer a list API instead- so from the system client it would be good to store and then pass back the last notification id so that notifications can be traversed sequentially without any duplication.

https://docs.google.com/document/d/1f0owcJRu2pLn2da7ZkrrOQN4579JjAOergvj4H8xx0E/edit

Related: #6

sub_type

Initial use-case is for TYPE_DATA_QUALITY notifications where the valid sub-types should be:

• SUB_TYPE_DATA_QUALITY_NAME
• SUB_TYPE_DATA_QUALITY_ADDRESS
• SUB_TYPE_DATA_QUALITY_NAME_AND_ADDRESS

raw

Currently it's possible to return the raw message in extra but where the raw message is required by a consumer it would be better to formally define a raw property (mixed type i.e., may contain an XML string or an object or array etc)

https://netistrar.com/help/developers/ote/
https://netistrar.com/help/developers/

Internal: TPS-050-52915

Greek Registry

https://upmind.com/community/topic/565-manage-theft-protection-on-domain-in-connect-reseller/

https://www.pknic.net.pk/

ClientHold etc

It's possible for some domain names to not have an EPP/authcode, but there's an endpoint to reset it.

If no authcode is present in the API response during getEppCode(), we should perform the authcode reset API call and then attempt to load the authcode again.

https://support.openprovider.eu/hc/en-us/articles/360024780654-15-Domains-API-How-to-request-or-reset-an-authcode

from here: https://upmind.com/community/topic/817-add-support-for-namesilos-portfolio-feature/

Please consider adding support for the Portfolio feature in Namesilo's integration. The portfolio is a way to separate domain registration in their system.

With portfolio support we could have different providers setup in Upmind for the same Namesilo account and have each one to use different Portfolio.

You could allow us to set the Portfolio in the provisioning account configuration "admin/host/domain-names/registrars" and send it when registering a domain and other pertinent operations.

https://www.namesilo.com/api-reference#domains/register-domain

As you can se in their API reference, it's available to use.

Need to check if we are generating an authInfo code in the registration request, and whether the requirements are different for .xyz

https://www.auda.org.au/