Deployed df15149 with MkDocs version 1.4.2 (9.1.5)

This commit is contained in:
github-actions[bot] 2023-03-31 11:52:30 +00:00
parent ed8f38723a
commit 956963fdf2
14 changed files with 30 additions and 26 deletions

View File

@ -11,7 +11,7 @@
<link rel="icon" href="/jwt/assets/jwt.png">
<meta name="generator" content="mkdocs-1.4.2, mkdocs-material-9.1.4">
<meta name="generator" content="mkdocs-1.4.2, mkdocs-material-9.1.5">
@ -19,7 +19,7 @@
<link rel="stylesheet" href="/jwt/assets/stylesheets/main.240905d7.min.css">
<link rel="stylesheet" href="/jwt/assets/stylesheets/main.7a7fce14.min.css">
<link rel="stylesheet" href="/jwt/assets/stylesheets/palette.a0c5b2b5.min.css">
@ -372,7 +372,7 @@
<script id="__config" type="application/json">{"base": "/jwt/", "features": ["navigation.instant", "navigation.tabs", "toc.integrate", "content.code.copy", "content.code.annotate"], "search": "/jwt/assets/javascripts/workers/search.208ed371.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
<script src="/jwt/assets/javascripts/bundle.19047be9.min.js"></script>
<script src="/jwt/assets/javascripts/bundle.407015b8.min.js"></script>
</body>

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

View File

@ -17,7 +17,7 @@
<link rel="next" href="usage/create/">
<link rel="icon" href="assets/jwt.png">
<meta name="generator" content="mkdocs-1.4.2, mkdocs-material-9.1.4">
<meta name="generator" content="mkdocs-1.4.2, mkdocs-material-9.1.5">
@ -25,7 +25,7 @@
<link rel="stylesheet" href="assets/stylesheets/main.240905d7.min.css">
<link rel="stylesheet" href="assets/stylesheets/main.7a7fce14.min.css">
<link rel="stylesheet" href="assets/stylesheets/palette.a0c5b2b5.min.css">
@ -517,7 +517,7 @@ vulnerabilities which will not be fixed.</p>
<script id="__config" type="application/json">{"base": ".", "features": ["navigation.instant", "navigation.tabs", "toc.integrate", "content.code.copy", "content.code.annotate"], "search": "assets/javascripts/workers/search.208ed371.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
<script src="assets/javascripts/bundle.19047be9.min.js"></script>
<script src="assets/javascripts/bundle.407015b8.min.js"></script>
</body>

File diff suppressed because one or more lines are too long

View File

@ -2,22 +2,22 @@
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://golang-jwt.github.io/jwt/</loc>
<lastmod>2023-03-30</lastmod>
<lastmod>2023-03-31</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://golang-jwt.github.io/jwt/usage/create/</loc>
<lastmod>2023-03-30</lastmod>
<lastmod>2023-03-31</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://golang-jwt.github.io/jwt/usage/parse/</loc>
<lastmod>2023-03-30</lastmod>
<lastmod>2023-03-31</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://golang-jwt.github.io/jwt/usage/signing_methods/</loc>
<lastmod>2023-03-30</lastmod>
<lastmod>2023-03-31</lastmod>
<changefreq>daily</changefreq>
</url>
</urlset>

Binary file not shown.

View File

@ -17,7 +17,7 @@
<link rel="next" href="../parse/">
<link rel="icon" href="../../assets/jwt.png">
<meta name="generator" content="mkdocs-1.4.2, mkdocs-material-9.1.4">
<meta name="generator" content="mkdocs-1.4.2, mkdocs-material-9.1.5">
@ -25,7 +25,7 @@
<link rel="stylesheet" href="../../assets/stylesheets/main.240905d7.min.css">
<link rel="stylesheet" href="../../assets/stylesheets/main.7a7fce14.min.css">
<link rel="stylesheet" href="../../assets/stylesheets/palette.a0c5b2b5.min.css">
@ -573,7 +573,7 @@ these are strictly for future compatibility and are currently not used.</p>
<script id="__config" type="application/json">{"base": "../..", "features": ["navigation.instant", "navigation.tabs", "toc.integrate", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.208ed371.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
<script src="../../assets/javascripts/bundle.19047be9.min.js"></script>
<script src="../../assets/javascripts/bundle.407015b8.min.js"></script>
</body>

View File

@ -17,7 +17,7 @@
<link rel="next" href="../signing_methods/">
<link rel="icon" href="../../assets/jwt.png">
<meta name="generator" content="mkdocs-1.4.2, mkdocs-material-9.1.4">
<meta name="generator" content="mkdocs-1.4.2, mkdocs-material-9.1.5">
@ -25,7 +25,7 @@
<link rel="stylesheet" href="../../assets/stylesheets/main.240905d7.min.css">
<link rel="stylesheet" href="../../assets/stylesheets/main.7a7fce14.min.css">
<link rel="stylesheet" href="../../assets/stylesheets/palette.a0c5b2b5.min.css">
@ -545,7 +545,7 @@
<script id="__config" type="application/json">{"base": "../..", "features": ["navigation.instant", "navigation.tabs", "toc.integrate", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.208ed371.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
<script src="../../assets/javascripts/bundle.19047be9.min.js"></script>
<script src="../../assets/javascripts/bundle.407015b8.min.js"></script>
</body>

View File

@ -15,7 +15,7 @@
<link rel="icon" href="../../assets/jwt.png">
<meta name="generator" content="mkdocs-1.4.2, mkdocs-material-9.1.4">
<meta name="generator" content="mkdocs-1.4.2, mkdocs-material-9.1.5">
@ -23,7 +23,7 @@
<link rel="stylesheet" href="../../assets/stylesheets/main.240905d7.min.css">
<link rel="stylesheet" href="../../assets/stylesheets/main.7a7fce14.min.css">
<link rel="stylesheet" href="../../assets/stylesheets/palette.a0c5b2b5.min.css">
@ -489,6 +489,10 @@
</tr>
</tbody>
</table>
<p><strong>Why is the HMAC signing method not accepting <code>string</code> as a key type?</strong></p>
<p>We often get asked why the HMAC signing method only supports <code>[]byte</code> and not <code>string</code>. This is intentionally and there are different reasons for doing so. First, we aim to use the key type that the underlying cryptographic operation in the Go library uses (this also applies to the other signing methods). In case of HMAC, this is <a href="https://pkg.go.dev/crypto/hmac#New"><code>hmac.New</code></a> and it uses <code>[]byte</code> as the type to represent a key.</p>
<p>Second, using <code>string</code> as a key type to represent a symmetric key can lead to unwanted situations. It gives the impression that this is something 'human readable' (like a password), but it is not. A symmetric key should contain as much entropy as possible and therefore include characters from the whole character set (even 'unreadable' ones) and ideally be generated by a cryptographic random source, such as <a href="https://pkg.go.dev/crypto/rand#Read"><code>rand.Read</code></a>. Signing tokens with a cryptographically weak key will compromise the security of the tokens and in effect everything that depends on it, e.g., user authentication.</p>
<p>If you have trouble handling a <code>[]byte</code> key in our setup, e.g., because you are reading it from your environment variables on your cluster or similar, you can always use base64 encoding to have the key as a "string" type outside of your program and then use <a href="https://pkg.go.dev/encoding/base64#Encoding.DecodeString"><code>base64.Encoding.DecodeString</code></a> to decode the base64 string into the <code>[]byte</code> slice that the signing method needs.</p>
<div class="footnote">
<hr />
<ol>
@ -552,7 +556,7 @@
<script id="__config" type="application/json">{"base": "../..", "features": ["navigation.instant", "navigation.tabs", "toc.integrate", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.208ed371.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
<script src="../../assets/javascripts/bundle.19047be9.min.js"></script>
<script src="../../assets/javascripts/bundle.407015b8.min.js"></script>
</body>