Documentation

When your account is created you are immediately taken to add your first Site.

The first thing we need is your Site URL. We add the https:// part for you, but if you are not interested in SSL certificate monitoring you can click and choose http:// instead. This way you can get basic uptime monitoring and a history of your endpoint’s uptime.

The Check Frequency tells us how often our monitor should check your site. This defaults to 5 minutes, but can be up to an hour in case you don’t want it checking as often. Premium subscribers can optionally reduce this to 1 minute.

You can keep adding sites by choosing “Add More”. Or you can skip this by choosing “Skip”.

The next step of the guided setup is to create your first Alert. You can do this by naming your Alert and adding one or more recipients. When you’re ready you can press “Continue” or you can skip this step by choosing “Skip”.

Finally, finish configuring your account by setting a Company Name and choosing your Time Zone. We’d also appreciate it if you told us how you heard of us. Thanks for choosing SSLDetect.com!

When your account was created you were sent a welcome email with a verification code. Until your account is verified you will see a banner at the top of the screen which shows that your address is not verified and that your account will be limited until it is verified. You can simply click “Verify” and then enter the code from the welcome email to verify your account. Thanks for choosing SSLDetect.com!

We have a few premium features that we charge $10 per month for.

• SMS/text messaging to the US & Canada (100 per month)
• Endpoint check frequency as low as 1 minute
• Increased Site/App limit to 200
• Increased User count to 10
• Domain expiration monitoring
• Priority support

Increased limits are available by ‘stacking’ the plan. Every additional increment of $10 monthly will increase limits by the following amounts:

• SMS/texts by 100
• Site/Apps by 200
• Users by 10

The Events panel shows a list of Events that have happened to your visible Sites/Apps. It is displayed in reverse chronological order and shows a simple description of each event. Click the name of each Site/App to be taken directly to its Details page.

From the Sites list, click the button in the top right that says “Add Site”. Here you can add a new Site by filling in the Site’s details:

Site name: This optional field is shown only to you, and lets you organize your Sites with custom names. If not entered it defaults to the domain name.

Site url: The url of the site for us to monitor. Defaults to https but can be changed to http by clicking on the https part at the start.

Alerts: Add Alerts by typing in their names here or choosing them from the list.

Check frequency: Defaults to 5 minutes; this is how often we check your endpoint. You can slow it down to as infrequently as 1 hour. Premium subscribers can increase the time to 1 minute.

Enabled: If this is switched off then the Site will be paused and monitoring/alerts will stop.

This screen contains detailed information about the Site and its history. There are three panels:

Site Details panel. This panel shows the following:

• Site Name. This is the name of the Site.
• Url. The url of the Site.
• Check Frequency. How often we check the Site.
• Alerts. This is a list of active Alerts for this Site. If there is more than one Alert, click on each Alert to see both recipients and which events are triggered.

Status panel. This panel shows 4 icons giving you a quick overview of the Site:

• Status. Current Status and how long it has been in this Status since last change.
• Response time. This shows the current response time of our most recent visit. Shows a yellow clock if it is over 500ms.
• SSL certificate. Shows current SSL status.
• SSL expiration. This shows how many days in the future the SSL certificate will expire in.

Events panel. This panel shows a detailed Site history with timestamps. It includes SSL certificate change history and downtime history.

Editing a Site uses a screen similar to adding a new Site. But to get to the edit screen you must first go to Site Details. From there you can click “Edit Site” to get to the Site Edit page. Here you can edit the Site by filling in the Site’s details:

Site name: This optional field is shown only to you, and lets you organize your Sites with custom names. If not entered it defaults to the domain name.

Site url: The url of the site for us to monitor. Defaults to https but can be changed to http by clicking on the https part at the start.

Alerts: Add alerts by typing in their names here or choosing them from the list.

Check frequency: Defaults to 5 minutes; this is how often we check your endpoint. You can slow it down to as infrequently as 1 hour. Premium subscribers can increase the time to 1 minute.

Enabled: If this is switched off then the Site will be paused and monitoring/alerts will stop.

Advanced settings
When editing Sites, there are additional customization options where are revealed when you click “Advanced settings”. The customizations are:

Retry count: Defaults to 0 but can be increased if you are receiving false positives due to intermittent packet loss or other networking issues. If this is above 0, then this is how many simultaneous checks must fail for the Site to be down. Please note that we always verify downtime from a second source before triggering Alerts.

HTTP request method: Defaults to HEAD. Can be changed to GET in case HEAD methods are problematic for some reason.

To delete a Site you simply need to go to the Site Edit page, described above in Editing a Site. Once you are there, and if you have the appropriate access level, you will see a Delete button at the bottom of the page.

Bulk editing is started from the Sites list. If you have the Admin role for the current company then the first column will be checkboxes which can be used to select each row. The top checkbox can be used to select/unselect all rows.

If one or more rows are selected then a “Modify” button will appear at the bottom of the list. Click to modify the selected Sites.

Bulk editing works by having you select a checkbox for each property you wish to set. If the checkbox is set then the value of all selected Sites will be set to the new value once you click “Process changes”. This may take a few minutes when editing large numbers of Sites.

From the Apps listing, click the button in the top right that says “Add App”. Here you can add a new App by filling in the App’s details:

App name: This optional field is shown only to you, and lets you organize your Apps with custom names.

