Interface

Symfony\Component\Form\Extension\Csrf\CsrfProvider\CsrfProviderInterface

interface CsrfProviderInterface

Marks classes able to provide CSRF protection

You can generate a CSRF token by using the method generateCsrfToken(). To this method you should pass a value that is unique to the page that should be secured against CSRF attacks. This value doesn't necessarily have to be secret. Implementations of this interface are responsible for adding more secret information.

If you want to secure a form submission against CSRF attacks, you could supply an "intention" string. This way you make sure that the form can only be bound to pages that are designed to handle the form, that is, that use the same intention string to validate the CSRF token with isCsrfTokenValid().

Methods

generateCsrfToken(string $intention)

Generates a CSRF token for a page of your application.

Boolean isCsrfTokenValid(string $intention, string $token)

Validates a CSRF token.

Details

at line 38
public generateCsrfToken(string $intention)

Generates a CSRF token for a page of your application.

Parameters

string $intention Some value that identifies the action intention (i.e. "authenticate"). Doesn't have to be a secret value.

at line 48
public Boolean isCsrfTokenValid(string $intention, string $token)

Validates a CSRF token.

Parameters

string $intention The intention used when generating the CSRF token
string $token The token supplied by the browser

Return Value

Boolean Whether the token supplied by the browser is correct