diff --git a/module-badge-maker.html b/module-badge-maker.html
index 1aa9de0183..7bf9cd817d 100644
--- a/module-badge-maker.html
+++ b/module-badge-maker.html
@@ -423,13 +423,13 @@
diff --git a/module-badge-maker_lib_xml-ElementList.html b/module-badge-maker_lib_xml-ElementList.html
index 7760661576..0fae21f3cc 100644
--- a/module-badge-maker_lib_xml-ElementList.html
+++ b/module-badge-maker_lib_xml-ElementList.html
@@ -157,13 +157,13 @@ like an XmlElement but renders multiple XML tags (not wrapped in a ).
diff --git a/module-badge-maker_lib_xml-XmlElement.html b/module-badge-maker_lib_xml-XmlElement.html
index d8d5221119..99d4ae2e37 100644
--- a/module-badge-maker_lib_xml-XmlElement.html
+++ b/module-badge-maker_lib_xml-XmlElement.html
@@ -468,13 +468,13 @@ element will be rendered as a self-closing element.
diff --git a/module-badge-maker_lib_xml.html b/module-badge-maker_lib_xml.html
index 92da38677c..1a89238f93 100644
--- a/module-badge-maker_lib_xml.html
+++ b/module-badge-maker_lib_xml.html
@@ -122,13 +122,13 @@
diff --git a/module-core_base-service_base-BaseService.html b/module-core_base-service_base-BaseService.html
index eb98f4aad0..0742a8c708 100644
--- a/module-core_base-service_base-BaseService.html
+++ b/module-core_base-service_base-BaseService.html
@@ -739,13 +739,13 @@ defined in this.route.pattern or this.route.capture
diff --git a/module-core_base-service_base-graphql-BaseGraphqlService.html b/module-core_base-service_base-graphql-BaseGraphqlService.html
index 4e79c3f6c3..97834d849f 100644
--- a/module-core_base-service_base-graphql-BaseGraphqlService.html
+++ b/module-core_base-service_base-graphql-BaseGraphqlService.html
@@ -823,13 +823,13 @@ an InvalidResponse.
diff --git a/module-core_base-service_base-graphql.html b/module-core_base-service_base-graphql.html
index 187db5e487..ba8ee843ba 100644
--- a/module-core_base-service_base-graphql.html
+++ b/module-core_base-service_base-graphql.html
@@ -119,13 +119,13 @@
diff --git a/module-core_base-service_base-json-BaseJsonService.html b/module-core_base-service_base-json-BaseJsonService.html
index ee16d2a357..1ae661cc86 100644
--- a/module-core_base-service_base-json-BaseJsonService.html
+++ b/module-core_base-service_base-json-BaseJsonService.html
@@ -668,13 +668,13 @@ This can be used to extend or override the
diff --git a/module-core_base-service_base-json.html b/module-core_base-service_base-json.html
index ebef38bc7c..e6f63cda4d 100644
--- a/module-core_base-service_base-json.html
+++ b/module-core_base-service_base-json.html
@@ -119,13 +119,13 @@
diff --git a/module-core_base-service_base-svg-scraping-BaseSvgScrapingService.html b/module-core_base-service_base-svg-scraping-BaseSvgScrapingService.html
index 04b5c99620..a7b15034e0 100644
--- a/module-core_base-service_base-svg-scraping-BaseSvgScrapingService.html
+++ b/module-core_base-service_base-svg-scraping-BaseSvgScrapingService.html
@@ -759,13 +759,13 @@ This can be used to extend or override the
diff --git a/module-core_base-service_base-svg-scraping.html b/module-core_base-service_base-svg-scraping.html
index adf4969a48..b7b6e20b1c 100644
--- a/module-core_base-service_base-svg-scraping.html
+++ b/module-core_base-service_base-svg-scraping.html
@@ -119,13 +119,13 @@
diff --git a/module-core_base-service_base-xml-BaseXmlService.html b/module-core_base-service_base-xml-BaseXmlService.html
index c421454cf3..688eb406f6 100644
--- a/module-core_base-service_base-xml-BaseXmlService.html
+++ b/module-core_base-service_base-xml-BaseXmlService.html
@@ -551,13 +551,13 @@ This can be used to extend or override the
diff --git a/module-core_base-service_base-xml.html b/module-core_base-service_base-xml.html
index f3656088eb..12ac4c7974 100644
--- a/module-core_base-service_base-xml.html
+++ b/module-core_base-service_base-xml.html
@@ -119,13 +119,13 @@
diff --git a/module-core_base-service_base-yaml-BaseYamlService.html b/module-core_base-service_base-yaml-BaseYamlService.html
index 273066bde1..dfd21daf23 100644
--- a/module-core_base-service_base-yaml-BaseYamlService.html
+++ b/module-core_base-service_base-yaml-BaseYamlService.html
@@ -548,13 +548,13 @@ This can be used to extend or override the
diff --git a/module-core_base-service_base-yaml.html b/module-core_base-service_base-yaml.html
index ec921c454a..f8b53ab9ec 100644
--- a/module-core_base-service_base-yaml.html
+++ b/module-core_base-service_base-yaml.html
@@ -119,13 +119,13 @@
diff --git a/module-core_base-service_base.html b/module-core_base-service_base.html
index 0f31d6f88b..018fd475c1 100644
--- a/module-core_base-service_base.html
+++ b/module-core_base-service_base.html
@@ -1202,13 +1202,13 @@ when the parameter is absent. (Note that in,
diff --git a/module-core_base-service_errors-Deprecated.html b/module-core_base-service_errors-Deprecated.html
index 505b47cfcd..8f9387c44f 100644
--- a/module-core_base-service_errors-Deprecated.html
+++ b/module-core_base-service_errors-Deprecated.html
@@ -205,13 +205,13 @@
diff --git a/module-core_base-service_errors-ImproperlyConfigured.html b/module-core_base-service_errors-ImproperlyConfigured.html
index 913ffbd67f..4ac91314cf 100644
--- a/module-core_base-service_errors-ImproperlyConfigured.html
+++ b/module-core_base-service_errors-ImproperlyConfigured.html
@@ -205,13 +205,13 @@
diff --git a/module-core_base-service_errors-Inaccessible.html b/module-core_base-service_errors-Inaccessible.html
index f21589bc46..2d99847349 100644
--- a/module-core_base-service_errors-Inaccessible.html
+++ b/module-core_base-service_errors-Inaccessible.html
@@ -206,13 +206,13 @@ or to wrap a 5XX response
diff --git a/module-core_base-service_errors-InvalidParameter.html b/module-core_base-service_errors-InvalidParameter.html
index b8618180f5..8fea640092 100644
--- a/module-core_base-service_errors-InvalidParameter.html
+++ b/module-core_base-service_errors-InvalidParameter.html
@@ -206,13 +206,13 @@ is invalid or unexpected
diff --git a/module-core_base-service_errors-InvalidResponse.html b/module-core_base-service_errors-InvalidResponse.html
index a4e3e424f4..3424d281c6 100644
--- a/module-core_base-service_errors-InvalidResponse.html
+++ b/module-core_base-service_errors-InvalidResponse.html
@@ -205,13 +205,13 @@
diff --git a/module-core_base-service_errors-NotFound.html b/module-core_base-service_errors-NotFound.html
index 34807b1850..be2f8ecef3 100644
--- a/module-core_base-service_errors-NotFound.html
+++ b/module-core_base-service_errors-NotFound.html
@@ -205,13 +205,13 @@
diff --git a/module-core_base-service_errors-ShieldsRuntimeError.html b/module-core_base-service_errors-ShieldsRuntimeError.html
index ee381c3b09..974cc492a6 100644
--- a/module-core_base-service_errors-ShieldsRuntimeError.html
+++ b/module-core_base-service_errors-ShieldsRuntimeError.html
@@ -378,13 +378,13 @@ should override this method.
diff --git a/module-core_base-service_errors.html b/module-core_base-service_errors.html
index 07e6ab3315..144489fc8c 100644
--- a/module-core_base-service_errors.html
+++ b/module-core_base-service_errors.html
@@ -312,13 +312,13 @@ badge when we catch and render the exception (Optional)
diff --git a/module-core_base-service_graphql.html b/module-core_base-service_graphql.html
index 573b921e2c..1892994828 100644
--- a/module-core_base-service_graphql.html
+++ b/module-core_base-service_graphql.html
@@ -290,13 +290,13 @@ but can't use that due to incorrect packaging.
diff --git a/module-core_base-service_resource-cache.html b/module-core_base-service_resource-cache.html
index ee77dad467..ff233ba1a3 100644
--- a/module-core_base-service_resource-cache.html
+++ b/module-core_base-service_resource-cache.html
@@ -531,13 +531,13 @@
diff --git a/module-core_server_server-Server.html b/module-core_server_server-Server.html
index 6e50452113..4256bf3919 100644
--- a/module-core_server_server-Server.html
+++ b/module-core_server_server-Server.html
@@ -675,13 +675,13 @@ Start listening for requests on this.baseUrl()
diff --git a/module-core_server_server.html b/module-core_server_server.html
index 8db96645bf..a938a7872d 100644
--- a/module-core_server_server.html
+++ b/module-core_server_server.html
@@ -119,13 +119,13 @@
diff --git a/module-core_service-test-runner_create-service-tester.html b/module-core_service-test-runner_create-service-tester.html
index 220fd222f4..9d149b526b 100644
--- a/module-core_service-test-runner_create-service-tester.html
+++ b/module-core_service-test-runner_create-service-tester.html
@@ -230,13 +230,13 @@ service.
diff --git a/module-core_service-test-runner_icedfrisby-shields.html b/module-core_service-test-runner_icedfrisby-shields.html
index d7a6bc4e67..1756764719 100644
--- a/module-core_service-test-runner_icedfrisby-shields.html
+++ b/module-core_service-test-runner_icedfrisby-shields.html
@@ -286,13 +286,13 @@
diff --git a/module-core_service-test-runner_infer-pull-request.html b/module-core_service-test-runner_infer-pull-request.html
index ff19b3b116..c1f1c333ff 100644
--- a/module-core_service-test-runner_infer-pull-request.html
+++ b/module-core_service-test-runner_infer-pull-request.html
@@ -506,13 +506,13 @@ of a pull request from the environment variables.
diff --git a/module-core_service-test-runner_runner-Runner.html b/module-core_service-test-runner_runner-Runner.html
index 81603e7505..c7171fbd4d 100644
--- a/module-core_service-test-runner_runner-Runner.html
+++ b/module-core_service-test-runner_runner-Runner.html
@@ -562,13 +562,13 @@ overridden on instances.
diff --git a/module-core_service-test-runner_runner.html b/module-core_service-test-runner_runner.html
index 8ca97212e0..7cc6953529 100644
--- a/module-core_service-test-runner_runner.html
+++ b/module-core_service-test-runner_runner.html
@@ -119,13 +119,13 @@
diff --git a/module-core_service-test-runner_service-tester-ServiceTester.html b/module-core_service-test-runner_service-tester-ServiceTester.html
index f953b8a434..7768c5d206 100644
--- a/module-core_service-test-runner_service-tester-ServiceTester.html
+++ b/module-core_service-test-runner_service-tester-ServiceTester.html
@@ -1120,13 +1120,13 @@ the CLI, or directly on the tester.
diff --git a/module-core_service-test-runner_service-tester.html b/module-core_service-test-runner_service-tester.html
index 987943c4d6..fd59e9c84e 100644
--- a/module-core_service-test-runner_service-tester.html
+++ b/module-core_service-test-runner_service-tester.html
@@ -119,13 +119,13 @@
diff --git a/module-core_service-test-runner_services-for-title.html b/module-core_service-test-runner_services-for-title.html
index ecb88b3c91..17fc96cf01 100644
--- a/module-core_service-test-runner_services-for-title.html
+++ b/module-core_service-test-runner_services-for-title.html
@@ -278,13 +278,13 @@ as an array of strings.
diff --git a/module-core_token-pooling_token-pool-Token.html b/module-core_token-pooling_token-pool-Token.html
index 0f6bde3b31..f96f01d132 100644
--- a/module-core_token-pooling_token-pool-Token.html
+++ b/module-core_token-pooling_token-pool-Token.html
@@ -709,13 +709,13 @@ stable ordering for a valid priority queue.
diff --git a/module-core_token-pooling_token-pool-TokenPool.html b/module-core_token-pooling_token-pool-TokenPool.html
index b99d7aede8..94b1b8fa28 100644
--- a/module-core_token-pooling_token-pool-TokenPool.html
+++ b/module-core_token-pooling_token-pool-TokenPool.html
@@ -893,13 +893,13 @@ indicate it should not be reused.
diff --git a/module-core_token-pooling_token-pool.html b/module-core_token-pooling_token-pool.html
index c5abb94763..f9dd242587 100644
--- a/module-core_token-pooling_token-pool.html
+++ b/module-core_token-pooling_token-pool.html
@@ -285,13 +285,13 @@
diff --git a/module-services_build-status.html b/module-services_build-status.html
index 6f461d0de7..1111bfc030 100644
--- a/module-services_build-status.html
+++ b/module-services_build-status.html
@@ -447,13 +447,13 @@ Determines the message and color of the badge according to the build status.
diff --git a/module-services_color-formatters.html b/module-services_color-formatters.html
index 92d2eb2c25..49025749c1 100644
--- a/module-services_color-formatters.html
+++ b/module-services_color-formatters.html
@@ -1526,13 +1526,13 @@ The color defaults to red if the score does not matches with any of the grade va
diff --git a/module-services_contributor-count.html b/module-services_contributor-count.html
index 37d3568adb..28fff4952b 100644
--- a/module-services_contributor-count.html
+++ b/module-services_contributor-count.html
@@ -530,13 +530,13 @@ Determines the message and color of the badge according to the contributor count
diff --git a/module-services_downloads.html b/module-services_downloads.html
index e67dceb0ea..d15782df24 100644
--- a/module-services_downloads.html
+++ b/module-services_downloads.html
@@ -540,13 +540,13 @@ this value as the prefix for versioned badges, e.g. foobar@v1.23. D
diff --git a/module-services_dynamic-common.html b/module-services_dynamic-common.html
index a9cacea4bb..92024681b9 100644
--- a/module-services_dynamic-common.html
+++ b/module-services_dynamic-common.html
@@ -954,13 +954,13 @@ Sets the color of the badge to blue.
diff --git a/module-services_dynamic_json-path.html b/module-services_dynamic_json-path.html
index 9fc8934713..e27d9ade22 100644
--- a/module-services_dynamic_json-path.html
+++ b/module-services_dynamic_json-path.html
@@ -417,13 +417,13 @@ This can be used to extend or override the
diff --git a/module-services_endpoint-common.html b/module-services_endpoint-common.html
index b43777fa6d..0643da9103 100644
--- a/module-services_endpoint-common.html
+++ b/module-services_endpoint-common.html
@@ -804,13 +804,13 @@ Optionally it prints those keys in the message to provide detailed feedback.
diff --git a/module-services_licenses.html b/module-services_licenses.html
index 9eaf9034de..4af36e1c93 100644
--- a/module-services_licenses.html
+++ b/module-services_licenses.html
@@ -644,13 +644,13 @@ Sets the badge color to the provided value, if not provided then the color is us
diff --git a/module-services_package-json-helpers.html b/module-services_package-json-helpers.html
index a3d085b89d..c89a5bfb35 100644
--- a/module-services_package-json-helpers.html
+++ b/module-services_package-json-helpers.html
@@ -650,13 +650,13 @@ Checks if the object has all the dependency types and the dependency types are v
diff --git a/module-services_steam_steam-base-BaseSteamAPI.html b/module-services_steam_steam-base-BaseSteamAPI.html
index 3532278340..2fa1a43be0 100644
--- a/module-services_steam_steam-base-BaseSteamAPI.html
+++ b/module-services_steam_steam-base-BaseSteamAPI.html
@@ -374,13 +374,13 @@
diff --git a/module-services_steam_steam-base.html b/module-services_steam_steam-base.html
index 5b2b5f6001..8f52565a82 100644
--- a/module-services_steam_steam-base.html
+++ b/module-services_steam_steam-base.html
@@ -119,13 +119,13 @@
diff --git a/services_build-status.js.html b/services_build-status.js.html
index f9deb02f66..5802f255f4 100644
--- a/services_build-status.js.html
+++ b/services_build-status.js.html
@@ -134,13 +134,13 @@ export { isBuildStatus, renderBuildStatusBadge }
diff --git a/services_color-formatters.js.html b/services_color-formatters.js.html
index fcc9687dc5..0270eb852a 100644
--- a/services_color-formatters.js.html
+++ b/services_color-formatters.js.html
@@ -234,13 +234,13 @@ export {
diff --git a/services_contributor-count.js.html b/services_contributor-count.js.html
index 45ed8e9d63..76f286ead5 100644
--- a/services_contributor-count.js.html
+++ b/services_contributor-count.js.html
@@ -79,13 +79,13 @@ export { contributorColor, renderContributorBadge }
diff --git a/services_downloads.js.html b/services_downloads.js.html
index f8f5604f73..d493ed0db1 100644
--- a/services_downloads.js.html
+++ b/services_downloads.js.html
@@ -95,13 +95,13 @@ export { renderDownloadsBadge }
diff --git a/services_dynamic-common.js.html b/services_dynamic-common.js.html
index 62467b3a8d..a6cfe65057 100644
--- a/services_dynamic-common.js.html
+++ b/services_dynamic-common.js.html
@@ -136,13 +136,13 @@ export {
diff --git a/services_dynamic_json-path.js.html b/services_dynamic_json-path.js.html
index 30c4ffa3d1..dfa4932484 100644
--- a/services_dynamic_json-path.js.html
+++ b/services_dynamic_json-path.js.html
@@ -114,13 +114,13 @@ export default superclass =>
diff --git a/services_endpoint-common.js.html b/services_endpoint-common.js.html
index b0e8dc5b9f..3626354f1c 100644
--- a/services_endpoint-common.js.html
+++ b/services_endpoint-common.js.html
@@ -142,13 +142,13 @@ export { validateEndpointData, fetchEndpointData }
diff --git a/services_licenses.js.html b/services_licenses.js.html
index f84a29f98f..1ab3bb2e15 100644
--- a/services_licenses.js.html
+++ b/services_licenses.js.html
@@ -195,13 +195,13 @@ export { licenseToColor, renderLicenseBadge }
diff --git a/services_package-json-helpers.js.html b/services_package-json-helpers.js.html
index 8e05d7c119..cf9a15fa0f 100644
--- a/services_package-json-helpers.js.html
+++ b/services_package-json-helpers.js.html
@@ -114,13 +114,13 @@ export { isDependencyMap, isPackageJsonWithDependencies, getDependencyVersion }
diff --git a/services_packagist_packagist-base.js.html b/services_packagist_packagist-base.js.html
index b376f4e65d..e28402d3fb 100644
--- a/services_packagist_packagist-base.js.html
+++ b/services_packagist_packagist-base.js.html
@@ -223,13 +223,13 @@ export {
diff --git a/services_steam_steam-base.js.html b/services_steam_steam-base.js.html
index d5855a94ea..5b964d048e 100644
--- a/services_steam_steam-base.js.html
+++ b/services_steam_steam-base.js.html
@@ -92,13 +92,13 @@ export default BaseSteamAPI
diff --git a/services_test-validators.js.html b/services_test-validators.js.html
index f66d7b5484..e7167074af 100644
--- a/services_test-validators.js.html
+++ b/services_test-validators.js.html
@@ -253,13 +253,13 @@ export {
diff --git a/tutorial-TUTORIAL.html b/tutorial-TUTORIAL.html
index 04366be280..ea80c05518 100644
--- a/tutorial-TUTORIAL.html
+++ b/tutorial-TUTORIAL.html
@@ -371,13 +371,13 @@ will review your contribution.
diff --git a/tutorial-adding-new-config-values.html b/tutorial-adding-new-config-values.html
index 4c8f6d3b02..4a615b3676 100644
--- a/tutorial-adding-new-config-values.html
+++ b/tutorial-adding-new-config-values.html
@@ -54,13 +54,13 @@
diff --git a/tutorial-authentication.html b/tutorial-authentication.html
new file mode 100644
index 0000000000..546ed0b53b
--- /dev/null
+++ b/tutorial-authentication.html
@@ -0,0 +1,57 @@
+
+
+
+
+ JSDoc: Tutorial: authentication
+
+
+
+
+
+
+
+
+
+
+
+
+
Tutorial: authentication
+
+
+
+
+
+
+
authentication
+
+
+
+
Badges Requiring Authentication
+
There are two patterns for how shields.io can interact with APIs that require auth:
+
+
We can store one token at the service level which allows us to read public data for everyone's projects, or lift a rate limit. If you are looking for information on configuring credentials for a self-hosted instance see https://github.com/badges/shields/blob/master/doc/server-secrets.md
+
If every user needs to provide their own token, that has to be a token which can be passed to us as a query param in the badge URL. This means it must be possible to generate a key or token that can be exposed in a public github README public with no negative consequences. (i.e: that key or token only exposes public metrics).
+
+
If every user would need to supply their own token for some particular service and it is only possible to generate a key or token which allows access to sensitive data or allows write access to resources, we can't provide an integration for this service.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/tutorial-badge-urls.html b/tutorial-badge-urls.html
index 0704d4a1ed..255b57ae82 100644
--- a/tutorial-badge-urls.html
+++ b/tutorial-badge-urls.html
@@ -77,13 +77,13 @@ badge is for issues, and the parameters are :user/:repo.
diff --git a/tutorial-code-walkthrough.html b/tutorial-code-walkthrough.html
index 9c2d326db0..1b8dbe4148 100644
--- a/tutorial-code-walkthrough.html
+++ b/tutorial-code-walkthrough.html
@@ -229,13 +229,13 @@ result over the HTTPS connection.
diff --git a/tutorial-deprecating-badges.html b/tutorial-deprecating-badges.html
index 9cfb9155e7..e134ddc367 100644
--- a/tutorial-deprecating-badges.html
+++ b/tutorial-deprecating-badges.html
@@ -136,13 +136,13 @@ t.create('no longer available (previously number of layers)')
diff --git a/tutorial-input-validation.html b/tutorial-input-validation.html
index 3795460a24..5095825f32 100644
--- a/tutorial-input-validation.html
+++ b/tutorial-input-validation.html
@@ -97,13 +97,13 @@
diff --git a/tutorial-json-format.html b/tutorial-json-format.html
index 935bbfd521..af24e0fa2c 100644
--- a/tutorial-json-format.html
+++ b/tutorial-json-format.html
@@ -54,13 +54,13 @@ if you have any queries regarding the JSON format.
diff --git a/tutorial-logos.html b/tutorial-logos.html
index e8c31b6ec4..a38f13dfc0 100644
--- a/tutorial-logos.html
+++ b/tutorial-logos.html
@@ -40,6 +40,17 @@
Custom Logos
Any custom logo can be passed in a URL parameter by base64 encoding it. e.g:
The logoColor param can be used to set the color of the logo. Hex, rgb, rgba, hsl, hsla and css named colors can all be used. For SimpleIcons named logos (which are monochrome), the color will be applied to the SimpleIcons logo.
In the case where Shields hosts a custom multi-colored logo, if the logoColor param is passed, the corresponding SimpleIcons logo will be substituted and colored.
Our preferred way to consume icons is via the SimpleIcons logo. As a first port of call, we encourage you to contribute logos to the SimpleIcons project. Please review their guidance before contributing.
In some cases we may also accept logo submissions directly. In general, we do this only when:
@@ -90,13 +101,13 @@
diff --git a/tutorial-performance-testing.html b/tutorial-performance-testing.html
index c4fcdc55f0..d07ef43cd1 100644
--- a/tutorial-performance-testing.html
+++ b/tutorial-performance-testing.html
@@ -70,13 +70,13 @@ node --prof-process --preprocess -j isolate-00000244AB6ED3B0-11920-v8.log | flam
diff --git a/tutorial-production-hosting.html b/tutorial-production-hosting.html
index 953bdf9165..b6905931ba 100644
--- a/tutorial-production-hosting.html
+++ b/tutorial-production-hosting.html
@@ -229,13 +229,13 @@ via local-shields-io-production.yml (see Home