React – WebAuthn

Cotter's WebAuthn authenticates your user using either TouchID or Windows Hello from their browser. This means it works from your website. It allows seamless, fast, and secure way for your user to login to your Web App. Follow this simple guide to see how it works!

Try it live on our Example Next.js Project. Check out the complete code on Github.

Step 1: Import Cotter as a dependency

yarn add cotter

(This feature is available on version >= 0.3.4)

Step 2: Initialize Cotter and Show the Form

import React, { useEffect, useState } from "react";
import Cotter from "cotter"; //  1️⃣  Import Cotter

function App() {
  const [payload, setpayload] = useState(null);

  //  2️⃣ Initialize and show the form
  useEffect(() => {
    var cotter = new Cotter(API_KEY_ID); // 👈 Specify your API KEY ID here
    cotter
      .withFormID("form_default") // Use customization for form "form_default"
      .signInWithWebAuthnOrLink()
      .showEmailForm()
      .then(response => {
        setpayload(response); // show the response in our state
      })
      .catch(err => console.log(err));
  }, []);

  return (
    <div>
      {/*  3️⃣  Put a <div> that will contain the form */}
      <div id="cotter-form-container" style={{ width: 300, height: 300 }} />
      
      <pre>{JSON.stringify(payload, null, 4)}</pre>
    </div>
  );
}

export default App;

Create a free account and go to the dashboard to get your API_KEY_ID .

Import Cotter
Call signInWithWebAuthnOrLink to use WebAuthn with fallback Magic Link, followed by showEmailForm or showPhoneForm, and get the response as a promise.
Setup a <div> with id="cotter-form-container" that will contain the form.

🎉 You're done!

✏️ Ready to setup & customize your login?

Customize the Form

Easily customize the form from Cotter's Dashboard > Branding.

Full JS SDK Reference

👉 What's Next?

Customize the Form

You can customize the form from the Dashboard > Branding. You can also add Custom CSS.

Add Additional Fields

Add Additional Fields like Name, Address, etc to the login form.

Register User to your Backend

When the user successfully authenticated, send Cotter's response to your backend to either create a new user or log the user in. Learn how to send Cotter's response and verify it in your backend:

Backend: Handling Response

PreviousReact – Sign in with Email/Phone NextReact Native – Sign in with Device

Last updated 3 years ago

import React, { useEffect, useState } from "react"; import Cotter from "cotter"; // 1️⃣ Import Cotter function App() { const [payload, setpayload] = useState(null); // 2️⃣ Initialize and show the form useEffect(() => { var cotter = new Cotter(API_KEY_ID); // 👈 Specify your API KEY ID here cotter .withFormID("form_default") // Use customization for form "form_default" .signInWithWebAuthnOrLink() .showEmailForm() .then(response => { setpayload(response); // show the response in our state }) .catch(err => console.log(err)); }, []); return ( <div> {/* 3️⃣ Put a <div> that will contain the form */} <div id="cotter-form-container" style={{ width: 300, height: 300 }} /> <pre>{JSON.stringify(payload, null, 4)}</pre> </div> ); } export default App;

👉 What's Next?

Customize the Form

You can customize the form from the Dashboard > Branding. You can also add Custom CSS.

Add Additional Fields

Add Additional Fields like Name, Address, etc to the login form.

Register User to your Backend

When the user successfully authenticated, send Cotter's response to your backend to either create a new user or log the user in. Learn how to send Cotter's response and verify it in your backend:

Backend: Handling Response