<secure-form>

The secure form component at the core of Secure-UI. Injects CSRF tokens, coordinates validation across all child fields, and at submission collects every field's behavioral signals into a SessionTelemetry payload — a riskScore from 0–100 and named riskSignals your server can act on immediately. Bot detection without CAPTCHA, no extra endpoint.

<script type="module"
  src="/components/secure-form/secure-form.js">
</script>
View API Reference →
Live Demo

Configurations

csrf-token
Pass the server-rendered CSRF token as an attribute. The component injects it as a hidden csrf_token field and attaches it as a request header — your submit handler needs no extra logic. Use csrf-field-name and csrf-header-name to match your backend's expected names.
<!-- Server renders the token inline -->
<secure-form
  action="/login"
  method="POST"
  csrf-token="{ .CSRFToken }"
  csrf-header-name="X-CSRF-Token"
  security-tier="sensitive">
  <!-- fields -->
</secure-form>
security-tier="sensitive"
Every submission attempt is written to the audit log. Child fields with security-tier="sensitive" disable autocomplete and prevent browser caching. Use for login, profile, and any form collecting PII.
<secure-form
  action="/login"
  method="POST"
  security-tier="sensitive">
  <secure-input name="email"
    type="email"
    security-tier="sensitive"
    required>
  </secure-input>
  <secure-input name="password"
    type="password"
    security-tier="critical"
    required>
  </secure-input>
</secure-form>
security-tier="critical"
Highest risk tier. Rate limiting active on all child fields. All fields audited. Combined with <secure-telemetry-provider>, environmental signals (headless browser, webdriver flags, suspicious screen dimensions) are bundled into the payload alongside behavioral telemetry for a full bot detection signal set.
<secure-telemetry-provider
  signing-key="{ .TelemetryKey }">
  <secure-form
    action="/transfer"
    method="POST"
    security-tier="critical">
    <!-- fields -->
  </secure-form>
</secure-telemetry-provider>
novalidate
Disables native browser constraint validation popups. Component-controlled validation runs instead — consistent UX, no browser tooltip revealing shadow DOM internals. Required when mixing Secure-UI components with legacy fields that have browser validation enabled.
<secure-form
  action="/submit"
  method="POST"
  novalidate
  security-tier="public">
  <!-- fields -->
</secure-form>

Security Features

These are client-side defences. Server-side validation is always the security boundary — these reduce the attack surface and produce a complete interaction record for your server to act on.

secure-form-submit event detail Fired before the fetch request
element.addEventListener('secure-form-submit', e => {
  const { telemetry } = e.detail;

  // Act before the request fires
  if (telemetry.riskScore > 60) {
    e.detail.cancelSubmission(); // abort fetch + reset form state
    showChallenge();
  }
});
Risk signals
session_too_fast +30 Form completed in under 3 seconds
all_fields_pasted +25 All fields pasted with zero keystrokes
high_velocity_typing +15 Any field typed at more than 15 keys/s
field_filled_without_focus +15 Field has a value but focusCount is 0
form_probing +10 Multiple focus/blur cycles, no entry
high_correction_count +5 Excessive deletions on a single field
autofill_detected −10 Genuine browser autofill on all fields
CSRF token absent detection Fires secure-threat-detected at submission — sensitive & critical tiers only

When a sensitive or critical tier form is submitted without a CSRF token value, the form dispatches secure-threat-detected before the request proceeds. The signal bubbles up to any wrapping <secure-telemetry-provider> where it is accumulated in the threatSignals array and included in the signed envelope.

element.addEventListener('secure-threat-detected', e => {
  const { fieldName, threatType,
          patternId, tier, timestamp } = e.detail;
  // threatType:  'csrf-token-absent'
  // patternId:   'csrf-token-absent'
  // fieldName:   internal form instance ID
});
FeaturePublicAuthenticatedSensitiveCritical
CSRF token injectionYesYesYesYes
Form action enforcementYesYesYesYes
Field validation coordinationYesYesYesYes
Behavioral telemetry collection-YesYesYes
Risk scoring (0–100)-YesYesYes
Submission audit-YesYesYes
Autocomplete disabled--YesYes
CSRF token absent detection--YesYes

Theming

