OpenSRS-PHP is a PHP-based client class that communicates with the TuCows OpenSRS Domain Name Registry System via an API.

I have just released version 2.8.1 with many long awaited fixes.

• Website

Enjoy!

Related posts:

1. Transfering domains from Godaddy.com to TuCows OpenSRS I need to transfer a bunch of domains from Godaddy...
2. How to setup Tucows OpenSRS OpensSRS is a domain reseller system offered by Tucows to...
3. An FTP client I have been looking for a decent FTP client for...
4. How to Minimize Microsoft Office Outlook to the System Tray Open your registry and find or create the key below....

I found that there were lots of articles on how to transfer to Godaddy, but not how to get out. This is a short guide on how to transfer away from Godaddy, in this case we will be transferring to OpenSRS.

This guide is appropriate for .com, .net, .org, .name domain names.

These are the steps you need to take:

• Go to: http://mya.godaddy.com/ and login.
  
• On the menu at the top, go to “Domains”, and on the drop-down menu click on “My Domain Names”.
• When the “Domain Control Center” loads, simply select the domain(s) you wish to transfer.
• Click on the lock button entitled “Locking”.
• When the “Locking” page loads, change the radio button from “Lock” to “Unlock” and press OK.
• You must then click on each domain, and where it says “Authorization Code:”, click on “Send by Email” (Note: It will send to the email address that Godaddy has on file for that domain, so ensure it is one you own and is working BEFORE you send out the request).
• Press OK on that page, this will send the authorization code email message to the administrative contact for the selected domain.

The email from Godaddy comes fairly quickly and should look like this:

The authorization information you requested is as follows:

Domain Name: EXAMPLE.COM

Authorization Info: [Authorization Code]

The next step requires you to log into your OpenSRS TuCows reseller account (however some people may wish to use their own API).

Note: You can’t do this step unless the domain is unlocked.

• Visit: https://rr-n1-tor.opensrs.net/resellers/ and login.
• Find the “Transfer a domain” box and enter the domain name there.
• Fill out the appropriate details and submit.
• You will receive an email with instructions, simply follow the instructions, it will ask for an auth code.

At this point if you log into OpenSRS it says: “Pending Registry Approval” and “Registry hasn’t transfered the domain yet” and if you log into Godaddy it says: “Transfer Away Accept/Decline Required”.

The email from OpenSRS Transfer [transfers@opensrs.org] will take some time to come through, be patient it does come eventually, usually within 1 hour, and it should appear something like this:

An English version of this message is contained below.

Attention: dns@example.net

Re: Transfer of example.com

The current registrar of record for this domain name is GoDaddy.com, Inc. (R91-LROR).

Tucows has received a request from Your Name

on Wed Jan 30 09:36:35 2008 for us to become the new registrar of record.

You have received this message because you are listed as the Registered Name Holder or Administrative contact for this domain name in the WHOIS database.
Please read the following important information about transferring your domain name:

* You must agree to enter into a new Registration Agreement with us. You can
review the full terms and conditions of the Agreement at

https://rr-n1-tor.opensrs.net/transfers/index.cgi?rid=12345&tld=.com&action=contract

* Once you have entered into the Agreement, the transfer will take place within
five (5) calendar days unless the current registrar of record denies the request.

* Once a transfer takes place, you will not be able to transfer to another registrar
for 60 days.
If you WISH TO PROCEED with the transfer, you must respond to this message as outlined below (note: if you do not respond by Mon Feb 4 09:36:35 2008, example.com will not be transferred to us.).

Please go to our website, https://rr-n1-tor.opensrs.net/transfers/index.cgi?rid=12345 to confirm.

You will need to enter the following information to log in and accept or decline the transfer:

Domain Name : example.com
Transfer Key: [Random Key]

If you DO NOT WANT the transfer to proceed, then don’t respond to this message.

If you have any questions about this process, please contact transfers@opensrs.org

