joker.toml 2.3 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859
  1. Name = "Joker"
  2. Description = ''''''
  3. URL = "https://joker.com"
  4. Code = "joker"
  5. Since = "v2.6.0"
  6. Example = '''
  7. # SVC
  8. JOKER_API_MODE=SVC \
  9. JOKER_USERNAME=<your email> \
  10. JOKER_PASSWORD=<your password> \
  11. lego --email you@example.com --dns joker -d '*.example.com' -d example.com run
  12. # DMAPI
  13. JOKER_API_MODE=DMAPI \
  14. JOKER_USERNAME=<your email> \
  15. JOKER_PASSWORD=<your password> \
  16. lego --email you@example.com --dns joker -d '*.example.com' -d example.com run
  17. ## or
  18. JOKER_API_MODE=DMAPI \
  19. JOKER_API_KEY=<your API key> \
  20. lego --email you@example.com --dns joker -d '*.example.com' -d example.com run
  21. '''
  22. Additional = '''
  23. ## SVC mode
  24. In the SVC mode, username and passsword are not your email and account passwords, but those displayed in Joker.com domain dashboard when enabling Dynamic DNS.
  25. As per [Joker.com documentation](https://joker.com/faq/content/6/496/en/let_s-encrypt-support.html):
  26. > 1. please log in at Joker.com, visit 'My Domains',
  27. > find the domain you want to add Let's Encrypt certificate for, and chose "DNS" in the menu
  28. >
  29. > 2. on the top right, you will find the setting for 'Dynamic DNS'.
  30. > If not already active, please activate it.
  31. > It will not affect any other already existing DNS records of this domain.
  32. >
  33. > 3. please take a note of the credentials which are now shown as 'Dynamic DNS Authentication', consisting of a 'username' and a 'password'.
  34. >
  35. > 4. this is all you have to do here - and only once per domain.
  36. '''
  37. [Configuration]
  38. [Configuration.Credentials]
  39. JOKER_API_MODE = "'DMAPI' or 'SVC'. DMAPI is for resellers accounts. (Default: DMAPI)"
  40. JOKER_USERNAME = "Joker.com username"
  41. JOKER_PASSWORD = "Joker.com password"
  42. JOKER_API_KEY = "API key (only with DMAPI mode)"
  43. [Configuration.Additional]
  44. JOKER_POLLING_INTERVAL = "Time between DNS propagation check in seconds (Default: 2)"
  45. JOKER_PROPAGATION_TIMEOUT = "Maximum waiting time for DNS propagation in seconds (Default: 120)"
  46. JOKER_TTL = "The TTL of the TXT record used for the DNS challenge in seconds (Default: 120)"
  47. JOKER_HTTP_TIMEOUT = "API request timeout in seconds (Default: 60)"
  48. JOKER_SEQUENCE_INTERVAL = "Time between sequential requests in seconds (Default: 60), only with 'SVC' mode"
  49. [Links]
  50. API = "https://joker.com/faq/category/39/22-dmapi.html"
  51. API_SVC = "https://joker.com/faq/content/6/496/en/let_s-encrypt-support.html"