Secure-UI uses CSS custom properties. Override at :root, per-component, or per-instance.

VariableDefaultDescription
--secure-ui-form-gap1remGap between form fields
--secure-ui-form-label-margin-bottom0.375remSpace between label and input
--secure-ui-form-error-margin-top0.25remSpace above error messages
Themed Example
secure-form {
  --secure-ui-form-gap: 1.5rem;
  --secure-ui-form-label-margin-bottom: 0.5rem;
}

Framework Examples

Web Components work natively in all frameworks. No wrappers, no adapters.

Plain HTML html
<script type="module"
  src="/components/secure-form/secure-form.js">
</script>

<secure-form
  action="/login"
  method="POST"
  csrf-token="{ .CSRFToken }"
  security-tier="sensitive">
  <secure-input
    type="email"
    label="Email"
    name="email"
    security-tier="sensitive"
    required>
  </secure-input>
  <secure-input
    type="password"
    label="Password"
    name="password"
    security-tier="critical"
    required>
  </secure-input>
  <button type="submit">Sign In</button>
</secure-form>
React (JSX) tsx
import { useEffect } from 'react';

export function LoginForm({ csrfToken }: { csrfToken: string }) {
  useEffect(() => {
    import('/components/secure-form/secure-form.js');
    import('/components/secure-input/secure-input.js');
  }, []);

  return (
    <secure-form action="/login" method="POST"
      csrf-token={csrfToken} security-tier="sensitive">
      <secure-input type="email" label="Email" name="email"
        security-tier="sensitive" required />
      <secure-input type="password" label="Password" name="password"
        security-tier="critical" required />
      <button type="submit">Sign In</button>
    </secure-form>
  );
}
Vue 3 vue
<template>
  <secure-form action="/login" method="POST"
    :csrf-token="csrfToken" security-tier="sensitive">
    <secure-input type="email" label="Email" name="email"
      security-tier="sensitive" required />
    <secure-input type="password" label="Password" name="password"
      security-tier="critical" required />
    <button type="submit">Sign In</button>
  </secure-form>
</template>

<script setup>
import { onMounted } from 'vue';
const props = defineProps({ csrfToken: String });
onMounted(async () => {
  await import('/components/secure-form/secure-form.js');
  await import('/components/secure-input/secure-input.js');
});
</script>
Angular typescript
import { Component, CUSTOM_ELEMENTS_SCHEMA, OnInit, Input } from '@angular/core';

@Component({
  selector: 'app-login-form',
  template: `
    <secure-form action="/login" method="POST"
      [attr.csrf-token]="csrfToken"
      security-tier="sensitive">
      <secure-input type="email" label="Email" name="email"
        security-tier="sensitive" required>
      </secure-input>
      <secure-input type="password" label="Password" name="password"
        security-tier="critical" required>
      </secure-input>
      <button type="submit">Sign In</button>
    </secure-form>
  `,
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class LoginFormComponent implements OnInit {
  @Input() csrfToken = '';
  ngOnInit() {
    import('/components/secure-form/secure-form.js');
    import('/components/secure-input/secure-input.js');
  }
}
Svelte svelte
<script>
  import { onMount } from 'svelte';
  export let csrfToken = '';
  onMount(async () => {
    await import('/components/secure-form/secure-form.js');
    await import('/components/secure-input/secure-input.js');
  });
</script>

<secure-form action="/login" method="POST"
  csrf-token={csrfToken} security-tier="sensitive">
  <secure-input type="email" label="Email" name="email"
    security-tier="sensitive" required>
  </secure-input>
  <secure-input type="password" label="Password" name="password"
    security-tier="critical" required>
  </secure-input>
  <button type="submit">Sign In</button>
</secure-form>
Go / Templ templ
templ LoginForm(action, csrfToken string) {
  <secure-form
    action={ action }
    method="POST"
    csrf-token={ csrfToken }
    security-tier="sensitive">
    <secure-input
      type="email"
      label="Email"
      name="email"
      security-tier="sensitive"
      required>
    </secure-input>
    <secure-input
      type="password"
      label="Password"
      name="password"
      security-tier="critical"
      required>
    </secure-input>
    <button type="submit">Sign In</button>
  </secure-form>
}