Alerts: Add Alerts by typing in their names here or choosing them from the list.

Enabled: If this is switched off then the App will be paused and monitoring/alerts will stop.

To start using the App you will need to ping it. See the section below titled “App Ping API” for more information.

This screen contains detailed information about the App and its history. There are two information panels:

App Details panel. This panel shows the following:

• App Name. This is the name of the App.
• Alerts. This is a list of active Alerts for this App. If there is more than one Alert, click on each Alert to see both recipients and which events are triggered

Events panel. This panel shows a detailed App history with timestamps. It includes entries for each start and stop of the App.

Editing an App uses a screen similar to adding a new App. But to get to the edit screen you must first go to App Details. From there you can click “Edit App” to get to the App Edit page. Here you can edit the App by filling in the Apps’s details:

App name: This field is shown only to you, and lets you organize your Apps with custom names.

Auth Token: This is the Auth Token which is used when making requests to the ping API. This token identifies which app the request is for. The buttons next to the token let you copy it to the clipboard or regenerate it. Note that when regenerating the API token, the old token will no longer work for any requests. If you are looking for integration information see “App Ping API” below.

Alerts: Add alerts by typing in their names here or choosing them from the list.

Enabled: If this is switched off then the Site will be paused and monitoring/alerts will stop.

To delete an App you simply need to go to the App’s Edit page, described above in Editing an App. Once you are there, and if you have the appropriate access level, you will see a Delete button at the bottom of the page.

Bulk editing is started from the Apps list. If you have the Admin role for the current company then the first column will be checkboxes which can be used to select each row. The top checkbox can be used to select/unselect all rows.

If one or more rows are selected then a “Modify” button will appear at the bottom of the list. Click to modify the selected Sites.

Bulk editing works by having you select a checkbox for each property you wish to set. If the checkbox is set then the value of all selected Apps will be set to the new value once you click “Process changes”. This may take a few minutes when editing large numbers of Apps.

This is an example API request for the app with an Auth Token of 08f27744-a2f8-41b0-813d-6c1245dc8c61 and a ping time of 11 minutes:

GET https://ping.ssldetect.com/08f24477-a2f8-41b0-813d-6c1245dc8c61/11

The API simply returns an empty 200 (OK) response when it receives a ping with a valid App auth token.

From the Alerts list, click the button in the top right that says “Add Alert”. Here you can add a new Alert by filling in the Alert’s details:

Alert name: This field is shown only to you, and lets you organize your Alerts with custom names.

Site events: This lets you select which Site-related events this Alert will be triggered by.

App events: This lets you select which App-related events this Alert will be triggered by.

Recipients: Here you can add all of the recipients that should be notified when this Alert is triggered.

Editing an Alert uses a screen similar to adding a new Alert. You can get to the Alert Edit screen from the Alert List by clicking on the name of the Alert. You can then edit the Alert by filling in the Alert’s details:

Alert name: This field is shown only to you, and lets you organize your Alerts with custom names.

Site events: This lets you select which Site-related events this Alert will be triggered by.

App events: This lets you select which App-related events this Alert will be triggered by.

Recipients: Here you can edit the list of recipients that should be notified when this Alert is triggered.

To delete an Alert you simply need to go to the Alert Edit page, described above in Editing an Alert. Once you are there, and if you have the appropriate access level, you will see a Delete button at the bottom of the page.

Bulk editing is started from the Alerts list. If you have the Admin role for the current company then the first column will be checkboxes which can be used to select each row. The top checkbox can be used to select/unselect all rows.

If one or more rows are selected then a “Modify” button will appear at the bottom of the list. Click to modify the selected Alerts.

Bulk editing works by having you select a checkbox for each property you wish to set. If the checkbox is set then the value of all selected Alerts will be set to the new value once you click “Process changes”. This may take a few minutes when editing large numbers of Alerts.

To manage your Invitations and Users, start by clicking Settings at the top right and then choosing “Managed Companies” This brings you to the Managed Companies page.

On the Managed Companies page you can see a list of Companies to which you have been invited. This page displays each Company’s name, your assigned Role, and a list of Sites/Apps you have access to. Click on the Company name to see the invitation details.

On the details page you can see exactly which Sites/Apps you have access to, and once again the Company’s name and your User Role. You can choose to uncheck “Show on Dashboard” if you want to hide this company’s Sites/Apps from appearing on your Dashboard. You can also Delete the invitation if you no longer wish to have access to this Company.

Invited Users can have one of two roles:

• User. This provides read-only access to a Company’s Sites/Apps. A User in this role can view and manage their own Alerts on Company Sites/Apps, as well as see Site/App information on their dashboard.
• Admin. This provides write-access to a Company’s Sites, Apps, and Alerts. A User in this role can create, delete, or modify Sites, Apps, and Alerts on the company’s behalf. This role can also see Alerts belonging to other invited Users of the Company when they are attached to the Company’s Sites and Apps. If given access to All Sites or All Apps, this User can also change the default sort order of Sites and Apps on the main listing pages.

When running scripts stored on disk, always remember the principle of least privilege. Meaning that the user used for running scripts should be only allowed to access the scripts directory and have only the minimum required access to other system resources. It’s also important that no other users can modify the scripts. This way if another user account gets compromised it can’t modify the scripts that get executed automatically and run them under a different security context.