Cloudflare Integration - GrackerAI Portal

This comprehensive guide covers Cloudflare integration scenarios for GrackerAI's cybersecurity content marketing platform, including subpath routing and custom domain configuration.

Subpath Routing with Cloudflare Workers

Host your GrackerAI portal at a custom subpath (e.g., /portal, /dashboard) on your domain using Cloudflare Workers for seamless integration.

Step 1: Create a Cloudflare Worker

If you haven't already, create a Cloudflare Worker by following the Cloudflare Workers getting started guide (opens in a new tab).

Step 2: Configure Worker Code

1. Log in to the Cloudflare dashboard and select your account
2. Navigate to Workers & Pages
3. Select your Worker application
4. Click Edit Code

Replace the default Worker code with the following script. For detailed information on editing Workers, refer to the Cloudflare Workers documentation (opens in a new tab).

const seoTargetBase = 'https://portal.pseo.one';
 
export default {
  async fetch(request, env, ctx) {
    const url = new URL(request.url);
    const origin = url.origin;
    const pathname = url.pathname;
 
    if (pathname.startsWith("/yoursubpath")) {
      const targetUrl = seoTargetBase + url.pathname + url.search;
 
      const newHeaders = new Headers(request.headers);
      newHeaders.set('x-req-domain', origin);
 
      const newRequest = new Request(targetUrl, {
        method: request.method,
        headers: newHeaders,
        body: request.body,
        redirect: 'manual'
      });
 
      const response = await fetch(newRequest);
      return new Response(response.body, response);
    }
 
    return fetch(request);
  }
};
 

Click Deploy to save your changes. Deployment typically takes a few minutes, but full propagation can take up to several hours.

Step 3: Test Your Worker

Once deployed, verify that your Worker correctly routes requests to your GrackerAI portal.

1. Test using the Worker's preview URL:

   your-worker.your-subdomain.workers.dev/yoursubpath

Step 4: Configure Worker Routes

Connect your Worker to your domain by configuring a route pattern that defines when the Worker should handle requests.

1. In your Worker settings, navigate to the Domains & Routes tab

2. Click Add Route

3. Enter your route pattern:

   yourdomain.com/yoursubpath*

4. Select your zone from the dropdown menu

5. Click Save

Route Pattern Examples

• example.com/portal/* - Routes all requests starting with /portal/
• *.example.com/docs/* - Routes subdomains with /docs/ path

For comprehensive information on route patterns and advanced configuration options, refer to the Cloudflare Workers Routes documentation (opens in a new tab).

Custom Domain Setup with Cloudflare

This section provides a comprehensive guide for configuring custom domains using Cloudflare's DNS management for seamless GrackerAI portal integration.

Step 1: Configure DNS Records

Connect your custom domain to the GrackerAI portal by adding a CNAME record in your Cloudflare DNS settings.

Add CNAME Record

1. Log in to your Cloudflare dashboard
2. Navigate to DNS > Records
3. Click Add record
4. Configure the CNAME record with the following settings:

Type: CNAME
Name: your-subdomain (e.g., portal, portal-101)
Target: portal.pseo.one
Proxy status: Proxied (orange cloud)

Configuration Example

portal-101.customer1.com → portal.pseo.one

Step 2: Verify DNS Propagation

After adding the CNAME record, monitor the propagation status:

• Cloudflare Proxy: Changes typically propagate within 2-5 minutes
• Global Propagation: Full worldwide propagation may take 24-48 hours
• Verification Tool: Use DNS Checker (opens in a new tab) to monitor propagation status

Additional Resources

For more detailed information on Cloudflare DNS management:

• Cloudflare DNS Records Documentation (opens in a new tab)
• Creating DNS Records Guide (opens in a new tab)
• Understanding Proxied DNS Records (opens in a new tab)