Nette Documentation Preview

syntax
Autenticação
************

Nette fornece diretrizes sobre como programar a autenticação em sua página, mas não o obriga a fazê-lo de nenhuma forma em particular. A implementação é da sua responsabilidade. Nette tem uma interface `Nette\Security\Authenticator` que o força a implementar apenas um único método chamado `authenticate`, que encontra o usuário de qualquer maneira que você queira.

Há muitas maneiras de como um usuário pode se autenticar. A maneira mais comum é *a autenticação baseada em senha* (o usuário fornece seu nome ou e-mail e uma senha), mas também há outros meios. Você pode estar familiarizado com os botões "Login com Facebook" em muitos sites, ou fazer login via Google/Twitter/GitHub ou qualquer outro site. Com Nette, você pode ter qualquer método de autenticação que desejar, ou pode combiná-los. A decisão é sua.

Normalmente você escreveria seu próprio autenticador, mas para este pequeno e simples blog nós usaremos o autenticador incorporado, que se autentica com base em uma senha e nome de usuário armazenados em um arquivo de configuração. Ele é bom para fins de teste. Portanto, adicionaremos a seguinte seção *security* ao arquivo de configuração `config/common.neon`:


```neon .{file:config/common.neon}
security:
	users:
		admin: secreto # usuário 'admin', senha 'secret'
```

A Nette criará automaticamente um serviço no contêiner DI.


