Standardized hook - Retrieve PostURL

[Haioken]

Hi All,

I have a need to trigger post events to the iContact PostURL (WHM -> Basic WebHost Manager Setup -> Contact Information -> URLs of a system to which you want to send POST notifications) via a standardized hook.
As the contact manager does not have this capability, I've written a standardized hook to perform the curl request.

At the moment, I'm retrieving this from /etc/wwwacct.conf.shadow (CONTACTPOSTURL https://dev-api.<redacted>/postMsg).

Is this the correct place on the filesystem to retrieve this?
Is there a better way of doing this? How? (IE: A cpanel module I can include to retrieve this)

Kind Regards,

Hayden Katz

 

[cPanelMichael]

Hello @Haioken,

The following WHM API 1 function may help:

WHM API 1 Functions - verify_posturl_access - Developer Documentation - cPanel Documentation

Per it's description:

This function calls the WHM API 1 send_test_posturl function for your specified POST notification URLs. You can specify POST notification URLs in the Contact Information section of WHM's Basic WebHost Manager Setup interface ( WHM >> Home >> Server Configuration >> Basic WebHost Manager Setup) .

Let me know if this is what you are looking for.

Thank you.

 

[Haioken]

Hi @cPanelMichael,

Unfortunately, this isn't what I'm looking for. This function only tells me that the postURL is valid and responds OK.
I need to retrieve the PostURL from inside a standardized hook that I've attached to various functions (Such as Api2::SubDomain::addsubdomain) so that I send a post to it from within the standardized hook.

The idea is to send cPanel contact manager like post to url events for functions that are not supported by contact manager (Such as creation of sub/parked/addon domains, autossl notifications)

Is there a recommended way of retrieving the PostURL as stored in [ WHM -> Basic WebHost Manager® Setup -> Contact Information -> A comma-separated list of http:// or https:// URLs ... ] ?

 

[cPanelMichael]

Is there a recommended way of retrieving the PostURL as stored in [ WHM -> Basic WebHost Manager® Setup -> Contact Information -> A comma-separated list of http:// or https:// URLs ... ] ?

Hello @Haioken

I don't see a specific WHM API 1 function that will output the server's configured PostURL value. However, you should be able to review the contents of the following Perl module to get an idea of how you'd obtain this information in a script:

/usr/local/cpanel/Cpanel/iContact/Provider/Schema/Posturl.pm

Here's an additional document that may point you in the right direction:

How to Send Server Notifications to Custom Services - cPanel Knowledge Base - cPanel Documentation

documentation.cpanel.net

Let me know if this helps.

Thank you.