Note: When following these instructions, you will need the “Authorization code” that was sent from Godaddy.

You should now receive an email with instructions telling you that now you have to accept the transfer via Godaddy.

• Go back to: http://mya.godaddy.com/ and login.
• Select “Pending Domain Transfers” from the list (on the right).
• Select the transfers you wish to accept from the “Pending Domain Transfers” list, and click “Accept.”

Note: Apparently you don’t need to “accept” the transfer with Godaddy now, instead it is assumed that you wish to transfer, and gives you the opportunity to cancel instead, details of which are included in the email you receive from Godaddy.

Update: Although you can just WAIT for the transfer to be actioned by Godaddy, it usually takes about 7 days, this is a long time, so here’s what to do:

• Go back to: http://mya.godaddy.com/ and login.
• Select ‘Domain Names’ from the ‘My Account’ menu.
• Select ‘Pending Transfers’ from the ‘Domains’ tab at the top of the page.
• Click the domain name in the list.
• Click ‘Accept’ to accept the transfer away of your domain.
• After confirming your intent, the domain registration will be transfered to your new Registrar.

What a ball ache! Got there in the end though!

Related posts:

1. How to setup Tucows OpenSRS OpensSRS is a domain reseller system offered by Tucows to...
2. PHP OpenSRS Client This is only a quick message to say that I...
3. Google AdSense won’t let me in! Back in 2004, I signed up my old site “hm2k.org”...
4. Safely Remove Hardware Icon Here’s a quick guide on what to do if your...

Although Tucows offers a very flexible system, there’s a serious lack of easy to follow documentation.

This document will explain how to get your tucows opensrs reseller account up and running with full access.

1. To begin with you will require an OpenSRS account, you can signup here.
2. You then need to review the contracts you want.
3. In this case we will be reviewing the Master TLD Contract.
4. Print this off, fill out the spaces on the contract, and don’t forget to sign it.
5. Fax it across to (416) 531-2516 or from the UK 1014165312516.
6. The next thing to do is to decide how you wish to make payments. In my case I will be using MasterCard, so do pay anything you have to fill out the Credit Card form and fax the details across to the same number.
7. You must pay $95 for the setup fee.
8. Don’t forget to update your website/terms and conditions with the TuCows contract terms.
9. Once you receive your username and password via email, you need to complete the access tests, which are a pain in themselves.

At this point you will be unable to log into the “Live System“, until you complete the full access test…

1. Log into the “Test System” using your username and password provided in the welcome email.
2. Once logged in you will see the administration page for the test system, which is an exact replica of the live system. For now, ignore this, and scroll to the bottom. You need to open the page entitled “Full Access Test Instructions“, and read the instructions, however vague they are.
3. As it says, you need to download and install the “OpenSRS Client Software“, but what you actually need is the “Reseller Client Library (RCL)“, download this.
4. Although the RCL manual can be found on the website, its not very clear what you need to do. Take a look at it anyway.
5. Once you have downloaded the RCL, extract it, and edit the “etc/OpenSRS.conf” file.
   1. Get the username from the welcome email, and enter inside the quotes on line 13…
   2. my $USERNAME = “yourusername”; # XXX insert username here
   3. Log back into the “Test System“, scroll to the bottom and find “Generate New Private Key“, follow the on-screen instructions and enter the private key provided on line 14…
   4. my $PRIVATE_KEY = “your_private_key “; # XXX insert DES key here
   5. Next set your admin email address on line 16…
   6. $ADMIN_EMAIL = ‘admin@example.com’;
   7. Next set the email address where renewals will be sent to on line 17…
   8. $RENEW_EMAIL = ‘domains@example.com’;
   9. For now on line 22, you must keep test server as 1 (this would be set to 0 if we were live)…
   10. $TEST_SERVER = 1;
   11. On line 28, configure the full path to where you intend on installing the client…
   12. $PATH_SOURCE = “<path_to_source>”; # e.g., “/home/username/opensrs”
   13. On line 49 to 55, you have the remote server config settings:
   14. REMOTE_PORT => 55000,
       REMOTE_HOST => “horizon.opensrs.net”,
       REMOTE_HTTPS_PORT => 55443,# OSRS IDN conversion server connection settings
       REMOTE_IDN_HOST => ‘horizon.opensrs.net’,
       REMOTE_IDN_PORT => 55044,
   15. If you are in test mode, these must remain the same, and you must make sure the server can use those external ports. If you are in live mode, the ports start with “52″, instead of “55″, and the hostname is “rr-n1-tor.opensrs.net”.
   16. On line 60, you must decide which connection type you want to use…
   17. connection_type => ‘CBC’, # CBC, HTTPS
   18. If you use CBC you also need to set the connection type on line 61 (try Blowfish)…
   19. crypt_type => ”, # Blowfish, DES, or Blowfish_PP (slow!). ONLY important
