a symfony bundle to help secure your REST api with signed requests

1.0 2014-10-04 22:09 UTC


Build Status Total Downloads Latest Stable Version


1. Download CaparicaBundle using composer
2. Enable the Bundle
3. add a client
4. Configure your controller

Step1: Download CaparicaBundle using composer

Add CaparicaBundle by running the command:

$ php composer.phar require francodacosta/caparica-bundle '~1.0'

Step 2: Enable the bundle

Enable the bundle in the kernel:

// app/AppKernel.php

public function registerBundles()
    $bundles = array(
        // ...
        new Francodacosta\CaparicaBundle\FrancodacostaCaparicaBundle(),

Step 3: Configure a client

So that the server can verify the client signature it needs to know the client/api id and secret

If using the YamlClientProvider edit the file : app/config/caparica.yml

    code: "the client code"
    secret: "the client api secret"

add the following to your app/config.yml file

    client_provider_id: francodacosta.caparica.client.provider.yaml

Step 4: Configure your controller

Make sure you controller implements the Francodacosta\CaparicaBundle\Controller\CaparicaControllerInterface. The Francodacosta\CaparicaBundle\Controller\CaparicaController extends the Symfony controller and has some handy methods.

and that's it all controller actions accessed via a route will have to be signed