Formulário de inscrição .[#toc-sign-in-form]
============================================

Agora temos a parte back-end da autenticação pronta e precisamos fornecer uma interface de usuário, através da qual o usuário faria o login. Vamos criar um novo apresentador chamado *SignPresenter*, que irá

- exibir um formulário de login (solicitando nome de usuário e senha)
- autenticar o usuário quando o formulário é submetido
- proporcionar ação de log out

Vamos começar com o formulário de login. Você já sabe como funcionam os formulários em um apresentador. Crie o `SignPresenter` e o método `createComponentSignInForm`. Deve ser parecido com isto:

```php .{file:app/UI/Sign/SignPresenter.php}
<?php
namespace App\UI\Sign;

use Nette;
use Nette\Application\UI\Form;

final class SignPresenter extends Nette\Application\UI\Presenter
{
	protected function createComponentSignInForm(): Form
	{
		$form = new Form;
		$form->addText('username', 'Username:')
			->setRequired('Please enter your username.');

		$form->addPassword('password', 'Password:')
			->setRequired('Please enter your password.');

		$form->addSubmit('send', 'Sign in');

		$form->onSuccess[] = $this->signInFormSucceeded(...);
		return $form;
	}
}
```

Há uma entrada para nome de usuário e senha.


Modelo .[#toc-template]
-----------------------

O formulário será apresentado no modelo `in.latte`

```latte .{file:app/UI/Sign/in.latte}
{block content}
<h1 n:block=title>Sign in</h1>

{control signInForm}
```


Manipulador de Login .[#toc-login-handler]
------------------------------------------

Acrescentamos também um *agitador de formulário* para assinar no usuário, que é invocado logo após o envio do formulário.

O manipulador pegará apenas o nome de usuário e a senha que o usuário digitou e a passará para o autenticador definido anteriormente. Após o login do usuário, nós o redirecionaremos para a página inicial.

```php .{file:app/UI/Sign/SignPresenter.php}
private function signInFormSucceeded(Form $form, \stdClass $data): void
{
	try {
		$this->getUser()->login($data->username, $data->password);
		$this->redirect('Home:');

	} catch (Nette\Security\AuthenticationException $e) {
		$form->addError('Incorrect username or password.');
	}
}
```

O método [Usuário::login() |api:Nette\Security\User::login()] deve lançar uma exceção quando o nome de usuário ou senha não corresponder aos que definimos anteriormente. Como já sabemos, isso resultaria em uma tela vermelha [Tracy |tracy:], ou, no modo de produção, uma mensagem informando sobre um erro interno do servidor. Nós não gostaríamos disso. É por isso que pegamos a exceção e adicionamos uma mensagem de erro agradável e amigável ao formulário.

Quando o erro ocorrer no formulário, a página com o formulário será novamente apresentada, e acima do formulário, haverá uma mensagem agradável, informando ao usuário que ele digitou um nome de usuário ou senha errada.


Segurança dos apresentadores .[#toc-security-of-presenters]
===========================================================

Iremos assegurar um formulário para adicionar e editar postos. Ele está definido no apresentador `EditPresenter`. O objetivo é impedir que usuários que não estão logados acessem a página.

Criamos um método `startup()` que é iniciado imediatamente no início do [ciclo de vida do apresentador |application:presenters#life-cycle-of-presenter]. Isto redireciona os usuários não-logados para o formulário de login.

```php .{file:app/UI/Edit/EditPresenter.php}
public function startup(): void
{
	parent::startup();

	if (!$this->getUser()->isLoggedIn()) {
		$this->redirect('Sign:in');
	}
}
```


Ocultar Links .[#toc-hide-links]
--------------------------------

Um usuário não autenticado não pode mais ver a página *criar* nem *editar*, mas ele ainda pode ver os links que apontam para eles. Vamos escondê-los também. Um desses links está em `app/UI/Home/default.latte`, e deve ser visível somente se o usuário estiver logado.

Podemos escondê-lo usando *n:attribute* chamado `n:if`. Se a declaração dentro dele for `false`, o todo `<a>` e o seu conteúdo não será exibido:

```latte
<a n:href="Edit:create" n:if="$user->isLoggedIn()">Create post</a>
```

este é um atalho para (não confundir com `tag-if`):

```latte
{if $user->isLoggedIn()}<a n:href="Edit:create">Create post</a>{/if}
```

Você deve ocultar o link de edição localizado em `app/UI/Post/show.latte` de maneira semelhante.


Link para o Formulário de Login .[#toc-login-form-link]
=======================================================

Mas como chegamos à página de login? Não há nenhum link que aponte para ela. Vamos adicionar um no arquivo modelo `@layout.latte`. Tente encontrar um lugar agradável, pode ser em qualquer lugar que você mais goste.

```latte .{file:app/UI/@layout.latte}
...
<ul class="navig">
	<li><a n:href="Home:">Home</a></li>
	{if $user->isLoggedIn()}
		<li><a n:href="Sign:out">Sign out</a></li>
	{else}
		<li><a n:href="Sign:in">Sign in</a></li>
	{/if}
</ul>
...
```

Se o usuário ainda não estiver logado, mostraremos o link "Entrar". Caso contrário, mostraremos o link "Sign out". Acrescentamos essa ação no SignPresenter.

A ação de logout parece assim, e como redirecionamos o usuário imediatamente, não há necessidade de um modelo de visualização.

```php .{file:app/UI/Sign/SignPresenter.php}
public function actionOut(): void
{
	$this->getUser()->logout();
	$this->flashMessage('You have been signed out.');
	$this->redirect('Home:');
}
```

Ele apenas chama o método `logout()` e depois mostra uma mensagem agradável para o usuário.


Sumário .[#toc-summary]
=======================

Temos um link para fazer o login e também para fazer o logout do usuário. Utilizamos o autenticador incorporado para autenticação e os detalhes de login estão no arquivo de configuração, pois este é um aplicativo de teste simples. Também asseguramos os formulários de edição para que somente usuários logados possam adicionar e editar mensagens.

.[note]
Aqui você pode ler mais sobre o [login |security:authentication] e [autorização |security:authorization] do [usuário |security:authentication].

{{priority: -1}}
{{sitename: Nette Quickstart}}

Autenticação

Nette fornece diretrizes sobre como programar a autenticação em sua página, mas não o obriga a fazê-lo de nenhuma forma em particular. A implementação é da sua responsabilidade. Nette tem uma interface Nette\Security\Authenticator que o força a implementar apenas um único método chamado authenticate, que encontra o usuário de qualquer maneira que você queira.

Há muitas maneiras de como um usuário pode se autenticar. A maneira mais comum é a autenticação baseada em senha (o usuário fornece seu nome ou e-mail e uma senha), mas também há outros meios. Você pode estar familiarizado com os botões „Login com Facebook“ em muitos sites, ou fazer login via Google/Twitter/GitHub ou qualquer outro site. Com Nette, você pode ter qualquer método de autenticação que desejar, ou pode combiná-los. A decisão é sua.

Normalmente você escreveria seu próprio autenticador, mas para este pequeno e simples blog nós usaremos o autenticador incorporado, que se autentica com base em uma senha e nome de usuário armazenados em um arquivo de configuração. Ele é bom para fins de teste. Portanto, adicionaremos a seguinte seção security ao arquivo de configuração config/common.neon:

security:
	users:
		admin: secreto # usuário 'admin', senha 'secret'

A Nette criará automaticamente um serviço no contêiner DI.

Formulário de inscrição

Agora temos a parte back-end da autenticação pronta e precisamos fornecer uma interface de usuário, através da qual o usuário faria o login. Vamos criar um novo apresentador chamado SignPresenter, que irá

  • exibir um formulário de login (solicitando nome de usuário e senha)
  • autenticar o usuário quando o formulário é submetido
  • proporcionar ação de log out

Vamos começar com o formulário de login. Você já sabe como funcionam os formulários em um apresentador. Crie o SignPresenter e o método createComponentSignInForm. Deve ser parecido com isto:

<?php
namespace App\UI\Sign;

use Nette;
use Nette\Application\UI\Form;

final class SignPresenter extends Nette\Application\UI\Presenter
{
	protected function createComponentSignInForm(): Form
	{
		$form = new Form;
		$form->addText('username', 'Username:')
			->setRequired('Please enter your username.');

		$form->addPassword('password', 'Password:')
			->setRequired('Please enter your password.');

		$form->addSubmit('send', 'Sign in');

		$form->onSuccess[] = $this->signInFormSucceeded(...);
		return $form;
	}
}

Há uma entrada para nome de usuário e senha.

Modelo

O formulário será apresentado no modelo in.latte

{block content}
<h1 n:block=title>Sign in</h1>

{control signInForm}

Manipulador de Login

Acrescentamos também um agitador de formulário para assinar no usuário, que é invocado logo após o envio do formulário.

O manipulador pegará apenas o nome de usuário e a senha que o usuário digitou e a passará para o autenticador definido anteriormente. Após o login do usuário, nós o redirecionaremos para a página inicial.

private function signInFormSucceeded(Form $form, \stdClass $data): void
{
	try {
		$this->getUser()->login($data->username, $data->password);
		$this->redirect('Home:');

	} catch (Nette\Security\AuthenticationException $e) {
		$form->addError('Incorrect username or password.');
	}
}

O método Usuário::login() deve lançar uma exceção quando o nome de usuário ou senha não corresponder aos que definimos anteriormente. Como já sabemos, isso resultaria em uma tela vermelha Tracy, ou, no modo de produção, uma mensagem informando sobre um erro interno do servidor. Nós não gostaríamos disso. É por isso que pegamos a exceção e adicionamos uma mensagem de erro agradável e amigável ao formulário.

Quando o erro ocorrer no formulário, a página com o formulário será novamente apresentada, e acima do formulário, haverá uma mensagem agradável, informando ao usuário que ele digitou um nome de usuário ou senha errada.

Segurança dos apresentadores

Iremos assegurar um formulário para adicionar e editar postos. Ele está definido no apresentador EditPresenter. O objetivo é impedir que usuários que não estão logados acessem a página.

Criamos um método startup() que é iniciado imediatamente no início do ciclo de vida do apresentador. Isto redireciona os usuários não-logados para o formulário de login.

public function startup(): void
{
	parent::startup();

	if (!$this->getUser()->isLoggedIn()) {
		$this->redirect('Sign:in');
	}
}

Um usuário não autenticado não pode mais ver a página criar nem editar, mas ele ainda pode ver os links que apontam para eles. Vamos escondê-los também. Um desses links está em app/UI/Home/default.latte, e deve ser visível somente se o usuário estiver logado.

Podemos escondê-lo usando n:attribute chamado n:if. Se a declaração dentro dele for false, o todo <a> e o seu conteúdo não será exibido:

<a n:href="Edit:create" n:if="$user->isLoggedIn()">Create post</a>

este é um atalho para (não confundir com tag-if):

{if $user->isLoggedIn()}<a n:href="Edit:create">Create post</a>{/if}

Você deve ocultar o link de edição localizado em app/UI/Post/show.latte de maneira semelhante.

Mas como chegamos à página de login? Não há nenhum link que aponte para ela. Vamos adicionar um no arquivo modelo @layout.latte. Tente encontrar um lugar agradável, pode ser em qualquer lugar que você mais goste.

...
<ul class="navig">
	<li><a n:href="Home:">Home</a></li>
	{if $user->isLoggedIn()}
		<li><a n:href="Sign:out">Sign out</a></li>
	{else}
		<li><a n:href="Sign:in">Sign in</a></li>
	{/if}
</ul>
...

Se o usuário ainda não estiver logado, mostraremos o link „Entrar“. Caso contrário, mostraremos o link „Sign out“. Acrescentamos essa ação no SignPresenter.

A ação de logout parece assim, e como redirecionamos o usuário imediatamente, não há necessidade de um modelo de visualização.

public function actionOut(): void
{
	$this->getUser()->logout();
	$this->flashMessage('You have been signed out.');
	$this->redirect('Home:');
}

Ele apenas chama o método logout() e depois mostra uma mensagem agradável para o usuário.

Sumário

Temos um link para fazer o login e também para fazer o logout do usuário. Utilizamos o autenticador incorporado para autenticação e os detalhes de login estão no arquivo de configuração, pois este é um aplicativo de teste simples. Também asseguramos os formulários de edição para que somente usuários logados possam adicionar e editar mensagens.

Aqui você pode ler mais sobre o login e autorização do usuário.