clerk docs

package.json

@@ -5,7 +5,7 @@
   "scripts": {
     "docusaurus": "docusaurus",
     "start": "npm run ci:pre && npm run start:docusaurus",
-    "start:policies": "node ./scripts/build.mjs && nodemon --watch policies -e md,json,ts,svg ./scripts/update-policies.mjs",
+    "start:policies": "node ./scripts/build.mjs && nodemon --watch policies -e md,json,ts,svg,png ./scripts/update-policies.mjs",
     "start:docusaurus": "node ./scripts/check-prepared.mjs && docusaurus start --port 3002",
     "build": "npm run ci:pre && docusaurus build",
     "build:scripts": "node ./scripts/build.mjs",

policies/auth0-jwt-auth-inbound/doc.md

@@ -61,7 +61,7 @@ are found in Auth0.
    Variables** section in the <SettingsTabIcon /> **Settings** tab.
 
 2. Click **Add new Variable** and enter the name `AUTH0_DOMAIN` in the name
-   field. Set the value to
+   field. Set the value to your Auth0 domain.
 
 3. Click **Add new Variable** again and enter the name `AUTH0_AUDIENCE` in the
    name field. Set the value to the **identifier** URI you used when creating

policies/clerk-jwt-auth-inbound/doc.md

@@ -0,0 +1,77 @@
+## Using the Policy
+
+Adding Clerk authentication to your route takes just a few steps. Follow the
+instructions below to setup Clerk and the Clerk policy.
+
+## Setup Clerk
+
+If you haven't already done so, create a Clerk account and follow one of their
+[Quickstarts](https://clerk.com/docs/quickstarts/overview) to create a client
+app that can obtain an access token.
+
+In order to setup your policy in the API, you'll need to navigate to the
+[Clerk Dashboard](https://dashboard.clerk.com/) and Navigate to the
+[API Keys](https://dashboard.clerk.com/last-active?path=api-keys) section. Click
+**Advanced** at the bottom of the page and copy the value of the **Frontend API
+URL**. You'll use this value later in your API policy configuration.
+
+### Set Environment Variables
+
+Before adding the policy, you'll need to create an environment variable to store
+the Clerk Frontend API URL.
+
+1. In the [Zuplo Portal](https://portal.zuplo.com) open the **Environment
+   Variables** section in the <SettingsTabIcon /> **Settings** tab.
+
+2. Click **Add new Variable** and enter the name `CLERK_FRONTEND_API_URL` in the
+   name field. Set the value to the value you copied previously from the Clerk
+   dashboard.
+
+### Add the Clerk Policy
+
+The next step is to add the Clerk JWT Auth policy to a route in your project.
+
+1. In the [Zuplo Portal](https://portal.zuplo.com) open the **Route Designer**
+   in the <CodeEditorTabIcon /> **Files** tab then click **routes.oas.json**.
+
+2. Select or create a route that you want to authenticate with Clerk. Expand the
+   **Policies** section and click **Add Policy**. Search for and select the
+   Clerk JWT Auth policy.
+
+   <Screenshot src="https://cdn.zuplo.com/assets/c4bab517-1e42-4f68-83ce-b0ee4adca713.png" />
+
+3. With the policy selected, notice that there is a property `frontendApiUrl`
+   that are pre-populated with environment variable names that you set in the
+   previous section.
+
+  <Screenshot src="https://cdn.zuplo.com/assets/85d90802-d919-47c6-b944-c6ec3574a714.png" size="md" />
+
+4. Click **OK** to save the policy.
+
+### Test the Policy
+
+Finally, you'll make two API requests to your route to test that authentication
+is working as expected.
+
+1. In the route designer on the route you added the policy, click the **Test**
+   button. In the dialog that opens, click **Test** to make a request.
+
+2. The API Gateway should respond with a **401 Unauthorized** response.
+
+  <Screenshot src="https://cdn.zuplo.com/assets/626e10a2-2350-439a-9081-1ccf1fe90cad.png" size="md" />
+
+3. Now to make an authenticated request, add a header to the request called
+   `Authorization`. Set the value of the header to `Bearer YOUR_ACCESS_TOKEN`
+   replacing `YOUR_ACCESS_TOKEN` with the value of the Clerk access token
+   retrieved from your client app.
+
+  <Screenshot src="https://cdn.zuplo.com/assets/1486821b-cade-4041-b05b-80d3366327a5.png" size="lg" />
+
+4. Click the **Test** button and a **200 OK** response should be returned.
+
+  <Screenshot src="https://cdn.zuplo.com/assets/8182f932-8db6-4456-842f-f65158b174c0.png" size="md" />
+
+You have now setup Clerk JWT Authentication on your API Gateway.
+
+See [this document](/docs/articles/oauth-authentication) for more information
+about OAuth authorization in Zuplo.