Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents


FreePBX offers the ability for modules to be signed by a developer to ensure integrity of the module, and allow automatic detection of tampering. Module signing does not certify any quality, merchantability, or fitness for purpose.


Module signing is based on a hash of all files in a module, which is stored in the file module.sig, which is then clear-text signed by gpg.  As part of module loading the signature of the file is validated, and then the hash of all the files are verified. If the module.sig has been altered, or the file hashes don't match, a security alert is triggered.

Requesting a Key




be signed

Anyone may request their key to be signed by the FreePBX Master Key.   The current list of requirements (apart from all , excluding the Indemnification that needs to go into clauses that are in the Key Signing Agreement ) is going to be along the lines of:are below

  • Modules must be Open Source (GPL compatible via
  • There will be no financial cost to get your key signed by FreePBXThere is no limit to the number of modules you can sign with your own key (this includes re-signing a Schmooze or FreePBX module with your own changes, as long as you're abiding by the Open Source licence)
  • Signing your own commercial module will not be supported at the moment, because as soon as there's a financial agreement in place, a pile of other new and interesting laws apply. We'll cross that bridge when we come to it, but it's going to be annoyingly difficult.

Note that there is no financial cost to you of having your key signed. We do however reserve the right to charge for key signing if, in our opinion, it is needed.

Key Revocation

FreePBX has the ability to revoke your keys signature. If your keys signature is revoked, all modules signed by that key will be disabled and will not be able to be used. We hope to never have to use this, but it's there to be able to block a module with a significant security vulnerability. We believe that this will be rarely used, if ever, but some of the reasons that it may be used could be (but aren't limited to)

  • Your key is compromised
  • Your key signed a malicious module
  • Your key signed a module with a security vulnerability that is being actively attacked and you're not responding to the issue
  • You have developed and/or are utlizing a module with FreePBX for which you are directly or indirectly generating revenue or commercial advantage and you have not entered into a commercial agreement with Sangoma that protects its commercial interests and its intellectual property
  • .. for any other reason we deem at the time.

That is, of course, a non-exhaustive list, but we're trying to abide by the Don't-Be-Evil mantra, and I would expect that we would always err on the side of caution.  Saying that, as signing a new key isn't a major projectis a trivial exercise, if a key is revoked for whatever reason, unless the owner of the key is actively being evil, we would probably work with the key owner to get their modules re-signed with their new key.


This is all written around the GPG/PGP Web Of Trust which was first discussed in 1992 by Phil Zimmerman, and has been embraced by almost every other Open Source project – for example, dpkg and rpms are both signed in exactly the same way.

How do I get my GPG Key Signed by FreePBX

Follow the instructions on Requesting a Key to be Signed and email the executed agreement back to


Children Display