Skip to content
This repository was archived by the owner on Jun 13, 2022. It is now read-only.

Commit d228220

Browse files
Merge pull request #34 from DarkGhostHunter/master
Revised code for Laravel Octane compatibility
2 parents 54b5436 + c95df0a commit d228220

File tree

1 file changed

+19
-9
lines changed

1 file changed

+19
-9
lines changed

README.md

Lines changed: 19 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,6 @@
11
![Lukenn Sabellano - Unsplash (UL) #RDufjtg6JpQ](https://images.unsplash.com/photo-1567826722186-9ecdf689f122?ixlib=rb-1.2.1&auto=format&fit=crop&w=1280&h=400&q=80)
22

3-
[![Latest Stable Version](https://poser.pugx.org/darkghosthunter/larapass/v/stable)](https://packagist.org/packages/darkghosthunter/larapass) [![License](https://poser.pugx.org/darkghosthunter/larapass/license)](https://packagist.org/packages/darkghosthunter/larapass)
4-
![](https://img.shields.io/packagist/php-v/darkghosthunter/larapass.svg)
5-
![](https://github.com/DarkGhostHunter/Larapass/workflows/PHP%20Composer/badge.svg) [![Coverage Status](https://coveralls.io/repos/github/DarkGhostHunter/Larapass/badge.svg?branch=master)](https://coveralls.io/github/DarkGhostHunter/Larapass?branch=master)
3+
[![Latest Stable Version](https://poser.pugx.org/darkghosthunter/larapass/v/stable)](https://packagist.org/packages/darkghosthunter/larapass) [![License](https://poser.pugx.org/darkghosthunter/larapass/license)](https://packagist.org/packages/darkghosthunter/larapass) ![](https://img.shields.io/packagist/php-v/darkghosthunter/larapass.svg) ![](https://github.com/DarkGhostHunter/Larapass/workflows/PHP%20Composer/badge.svg) [![Coverage Status](https://coveralls.io/repos/github/DarkGhostHunter/Larapass/badge.svg?branch=master)](https://coveralls.io/github/DarkGhostHunter/Larapass?branch=master) [![Laravel Octane Compatible](https://img.shields.io/badge/Laravel%20Octane-Compatible-success?style=flat&logo=laravel)](https://github.com/laravel/octane)
64

75
## Larapass
86

@@ -643,11 +641,11 @@ Yes, as long you are hashing them as you should, and you have secured your appli
643641

644642
* **Can a user register two or more _devices_?**
645643

646-
Yes, but you need to manually attest (register) these. It's recommended to email him to register a new device.
644+
Yes.
647645

648646
* **What happens if a credential is cloned?**
649647

650-
The user won't be authenticated since the server counter will be greater than the reported by the credential. To intercede in the procedure, modify the Assertion Validator in the Service Container and add your own `CounterChecker`:
648+
The user won't be authenticated since the "logins" counter will be greater than the reported by the original device. To intercede in the procedure, modify the Assertion Validator in the Service Container and add your own `CounterChecker`:
651649

652650
```php
653651
$this->app->bind(CounterChecker::class, function () {
@@ -685,17 +683,21 @@ Yes, [use these recovery helpers](#6-set-up-account-recovery-optional).
685683

686684
Disabling a credential doesn't delete it, so it can be later enabled manually in the case the user recovers it. When the credential is deleted, it goes away forever.
687685

686+
* **Can a user delete its credentials from its device?**
687+
688+
Yes. If it does, the other part of the credentials in your server gets virtually orphaned. You may want to show the user a list of registered credentials to delete them.
689+
688690
* **How secure is this against passwords or 2FA?**
689691

690-
Extremely secure since it works only on HTTPS, and no password or codes are exchanged.
692+
Extremely secure since it works only on HTTPS (or `localhost`), and no password are exchanged, or codes are visible in the screen.
691693

692694
* **Can I deactivate the password fallback? Can I enforce only WebAuthn authentication?**
693695

694-
Yes. Just be sure to [use the recovery helpers](#6-set-up-account-recovery-optional) to avoid users locked out.
696+
Yes. Just be sure to [use the recovery helpers](#6-set-up-account-recovery-optional) to avoid locking out your users..
695697

696698
* **Does this includes a frontend Javascript?**
697699

698-
[Yes.](#5-use-the-javascript-helper-optional)
700+
[Yes](#5-use-the-javascript-helper-optional), but it's very _basic_.
699701

700702
* **Does this encodes/decode the strings automatically in the frontend?**
701703

@@ -707,7 +709,15 @@ Yes, the included [WebAuthn Helper](#5-use-the-javascript-helper-optional) does
707709

708710
* **Can I use my smartphone as authenticator through a PC desktop/laptop/terminal?**
709711

710-
Depends on the OS and hardware. Some will require previously pairing the device to an "account". Others won't and will only work with USB keys. This is up to hardware and software vendor themselves.
712+
Depends on the OS and hardware. Some will require previously pairing the device to an "account". Others will only work with USB keys. This is up to hardware and software vendor themselves.
713+
714+
* **Why my device doesn't show Windows Hello/TouchId/FaceId/fingerprint authentication?**
715+
716+
By default, this WebAuthn implementation accepts almost everything. Some combinations of devices, OS and web browsers may differ on what to make available for WebAuthn authentication. In other words, it's not my fault.
717+
718+
* **I'm trying to test this in my development server but it doesn't work**
719+
720+
Use `localhost` exclusively, or use [ngrok](https://ngrok.com/) (or similar) to tunnel your site through HTTPS. WebAuthn only works on `localhost` or `HTTPS` only.
711721

712722
## License
713723

0 commit comments

Comments
 (0)