https://github.com/getpinga/fossbilling-epp-fred

EPP Registrar Module for FOSSBilling (FRED Registry)
https://github.com/getpinga/fossbilling-epp-fred

billing epp epp-client epp-protocol fossbilling fossbilling-extensions fred

Last synced: 14 days ago
JSON representation

EPP Registrar Module for FOSSBilling (FRED Registry)

• Host: GitHub
• URL: https://github.com/getpinga/fossbilling-epp-fred
• Owner: getpinga
• License: mit
• Created: 2023-01-11T12:06:31.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-09-09T07:39:00.000Z (3 months ago)
• Last Synced: 2024-09-09T09:19:55.395Z (3 months ago)
• Topics: billing, epp, epp-client, epp-protocol, fossbilling, fossbilling-extensions, fred
• Language: PHP
• Homepage:
• Size: 111 KB
• Stars: 5
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Compatibility

This module is designed for use with FRED Registry (https://fred.nic.cz/en/).

# FOSSBilling Module Installation instructions

## 1. Download and Install FOSSBilling:

Start by downloading the latest version of FOSSBilling from the official website (https://fossbilling.org/). Follow the provided instructions to install it.

## 2. Installation and Configuration of Registrar Adapter:

First, download this repository which contains the fred.php file. After successfully downloading the repository, move the fred.php file into the `[FOSSBilling]/library/Registrar/Adapter` directory.

Next, rename `fred.php` as `YourRegistryName.php`. Please ensure to replace "**YourRegistryName**" with the actual name of your registry.

Proceed to open the newly renamed file and locate the phrase "**Registrar_Adapter_FRED**". Replace it with "**Registrar_Adapter_YourRegistryName**".

## 3. Addition of Synchronization Scripts:

There are two additional scripts in the repository: **fredSync.php** and **fredEpp.php**. These need to be placed in the main `[FOSSBilling]` directory.

Rename `fredSync.php` to `YourRegistryNameSync.php`.

Edit `fredSync.php` and replace **FRED** in the line `$registrar = "FRED";` with the name of your registry provided in step 2.

## 4. Setting Up the Cron Job:

You need to set up a cron job that runs the sync module twice a day. Open crontab using the command `crontab -e` in your terminal.

Add the following cron job:

`0 0,12 * * * php /var/www/html/YourRegistryNameSync.php`

This command schedules the synchronization script to run once every 12 hours (at midnight and noon).

## 5. Activate the Domain Registrar Module:

Within FOSSBilling, go to **System -> Domain Registration -> New Domain Registrar** and activate the new domain registrar.

## 6. Registrar Configuration:

Next, head to the "**Registrars**" tab. Here, you'll need to enter your specific configuration details, including the path to your SSL certificate and key.

## 7. Adding a New TLD:

Finally, add a new Top Level Domain (TLD) using your module from the "**New Top Level Domain**" tab. Make sure to configure all necessary details, such as pricing, within this tab.

# Troubleshooting

If you experience problems connecting to your EPP server, follow these steps:

1. Ensure your server's IP (IPv4 and IPv6) is whitelisted by the EPP server.

2. Confirm your client and server support IPv6 if required. If needed, disable IPv6 support in EPP server.

3. Reload the EPP module or restart the web server after any changes.

4. Ensure certificates have the correct permissions: `chown www-data:www-data cert.pem` and `chown www-data:www-data key.pem`.

5. Verify the EPP module is configured with the chosen registrar prefix.