icingaweb2/library/Icinga/Application/Hook/AuthenticationHook.php

76 lines
1.8 KiB
PHP

<?php
namespace Icinga\Application\Hook;
use Icinga\User;
use Icinga\Web\Hook;
use Icinga\Application\Logger;
/**
* Icinga Web Authentication Hook base class
*
* This hook can be used to authenticate the user in a third party application.
* Extend this class if you want to perform arbitrary actions during the login and logout.
*/
abstract class AuthenticationHook
{
/**
* Name of the hook
*/
const NAME = 'authentication';
/**
* Triggered after login in Icinga Web and when calling login action even if already authenticated in Icinga Web
*
* @param User $user
*/
public function onLogin(User $user)
{
}
/**
* Triggered before logout from Icinga Web
*
* @param User $user
*/
public function onLogout(User $user)
{
}
/**
* Call the onLogin() method of all registered AuthHook(s)
*
* @param User $user
*/
public static function triggerLogin(User $user)
{
/** @var AuthenticationHook $hook */
foreach (Hook::all(self::NAME) as $hook) {
try {
$hook->onLogin($user);
} catch (\Exception $e) {
// Avoid error propagation if login failed in third party application
Logger::error($e);
}
}
}
/**
* Call the onLogout() method of all registered AuthHook(s)
*
* @param User $user
*/
public static function triggerLogout(User $user)
{
/** @var AuthenticationHook $hook */
foreach (Hook::all(self::NAME) as $hook) {
try {
$hook->onLogout($user);
} catch (\Exception $e) {
// Avoid error propagation if login failed in third party application
Logger::error($e);
}
}
}
}