<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>Configurations
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" 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><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><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.
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();
}
});secure-threat-detected at submission — sensitive & critical tiers onlyWhen 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
});| Feature | Public | Authenticated | Sensitive | Critical |
|---|---|---|---|---|
| CSRF token injection | Yes | Yes | Yes | Yes |
| Form action enforcement | Yes | Yes | Yes | Yes |
| Field validation coordination | Yes | Yes | Yes | Yes |
| Behavioral telemetry collection | - | Yes | Yes | Yes |
| Risk scoring (0–100) | - | Yes | Yes | Yes |
| Submission audit | - | Yes | Yes | Yes |
| Autocomplete disabled | - | - | Yes | Yes |
| CSRF token absent detection | - | - | Yes | Yes |
Theming
Secure-UI uses CSS custom properties. Override at :root, per-component, or per-instance.
| Variable | Default | Description |
|---|---|---|
| --secure-ui-form-gap | 1rem | Gap between form fields |
| --secure-ui-form-label-margin-bottom | 0.375rem | Space between label and input |
| --secure-ui-form-error-margin-top | 0.25rem | Space above error messages |
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.
<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>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>
);
}<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>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');
}
}<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>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>
}