6. You MUST open EACH AND EVERY SINGLE .cgi file in the “cgi” directory, and change the “$path_to_config = ‘<path_to_conf_file>’;” to the correct path. You could probably get away with using ‘../etc’ as the path.
7. Upload all of the files to the directory you have decided on, and “chmod” all the “.cgi” files to “755″ so they are able to run.
8. If you have SSH access to your web server you can verify your install by running the “cgi/verify_install.cgi” using the perl command at console (NOT via a web browser).
9. Next you need to visit the true URL of the “reg_system.cgi” that you uploaded, and continue to follow the “Full Access Test Instructions“.
10. If this page appears to be blank, you need to speak to your web server admin and ask them to read the error log (sometimes located “/usr/local/apache/logs/error_log”), usually you will need to install a perl module such as Data::Structure::Util using cpan.
11. You may also require to “cpan install Unicode::String”.
12. If you get the “Ciphertext does not begin with a valid header for ’salt’ header mode” error, chances are you need to cpan update Crypt::CBC, and apply this fix. (Which is already already applied in the latest version)
13. [And well this is where I stopped because I'm still getting errors, and openSRS seem unable to help me]

If you are still having problems, read the OpenSRS FAQ.

So this is what I did, I contacted TuCows numerous times and they were unable to help me with this.

I was told by TuCows to downgrade my Crypt:CBC, I told them it wasn’t possible for me to do this.

I contacted TuCows again and insisted they allow me to bypass the Rite Test.

With this in mind, I decided to forget about the PERL solution and take a look at OpenSRS-PHP.

• I downloaded this, ensured I had the Crypt-CBC PEAR module installed and recompiled php with mcrypt.
• I extracted the files, read the README and uploaded them to the server.
• As I understand it, I required a private key from the test system and another from the live system.
• I loaded these private keys along with the username into the ‘openSRS.php’ and began investigating the ‘test.php’
• From my understanding ‘test.php’ looks up a domain to check if its available or not. With this in mind I needed to investigate other functions further.
• After reading the OpenSRS API specification (PDF) I was able to utilise commands to process domain names.

In Summery

After reading all that you are probably thinking what I’m thinking. “What a load of @#*$”. I could not agree more. TuCows OpenSRS is bloody awful to work with if you are new to it, it seems to have a serious lack of documentation on how to achieve things.

This article should help you with 2 things, firstly at least get you an account setup so you are able to manually manage domains. Secondly, it should offer you ways to interface with OpenSRS’s API.

Perhaps in the future I can provide you with some working examples, but that was not the objective of this article.

I hope this helps someone to have a less painful time with TuCows OpenSRS than me, and I invite anyone to discuss any issues I have mentioned here.

Related posts:

1. Transfering domains from Godaddy.com to TuCows OpenSRS I need to transfer a bunch of domains from Godaddy...
2. PHP OpenSRS Client This is only a quick message to say that I...
3. Gmail needs an API Yesterday I spent some time investigating Google Wave. A very...