77web/nanawebgithublistenerbundle

NanawebGithubListenerBundle

How to install

composer require nanaweb/github-listener-bundle:"~0.9"

Then, add Nanaweb\GithubListenerBundle\NanawebGithubListenerBundle to your registered bundle list in AppKernel. No configuration needed.

How to use

Create your own OperationRunner class for github webhook events . OperationRunners must implement Nanaweb\GithubListenerBundle\OperationRunner\OperationRunnerInterface .

Register to Symfony DI Container with nanaweb_github_listener.operation_runner tag with event attribute like this:

services:
    fake_operation_runner:
        class: App\GithubListener\OperationRunner\MyOperationRunner
        tags:
            - { name: nanaweb_github_listener.operation_runner, event: pull_request }

How to secure your webhook

Configure your guard security setting with Nanaweb\GithubListenerBundle\Security\Guard\GithubWebhookAuthenticator :

# config/packages/security.yaml
security:
    # ...

    firewalls:
        # ...

        main:
            anonymous: ~
            logout: ~

            guard:
                authenticators:
                    - Nanaweb\GithubListenerBundle\Security\Guard\GithubWebhookAuthenticator

And don't forget to add access_control configuration for ReceiveController:

# config/packages/security.yaml
security:
    # ...

    access_control:
        - { path: ^/nanaweb-github-listener/receive, roles: ROLE_GITHUB_WEBHOOK }

nanawebgithublistenerbundle's Issues

handle webhook secret