Skip to content

Azure Function app that interacts with Hudu API to provide Certificate monitoring

License

Notifications You must be signed in to change notification settings

JohnDuprey/HuduCertificateBot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HuduCertificateBot - SSL Certificate Monitoring

This is an Azure function app created to improve SSL monitoring for Hudu and add expirations for certificates not tied to websites. This is in response to the following feature request: https://hudu.canny.io/feature-requests/p/security-certificate-tracking

Features

  • Creates 'SSL Certificate' Asset Layout
  • Monitors assets for changes to the Certificate field and populates other certificate properties
  • PSA Integration: Create tickets for Native/Custom SSL Certificates and Domains
    • Supported PSAs
      • ConnectWise Manage

PSA Config Properties

  • Generic Properties
    • HuduDomainExclusionlist - Comma separated list of website names to match and skip ticket creation
    • HuduPSAIntegration - Set this to the matching integration name in Hudu (e.g. cw_manage), this enables ticketing for expirations
    • PSATicketAdditionalNotes - Notes to append ticket initial description
  • ConnectWise Manage
    • CWM_Server - Server hostname for cw manage
    • CWM_CompanyID - Company ID (from logon screen)
    • CWM_PublicKey - API Credential public key
    • CWM_PrivateKey - API Credential private key
    • CWM_ClientID - Client ID from CW Developer site
    • CWM_ServiceBoard - Service board name
    • CWM_NewStatus - New service ticket status
    • CWM_ResolvedStatus - Resolved service ticket status
    • CWM_ServiceType - (Optional) Type to apply to service ticket
    • CWM_ServiceSubType - (Optional) Sub-type to apply to service ticket

Requirements

  • Azure subscription and function app
  • Hudu hostname and API key

Installation

  1. Generate a Hudu API key https://yourhuduserver/admin/api_keys
  2. Fork this repository
  3. Deploy the Azure Function App to your environment
    • Deploy to Azure
  4. Fill in the details of the deployment template with the appropriate API keys.
  5. Disconnect and reconnect GitHub to enable Run from Package mode
  6. Create a new SSL Certificate asset and populate the Certificate field with the Base64 contents.
  7. The function app runs every 30 minutes looking for modified assets.

Copyright

This project utilizes some of the helper functions and approaches written by Kelvin Tegelaar from the CIPP project https://github.com/KelvinTegelaar/CIPP and is licensed under the same terms.

About

Azure Function app that interacts with Hudu API to provide Certificate monitoring

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published