README

为使用ApiKey身份验证提供途径，适用于Symfony2。需要FOSUserBundle。

安装

需要composer，按照以下方式安装

composer require uecode/api-key-bundle dev-master

启用Bundle

将以下内容放在你的 AppKernel.php 中以启用该Bundle

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Uecode\Bundle\ApiKeyBundle\UecodeApiKeyBundle(),
    );
}

配置

你可以更改API密钥的传递方式和传递参数的名称。默认情况下，此Bundle在查询字符串中查找api_key。

uecode_api_key:
    delivery: query #or header
    parameter_name: some_value # defaults to `api_key`

更新用户提供者

此Bundle提供了两种与用户模型协同工作的方式

使用此Bundle提供的模型和用户提供者
使用自定义用户提供者

使用此Bundle提供的模型

实体

假设你已经有一个继承自FOSUserBundle基础用户模型的User类，将其继承更改为继承自Uecode\Bundle\ApiKeyBundle\Model\ApiKeyUser

然后更新你的模式。

更改使用的用户提供者

在你的安全设置中，将提供者更改为服务uecode.api_key.provider.user_provider

security:
    providers:
        db:
            id: uecode.api_key.provider.user_provider

    # Or

    providers:
        chain_provider:
            chain:
                providers: [db, memory]
        memory: # .....
        db:
            id: uecode.api_key.provider.user_provider

使用自定义用户提供者

要与此Bundle协同工作，你的用户提供者应实现ApiKeyUserProviderInterface。它包含一个用于通过apiKey加载用户的方法。你应该为用于你的api防火墙的用户提供者实现此接口

use Uecode\Bundle\ApiKeyBundle\Security\Authentication\Provider\ApiKeyUserProviderInterface;

class MyCustomUserProvider implements ApiKeyUserProviderInterface {
// ...

public function loadUserByApiKey($apiKey)
{
    return $this->userManager->findUserBy(array('apiKey' => $apiKey));
}

}

更改安全设置

你现在可以向任何防火墙添加api_key: true和stateless: true。

例如

security:
    firewalls:
        auth:
            pattern: ^/api/*
            api_key: true
            stateless: true
            provider: db # Required if you have multiple providers and firewalls

uecode / api-key-bundle

维护者

详情