Bundle Installation

This framework provides a Symfony bundle that will help you to use the components within your Symfony application.
If you use Laravel, you may be interested in this project: https://github.com/asbiin/laravel-webauthn​
Installation
With Symfony Flex
Symfony Flex recipes are provided through a dedicated repository. It is highly recommended to add this repository before installing the bundle.
1
composer config --json extra.symfony.endpoint '["https://api.github.com/repos/Spomky-Labs/recipes/contents/index.json?ref=main", "flex://defaults"]'
Copied!
composer.json
1
{
2
    ...
3
    "extra": {
4
        "symfony": {
5
            "endpoint": [
6
                "https://api.github.com/repos/Spomky-Labs/recipes/contents/index.json?ref=main",
7
                "flex://defaults"
8
            ]
9
        }
10
    }
11
}
Copied!
Then, you can install the bundle or the complete framework:
1
composer require web-auth/webauthn-symfony-bundle #Will only install the bundle
2
​
3
#or
4
composer require web-auth/webauthn-framework# Will install the whole framework (not recommended)
Copied!
As the recipes are third party ones not officially supported by Symfony, you will be asked to execute the recipe or not. When applied, the recipes will prompt a message such as WebAuthn Framework is ready.
Without Symfony Flex
If you don't use Symfony Flex, you must register the bundle manually.
config/bundles.php
1
<?php
2
​
3
return [
4
    //...
5
    Webauthn\Bundle\WebauthnBundle::class => ['all' => true],
6
];
Copied!
config/routes/webauthn.php
1
<?php
2
​
3
declare(strict_types=1);
4
​
5
use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
6
​
7
return function (RoutingConfigurator $routes) {
8
    $routes->import('.', 'webauthn');
9
};
Copied!
Repositories
The first steps are:
The creation of your Credential Source repository​
The creation of your User Entity repositories.
You may also want to configure the other options offered by the bundle. Please refer to the configuration references.
Firewall
Now you have a fully configured bundle, you can protect your routes and manage the user registration and authenticatin through the Symfony Firewall.

Dealing with “localhost”

Next - Symfony Bundle

Credential Source Repository

Last modified 1mo ago

Export as PDF

Copy link

Edit on GitHub

Contents