[tl! add]
```
#### Варіанти макета сторінок автентифікації
Сторінки автентифікації, що входять до стартового набору Vue, - як-от сторінки входу та реєстрації, - також мають три варіанти макета: «simple», «card» і «split».
Щоб змінити макет автентифікації, змініть макет, що імпортується на початку файлу `resources/js/layouts/AuthLayout.vue` вашого застосунку:
```js
import AuthLayout from '@/layouts/auth/AuthSimpleLayout.vue'; // [tl! remove]
import AuthLayout from '@/layouts/auth/AuthSplitLayout.vue'; // [tl! add]
```
### Livewire
Наш стартовий набір Livewire побудований на Livewire 4, Tailwind і [Flux UI](https://fluxui.dev/). Як і в усіх наших наборах, увесь код бекенду та фронтенду міститься у вашому застосунку, що дозволяє повністю його налаштувати.
Більшість коду фронтенду розташована в каталозі `resources/views`. Ви вільні змінювати будь-який код, щоб налаштувати вигляд і поведінку свого застосунку:
```text
resources/views
├── components # Reusable components
├── flux # Customized Flux components
├── layouts # Application layouts
├── pages # Livewire pages
├── partials # Reusable Blade partials
├── dashboard.blade.php # Authenticated user dashboard
├── welcome.blade.php # Guest user welcome page
```
#### Доступні макети
Стартовий набір Livewire містить два основні макети на вибір: макет із бічною панеллю («sidebar») і макет із шапкою («header»). За замовчуванням використовується макет із бічною панеллю, але ви можете перемкнутися на макет із шапкою, змінивши макет, який використовує файл `resources/views/layouts/app.blade.php` вашого застосунку. Крім того, вам слід додати атрибут `container` до головного компонента Flux:
```blade
{{ $slot }}
```
#### Варіанти макета сторінок автентифікації
Сторінки автентифікації, що входять до стартового набору Livewire, - як-от сторінки входу та реєстрації, - також мають три варіанти макета: «simple», «card» і «split».
Щоб змінити макет автентифікації, змініть макет, який використовує файл `resources/views/layouts/auth.blade.php` вашого застосунку:
```blade
{{ $slot }}
```
## Автентифікація
Усі стартові набори використовують [Laravel Fortify](/docs/{{version}}/fortify) для обробки автентифікації. Fortify надає маршрути, контролери та логіку для входу, реєстрації, скидання пароля, підтвердження електронної пошти тощо.
Fortify автоматично реєструє наведені нижче маршрути автентифікації залежно від того, які можливості увімкнено у вашому конфігураційному файлі `config/fortify.php`:
| Маршрут | Метод | Опис |
| ---------------------------------- | ------ | --------------------------------------- |
| `/login` | `GET` | Показати форму входу |
| `/login` | `POST` | Автентифікувати користувача |
| `/logout` | `POST` | Вийти з облікового запису |
| `/register` | `GET` | Показати форму реєстрації |
| `/register` | `POST` | Створити нового користувача |
| `/forgot-password` | `GET` | Показати форму запиту скидання пароля |
| `/forgot-password` | `POST` | Надіслати посилання для скидання |
| `/reset-password/{token}` | `GET` | Показати форму скидання пароля |
| `/reset-password` | `POST` | Оновити пароль |
| `/email/verify` | `GET` | Показати повідомлення про підтвердження |
| `/email/verify/{id}/{hash}` | `GET` | Підтвердити адресу електронної пошти |
| `/email/verification-notification` | `POST` | Надіслати лист підтвердження ще раз |
| `/user/confirm-password` | `GET` | Показати форму підтвердження пароля |
| `/user/confirm-password` | `POST` | Підтвердити пароль |
| `/two-factor-challenge` | `GET` | Показати форму перевірки 2FA |
| `/two-factor-challenge` | `POST` | Перевірити код 2FA |
Команда Artisan `php artisan route:list` дозволяє переглянути всі маршрути вашого застосунку.
### Увімкнення та вимкнення можливостей
Ви можете керувати тим, які можливості Fortify увімкнено, у конфігураційному файлі `config/fortify.php` вашого застосунку:
```php
use Laravel\Fortify\Features;
'features' => [
Features::registration(),
Features::resetPasswords(),
Features::emailVerification(),
Features::twoFactorAuthentication([
'confirm' => true,
'confirmPassword' => true,
]),
],
```
Щоб вимкнути можливість, закоментуйте або вилучіть відповідний запис із масиву `features`. Наприклад, вилучіть `Features::registration()`, щоб вимкнути публічну реєстрацію.
Використовуючи стартові набори [React](#react), [Svelte](#svelte) чи [Vue](#vue), вам також потрібно буде прибрати всі згадки маршрутів вимкненої можливості у коді фронтенду. Наприклад, якщо ви вимикаєте підтвердження електронної пошти, слід прибрати імпорти та звернення до маршрутів `verification` у ваших компонентах React, Svelte чи Vue. Це потрібно, бо ці набори використовують Wayfinder для типобезпечної маршрутизації, який генерує визначення маршрутів під час збірки. Якщо ви посилатиметеся на маршрути, яких більше немає, збірка вашого застосунку завершиться помилкою.
### Налаштування створення користувача та скидання пароля
Коли користувач реєструється або скидає пароль, Fortify викликає класи дій, розташовані в каталозі `app/Actions/Fortify` вашого застосунку:
| Файл | Опис |
| ----------------------------- | ------------------------------------------ |
| `CreateNewUser.php` | Валідує та створює нових користувачів |
| `ResetUserPassword.php` | Валідує та оновлює паролі користувачів |
| `PasswordValidationRules.php` | Визначає правила валідації паролів |
Наприклад, щоб налаштувати логіку реєстрації вашого застосунку, відредагуйте дію `CreateNewUser`:
```php
public function create(array $input): User
{
Validator::make($input, [
'name' => ['required', 'string', 'max:255'],
'email' => ['required', 'email', 'max:255', 'unique:users'],
'phone' => ['required', 'string', 'max:20'], // [tl! add]
'password' => $this->passwordRules(),
])->validate();
return User::create([
'name' => $input['name'],
'email' => $input['email'],
'phone' => $input['phone'], // [tl! add]
'password' => Hash::make($input['password']),
]);
}
```
### Двофакторна автентифікація
Стартові набори містять вбудовану двофакторну автентифікацію (2FA), що дозволяє користувачам захистити свої облікові записи будь-яким TOTP-сумісним застосунком-автентифікатором. 2FA увімкнено за замовчуванням через `Features::twoFactorAuthentication()` у конфігураційному файлі `config/fortify.php` вашого застосунку.
Опція `confirm` вимагає від користувачів підтвердити код, перш ніж 2FA буде повністю увімкнено, а `confirmPassword` вимагає підтвердження пароля перед увімкненням чи вимкненням 2FA. Докладніше дивіться в [документації Fortify щодо двофакторної автентифікації](/docs/{{version}}/fortify#two-factor-authentication).
### Обмеження частоти
Обмеження частоти запобігає перебору паролів і повторним спробам входу, які могли б перевантажити ваші точки автентифікації. Ви можете налаштувати поведінку обмеження частоти Fortify у `FortifyServiceProvider` вашого застосунку:
```php
use Illuminate\Support\Facades\RateLimiter;
use Illuminate\Cache\RateLimiting\Limit;
RateLimiter::for('login', function ($request) {
return Limit::perMinute(5)->by($request->email.$request->ip());
});
```
## Команди
Стартові набори React, Svelte, Vue і Livewire можна також згенерувати з підтримкою команд. Коли можливість команд увімкнено, кожен користувач належить до однієї чи кількох команд і має поточну команду. Під час реєстрації нові користувачі автоматично отримують особисту команду. Набори також містять екрани керування командами: створення команд, перемикання між ними, запрошення учасників і оновлення даних команди.
Коли маршрут прив'язаний до поточної команди, її slug входить до URL. Наприклад, маршрут панелі керування стає `/{current_team}/dashboard`, а сторінки керування командами використовують маршрути на кшталт `settings/teams/{team}`. Використовуючи параметри маршруту `{current_team}` і `{team}`, стартові набори автоматично перевіряють, що автентифікований користувач належить до запитаної команди, перш ніж надати доступ до маршруту.
Щоб зручніше генерувати URL з урахуванням команди, стартові набори реєструють значення URL за замовчуванням для поточної команди автентифікованого користувача. Це дозволяє викликам хелперів на кшталт `route('dashboard')` автоматично включати slug поточної команди. Коли користувач входить, реєструється чи перемикає команди, набори оновлюють поточну команду та ці значення за замовчуванням, тож згенеровані посилання й далі використовують правильний контекст команди.
Створюючи чи перейменовуючи команду, стартові набори також не дають користувачам обирати зарезервовані імена, які могли б утворити небезпечні чи конфліктні сегменти маршрутів. Наприклад, не можна використовувати імена, що збігалися б із префіксами маршрутів на кшталт `settings`, `login` чи `dashboard`.
## Автентифікація через WorkOS AuthKit
За замовчуванням стартові набори React, Svelte, Vue і Livewire використовують вбудовану систему автентифікації Laravel, що пропонує вхід, реєстрацію, скидання пароля, підтвердження електронної пошти тощо. Крім того, ми пропонуємо варіант кожного набору на основі [WorkOS AuthKit](https://authkit.com), який дає:
- Соціальну автентифікацію (Google, Microsoft, GitHub та Apple)
- Автентифікацію за допомогою passkey
- «Magic Auth» на основі електронної пошти
- SSO
Використання WorkOS як провайдера автентифікації [потребує облікового запису WorkOS](https://workos.com). WorkOS пропонує безкоштовну автентифікацію для застосунків із до 1 мільйона активних користувачів на місяць.
Щоб використовувати WorkOS AuthKit як провайдера автентифікації вашого застосунку, оберіть варіант WorkOS під час створення нового застосунку зі стартовим набором через `laravel new`.
### Налаштування вашого стартового набору WorkOS
Після створення нового застосунку зі стартовим набором на основі WorkOS задайте змінні середовища `WORKOS_CLIENT_ID`, `WORKOS_API_KEY` і `WORKOS_REDIRECT_URL` у файлі `.env` вашого застосунку. Ці значення мають збігатися з тими, що надані вам у панелі WorkOS для вашого застосунку:
```ini
WORKOS_CLIENT_ID=your-client-id
WORKOS_API_KEY=your-api-key
WORKOS_REDIRECT_URL="${APP_URL}/authenticate"
```
Крім того, налаштуйте URL головної сторінки застосунку в панелі WorkOS. Саме на цей URL перенаправлятимуться користувачі після виходу з вашого застосунку.
#### Налаштування методів автентифікації AuthKit
Коли ви використовуєте стартовий набір на основі WorkOS, ми радимо вимкнути автентифікацію «Email + Password» у налаштуваннях WorkOS AuthKit вашого застосунку, дозволивши користувачам автентифікуватися лише через провайдерів соціальної автентифікації, passkey, «Magic Auth» і SSO. Це дозволяє вашому застосунку взагалі не мати справи з паролями користувачів.
#### Налаштування тайм-аутів сесії AuthKit
Крім того, ми радимо налаштувати тайм-аут неактивності сесії WorkOS AuthKit так, щоб він відповідав налаштованому порогу тайм-ауту сесії вашого застосунку Laravel, який зазвичай становить дві години.
### Inertia SSR
Стартові набори React, Svelte і Vue сумісні з можливостями [рендерингу на боці сервера](https://inertiajs.com/server-side-rendering) від Inertia. Щоб зібрати сумісний з Inertia SSR бандл для вашого застосунку, виконайте команду `build:ssr`:
```shell
npm run build:ssr
```
Для зручності також доступна команда `composer dev:ssr`. Вона запустить сервер розробки Laravel і сервер Inertia SSR після збірки SSR-сумісного бандла, дозволяючи протестувати застосунок локально з рушієм серверного рендерингу Inertia:
```shell
composer dev:ssr
```
### Стартові набори від спільноти
Створюючи новий застосунок Laravel за допомогою інсталятора Laravel, ви можете передати прапорцю `--using` будь-який стартовий набір від спільноти, доступний на Packagist:
```shell
laravel new my-app --using=example/starter-kit
```
#### Створення стартових наборів
Щоб ваш стартовий набір був доступний іншим, вам потрібно опублікувати його на [Packagist](https://packagist.org). Ваш набір має визначати потрібні йому змінні середовища у файлі `.env.example`, а всі потрібні команди після встановлення слід перелічити в масиві `post-create-project-cmd` файлу `composer.json` набору.
### Часті запитання
#### Як мені оновитися?
Кожен стартовий набір дає вам надійну відправну точку для наступного застосунку. Маючи повне право власності на код, ви можете доопрацьовувати, налаштовувати й будувати свій застосунок саме так, як задумали. Утім, оновлювати сам стартовий набір не потрібно.
#### Як увімкнути підтвердження електронної пошти?
Підтвердження електронної пошти можна додати, розкоментувавши імпорт `MustVerifyEmail` у вашій моделі `App/Models/User.php` і переконавшись, що модель реалізує інтерфейс `MustVerifyEmail`:
```php
group(function () {
Route::get('dashboard', function () {
return Inertia::render('dashboard');
})->name('dashboard');
});
```
> [!NOTE]
> Підтвердження електронної пошти не потрібне, коли ви використовуєте варіант стартових наборів на основі [WorkOS](#workos).
#### Як змінити типовий шаблон листа?
Можливо, ви захочете налаштувати типовий шаблон листа, щоб він краще відповідав брендингу вашого застосунку. Щоб змінити цей шаблон, опублікуйте представлення листів у своєму застосунку такою командою:
```shell
php artisan vendor:publish --tag=laravel-mail
```
Це створить кілька файлів у `resources/views/vendor/mail`. Ви можете змінювати будь-який із них, а також файл `resources/views/vendor/mail/themes/default.css`, щоб змінити вигляд типового шаблону листа.