Add HowTo NextAuth on cloudflare

Author: vicb

.github/workflows/check.yml

@@ -10,6 +10,6 @@ jobs:
         runs-on: ubuntu-latest
         steps:
             - name: Checkout
-              uses: actions/checkout@v3
+              uses: actions/checkout@v4
             - uses: oven-sh/setup-bun@v2
             - uses: ./.github/actions/build-docs

pages/cloudflare/_meta.json

@@ -3,6 +3,7 @@
   "get-started": "",
   "bindings": "",
   "caching": "",
+  "howtos": "How-Tos",
   "examples": "",
   "community": "Community projects",
   "troubleshooting": "",

pages/cloudflare/howtos/NextAuth.mdx

@@ -0,0 +1,37 @@
+
+## [NextAuth.js](https://next-auth.js.org/)
+
+NextAuth.js is an open-source authentication solution for Next.js applications.
+
+### Solving a broken build
+
+Authentication uses crypto algorithms and NextAuth.js relies on [`createCipheriv`](https://nodejs.org/docs/v22.13.1/api/crypto.html#cryptocreatecipherivalgorithm-key-iv-options) from [`node:crypto`](https://nodejs.org/docs/v22.13.1/api/crypto.html).
+
+`createCipheriv` is not currently implemented by the workerd runtime so apps using NextAuth.js are broken out of the box.
+
+However you can configure NextAuth.js to use custom implementations for the `encode` and `decode` functions. An implementation built on top of [`SubtleCrypto`](https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto) can run on workerd.
+
+The NextAuth.js configuration file should look like:
+
+```js
+import { encode, decode } from "@/lib/webcrypto";
+
+export const NEXT_AUTH_CONFIG = {
+  // ...
+  jwt: {
+    encode,
+    decode,
+  },
+};
+```
+
+Kudos to Arnav Gupta ([`@arnavgupta00`](https://github.com/arnavgupta00)) for coming up with the solution.
+You can find an example on his [example repository](https://github.com/arnavgupta00/deployment-cf-workers-prisma-nextauth).
+
+Related issues: [`workers-sdk#206`](https://github.com/opennextjs/opennextjs-cloudflare/issues/206) and [`workerd#3277`](https://github.com/cloudflare/workerd/issues/3277).
+
+
+
+
+
+