Skip to main content

Integration prerequisites

A relying party represents a web application that you wish to secure using WebAuthn to register and authenticate users. Before you can integrate WebAuthn, you need to collect information about your web application, the relying party:

Relying party name: The name of your choosing, for example: Siven Chocolate Factory.

Relying party ID: The root domain or part of the domains of your web applications that you plan to register and authenticate users on, for example: siven.ch.

Origins: The list of the origins of your web application. Each origin has to be explicitly allowed, for example:

  • https://www.siven.ch
  • https://login.siven.ch:9443
  • https://sso.login.siven.ch

As WebAuthn can only be used from a secure context, the origins have to be one of the following:

  • A local address: http://localhost.
  • An https:// address on condition that the application provides a valid SSL certificate.
info

Make sure that you choose a Relying party ID, which is a subset of all the origins you intend to use.

For example, the siven.ch Relying party ID matches the http://login.siven.ch:9443 origin, but not the https//bank.ch/ origin.