NotificationsYou must be signed in to change notification settings
Fork0
Star0

Commit46ca631

committed

[reference] Removing some duplicate security reference and adding some links between sections

1 parent2b17e1b commit46ca631Copy full SHA for 46ca631

File tree

2 files changed

+29

-95

lines changed

cookbook/security
- form_login.rst
reference/configuration
- security.rst

2 files changed

+29

-95

lines changed

`‎cookbook/security/form_login.rst`

Lines changed: 3 additions & 86 deletions

Original file line number	Diff line number	Diff line change
`@@ -12,92 +12,9 @@ configuration is shown in the next section.`
`12`	`12`	`Form Login Configuration Reference`
`13`	`13`	`----------------------------------`
`14`	`14`
`15`		`-..configuration-block::`
`16`		`-`
`17`		`- ..code-block::yaml`
`18`		`-`
`19`		`-# app/config/security.yml`
`20`		`-security:`
`21`		`-firewalls:`
`22`		`-main:`
`23`		`-form_login:`
`24`		`-# the user is redirected here when he/she needs to login`
`25`		`-login_path:/login`
`26`		`-`
`27`		`-# if true, forward the user to the login form instead of redirecting`
`28`		`-use_forward:false`
`29`		`-`
`30`		`-# submit the login form here`
`31`		`-check_path:/login_check`
`32`		`-`
`33`		`-# by default, the login form must be a POST, not a GET`
`34`		`-post_only:true`
`35`		`-`
`36`		`-# login success redirecting options (read further below)`
`37`		`-always_use_default_target_path:false`
`38`		`-default_target_path:/`
`39`		`-target_path_parameter:_target_path`
`40`		`-use_referer:false`
`41`		`-`
`42`		`-# login failure redirecting options (read further below)`
`43`		`-failure_path:null`
`44`		`-failure_forward:false`
`45`		`-`
`46`		`-# field names for the username and password fields`
`47`		`-username_parameter:_username`
`48`		`-password_parameter:_password`
`49`		`-`
`50`		`-# csrf token options`
`51`		`-csrf_parameter:_csrf_token`
`52`		`-intention:authenticate`
`53`		`-`
`54`		`- ..code-block::xml`
`55`		`-`
`56`		`-<!-- app/config/security.xml-->`
`57`		`- <config>`
`58`		`- <firewall>`
`59`		`- <form-login`
`60`		`-check_path="/login_check"`
`61`		`-login_path="/login"`
`62`		`-use_forward="false"`
`63`		`-always_use_default_target_path="false"`
`64`		`-default_target_path="/"`
`65`		`-target_path_parameter="_target_path"`
`66`		`-use_referer="false"`
`67`		`-failure_path="null"`
`68`		`-failure_forward="false"`
`69`		`-username_parameter="_username"`
`70`		`-password_parameter="_password"`
`71`		`-csrf_parameter="_csrf_token"`
`72`		`-intention="authenticate"`
`73`		`-post_only="true"`
`74`		`- />`
`75`		`- </firewall>`
`76`		`- </config>`
`77`		`-`
`78`		`- ..code-block::php`
`79`		`-`
`80`		`- // app/config/security.php`
`81`		`- $container->loadFromExtension('security', array(`
`82`		`- 'firewalls' => array(`
`83`		`- 'main' => array('form_login' => array(`
`84`		`- 'check_path' => '/login_check',`
`85`		`- 'login_path' => '/login',`
`86`		`- 'user_forward' => false,`
`87`		`- 'always_use_default_target_path' => false,`
`88`		`- 'default_target_path' => '/',`
`89`		`- 'target_path_parameter' => _target_path,`
`90`		`- 'use_referer' => false,`
`91`		`- 'failure_path' => null,`
`92`		`- 'failure_forward' => false,`
`93`		`- 'username_parameter' => '_username',`
`94`		`- 'password_parameter' => '_password',`
`95`		`- 'csrf_parameter' => '_csrf_token',`
`96`		`- 'intention' => 'authenticate',`
`97`		`- 'post_only' => true,`
`98`		`- )),`
`99`		`- ),`
`100`		`- ));`
	`15`	`+To see the full form login configuration reference, see`
	`16`	+:doc:`/reference/configuration/security`. Some of the more interesting options
	`17`	`+are explained below.`
`101`	`18`
`102`	`19`	`Redirecting after Success`
`103`	`20`	`-------------------------`

`‎reference/configuration/security.rst`

Lines changed: 26 additions & 9 deletions

Original file line number	Diff line number	Diff line change
`@@ -86,24 +86,39 @@ Each part will be explained in the next section.`
`86`	`86`	`http_digest:`
`87`	`87`	`provider:name`
`88`	`88`	`form_login:`
	`89`	`+# submit the login form here`
`89`	`90`	`check_path:/login_check`
	`91`	`+`
	`92`	`+# the user is redirected here when he/she needs to login`
`90`	`93`	`login_path:/login`
	`94`	`+`
	`95`	`+# if true, forward the user to the login form instead of redirecting`
`91`	`96`	`use_forward:false`
	`97`	`+`
	`98`	`+# login success redirecting options (read further below)`
`92`	`99`	`always_use_default_target_path:false`
`93`		`-default_target_path:/`
`94`		`-target_path_parameter:_target_path`
`95`		`-use_referer:false`
`96`		`-failure_path:/foo`
	`100`	`+default_target_path:/`
	`101`	`+target_path_parameter:_target_path`
	`102`	`+use_referer:false`
	`103`	`+`
	`104`	`+# login failure redirecting options (read further below)`
	`105`	`+failure_path:/foo`
`97`	`106`	`failure_forward:false`
`98`	`107`	`failure_handler:some.service.id`
`99`	`108`	`success_handler:some.service.id`
	`109`	`+`
	`110`	`+# field names for the username and password fields`
`100`	`111`	`username_parameter:_username`
`101`	`112`	`password_parameter:_password`
	`113`	`+`
	`114`	`+# csrf token options`
`102`	`115`	`csrf_parameter:_csrf_token`
`103`		`-intention:authenticate`
`104`		`-csrf_provider:my.csrf_provider.id`
`105`		`-post_only:true`
`106`		`-remember_me:false`
	`116`	`+intention:authenticate`
	`117`	`+csrf_provider:my.csrf_provider.id`
	`118`	`+`
	`119`	`+# by default, the login form must be a POST, not a GET`
	`120`	`+post_only:true`
	`121`	`+remember_me:false`
`107`	`122`	`remember_me:`
`108`	`123`	`token_provider:name`
`109`	`124`	`key:someS3cretKey`
`@@ -147,7 +162,9 @@ Form Login Configuration`
`147`	`162`	`------------------------`
`148`	`163`
`149`	`164`	When using the ``form_login`` authentication listener beneath a firewall,
`150`		`-there are several common options for configuring the "form login" experience:`
	`165`	`+there are several common options for configuring the "form login" experience.`
	`166`	`+`
	`167`	+For even more details, see:doc:`/cookbook/security/form_login`.
`151`	`168`
`152`	`169`	`The Login Form and Process`
`153`	`170`	`~~~~~~~~~~~~~~~~~~~~~~~~~~`

0 commit comments

Comments

(0)

Movatterモバイル変換

Navigation Menu

Search code, repositories, users, issues, pull requests...

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Commit46ca631

File tree

2 files changed

2 files changed

`‎cookbook/security/form_login.rst`

`‎reference/configuration/security.rst`

0 commit comments