Capítulo 3

Instalação e Configuração do Laravel Socialite

A melhor e mais segura forma de ligar a sua aplicação Laravel ao ACAPADEV ID é utilizando o Laravel Socialite juntamente com a comunidade SocialiteProviders.

1. Instalação via Composer

Na sua aplicação cliente, execute os seguintes comandos no terminal:

composer require laravel/socialite
composer require socialiteproviders/laravelpassport

2. Adicionar o Provider no EventServiceProvider

O Laravel precisa de saber como gerir as credenciais do nosso servidor OAuth. Vá ao ficheiro app/Providers/EventServiceProvider.php e adicione o seguinte evento:

protected $listen = [
    \SocialiteProviders\Manager\SocialiteWasCalled::class => [
        \SocialiteProviders\LaravelPassport\LaravelPassportExtendSocialite::class.'@handle',
    ],
];

3. Configurar as Variáveis de Ambiente (.env)

Coloque as chaves geradas pelo painel ACAPADEV ID no ficheiro .env do seu projeto:

ACAPADEV_CLIENT_ID="cli_c0nt4g1l_29f8a3b1"
ACAPADEV_CLIENT_SECRET="sk_live_xK93mP0zQ7vR2aL5nT8yW1eJ"
ACAPADEV_REDIRECT_URI="https://sua-app.ao/auth/callback"
ACAPADEV_HOST="https://sso-acapadev.test"

4. Registar os Serviços no config/services.php

Adicione um novo array laravelpassport ao ficheiro config/services.php da sua aplicação:

'laravelpassport' => [
    'client_id' => env('ACAPADEV_CLIENT_ID'),
    'client_secret' => env('ACAPADEV_CLIENT_SECRET'),
    'redirect' => env('ACAPADEV_REDIRECT_URI'),
    'host' => env('ACAPADEV_HOST'),
],

Com estas definições criadas, a sua app já consegue contactar o ACAPADEV ID. No próximo capítulo, iremos criar a lógica para processar o Callback.