From 00d259a047bcadfadc3a6177af2f809e4bd3320d Mon Sep 17 00:00:00 2001 From: Ross Stewart Date: Fri, 29 Aug 2025 16:05:06 +0100 Subject: [PATCH] - Added clarification on certificate options - Resolves #46 --- .vscode/settings.json | 1 + sphinx/index.rst | 16 ++++++++++++++++ 2 files changed, 17 insertions(+) diff --git a/.vscode/settings.json b/.vscode/settings.json index ddbd1a5..5616502 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -10,6 +10,7 @@ "Navi", "Navidrome", "Navisonic", + "ngrok", "quickstart", "randomise", "rosskouk", diff --git a/sphinx/index.rst b/sphinx/index.rst index 0fd2783..b4922c1 100644 --- a/sphinx/index.rst +++ b/sphinx/index.rst @@ -226,6 +226,19 @@ Creating the AskNavidrome Alexa Skill choose *My development endpoints has a certificate from a trusted certificate authority* - Click *Save Endpoints* + .. TIP:: There are three options to pick from when setting the SSL certificate type in the Amazon Developer portal. + To confirm that you are using the correct option browse to the URL of your AskNavidrome skill, you will see a message similar to *405 Method Not Allowed*, this is normal. + View the certificate in use by the skill in your browser and look at the **Common Name (CN)** field. If this contains a **\*** for example **\*.ngrok-free.app** then you + are using a wildcard certificate. If the common name does not contain a **\*** then you have a regular certificate. + + - My development endpoint is a sub-domain of a domain that has a wildcard certificate from a certificate authority + - Use this if your skill uses a wildcard certificate with a **\*** + - My development endpoint has a certificate from a trusted certificate authority + - Use this if you have a regular certificate + - I will upload a self-signed certificate in X509 format + - Do not select this option unless you know what you are doing. + + #. Build the skill .. image:: resources/create_skill_7.png @@ -379,6 +392,9 @@ You can play music on multiple devices, by following these steps: Troubleshooting *************** +General +------- + Troubleshooting and debugging Alexa skills can be a little frustrating, here are the best ways I have found to do it. #. Understand that the Alexa skill is effectively just a set of buttons.