Waca\Security\CredentialProviders\ICredentialProvider

Size/Duplication

Total Lines	31
Duplicated Lines	0 %

Importance

Changes

0

4 Methods

Rating	Name	Duplication	Size	Complexity
	authenticate()	0	1	?
	setCredential()	0	1	?
	deleteCredential()	0	1	?
	userIsEnrolled()	0	1	?

<?php
/******************************************************************************
 * Wikipedia Account Creation Assistance tool                                 *
 *                                                                            *
 * All code in this file is released into the public domain by the ACC        *
 * Development Team. Please see team.json for a list of contributors.         *
 ******************************************************************************/

namespace Waca\Security\CredentialProviders;

use Waca\DataObjects\User;

interface ICredentialProvider
{
    /**
     * Validates a user-provided credential
     *
     * @param User $user The user to test the authentication against
     * @param string $data The raw credential data to be validated
     *
     * @return bool
     */
    public function authenticate(User $user, $data);

    /**
     * @param User $user The user the credential belongs to
     * @param int $factor The factor this credential provides
     * @param string $data
     */
    public function setCredential(User $user, $factor, $data);

For interfaces and abstract methods it is generally a good practice to add a @return annotation even if it is just @return void or @return null, so that implementors know what to do in the overridden method.

    /**
     * @param User $user
     */
    public function deleteCredential(User $user);

For interfaces and abstract methods it is generally a good practice to add a @return annotation even if it is just @return void or @return null, so that implementors know what to do in the overridden method.

    /**
     * @param int $userId
     *
     * @return bool
     */
    public function userIsEnrolled($userId);
}