openmaic/OpenMAIC/tests/server/ops-access.test.ts

import { afterEach, describe, expect, it, vi } from 'vitest';
import { NextRequest } from 'next/server';
import { createAccessToken } from '@/lib/server/access-token';
import { requireOpsAccess } from '@/lib/server/ops-access';

afterEach(() => {
  vi.unstubAllEnvs();
});

describe('requireOpsAccess', () => {
  it('rejects course management on a learner deployment', async () => {
    vi.stubEnv('NODE_ENV', 'production');
    vi.stubEnv('OPENMAIC_DEPLOYMENT_ROLE', 'learner');

    const response = requireOpsAccess(new NextRequest('http://localhost/api/courses'));
    expect(response?.status).toBe(403);
    await expect(response?.json()).resolves.toMatchObject({ errorCode: 'FORBIDDEN' });
  });

  it('fails closed when a production ops deployment has no access code', () => {
    vi.stubEnv('NODE_ENV', 'production');
    vi.stubEnv('OPENMAIC_DEPLOYMENT_ROLE', 'ops');
    vi.stubEnv('ACCESS_CODE', '');

    const response = requireOpsAccess(new NextRequest('http://localhost/api/courses'));
    expect(response?.status).toBe(503);
  });

  it('accepts a valid access-code session on an ops deployment', () => {
    vi.stubEnv('NODE_ENV', 'production');
    vi.stubEnv('OPENMAIC_DEPLOYMENT_ROLE', 'ops');
    vi.stubEnv('ACCESS_CODE', 'test-access-code');
    const token = createAccessToken('test-access-code');
    const request = new NextRequest('http://localhost/api/courses', {
      headers: { cookie: `openmaic_access=${token}` },
    });

    expect(requireOpsAccess(request)).toBeNull();
  });

  it('accepts a same-origin mutation with a valid ops session', () => {
    vi.stubEnv('NODE_ENV', 'production');
    vi.stubEnv('OPENMAIC_DEPLOYMENT_ROLE', 'ops');
    vi.stubEnv('ACCESS_CODE', 'test-access-code');
    const token = createAccessToken('test-access-code');
    const request = new NextRequest('https://ops.example/api/courses', {
      method: 'POST',
      headers: {
        cookie: `openmaic_access=${token}`,
        origin: 'https://ops.example',
      },
    });

    expect(requireOpsAccess(request)).toBeNull();
  });

  it('rejects missing or cross-origin mutation origins', async () => {
    vi.stubEnv('NODE_ENV', 'production');
    vi.stubEnv('OPENMAIC_DEPLOYMENT_ROLE', 'ops');
    vi.stubEnv('ACCESS_CODE', 'test-access-code');
    const token = createAccessToken('test-access-code');

    for (const origin of [undefined, 'https://attacker.example']) {
      const response = requireOpsAccess(
        new NextRequest('https://ops.example/api/courses', {
          method: 'POST',
          headers: {
            cookie: `openmaic_access=${token}`,
            ...(origin ? { origin } : {}),
          },
        }),
      );
      expect(response?.status).toBe(403);
      await expect(response?.json()).resolves.toMatchObject({ errorCode: 'FORBIDDEN' });
    }
  });

  it('uses a configured public origin and never trusts forged forwarded hosts', async () => {
    vi.stubEnv('NODE_ENV', 'production');
    vi.stubEnv('OPENMAIC_DEPLOYMENT_ROLE', 'ops');
    vi.stubEnv('ACCESS_CODE', 'test-access-code');
    vi.stubEnv('ACCESS_CODE_TRUST_PROXY_HEADERS', 'true');
    vi.stubEnv('OPS_PUBLIC_ORIGIN', 'https://ops.example');
    const token = createAccessToken('test-access-code');

    const accepted = new NextRequest('http://internal:3000/api/courses', {
      method: 'POST',
      headers: {
        cookie: `openmaic_access=${token}`,
        origin: 'https://ops.example',
        'x-forwarded-host': 'attacker.example',
        'x-forwarded-proto': 'https',
      },
    });
    expect(requireOpsAccess(accepted)).toBeNull();

    const rejected = new NextRequest('http://internal:3000/api/courses', {
      method: 'POST',
      headers: {
        cookie: `openmaic_access=${token}`,
        origin: 'https://attacker.example',
        'x-forwarded-host': 'attacker.example',
        'x-forwarded-proto': 'https',
      },
    });
    const response = requireOpsAccess(rejected);
    expect(response?.status).toBe(403);
    await expect(response?.json()).resolves.toMatchObject({ errorCode: 'FORBIDDEN' });
  });

  it('fails closed when the configured public origin is malformed', () => {
    vi.stubEnv('NODE_ENV', 'production');
    vi.stubEnv('OPENMAIC_DEPLOYMENT_ROLE', 'ops');
    vi.stubEnv('ACCESS_CODE', 'test-access-code');
    vi.stubEnv('OPS_PUBLIC_ORIGIN', 'https://ops.example/path');
    const token = createAccessToken('test-access-code');
    const response = requireOpsAccess(
      new NextRequest('https://ops.example/api/courses', {
        method: 'POST',
        headers: {
          cookie: `openmaic_access=${token}`,
          origin: 'https://ops.example',
        },
      }),
    );
    expect(response?.status).toBe(403);
  });

  it('keeps production role=all aligned with the ops session contract', () => {
    vi.stubEnv('NODE_ENV', 'production');
    vi.stubEnv('OPENMAIC_DEPLOYMENT_ROLE', 'all');
    vi.stubEnv('ACCESS_CODE', 'test-access-code');
    const token = createAccessToken('test-access-code');
    const request = new NextRequest('https://ops.example/api/coursewares', {
      method: 'POST',
      headers: {
        cookie: `openmaic_access=${token}`,
        origin: 'https://ops.example',
      },
    });

    expect(requireOpsAccess(request)).toBeNull();
  });
});