🔐 Soauth

Introduction

Package d'authentification via les réseaux sociaux pour Bow Framework. Ce package utilise le package thephpleague/oauth2-client pour faire un wrapper.

Actuellement, il supporte le fournisseur suivant :

• Facebook
• Gitlab
• Github
• Google
• Instagram
• Linkedin

Installation

Pour installer ce paquet, vous devez utiliser composer. Nous vous recommandons de l'installer globalement.

composer require bowphp/soauth

Configuration

Après l'installation Dans votre fichier .env.json, vous devez définir les informations d'accès au fournisseur comme suit:

Configuration Facebook

Vous pouvez créer la nouvelle application facebook à l'adresse https://developers.facebook.com/fr.

{
  "FACEBOOK_CLIENT_ID": "client_id",
  "FACEBOOK_CLIENT_SECRET": "client_secret",
  "FACEBOOK_REDIRECT_URI": "redirect_uri"
}

Configuration Gitlab

{
  "GITLAB_CLIENT_ID": "client_id",
  "GITLAB_CLIENT_SECRET": "client_secret",
  "GITLAB_REDIRECT_URI": "redirect_uri"
}

Configuration GitHub

{
  "GITHUB_CLIENT_ID": "client_id",
  "GITHUB_CLIENT_SECRET": "client_secret",
  "GITHUB_REDIRECT_URI": "redirect_uri"
}

Ainsi de suite, la configuration des autres providers suivent la même approche.

Utilisation

Pour utiliser le package, vous devez importer la configuration du package :

return [
  \Bow\Soauth\SoauthConfiguration::class,
  ...
];

Nous considérons le contrôleur suivant :

namespace App\Controllers;

use App\Controller\Controller;
use Bow\Soauth\Soauth;

class SoauthController extends Controller
{
  /**
   * Redirection vers le fournisseur define
   * 
   * @param string $provider
   * @return mixed
   */
  public function redirect($provider)
  {
    return Soauth::redirect($provider, $scope);
  }

  /**
   * Gérer les informations oauth
   * 
   * @param string $provider
   * @return mixed
   */
  public function handle($provider)
  {
    $user = Soauth::resource($provider);
  }
}

Ajouter un itinéraire

Définissez la route qui utilisera pour les actions d'appel soauth:

routes/app.php

$app->get('/oauth/:provider/redirect', 'SoauthController::redirect');
$app->get('/oauth/:provider/callback', 'SoauthController::handle');

Il manque quelque chose ?

Si vous rencontrez des problèmes avec la documentation ou si vous avez des suggestions pour améliorer la documentation ou le projet en général, veuillez déposer une issue pour nous, ou envoyer un tweet mentionnant le compte Twitter @bowframework ou sur directement sur le github.